본문으로 건너뛰기

User Profile Summary MCP Tool

1. 개요​

1.1 목적​

AI Agent가 사용자의 전반적인 치료 상태를 요약하여 초기 컨텍스트를 파악하고 치료 방향성을 설정할 수 있도록 지원합니다.

1.2 Tool 정보​

  • Tool Name: user_profile_summary
  • Description: 사용자의 종합적인 치료 현황과 주요 지표를 요약하여 제공합니다.
  • Source Domain: 전체 도메인 → Agent Data
  • Data Source: Firestore의 모든 관련 컬렉션

2. 기능 요구사항​

2.1 치료 현황 요약​

  • 치료 시작일과 경과일, 현재 치료 단계를 제공해야 한다.
  • 전체 치료 진행률과 주요 마일스톤 달성 여부를 포함해야 한다.
  • 최근 활동 요약(설문, 수면기록, 학습 등)을 제시해야 한다.

2.2 주요 개선 지표​

  • 핵심 설문 점수의 변화 추이를 요약해야 한다.
  • 수면 품질 개선도의 주요 지표를 제공해야 한다.
  • 학습 진도와 적용률의 요약 정보를 포함해야 한다.

2.3 개인화 컨텍스트​

  • 사용자의 주요 관심사와 치료 목표를 파악해야 한다.
  • 효과적인 치료 방법과 어려움을 겪는 영역을 구분해야 한다.
  • 개인별 특성과 선호도를 요약해야 한다.

3. 출력 형식​

3.1 기본 응답 구조​

{
  "success": true,
  "data": {
    "user_overview": {
      "user_id": "user123",
      "treatment_start_date": "2024-01-01",
      "current_day_index": 68,
      "treatment_phase": "중기",
      "overall_progress_percentage": 67.5
    },
    "key_improvements": {
      "sleep_efficiency_improvement": 18.2,
      "isi_score_improvement": -8,
      "learning_completion": 65.5,
      "treatment_goal_achievement": 72.0
    },
    "current_status": {
      "latest_sleep_quality": 8.1,
      "latest_questionnaire_scores": {
        "ISI": 10,
        "PHQ-9": 6,
        "GAD-7": 5
      },
      "recent_learning_activity": "CBT 기법 학습 중",
      "days_since_last_activity": 1
    },
    "strengths_and_challenges": {
      "strengths": [
        "수면위생 영역에서 뛰어난 실천력",
        "꾸준한 학습 참여와 높은 이해도",
        "설문 응답의 성실성과 일관성"
      ],
      "challenges": [
        "CBT 기법의 실제 적용 어려움",
        "주말 수면 패턴의 불규칙성",
        "스트레스 관리 기법 부족"
      ]
    },
    "personalization_insights": {
      "preferred_learning_style": "시각적, 실습 중심",
      "optimal_engagement_time": "저녁 시간대",
      "most_effective_techniques": [
        "점진적 근육 이완법",
        "수면위생 실천",
        "규칙적인 취침 루틴"
      ],
      "risk_factors": ["주말 늦잠", "업무 스트레스"]
    },
    "recommendations": [
      "CBT 기법은 단계별 접근으로 천천히 진행",
      "주말 수면 일관성 개선에 중점",
      "현재 성공하고 있는 수면위생 습관 강화",
      "스트레스 관리 학습 우선 권장"
    ]
  }
}

4. 사용 사례​

4.1 초기 컨텍스트 파악​

AI Agent가 대화를 시작할 때 사용자의 전반적인 상태를 빠르게 파악하여 적절한 대화 방향을 설정할 수 있습니다.

4.2 치료 방향성 설정​

현재 진행 상황과 강점/약점을 종합하여 다음 단계의 치료 방향을 결정할 수 있습니다.

4.3 개인화된 상호작용​

사용자의 선호도와 특성을 반영하여 맞춤형 대화와 권장사항을 제공할 수 있습니다.

5. 기술 요구사항​

5.1 다중 도메인 데이터 통합​

  • questionnaire, sleep, learning 도메인의 데이터를 통합 분석
  • 실시간 데이터와 배치 처리된 분석 결과 조합
  • 데이터 간 일관성과 신뢰성 확보

5.2 지능형 요약 생성​

  • 방대한 데이터를 핵심 인사이트로 압축
  • AI Agent가 이해하기 쉬운 구조화된 정보 제공
  • 개인별 특성을 반영한 맞춤형 요약

6. 변경 이력​

버전날짜작성자변경 내용
0.1.02025-01-15bok@weltcorp.com최초 작성