Skip to main content
GET
获取智能体
每个请求都必须发送 ?beta=true

授权

X-Api-Key
string
header
默认值:sk-ant-local-default
必填

OMA 工作区 API 密钥。

请求头

anthropic-version
string

要使用的 OMA API 兼容版本。

anthropic-beta
string

用于启用托管智能体 API 合同的 Beta 请求头。

路径参数

agent_id
string
必填

智能体标识符。

查询参数

beta
enum<boolean>
必填

为此接口启用 Beta API 合同,必须为 true

可用选项:
true
version
integer<int32>

智能体版本。省略则使用最新版本。指定时必须至少为 1。

响应

请求成功。

托管智能体的 agent

id
string
必填
示例:

"agent_011CZkYpogX7uDKUyvBTophP"

archived_at
string<date-time> | null
必填

智能体的归档时间。未归档时为 null。

示例:

null

created_at
string<date-time>
必填

RFC 3339 格式的时间戳

示例:

"2026-03-15T10:00:00Z"

description
string | null
必填
示例:

"一个通用入门智能体。"

mcp_servers
object[]
必填
示例:
metadata
object
必填
示例:
model
object
必填

模型标识符和配置。

示例:
multiagent
object | null
必填

多智能体编排配置。当智能体为单线程时为 null。

示例:
name
string
必填
示例:

"我的第一个智能体"

skills
object[]
必填

API 响应中返回的已解析技能。

示例:
示例:
system
string | null
必填
示例:

"你是一个通用智能体,可以研究问题、编写代码、运行命令并使用已连接的工具,端到端地完成用户任务。"

tools
object[]
必填

API 响应中返回的工具配置的联合类型。

示例:
type
enum<string>
必填
可用选项:
agent
示例:

"agent"

updated_at
string<date-time>
必填

RFC 3339 格式的时间戳

示例:

"2026-03-15T10:00:00Z"

version
integer<int32>
必填

智能体的当前版本。从 1 开始,每次修改智能体时递增。

示例:

1