Agents

List agents (summary)

Returns a summary list of all registered agents with high-level performance metrics and their current primary role and specialization.

get

/agents

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://infa.idefi.ai/api/agents'

200

200

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

A summary list of agents

Create a new agent

Creates a new agent with all five roles. The user can train/specialize the agent; the dominant trait is recorded in the specialization field.

post

/agents

Body

idstringrequired

Example: agent_001

namestringrequired

Example: iNFA Agent Alpha

aiEnginestringrequired

Example: Adaptive ML Engine v2.3

experiencePointsinteger

Example: 1500

specializationstring

Dominant role trait after training/minting

Example: Scout

operationalHistorystring[]

Example: ["Task A completed","Task B updated"]

rolesobject[]required

ownershipMetadataobject

performanceMetricsobject

Real-time performance statistics

dynamicMetadataobject

Versioning and upgrade details

historicalDataobject[]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://infa.idefi.ai/api/agents' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "agent_001",
    "name": "iNFA Agent Alpha",
    "aiEngine": "Adaptive ML Engine v2.3",
    "experiencePoints": 1500,
    "specialization": "Scout",
    "operationalHistory": [
      "Task A completed",
      "Task B updated"
    ],
    "roles": [
      {
        "roleName": "Scout",
        "primaryFunction": "Analyzes market trends and signals opportunities.",
        "skills": [
          "Predictive modeling",
          "Trend analysis",
          "Rapid data scanning"
        ]
      }
    ],
    "ownershipMetadata": {
      "owner": "user123",
      "leased": false
    },
    "performanceMetrics": {
      "uptime": 99.9,
      "completionRate": 95.5,
      "averageResponseTime": 350,
      "errorRate": 0.2
    },
    "dynamicMetadata": {
      "currentVersion": "v2.3",
      "skillUpgrades": [
        "Analytics boost"
      ]
    },
    "historicalData": [
      {
        "timestamp": "2025-02-01T12:00:00Z",
        "tasksCompleted": 50,
        "experiencePoints": 1400
      }
    ]
  }'

201

201

{
  "id": "agent_003",
  "name": "iNFA Gamma",
  "aiEngine": "Adaptive ML Engine v2.4",
  "experiencePoints": 1000,
  "specialization": "Defender",
  "operationalHistory": [
    "Initialized",
    "Trained on market data"
  ],
  "ownershipMetadata": {
    "owner": "user789",
    "leased": false
  },
  "performanceMetrics": {
    "uptime": 98.5,
    "completionRate": 92,
    "averageResponseTime": 400,
    "errorRate": 0.5
  },
  "dynamicMetadata": {
    "currentVersion": "v2.4",
    "skillUpgrades": [
      "Enhanced threat detection"
    ]
  },
  "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"
      ]
    }
  ]
}

Agent created successfully