Agents API

Manage agents programmatically.

List Agents

GET /api/agents

Response

{
  "agents": [
    {
      "name": "default",
      "status": "running",
      "model": "gpt-4o",
      "skills_count": 12,
      "channels": ["telegram", "discord"],
      "created_at": "2024-01-15T10:00:00Z"
    },
    {
      "name": "researcher",
      "status": "running",
      "model": "gpt-4o-mini",
      "skills_count": 8,
      "channels": [],
      "created_at": "2024-01-16T14:30:00Z"
    }
  ]
}

Get Agent

GET /api/agents/:name

Response

{
  "name": "default",
  "status": "running",
  "config": {
    "model": "gpt-4o",
    "provider": "openai",
    "temperature": 0.7
  },
  "skills": ["host_shell", "web_crawler", "git"],
  "channels": [
    {"type": "telegram", "status": "connected"}
  ],
  "memory": {
    "stm_entries": 25,
    "ltm_entries": 150
  },
  "created_at": "2024-01-15T10:00:00Z"
}

Create Agent

POST /api/agents

Request

{
  "name": "new_agent",
  "persona": "You are a helpful assistant specialized in data analysis.",
  "config": {
    "model": "gpt-4o-mini",
    "provider": "openai",
    "temperature": 0.5
  }
}

Response

{
  "success": true,
  "agent": {
    "name": "new_agent",
    "status": "created",
    "created_at": "2024-01-15T12:00:00Z"
  }
}

Update Agent

PUT /api/agents/:name

Request

{
  "persona": "Updated persona text...",
  "config": {
    "temperature": 0.8
  }
}

Delete Agent

DELETE /api/agents/:name

Response

{
  "success": true,
  "message": "Agent 'old_agent' deleted"
}

Restart Agent

POST /api/agents/:name/restart

Response

{
  "success": true,
  "message": "Agent 'default' restarted"
}

Get Agent Status

GET /api/agents/:name/status

Response

{
  "name": "default",
  "status": "running",
  "uptime_seconds": 86400,
  "requests_processed": 1523,
  "last_activity": "2024-01-15T12:00:00Z",
  "memory_usage_mb": 45.2
}

Get Agent Logs

GET /api/agents/:name/logs?limit=100

Query Parameters

Parameter	Default	Description
limit	100	Max log entries
level	all	Filter by level (debug, info, warn, error)
since	-	ISO timestamp for start

Response

{
  "logs": [
    {
      "timestamp": "2024-01-15T12:00:00Z",
      "level": "info",
      "message": "Brain activated by WEB_UI"
    },
    {
      "timestamp": "2024-01-15T12:00:01Z",
      "level": "debug",
      "message": "Invoking skill: host_shell"
    }
  ]
}