Google 캘린더를 자율 AI 에이전트에 연결하기

자율 AI 에이전트를 Google 캘린더에 연결해야 하는 이유

Google 캘린더 커넥터는 아직 사용할 수 없습니다. 이 페이지는 출시 후 커넥터가 할 일을 설명합니다.

Google 캘린더에는 특히 Google Workspace를 쓰는 많은 기업의 일정, 회의, 가능 시간이 모입니다. 연결된 자율 에이전트는 단발성 명령에 답하는 데 그치지 않습니다. 계속 실행되면서 받은 지시에 따라 빈 시간 확인, 충돌 발견, 일정 제안을 도구 호출로 스스로 판단하게 됩니다.

연결에는 OAuth 2.0과 Google 캘린더의 calendar.events 스코프를 사용할 예정입니다(Google OAuth 스코프). 이 스코프로는 일정 읽기, 생성, 수정이 가능하지만 Google 계정 자체를 삭제하거나 보안 설정을 바꿀 수는 없습니다.

그래서 면접을 위한 공통 시간 찾기 같은 흐름이 유용해집니다. HR 운영 에이전트나, 영업 미팅 예약이라면 레비뉴 오퍼레이션 에이전트와 비슷하게, 요청을 받으면 누군가 캘린더를 열어 여러 사람의 가능 시간을 손으로 비교하기를 기다리지 않고 다음 단계(시간, 일정, 확인 알림)를 준비합니다. Google 캘린더는 Standard 플랜에 포함되는 연동 중 하나가 되며, 커넥터별 별도 청구 항목은 없습니다.

한계와 모범 사례

이 커넥터에서 가장 민감한 액션은 create_event가 됩니다. 쓰기 스코프로 부여되면 에이전트는 사용자를 거치지 않고 일정을 잡고, Google이 모든 참석자에게 초대 메일을 보냅니다. 가장 안전한 방식은 check_availability와 list_events만 부여하는 것입니다. 에이전트가 시간을 제안하고, 사람이 최종 일정을 만들어 초대를 보냅니다.

calendar.events 스코프는 특정 보조 캘린더가 아니라 연결된 계정의 캘린더 전체에 적용됩니다. 따라서 실제 한계는 권한이 정합니다. 생성과 취소를 한꺼번에 부여하지 말고, 단순 조회라면 읽기 전용처럼 필요한 액션만 지정하세요.

update_event와 cancel_event는 원래 초대를 이미 수락한 참석자의 일정까지 포함해 기존 일정을 수정하거나 삭제합니다. 이 두 액션은 역할상 정말 필요한 에이전트에만 맡기고, 제안만 하고 취소는 하지 않게 하려면 권한에서 cancel_event를 create_event와 분리하세요.

Google Calendar API의 표준 할당량이 적용됩니다. 실행되었든 거부되었든 모든 호출은 에이전트 페이지의 감사 로그에서 확인할 수 있게 됩니다. 다른 OAuth 계정과 마찬가지로 Google 쪽에서 토큰이 만료되거나 철회되면, 다시 연결할 때까지 연결은 오류 상태가 됩니다.