获取 Agent

根据 ID 获取指定 Agent 的详细信息。

GET /api/v1/cloud/agents/{agent_id}

获取指定 Agent 的详细信息。

​

请求头

头部	必选	说明
Authorization	是	Bearer <PAT>

​

路径参数

参数	类型	必选	说明
agent_id	string	是	Agent 唯一标识，前缀为 agent_

​

查询参数

参数	类型	必选	说明
version	integer	否	返回指定版本的 Agent 快照；不传时返回当前 Agent

​

示例请求

curl -X GET "https://api.qoder.com/api/v1/cloud/agents/agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Authorization: Bearer $QODER_PAT"

​

示例响应

HTTP 200 OK

{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "name": "doc-test-agent",
  "description": "",
  "model": "ultimate",
  "system": "你是文档测试助手",
  "tools": [],
  "mcp_servers": [],
  "skills": [
    {"type": "custom", "skill_id": "skill_019e5d133c057536872f745e0b6dbd5d"}
  ],
  "metadata": {},
  "multiagent": null,
  "version": 1,
  "archived_at": null,
  "created_at": "2026-05-18T15:26:39.61669Z",
  "updated_at": "2026-05-18T15:26:39.61669Z"
}

​

响应字段

不传 version 时，响应为当前 Agent 对象。传入 version 时，响应为 Agent version snapshot。

字段	类型	说明
type	string	固定值 "agent"
id	string	Agent 唯一标识
name	string	Agent 名称
description	string	Agent 描述
model	string | object	模型标识，详见 Agent model
system	string	系统提示词
tools	Agent tool 数组	工具配置列表
mcp_servers	MCP server 数组	MCP 服务器配置
skills	Skill binding 数组	Skill 绑定列表
metadata	Metadata 对象	自定义元数据
multiagent	Multiagent | null	Agents 配置，未设置时为 null
version	integer	当前版本号
archived_at	string|null	归档时间（ISO 8601），未归档时为 null
created_at	string	创建时间（ISO 8601）
updated_at	string	最后更新时间（ISO 8601）

​

错误码

HTTP	type	触发条件
400	invalid_request_error	version 不是正整数
401	authentication_error	PAT 无效或过期
403	permission_error	无权限访问此 Agent
404	not_found_error	指定 ID 的 Agent 不存在

错误响应示例：

{
  "type": "error",
  "request_id": "cb80235f-76a2-4ff3-9e28-5aa2da12dc14",
  "error": {
    "type": "not_found_error",
    "message": "Agent 'agent_nonexistent' was not found."
  }
}

​

相关

定义 Agent

创建可复用、可版本化的 Agent 配置。