anpheros/agent-skills

Anpheros 건강 백엔드

Anpheros는 각 개인의 건강 기록을 표준 HL7 FHIR R4 리소스로 저장하며, 동일한 데이터를 간단한 REST API(/v1)와 엄격한 FHIR(/fhir/R4)을 통해 제공합니다. ID는 두 API에서 동일합니다.

• 기본 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/ 에 로그인하고 Get a sandbox key를 누릅니다.
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 또는 가이드 인덱스)를 검색하세요.