Agents

List agents (summary)

get

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"
  }
]

Create a new agent

post

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
specializationstringOptional

Dominant role trait after training/minting

Example: 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"
}