AI를 위한 의료 API: 토큰 예산 내에서 출처가 명시된 환자 정보

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 에이전트로 등록된 애플리케이션은 동의 하에 읽을 수 있으며 쓰기를 제안할 수만 있으며, 개인은 이를 승인하거나 거부합니다.

동일한 컨텍스트를 MCP 도우미에게 get_patient_context 도구로 platform.anpheros.com/mcp에서 사용할 수 있으므로 Claude, ChatGPT 또는 자체 에이전트는 자체 코드를 작성하지 않고도 이를 읽을 수 있습니다. AI 의료 도우미와의 EMR 통합을 참조하세요.

자주 묻는 질문

플랫폼에서 어떤 모델을 사용하나요?

없습니다. 플랫폼은 컨텍스트를 구축하며, 선택한 모델(호스팅 또는 개인)로 보냅니다. 플랫폼 측에서는 기록이 EU를 벗어나지 않습니다.

예산은 어떻게 집행되나요?

항목은 임상 관련성 순으로 순위가 매겨지고 예산에 도달할 때까지 포함됩니다. 응답의 omitted 목록은 제외된 항목을 나열하므로 모델은 컨텍스트가 부분적임을 알 수 있습니다.

기록의 일부만 요청할 수 있나요?

예, 세 가지 방법으로 가능합니다. 개인의 동의 범위는 읽을 수 있는 내용을 제한하고, needs와 window_days는 요청을 좁히며, 예산은 나머지를 잘라냅니다. 원시 제어를 사용하려면 대신 search_fhir 또는 /v1 엔드포인트를 사용하세요.

출력은 결정적인가요?

동일한 기록, 동의 및 예산의 경우 예. 새로운 항목은 이를 변경하며, 이것이 요점입니다. 컨텍스트는 현재 기록을 반영합니다.

어디서 시도해 볼 수 있나요?

샌드박스는 무료이며 30명의 합성 환자는 6개월간의 코딩된 기록을 가지고 있습니다. 키를 얻고 다음에서 컨텍스트 엔드포인트를 호출하세요. developers.anpheros.com/guides/first-hour.