列出智能体

通过 OMA API 列出智能体。

GET /v1/agents

列出智能体

cURL

curl --request GET \
  --url http://localhost:38080/v1/agents \
  --header 'X-Api-Key: <api-key>'

200

{
  "data": [
    {
      "id": "agent_011CZkYpogX7uDKUyvBTophP",
      "archived_at": null,
      "created_at": "2026-03-15T10:00:00Z",
      "description": "通用入门智能体。",
      "mcp_servers": [
        {
          "name": "example-mcp",
          "type": "url",
          "url": "https://example-server.modelcontextprotocol.io/sse"
        }
      ],
      "metadata": {
        "foo": "bar"
      },
      "model": {
        "id": "claude-sonnet-4-6",
        "effort": {
          "type": "low"
        },
        "inference_geo": "inference_geo",
        "speed": "standard"
      },
      "multiagent": {
        "agents": [
          {
            "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
            "type": "agent",
            "version": 1
          }
        ],
        "type": "coordinator"
      },
      "name": "我的第一个智能体",
      "skills": [
        {
          "skill_id": "xlsx",
          "type": "anthropic",
          "version": "1"
        },
        {
          "skill_id": "skill_011CZkZFNu9hAbo3jZPRgTlx",
          "type": "custom",
          "version": "2"
        }
      ],
      "system": "你是一个通用智能体，可以研究问题、编写代码、运行命令并使用已连接的工具，端到端地完成用户任务。",
      "tools": [
        {
          "configs": [
            {
              "enabled": true,
              "name": "bash",
              "permission_policy": {
                "type": "always_allow"
              }
            }
          ],
          "default_config": {
            "enabled": true,
            "permission_policy": {
              "type": "always_ask"
            }
          },
          "type": "agent_toolset_20260401"
        }
      ],
      "type": "agent",
      "updated_at": "2026-03-15T10:00:00Z",
      "version": 1
    }
  ],
  "next_page": "<string>"
}

每个请求都必须发送 ?beta=true。

授权

omaApiKeyomaBearer

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

OMA 工作区 API 密钥。

请求头

anthropic-version · string

要使用的 OMA API 兼容版本。

anthropic-beta · string

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

查询参数

beta · enum<boolean> · 必填

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

可用选项: true

limit · integer<int32>

每页最大结果数。默认 20，上限 100。

page · string

来自上一个响应的不透明分页游标。

created_at[gte] · string<date-time>

返回在此时间或之后创建的智能体（含该时间）。 RFC 3339 格式的时间戳

created_at[lte] · string<date-time>

返回在此时间或之前创建的智能体（含该时间）。 RFC 3339 格式的时间戳

include_archived · boolean

在结果中包含已归档的智能体。默认为 false。

响应

200

application/json

请求成功。

智能体的分页列表。

data · object[] · 必填

智能体列表。

Show child attributes

next_page · string | null

下一页的不透明游标。没有更多结果时为 null。