面向开发者

面向人工智能的医疗保健 API:在令牌预算内的、带有来源标签的患者上下文

人工智能模型从医疗保健 API 中需要什么,而普通的 FHIR 搜索无法提供:正确的事实排在最前,每条都标明记录者,控制在令牌预算内,并以本人同意为前提。本文介绍 Anpheros 上下文 API 的工作原理,以及请求和响应的结构。

作者 · 编辑政策 (EN) 发布于 阅读约 1 分钟

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。

Anpheros Platform

在沙盒中免费试用

5 分钟完成第一次 FHIR 调用. 一个内置患者授权的 HL7 FHIR R4 API:先在沙盒中试用,然后连接您自己的应用或诊所系统。

免费 · 30 位合成患者 · 无需信用卡

本指南仅供参考,不能替代医生诊疗。涉及健康的决定请咨询医生。紧急情况下,请拨打当地急救电话(欧洲为 112)。
撰写人
Anpheros Editorial Team

Anpheros 致力于打造一个由患者掌控的医疗记录,并可在欧盟的 HL7 FHIR R4 平台上与任何诊所共享。这些指南旨在帮助您理解和整理您的健康信息,但不能替代您的医生。

关于 Anpheros →