AI 에이전트가 일정 조율에서 실패하는 이유가 추론 능력이 아닌 캘린더 API 설계에 있다

Context

기존 캘린더 API는 인간이 UI를 통해 일정을 조율하는 상황을 하여 설계되었다. OAuth 인증, 자유/사용 중 상태 데이터 반환, 타임존 미지정 datetime 등의 설계로 인해 에이전트가 6~8단계의 순차적 도구 호출을 수행해야 한다. 각 단계에서 환각이나 자동 실패가 발생할 수 있으며, 다수 인원이 관련된 복잡한 일정 조율은 단일 에이전트 루프 처리 범위를 벗어난다.

Technical Solution

• 캘린더 API → 에이전트 친화적 인증 체계로 전환하여 API 키 기반(X-API-Key 헤더) OAuth 리다이렉트 제거
• datetime 필드 → ISO 8601 형식의 명시적 타임존 오프셋 포함하여 LLM의 타임존 산술 의존 제거
• 일정 항목 식별자 → UUID 기반 안정적 참조 제공으로 다중 도구 호출 간 엔티티 재확인 불필요
• 가용 시간대 응답 → 0~1 점수로 가중치 부여된 순위 리스트 반환으로 에이전트의 스ロット 순위 결정 로직 불필요
• 에러 응답 → code, message, details 필드 포함하여 실패 원인 및 수정 방법 명시

Impact

기존 Google Calendar나 Outlook API 대비 에이전트 일정 조율 워크플로우가 6~8단계에서 5단계(참가자 등록, 가용성 조회, 사용자 확인, 예약 생성, 옵션 제안 워크플로우)로 축소

Key Takeaway

에이전트 친화적 API 설계의 핵심은 에이전트에게 추론 부담을 전가하는 것이 아니라 API 자체가 가용성 지능을 처리하고 구조화된 응답을 제공하는 것이다