Agent Data
⚠️ agentz-studio 플랫폼 통합 (2025-12-24)
이 도메인은 agentz-studio에 MCP 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: 사용자 기본 정보 및 치료 상태 공유