본문으로 건너뛰기

Agent Data

⚠️ agentz-studio 플랫폼 통합 (2025-12-24)

이 도메인은 agentz-studioMCP Server로 데이터를 제공합니다.

┌─────────────────────────────────────────────────────────────────┐
│ 변경 전 │
│ MAO Agent → Agent Data API → Domain Data │
│ │
│ 변경 후 │
│ agentz-studio Agent Team │
│ ↓ │
│ MCP Protocol │
│ ↓ │
│ dha-sleep-api (MCP Server) │
│ ↓ │
│ Agent Data Domain → Sleep/Medication/Questionnaire/... │
└─────────────────────────────────────────────────────────────────┘

dha-sleep-api에 유지되는 기능 (전체 유지):

  • 다중 도메인 데이터 수집: Sleep, Questionnaire, Learning, Medication, Condition 이벤트 구독
  • LLM 친화적 변환: 축약 필드명 → 명시적 이름, 컨텍스트 정보 추가
  • 지식 그래프 통합: Medication 도메인의 복잡한 데이터 denormalize
  • 실시간 알림 처리: 약물 상호작용 경고, 증상 경보 (5초 SLA)

agentz-studio 연동 변경사항:

  • 데이터 제공 방식: REST API → MCP Protocol (Tool)
  • 호출 주체: dha-sleep-api/MAO → agentz-studio Agent Team
  • 인터페이스: AgentDataService → MCP Tool Definition

MCP Tool 예시:

  • get_sleep_summary: 최근 수면 데이터 요약
  • get_medication_profile: 현재 복약 프로필
  • get_questionnaire_scores: 설문 점수 히스토리
  • get_condition_alerts: 활성 증상 경보

관련 문서:


개요

Agent Data 도메인은 AI Agent 시스템에서 사용자의 수면, 설문, 학습, 약물 데이터를 LLM 친화적 형태로 수집, 변환, 저장하는 도메인입니다. 여러 도메인의 데이터를 통합하여 AI Agent가 개인화된 치료 서비스를 제공할 수 있도록 지원합니다.

주요 기능

  • 다중 도메인 데이터 수집: Sleep, Questionnaire, Learning, Medication, Condition 도메인 이벤트 구독 및 처리
  • LLM 친화적 변환: 축약 필드명을 명시적 이름으로 변환, 컨텍스트 정보 추가
  • 지식 그래프 통합: Medication 도메인의 복잡한 지식 그래프를 사용자별 요약 정보로 denormalize
  • 증상 및 상태 추적: Condition 도메인의 신체적·정신적 상태 데이터를 통합하여 사용자 건강 프로필 제공
  • 치료 진행 상황 통합: 사용자의 전반적인 치료 경과 및 트렌드 분석
  • 실시간 알림 처리: 약물 상호작용 경고, 증상 경보 등 실시간 안전 알림 (5초 SLA)
  • 데이터 품질 관리: OCR/LLM 메타데이터 추적, 데이터 검증 및 품질 보장

아키텍처

구체적인 내용은 다른 문서들을 참고하세요:

관련 도메인

상위 컨텍스트 (Upstream Contexts):

  • Sleep: 수면 기록 및 패턴 데이터 제공
  • Questionnaire: 설문 응답 및 점수 데이터 제공
  • Learning: 학습 진도 및 이해도 데이터 제공
  • Medication: 약물 프로필, 상호작용 경고, 감량 계획 데이터 제공
  • Condition: 증상 리포트, 신체적·정신적 상태, 경보 데이터 제공

하위 컨텍스트 (Downstream Contexts):

  • Agent Treatment Flow: 변환된 데이터 활용 (MCP를 통해 접근)

협력 컨텍스트:

  • User: 사용자 기본 정보 및 치료 상태 공유