运行时 & Agent API

运行时守护进程是在本地执行 AI Agent 任务的进程。它们注册到服务器、轮询任务并报告结果。

Agent 发现

列出可用 Agent

返回从已注册运行时聚合的所有已知 Agent。

GET /api/v1/agents/available
Authorization: Bearer <token>

响应 200 OK

[
  {
    "agent_id": "claude-code",
    "display_name": "Claude Code",
    "available": true,
    "runtime_count": 2,
    "compatibility_level": "full",
    "versions": ["1.0.22"]
  },
  {
    "agent_id": "gemini-cli",
    "display_name": "Gemini CLI",
    "available": true,
    "runtime_count": 1,
    "compatibility_level": "full",
    "versions": ["2.1.0"]
  }
]

支持的 Agent：claude-code、codex、gemini-cli、opencode、kimi-code

运行时管理（平台管理员）

列出运行时

需要平台管理员权限。

GET /api/v1/runtimes
Authorization: Bearer <token>

响应 200 OK

[
  {
    "id": "uuid",
    "daemon_id": "mac-studio-01",
    "device_name": "Mac Studio M2",
    "status": "online",
    "available_agents": ["claude-code", "gemini-cli"],
    "max_concurrent_tasks": 3,
    "last_heartbeat": "2026-01-01T00:00:00Z"
  }
]

获取运行时详情

GET /api/v1/runtimes/{runtime_id}

移除运行时

DELETE /api/v1/runtimes/{runtime_id}

守护进程注册（内部接口）

守护进程启动时自动调用。

注册

POST /api/v1/runtimes/register
Content-Type: application/json

{
  "daemon_id": "mac-studio-01",
  "device_name": "Mac Studio M2",
  "available_agents": ["claude-code", "gemini-cli"],
  "max_concurrent_tasks": 3
}

心跳

POST /api/v1/runtimes/{runtime_id}/heartbeat

领取任务

POST /api/v1/runtimes/{runtime_id}/poll

报告完成

POST /api/v1/runtimes/{runtime_id}/complete
Content-Type: application/json

{
  "node_id": "uuid",
  "status": "completed",
  "metrics": {
    "duration_seconds": 120,
    "tokens_used": 50000
  }
}