開発者向け

AI向けヘルスケアAPI:トークン予算内で、患者のコンテキストに由来情報が付与されたもの

AIモデルがヘルスケアAPIに求めるもの。プレーンなFHIR検索では得られない、誰が記録したかの情報が付与された正しい事実を、トークン予算内で、同意のもとで提供します。AnpherosコンテキストAPIの仕組み、リクエストとレスポンスの形式について。

著 公開日 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エージェントとして登録されたアプリケーションは、同意のもとで読み取り、書き込みを提案することのみが可能で、個人が承認または拒否します。

同じコンテキストが、platform.anpheros.com/mcpのget_patient_contextツールとしてMCPアシスタントにも利用可能であるため、Claude、ChatGPT、または独自のAIエージェントは、お客様側でコードを記述することなくコンテキストを読み取ることができます。EMRとAI医療アシスタントの連携をご覧ください。

よくある質問

プラットフォームはどのモデルを使用しますか?

使用しません。プラットフォームはコンテキストを構築します。お客様はそれを選択したモデルに送信し、ホスト型またはプライベートで実行します。プラットフォーム側では、記録はEUから離れることはありません。

予算はどのように強制されますか?

項目は臨床的な関連性によってランク付けされ、予算に達するまで含まれます。omittedリストには、除外されたものが記載されているため、モデルはコンテキストが部分的であることを認識します。

レコードの一部のみを要求できますか?

はい、3つの方法があります。個人の同意のスコープがそもそも読み取れるものを制限し、needsとwindow_daysがリクエストを絞り込み、予算が残りをカットします。生の制御が必要な場合は、代わりにsearch_fhirまたは/v1エンドポイントを使用してください。

出力は決定論的ですか?

同じレコード、同意、予算であれば、はい。新しいエントリはそれを変更します。それが目的です。コンテキストは現在のレコードを反映します。

どこで試せますか?

サンドボックスは無料で、30人の合成患者には6ヶ月分のコード化された履歴があります。キーを取得し、それらのいずれかでコンテキストエンドポイントを呼び出してください:developers.anpheros.com/guides/first-hour。

このガイドは情報提供のみを目的としており、医学的アドバイスに代わるものではありません。健康に関する決定については、医師にご相談ください。緊急の場合は、112にお電話ください。
著者について
Adrian Kereky

Founder of Anpheros. An electronics engineer, he spent six years in autonomous driving, on automotive projects run in partnership with Samsung and NVIDIA, designing the architecture of driver-assistance and AI systems that run on NVIDIA chips with CUDA. He then built Anpheros: the patient-controlled medical record and the HL7 FHIR R4 platform it runs on.

Anpherosと著者について →

あなたの医療記録を持ち歩こう

Anpheros Dailyは、症状、検査結果、薬剤、書類を、標準フォーマットで、あなたの管理下に一元化します。ベーシックプランは無料です。

Anpheros Dailyを入手する