开始使用
选择你的 API
Answers API vs Agent API:一分钟选对接口。
Mirobody 通过两个接口暴露同一个有据可循的健康 agent。两者都基于 Subject 真实、标准化的健康数据作答,也都返回回答背后的工具轨迹。
两者都属于③ 问答,即引擎三个步骤里的第三个(① 采集 → ② 标准化 → ③ 问答)。这一页要选的不是你能获得什么,而是这个循环由谁来驱动:Answers API 在服务端把循环闭合、直接交给你一个成品答案;Agent API 把它留开,让你自己的工具参与进来。自托管引擎在它那两个 agent 之间画的正是同一条线,所以在这里做的决定,等你以后自己运行一套时依然成立。
POST /v1/chat/completions:封闭、一发一答、有证据支撑。无客户端工具、无状态。可直接替换 OpenAI 调用。
POST /v1/responses:兼容 OpenAI Responses。多轮状态、自带 function 工具、response.* 流式。
Answers API 用的是更早的 Chat Completions 协议,刻意保持封闭:无客户端工具、不存状态,只有 chat.completion.chunk 流式。正因如此,它能原样嵌进现有的 OpenAI 集成,或包成一个工具嵌入更大的 agent 中。Agent API 用的是更新的 Responses 协议:跨轮次保持状态(store、previous_response_id、session_id)、你自己的 function 工具与完整的 function_call 交接、response.* 事件流。openai-agents SDK 开箱即用对接的就是它,只需改 base_url。
除此之外两者完全一样:同一套基于你标准化数据的服务端依据、同样的 mirobody-flash / mirobody-expert 模型、同样的 Subject 租户隔离、同样的用量口径。
- Answers API(Chat Completions):封闭式、有据可循的问答。
- Agent API(Responses):开放的 agent 循环。
- 快速开始:取密钥、写一条记录、拿到第一个回答。