端点
stream: true 走 SSE。
它刻意保持封闭 —— 没有客户端工具、没有响应格式控制、没有多轮状态。这让它极易嵌入：直接调用，或把它包成你自己 agent 里的一个工具。若你需要客户端工具、存储的对话或 previous_response_id 链式续聊，请使用 Agent API（POST /v1/responses）。
当前可用的接入环境是全球 test 集群：
快速上手
请求体
user 字段是租户隔离键。 后端把 (你的账户, user) 映射为内部的数据主体(Subject)；你传入的每个 user 彼此完全隔离。为每个终端用户传入其稳定 id，数据就绝不会串。省略时回落到你账户的默认 Subject。Subject 对 Mirobody 消费端 App 和其他开发者均不可见。不支持的参数
此面是封闭的 grounded completion —— 工具只在服务端运行，回答是自由文本。与此矛盾的参数会被显式拒绝并返回400（code: unsupported_parameter，param 指出问题字段），而不是被静默吞掉：
采样参数接受但忽略（agent 型接口的业界惯例）：
max_tokens 不限制输出；temperature、top_p、stop、seed 无效。响应始终只含一个 choice。响应
message.content 只承载一条干净的最终回答。收集阶段（思考 + 工具调用）走独立通道，回答本身绝不被工具叙述污染。
reasoning_content 和 tool_steps 是增量通道 —— 只读 message.content 的客户端不受影响。
用量口径
usage.prompt_tokens 只报告你实际发送的输入（你的 messages）；平台自身的系统提示与工具 schema 单列在 prompt_tokens_details.system_tokens，不会算到你的 prompt 头上。completion_tokens_details.reasoning_tokens 统计思考 token。计数为该 agent 轮次内所有模型调用之和。
流式传输
stream: true 时帧按序到达。首个 chunk 携带 delta.role: "assistant"（对齐 OpenAI —— 许多客户端以它初始化消息），随后是工具/思考增量，最后是一条不间断的回答流：
chat.completion.chunk 对象。按 id 合并 tool_steps（流式步骤携带 {id, name, arguments}；完整 result 在非流式响应上）。最后一帧（[DONE] 之前）携带顶层 health_records / citations 以及 usage。上游失败会在流结束前以 SSE {"error": ...} 帧到达。只读 delta.content 的客户端不受影响。
系统提示
system 消息设定回答的语气、人设、格式与语言。数据收集由平台控制 —— 智能体始终读取 Subject 的真实数据 —— 因此 system 提示塑造回答怎么读，从不决定是否使用真实数据。
内置工具
除了普通的工具调用,托管智能体还能规划多步工作、分派子任务、运行沙箱代码做数值分析(趋势、相关性),并读取 Subject 上传的文件。这些都不需要你调用——智能体自己会,基于该 Subject 的数据。 公开工具目录 —— 即GET /api/health 报告的 tool_names：
query_health_data、summarize_health_data—— 检索并聚合 Subject 的记录list_clinical_records—— 列出临床文档 / FHIR 支撑的记录list_family_members—— 解析 Subject 有权查询的照护圈成员write_fhir_observation—— 写入一条结构化 FHIR observationsearch_medical_literature、get_clinical_trials、get_article_by_pmcid—— 查询医学证据（供给citations）fetch_url—— 读取网页
write_todos、task、eval 及文件系统工具（ls / read_file / …）—— 供内部使用，不会出现在 tool_names 中。ask_user 存在于网页应用产品，但在 /v1 两个面上均已禁用（API 调用方没有可作答的 widget）。公开工具集可能因集群而异；调用 GET /api/health 查看实时 tool_names。你通过 /v1/files 上传的文件会落在 /uploads，智能体会自动读取。
要添加你自己的工具，请使用 Agent API 的 function calling —— 此面刻意不提供工具注入。
图表（vis-chart）
当回答涉及趋势 / 对比 / 分布时，可能嵌入一个围栏```vis-chart 代码块，内容为纯数据 JSON（{type, title, axisXTitle, axisYTitle, data}）。渲染是客户端的职责 —— API 只返回数据规格。检测该围栏块并渲染（折线 / 面积 / 柱状 / 饼图）。