anpheros/agent-skills

Anpheros Gesundheits-Backend

Anpheros speichert die Gesundheitsakte jeder Person als standardisierte HL7 FHIR R4-Ressourcen und stellt dieselben Daten über eine einfache REST-API (/v1) und strikte FHIR (/fhir/R4) bereit. Die IDs sind in beiden APIs identisch.

• Basis-URL: https://platform.anpheros.com (der Schlüssel entscheidet über Sandbox oder Produktion)
• Leitfäden: https://developers.anpheros.com/guides/ — OpenAPI: /docs — CapabilityStatement: /fhir/R4/metadata
• Dokumentations-MCP-Server (kein Konto, schreibgeschützt): https://platform.anpheros.com/mcp/docs
• SDKs: npm install @anpheros/sdk (TypeScript), anpheros_sdk (Dart/Flutter)

Regeln (immer)

1. Zuerst Sandbox. Verwende einen sk_test_-Schlüssel: Dieser sieht nur die synthetischen Patienten des Projekts. Lege niemals echte Patientendaten in der Sandbox ab und schreibe niemals sk_live_-Schlüssel in Code, Beispiele oder Commits; lies Schlüssel aus der Umgebung (ANPHEROS_KEY).
2. Nie Codes erfinden. LOINC-, SNOMED CT-, ICD-10-, ICD-11-, ATC- und RxNorm-Codes stammen aus dem offiziellen Codesystem oder aus der Terminologiesuche (GET /v1/search?q=…, GET /v1/search/{id}). Wenn ein Code unbekannt ist, lasse ihn weg. Einheiten sind UCUM (mg/dL, mmHg, kg).
3. Einwilligung ist Pflicht. Ein API-Schlüssel sieht nur Patienten, die sein Projekt erstellt hat. Um auf die bestehenden Daten einer Person zuzugreifen, frage sie über den Einwilligungsablauf (unten Schritt 4). Ein 403 bedeutet „außerhalb der Einwilligung“: bitte um mehr, umgehe es niemals. Ein 401 nach einem Widerruf bedeutet, dass der Zugriff beendet ist.
4. Sage, wer es geschrieben hat. Jeder Schreibvorgang enthält author_type (patient, practitioner, device, import, ai). Von einem Modell geschriebene Daten verwenden author_type: "ai" (HL7-KI-Transparenzetiketten werden von der Plattform hinzugefügt).
5. Keine Diagnose, keine Behandlungsempfehlung. Die App darf Aufzeichnungen, Trends und Muster anzeigen; sie darf Benutzern nicht sagen, was sie haben oder welches Medikament sie nehmen sollen.
6. Sende einen Idempotency-Key-Header bei Schreibvorgängen, die wiederholt werden könnten.

Ablauf

1. Schlüssel. Der Entwickler meldet sich unter https://platform.anpheros.com/dashboard/ an und drückt Get a sandbox key.
2. Lesen.

   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. Schreiben.

   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"}'
   

   Mit dem 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. Einwilligung (SMART on FHIR, OAuth 2.1 + PKCE). Registriere eine Anwendung (POST /admin/projects/{id}/applications), sende die Person zu GET /oauth/authorize?…&scope=patient/Observation.rs offline_access&purpose=treatment, tausche den Code bei POST /oauth/token ein, rufe dann die API mit Authorization: Bearer at_… auf. Discovery: /.well-known/smart-configuration. Leitfaden: https://developers.anpheros.com/guides/healthcare-api-patient-consent
5. KI-Kontext. POST /v1/context gibt die Teile einer Akte zurück, die zu einer Eingabeaufforderung passen, mit Provenienz, anstatt rohe Ressourcen in das Modell zu laden.
6. Laborimporte. HL7 v2 ORU- und CSV-Labordaten: https://developers.anpheros.com/guides/import-lab-results-fhir

Bevor du Code zu einem hier nicht abgedeckten Thema schreibst, durchsuche die Leitfäden (den search_docs des Dok-MCP-Servers oder das Leitfadenverzeichnis), anstatt Endpunkte zu erraten.