Agents
Returns a summary list of all registered agents with high-level performance metrics and their current primary role and specialization.
Responses
200
A summary list of agents
application/json
get
GET /api/agents HTTP/1.1
Host: infa.idefi.ai
Accept: */*
200
A summary list of agents
[
{
"id": "agent_001",
"name": "iNFA Alpha",
"currentRole": "Scout",
"completionRate": 95.5,
"specialization": "Trend Analysis"
},
{
"id": "agent_002",
"name": "iNFA Beta",
"currentRole": "Builder",
"completionRate": 90,
"specialization": "Workflow Orchestration"
}
]
Creates a new agent with all five roles. The user can train/specialize the agent; the dominant trait is recorded in the specialization field.
Body
idstringRequiredExample:
agent_001
namestringRequiredExample:
iNFA Agent Alpha
aiEnginestringRequiredExample:
Adaptive ML Engine v2.3
operationalHistorystring[]OptionalExample:
["Task A completed","Task B updated"]
experiencePointsintegerOptionalExample:
1500
specializationstringOptionalExample:
Dominant role trait after training/minting
Scout
Responses
201
Agent created successfully
application/json
post
POST /api/agents HTTP/1.1
Host: infa.idefi.ai
Content-Type: application/json
Accept: */*
Content-Length: 698
{
"id": "agent_001",
"name": "iNFA Agent Alpha",
"aiEngine": "Adaptive ML Engine v2.3",
"operationalHistory": [
"Task A completed",
"Task B updated"
],
"ownershipMetadata": {
"owner": "user123",
"leased": false
},
"roles": [
{
"roleName": "Scout",
"primaryFunction": "Analyzes market trends and signals opportunities.",
"skills": [
"Predictive modeling",
"Trend analysis",
"Rapid data scanning"
]
}
],
"experiencePoints": 1500,
"dynamicMetadata": {
"currentVersion": "v2.3",
"skillUpgrades": [
"Analytics boost"
]
},
"performanceMetrics": {
"uptime": 99.9,
"completionRate": 95.5,
"averageResponseTime": 350,
"errorRate": 0.2
},
"historicalData": [
{
"timestamp": "2025-02-01T12:00:00Z",
"tasksCompleted": 50,
"experiencePoints": 1400
}
],
"specialization": "Scout"
}
201
Agent created successfully
{
"id": "agent_003",
"name": "iNFA Gamma",
"aiEngine": "Adaptive ML Engine v2.4",
"operationalHistory": [
"Initialized",
"Trained on market data"
],
"ownershipMetadata": {
"owner": "user789",
"leased": false
},
"roles": [
{
"roleName": "Scout",
"primaryFunction": "Scans market trends",
"skills": [
"Predictive modeling",
"Data scanning"
]
},
{
"roleName": "Builder",
"primaryFunction": "Constructs workflows",
"skills": [
"Smart contract assembly",
"Protocol integration"
]
},
{
"roleName": "Defender",
"primaryFunction": "Secures operations",
"skills": [
"Threat detection",
"Compliance monitoring"
]
},
{
"roleName": "Scout",
"primaryFunction": "Identifies opportunities",
"skills": [
"Rapid data scanning"
]
},
{
"roleName": "Healer",
"primaryFunction": "Optimizes systems",
"skills": [
"Self-correcting algorithms",
"Portfolio balancing"
]
}
],
"experiencePoints": 1000,
"dynamicMetadata": {
"currentVersion": "v2.4",
"skillUpgrades": [
"Enhanced threat detection"
]
},
"performanceMetrics": {
"uptime": 98.5,
"completionRate": 92,
"averageResponseTime": 400,
"errorRate": 0.5
},
"specialization": "Defender"
}