개요
에이전트가 Google Calendar를 통해 캘린더 이벤트, 일정, 가용 시간을 관리할 수 있도록 지원합니다. 이벤트를 생성 및 업데이트하고 참석자를 관리하며, 가용성을 확인하고 AI 기반 자동화로 일정 관리 워크플로우를 효율적으로 운영하세요.필수 조건
Google Calendar 통합을 사용하기 전에 다음을 준비해야 합니다:- 활성 구독이 있는 CrewAI AMP 계정
 - Google Calendar에 접근 가능한 Google 계정
 - 통합 페이지를 통해 Google 계정을 연결 완료
 
Google Calendar 연동 설정
1. Google 계정 연결하기
- CrewAI AMP Integrations로 이동합니다.
 - 인증 통합 섹션에서 Google Calendar를 찾습니다.
 - Connect를 클릭하고 OAuth 과정을 완료합니다.
 - 캘린더 및 연락처 접근 권한을 허용합니다.
 - 통합 설정에서 Enterprise Token을 복사합니다.
 
2. 필수 패키지 설치
3. 환경 변수 설정
Agent(apps=[])와 함께 통합을 사용하려면 Enterprise Token으로 CREWAI_PLATFORM_INTEGRATION_TOKEN 환경 변수를 설정해야 합니다..env 파일에 추가하세요:
사용 가능한 작업
google_calendar/create_event
google_calendar/create_event
설명: Google 캘린더에 이벤트를 생성합니다.파라미터:
eventName(string, 필수): 이벤트 이름.startTime(string, 필수): 시작 시간 - Unix 타임스탬프 또는 ISO8601 날짜 형식 허용.endTime(string, 선택): 종료 시간 - 비워두면 시작 시간 기준 1시간 후로 기본 설정됩니다.calendar(string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.attendees(string, 선택): 참석자 - 이메일 주소 배열 또는 쉼표로 구분된 이메일 주소 허용.eventLocation(string, 선택): 이벤트 위치.eventDescription(string, 선택): 이벤트 설명.eventId(string, 선택): 이벤트 ID - 이 이벤트와 연결할 애플리케이션의 ID입니다. 이후 이 ID를 사용하여 이벤트를 동기화할 수 있습니다.includeMeetLink(boolean, 선택): Google Meet 링크 포함 여부? - 이 이벤트에 대해 Google Meet 컨퍼런스 링크를 자동으로 생성합니다.
google_calendar/update_event
google_calendar/update_event
설명: Google 캘린더에서 기존 이벤트를 업데이트합니다.파라미터:
eventId(string, 필수): 이벤트 ID - 업데이트할 이벤트의 ID입니다.eventName(string, 선택): 이벤트 이름.startTime(string, 선택): 시작 시간 - Unix 타임스탬프 또는 ISO8601 날짜 형식 허용.endTime(string, 선택): 종료 시간 - 비워두면 시작 시간 기준 1시간 후로 기본 설정됩니다.calendar(string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.attendees(string, 선택): 참석자 - 이메일 주소 배열 또는 쉼표로 구분된 이메일 주소 허용.eventLocation(string, 선택): 이벤트 위치.eventDescription(string, 선택): 이벤트 설명.
google_calendar/view_events
google_calendar/view_events
설명: Google 캘린더에서 이벤트 목록을 가져옵니다.파라미터:
calendar(string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.after(string, 선택): 이후 - 제공된 날짜 이후에 시작하는 이벤트를 필터링합니다 (밀리초 단위의 Unix 또는 ISO 타임스탬프). (예시: “2025-04-12T10:00:00Z 또는 1712908800000”).before(string, 선택): 이전 - 제공된 날짜 이전에 종료되는 이벤트를 필터링합니다 (밀리초 단위의 Unix 또는 ISO 타임스탬프). (예시: “2025-04-12T10:00:00Z 또는 1712908800000”).
google_calendar/get_event_by_id
google_calendar/get_event_by_id
설명: Google 캘린더에서 ID로 특정 이벤트를 가져옵니다.파라미터:
eventId(string, 필수): 이벤트 ID.calendar(string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.
google_calendar/delete_event
google_calendar/delete_event
설명: Google 캘린더에서 이벤트를 삭제합니다.파라미터:
eventId(string, 필수): 이벤트 ID - 삭제할 캘린더 이벤트의 ID입니다.calendar(string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.
google_calendar/get_contacts
google_calendar/get_contacts
설명: Google 캘린더에서 연락처를 가져옵니다.파라미터:
paginationParameters(object, 선택): 페이지네이션 파라미터.
google_calendar/search_contacts
google_calendar/search_contacts
설명: Google 캘린더에서 연락처를 검색합니다.파라미터:
query(string, 선택): 연락처를 검색할 검색 쿼리.
google_calendar/list_directory_people
google_calendar/list_directory_people
설명: 디렉토리 구성원 목록을 가져옵니다.파라미터:
paginationParameters(object, 선택): 페이지네이션 파라미터.
google_calendar/search_directory_people
google_calendar/search_directory_people
설명: 디렉토리 구성원을 검색합니다.파라미터:
query(string, 필수): 연락처를 검색할 검색 쿼리.paginationParameters(object, 선택): 페이지네이션 파라미터.
google_calendar/list_other_contacts
google_calendar/list_other_contacts
설명: 기타 연락처 목록을 가져옵니다.파라미터:
paginationParameters(object, 선택): 페이지네이션 파라미터.
google_calendar/search_other_contacts
google_calendar/search_other_contacts
설명: 기타 연락처를 검색합니다.파라미터:
query(string, 선택): 연락처를 검색할 검색 쿼리.
google_calendar/get_availability
google_calendar/get_availability
설명: 캘린더의 가용성 정보를 가져옵니다.파라미터:
timeMin(string, 필수): 기간의 시작. ISO 형식.timeMax(string, 필수): 기간의 끝. ISO 형식.timeZone(string, 선택): 응답에 사용되는 시간대. 선택 사항입니다. 기본값은 UTC입니다.items(array, 선택): 조회할 캘린더 및/또는 그룹 목록. 비워두면 사용자 기본 캘린더가 기본값입니다.
사용 예시
기본 캘린더 에이전트 설정
특정 캘린더 도구 필터링
이벤트 관리 및 업데이트
연락처 및 가용성 관리
자동화된 일정 관리 워크플로우
문제 해결
일반적인 문제
인증 오류- Google 계정에 캘린더 접근에 필요한 권한이 있는지 확인하세요
 - OAuth 연결에 Google Calendar API에 필요한 모든 범위가 포함되어 있는지 확인하세요
 - 캘린더 공유 설정이 필요한 접근 수준을 허용하는지 확인하세요
 
- 시간 형식이 올바른지(ISO8601 또는 Unix 타임스탬프) 확인하세요
 - 참석자 이메일 주소가 올바르게 형식화되어 있는지 확인하세요
 - 대상 캘린더가 존재하며 접근 가능한지 확인하세요
 - 올바른 시간대가 지정되어 있는지 확인하세요
 
- 가용성 확인 시 시간 범위에 올바른 ISO 형식을 사용하세요
 - 모든 작업에서 시간대가 일관성 있는지 확인하세요
 - 여러 캘린더를 확인할 때 캘린더 ID가 올바른지 확인하세요
 
- 검색 쿼리가 올바르게 형식화되어 있는지 확인하세요
 - 디렉터리 접근 권한이 부여되었는지 확인하세요
 - 연락처 정보가 최신이며 접근 가능한지 확인하세요
 
- 이벤트 ID가 올바르며 이벤트가 존재하는지 확인하세요
 - 이벤트를 편집할 수 있는 권한이 있는지 확인하세요
 - 캘린더 소유권이 수정 작업을 허용하는지 확인하세요
 
도움 받기
도움이 필요하신가요?
Google Calendar 연동 설정 또는 문제 해결에 대한 지원이 필요하면 저희 지원팀에 문의하세요.
