← Docs hub

Schedule Milestone PRD and UX Spec

이 문서는 1차 마일스톤인 “사용자 설정값을 받아 고정청정 스케줄을 생성”하는 기능을 제품/UX/개발 공통 기준으로 정리한다.

1. 배경과 목표

1차 마일스톤은 사용자의 음성 입력을 Cloud LLM Server로 보내고, Cloud에서 Gemini STT로 텍스트화한 뒤, Schedule Agent가 멀티턴으로 필요한 slot을 채워 고정청정 스케줄 API를 호출하는 것이다.

핵심 목표:

• 사용자는 자연어로 스케줄을 요청한다.
• 시스템은 부족한 값만 되묻는다.
• 필수 slot이 모두 채워지기 전에는 API를 호출하지 않는다.
• 완료 시 실제 schedule 생성 결과를 확인한다.
• 고정청정 등록 구조를 기반으로 다른 스케줄 기능의 등록/수정/삭제/조회를 확장한다.

2. 전제와 비범위

3. Schedule 기능 목록도 slot이다

고정청정만 보면 안 된다. 사용자가 “스케줄 등록해줘”라고 말하면 무엇을 스케줄할지부터 모를 수 있다. 따라서 schedule_function 자체가 첫 번째 핵심 slot이다.

4. 1차 기능 범위

Must

Should

Could

5. UX 흐름

5.1 모든 slot이 있는 경우

사용자: 평일 밤 10시부터 아침 7시까지 안방 고정청정 예약해줘
Cloud: transcript 생성
Schedule Agent: schedule_function=fixed_cleaning, operation=create, repeat_days=weekday, start_time=22:00, end_time=07:00, target_area=안방
Cloud: fixed cleaning schedule API 호출
응답: 평일 밤 10시부터 아침 7시까지 안방 고정청정 스케줄을 등록했어요.

5.2 기능이 빠진 경우

사용자: 스케줄 등록해줘
시스템: 어떤 기능을 스케줄로 등록할까요? 고정청정, 이동청정, 웨이크업 중에서 선택할 수 있어요.
사용자: 고정청정
시스템: 언제 실행할까요?

5.3 시간이 빠진 경우

사용자: 안방 고정청정 매일 예약해줘
시스템: 몇 시부터 몇 시까지 실행할까요?
사용자: 밤 10시부터 아침 7시까지
시스템: 매일 밤 10시부터 아침 7시까지 안방 고정청정 스케줄을 등록했어요.

5.4 operation이 다른 경우

사용자: 내일 아침 고정청정 예약 지워줘
시스템: 어떤 고정청정 예약을 삭제할까요? 등록된 예약을 확인해드릴게요.

삭제/수정/조회는 1차 등록 구조가 안정화된 뒤 같은 slot registry와 workflow 상태를 재사용한다.

6. On-device와 Cloud 책임 분리

7. 응답 계약

slot 부족:

{
  "response": "몇 시부터 몇 시까지 실행할까요?",
  "there_is_question_mark": "true",
  "workflow_id": "sch_001",
  "schedule_workflow_status": "collecting_slots",
  "slot_state": {
    "collected_slots": {
      "schedule_function": "fixed_cleaning",
      "operation": "create",
      "target_area": "안방",
      "repeat_days": "daily"
    },
    "missing_slots": ["start_time", "end_time"]
  }
}

slot 완료:

{
  "response": "안방 고정청정 스케줄을 등록했어요.",
  "there_is_question_mark": "false",
  "workflow_id": "sch_001",
  "schedule_workflow_status": "completed",
  "result_kind": "success",
  "schedule_id": "schedule_123"
}

8. 수용 기준

관련 문서

• A2A Product PRD
• A2A Follow-up Question Strategy
• Device Task Flow
• A2A Success Criteria