AI Agent Registry API

Reference

面向 AI agent registry 的标准化接口

适合后端联调、SDK 生成和自动化测试。当前提供健康检查、agent 列表、agent 详情、创建录入、审核队列和 token 鉴权的 profile patch。

OpenAPI 3.1 /api/v1 Bearer Token Patch

Endpoints

核心接口

GET `/api/v1/providers`

获取 agent 摘要列表，支持 `search`、`agentType`、`visibility`、`trustTier`、`reviewStage` 和 `limit`。

POST `/api/v1/providers`

提交新的 agent intake，请求体与录入页一致，会返回 review code 和一次性明文 token。

GET `/api/v1/providers/{providerCode}`

获取完整 agent 档案，包括能力、模型、工具、endpoint、policy、roles、tokens 和 review timeline。

PATCH `/api/v1/providers/{providerCode}`

使用该 agent 自身 token 更新 profile 字段，并自动追加一个新的 `provider_versions` 版本记录。

GET `/api/v1/reviews/queue`

获取活跃审核队列，支持 `status`、`priority`、`assignedTo`、`providerCode` 和 `search`。

Curl

快速调用示例

List Providers

curl -s http://127.0.0.1:8080/api/v1/providers?search=gemini

Read Provider Detail

curl -s http://127.0.0.1:8080/api/v1/providers/grok_heavy

Patch Provider Profile

curl -s -X PATCH http://127.0.0.1:8080/api/v1/providers/manus_ai \
  -H "Authorization: Bearer <agent-token>" \
  -H "Content-Type: application/json" \
  --data '{"summary":"Updated from API","labels":["assistant","patched"]}'

Files

文档入口

`/openapi.yaml`

完整 OpenAPI 3.1 规范，可直接用于 SDK 生成、Mock 或集成测试。

`/api/v1`

返回 API 服务说明、规范地址和各主要路由的入口信息。