Human Benchmark API 与 Agent 发现能力

公开端点

• GET /api/health：返回服务健康状态与发现链接。
• GET /api/games：返回测试项目目录。
• GET /api/games/{slug}：返回单个测试项目详情。

受保护 Agent 端点

GET /api/agent/summary 需要携带包含 site.read scope 的 bearer token。token 通过 POST /oauth/token 的 client_credentials 流程签发。

生产环境建议配置 AGENT_CLIENT_ID、AGENT_CLIENT_SECRET、AGENT_OAUTH_SECRET。本地开发可使用非生产默认值进行联调。

发现文档

• /.well-known/api-catalog：RFC 9727 API catalog。
• /openapi.json：OpenAPI 3.1 规范描述。
• /.well-known/oauth-authorization-server：OAuth 授权服务元数据。
• /.well-known/oauth-protected-resource：受保护资源元数据。
• /.well-known/mcp/server-card.json：/api/mcp 的 MCP server card。
• /.well-known/agent-skills/index.json：Agent 技能发现索引。

MCP 与 WebMCP

/api/mcp 提供只读 MCP 能力，供站外代理访问。站内浏览器代理可通过 WebMCP 工具列出项目、打开测试页面并读取发现链接。

测试项目目录