GET /agents
列出 Cell 内所有 Agent。
GET /cells/{cellID}/agents
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
cellID | string | Cell ID |
查询参数
无。
curl 示例
curl -s "http://localhost:9091/cells/dept-legal/agents" \
-H "Authorization: Bearer $TOKEN" | jq .
响应
200 OK
{
"agents": [
{
"id": "agent-legal",
"name": "合同审查助手",
"description": "专业审查各类商业合同,识别风险条款",
"model": "gpt-4o",
"created_at": "2026-09-01T00:00:00Z",
"updated_at": "2026-09-20T10:00:00Z"
},
{
"id": "agent-research",
"name": "判例检索助手",
"description": "检索和分析相关法律判例",
"model": "claude-sonnet-4",
"created_at": "2026-09-05T00:00:00Z",
"updated_at": "2026-09-18T14:30:00Z"
}
]
}
Agent 对象字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Agent 唯一标识 |
name | string | 显示名称 |
description | string | 描述信息 |
model | string | 默认使用的模型 |
created_at | string | 创建时间(RFC 3339) |
updated_at | string | 最后更新时间(RFC 3339) |
错误码
| HTTP | 错误 | 说明 |
|---|---|---|
| 401 | — | 未认证或 Token 无效 |
| 404 | — | Cell 不存在 |
相关端点
- POST /agents — 注册 / 更新 Agent
- GET /agents/{aid} — 获取 Agent 详情
- DELETE /agents/{aid} — 删除 Agent