Answers API
POST /v1/chat/completions —— 封闭的 grounded completion。一发进、一条有证据的回答出。无客户端工具、无状态。适合 OpenAI 直接替换 —— 或作为你自己 agent 里的一个工具。Agent API
POST /v1/responses —— 推荐的 agent 接口（兼容 OpenAI Responses）。多轮状态（store / previous_response_id / session_id）、你自己的 function 工具与完整交接、标准 response.* 流式。决策表
| 你想要… | 用 |
|---|---|
| 把某个 OpenAI chat 调用替换为有健康数据依据的回答，零新概念 | Answers |
| 给你现有的 agent（任意框架、任意模型）加一项”查询该用户健康记录”的能力 | Answers，包成工具 |
| 构建以 Mirobody 为 agent、调用你的工具（预约、通知、EHR 写入）的健康助手 | Agent（function calling） |
| 多轮对话且无需重发历史 | Agent（previous_response_id / session_id —— 状态） |
原样使用 openai-agents SDK（只改 base_url） | Agent |
| 结构化输出 / JSON 模式 | 都不行 —— Answers 会拒绝 response_format；请在你的外层 agent 里做格式化 |
两面完全相同的部分
- 数据依据 —— 同一套服务端工具、同一份标准化数据（数据面）；证据在
health_records/citations；服务端工具轨迹在tool_steps扩展。 - 模型 ——
mirobody-flash/mirobody-expert（模型）。 - 租户模型 ——
user→ Subject 隔离（概览）。 - 用量口径 —— 只对你可见的输入 token 计入 prompt，平台开销单列
system_tokens。
两面不同的部分
Answers（/v1/chat/completions） | Agent（/v1/responses） | |
|---|---|---|
| 协议 | OpenAI Chat Completions | OpenAI Responses |
| 状态 | 无状态 —— 重发历史 | store（默认 true）、previous_response_id、session_id |
| 客户端工具 | 拒绝（400 unsupported_parameter） | tools + function_call 交接 |
| 流式 | chat.completion.chunk 帧 | response.* 事件协议 |
| 服务端工具轨迹 | message.tool_steps + 顶层扩展 | 顶层 tool_steps + response.mirobody_tool_call 事件 |