帮助中心/开发者
开发者

Agent API 接入

Agent API 是 AI 助手接入主路径,使用 Agent Key、权限 scope 和预览确认机制。

更新 2026-08-26
GET /api/v1/me/agent/context
POST /api/v1/me/agent/search
GET /api/v1/me/agent/entities/{entityType}/{id}
POST /api/v1/me/agent/actions/preview
POST /api/v1/me/agent/actions/confirm
POST /api/v1/me/agent/actions/restore
GET /api/v1/me/agent/openapi

请求头使用 Authorization: Bearer <Agent Key>。不要把 Key 放进 URL、日志或公开仓库。

当前契约不支持 Habit:不要向 Agent API 发送 entityType=habit,也不要用它创建、编辑、打卡或恢复习惯。

相关文章

集成与自动化

Agent API 和 MCP 该选哪个?

默认选 Agent API;MCP 只作为需要 MCP server 配置时的适配器。

开发者

错误码与速率限制

Agent API 返回结构化错误。遇到权限、Key、限流问题时,先看 code 和 hint。