FHIR 搜索会返回所有匹配项。而语言模型需要的是另一样东西:重要的事实排在最前,每条都说明是谁记录的,大小正好放得进提示。从原始资源构建这些内容本身就是一个项目,如果出错,模型就会将患者的猜测当作实验室结果。Anpheros 上下文 API 在平台端、在本人同意的前提下完成这项工作,让您选择的模型从一份站得住脚的摘要起步。
面向开发者的技术版本: LLM 与医疗保健数据 · AI 代理访问医疗记录,位于 developers.anpheros.com,包含请求、响应和限制说明。本页面是通俗易懂的版本。
请求
curl -X POST "$BASE/v1/context" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"patient": "'$PID'", "budget_tokens": 2000, "task": "pre-visit summary", "format": "text"}'
budget_tokens 是您在提示中能为此分配的令牌数量。task 和可选的 question 用于确定哪些项目优先显示;needs 指定您想要的数据类型;window_days 限制回溯的日期范围;format 选择结构化部分或渲染后的文本块。每次调用都会作为一次上下文读取记入本人的访问日志。
返回内容
带来源标签的各个部分(或者,如果使用 format: "text",则是一个可直接粘贴到提示中的渲染块),以及 tokens_used(已使用的令牌数)、一个 omitted 列表(列出未包含的内容)、warnings(警告)和 provenance_note(来源说明)。项目按临床相关性排序,并根据预算进行截断:首先是活动性问题和过敏,然后是当前用药、近期测量和结果、近期症状,最后是较早的病史。每个项目包含:
author_type:患者、医护人员、设备、导入或派生;source:编写该信息的应用程序或组织;- 日期、代码(LOINC、ICD-10、ATC)以及带单位的值;
- 对于派生项目,说明其派生来源。
响应中的来源说明会用文字解释相同的信息,因此阅读文本块的模型也能学会如何权衡这些项目。医护人员记录的诊断和患者输入的“我认为我得了……”都会出现,并且会以不同的方式标记。
用途
- 就诊前摘要:为临床医生生成,由您信任的模型基于标明来源的事实生成。
- 面向患者的助手:回答“我上次检查结果如何”的问题,并提供实际的数字和日期。
- 产品内的分诊或路由:模型需要读取记录,但看到的内容不能超出本人允许的范围。
- 模式问题(“自春季以来发生了什么变化”):平台的模式引擎以及
compare_periods、get_series工具提供证据而非结论。
它不是什么
上下文 API 不是临床决策支持,平台也不会为您调用模型。它返回带标记的事实;模型输出的内容由部署该模型的一方负责。API 也不会包含本人同意范围之外的项目:如果授权涵盖观察结果和用药,但不包括文档,那么上下文中就没有文档。
始终在同意下进行
请求中的令牌属于本人,通过 OAuth 2.1 获取,其范围和时长由本人选择。项目密钥只能看到该项目创建的患者。注册为 AI 代理的应用程序可以在本人同意下读取数据,但只能提议写入,由本人批准或拒绝。
同样的上下文也以 get_patient_context 工具的形式通过 platform.anpheros.com/mcp 提供给 MCP 助手,因此 Claude、ChatGPT 或您自己的代理无需您编写任何代码即可读取。请参阅 EMR 与 AI 医疗助手集成。
常见问题
平台使用哪个模型?
不使用任何模型。平台负责构建上下文;您把它发送给自己选择的模型,托管模型或私有模型均可。在平台这一侧,记录从不离开欧盟。
如何强制执行预算?
项目按临床相关性排序并依次纳入,直到达到预算为止;响应中的 omitted 列表会列出被省略的内容,因此模型知道上下文是不完整的。
我可以只请求记录的一部分吗?
是的,有三种方式:本人同意的范围决定了究竟能读取哪些内容,needs 和 window_days 缩小请求范围,预算再截掉其余部分。如需直接控制原始数据,请改用 search_fhir 或 /v1 端点。
输出是确定性的吗?
对于相同的记录、同意和预算,是的。新条目会改变输出,这正是设计用意:上下文反映的是记录的当前状态。
在哪里可以试用?
沙盒是免费的,其 30 名合成患者拥有六个月的编码病史。获取密钥后,即可对其中任意一位患者调用上下文端点:developers.anpheros.com/guides/first-hour。
在沙盒中免费试用
5 分钟完成第一次 FHIR 调用. 一个内置患者授权的 HL7 FHIR R4 API:先在沙盒中试用,然后连接您自己的应用或诊所系统。
免费 · 30 位合成患者 · 无需信用卡
