anpheros/agent-skills

Anpheros 健康后端

Anpheros 将每个人的健康记录存储为标准 HL7 FHIR R4 资源，并通过简单的 REST API (/v1) 和严格的 FHIR (/fhir/R4) 公开相同的数据。ID 在两者中相同。

• 基础 URL: https://platform.anpheros.com (密钥决定沙箱或生产环境)
• 指南: https://developers.anpheros.com/guides/ — OpenAPI: /docs — CapabilityStatement: /fhir/R4/metadata
• 文档 MCP 服务器 (无需账户，只读): https://platform.anpheros.com/mcp/docs
• SDK: npm install @anpheros/sdk (TypeScript), anpheros_sdk (Dart/Flutter)

规则 (始终遵守)

1. 优先使用沙箱。 使用 sk_test_ 密钥：它只会看到项目的合成患者。切勿将真实患者数据放入沙箱，也切勿将 sk_live_ 密钥写入代码、示例或提交中；从环境变量 (ANPHEROS_KEY) 读取密钥。
2. 切勿发明代码。 LOINC、SNOMED CT、ICD-10、ICD-11、ATC 和 RxNorm 代码来自官方代码系统或术语搜索 (GET /v1/search?q=…, GET /v1/search/{id})。如果代码未知，请省略。单位使用 UCUM (mg/dL, mmHg, kg)。
3. 同意是强制性的。 API 密钥只能看到其项目创建的患者。要访问某人的现有记录，请通过同意流程（下面的第 4 步）征询其同意。403 表示“超出同意范围”：请求更多，切勿绕过。401 在撤销后表示访问已结束。
4. 说明谁写的。 每次写入都带有 author_type (patient, practitioner, device, import, ai)。由模型写入的数据使用 author_type: "ai" (HL7 AI 透明度标签由平台添加)。
5. 不提供诊断或治疗建议。 应用可以显示记录、趋势和模式；但不得告诉用户他们得了什么病或该服用什么药。
6. 在可能重试的写入操作上发送 Idempotency-Key 标头。

工作流程

1. 密钥。 开发者在 https://platform.anpheros.com/dashboard/ 登录并点击 获取沙箱密钥。
2. 读取。

   curl $BASE/v1/patients -H "Authorization: Bearer $ANPHEROS_KEY"
   curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $ANPHEROS_KEY"
   curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $ANPHEROS_KEY"
   

3. 写入。

   curl -X POST "$BASE/v1/patients/$PID/observations" -H "Authorization: Bearer $ANPHEROS_KEY" \
        -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" -d '{
     "code": "2339-0", "display": "Glucose", "category": "laboratory",
     "value": 112, "unit": "mg/dL", "effective_at": "2026-09-19T08:10:00Z", "author_type": "device"}'
   

   使用 SDK:

   import { Anpheros, apiKey } from '@anpheros/sdk';
   const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
   const patient = await anpheros.patients.create({ given: 'Ana', family: 'Example', birth_date: '1980-05-17', gender: 'female' });
   

4. 同意 (SMART on FHIR, OAuth 2.1 + PKCE)。 注册一个应用 (POST /admin/projects/{id}/applications)，将用户引导至 GET /oauth/authorize?…&scope=patient/Observation.rs offline_access&purpose=treatment， 在 POST /oauth/token 处交换授权码，然后使用 Authorization: Bearer at_… 调用 API。 发现: /.well-known/smart-configuration。指南: https://developers.anpheros.com/guides/healthcare-api-patient-consent
5. AI 上下文。 POST /v1/context 返回记录中与提示相匹配的部分及其来源，而不是将原始资源转储到模型中。
6. 化验导入。 HL7 v2 ORU 和 CSV 化验报告: https://developers.anpheros.com/guides/import-lab-results-fhir

在为此处未涵盖的主题编写代码之前，请搜索指南（文档 MCP 服务器的 search_docs，或指南索引），而不是猜测端点。