개요
에이전트가 Google Calendar를 통해 캘린더 이벤트, 일정, 가용 시간을 관리할 수 있도록 지원합니다. 이벤트를 생성 및 업데이트하고 참석자를 관리하며, 가용성을 확인하고 AI 기반 자동화로 일정 관리 워크플로우를 효율적으로 운영하세요.필수 조건
Google Calendar 통합을 사용하기 전에 다음을 준비해야 합니다:- 활성 구독이 있는 CrewAI Enterprise 계정
- Google Calendar에 접근 가능한 Google 계정
- 통합 페이지를 통해 Google 계정을 연결 완료
Google Calendar 연동 설정
1. Google 계정 연결하기
- CrewAI Enterprise Integrations로 이동합니다.
- 인증 통합 섹션에서 Google Calendar를 찾습니다.
- Connect를 클릭하고 OAuth 과정을 완료합니다.
- 캘린더 및 연락처 접근 권한을 허용합니다.
- Account Settings에서 Enterprise Token을 복사합니다.
2. 필수 패키지 설치
사용 가능한 작업
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_LIST_EVENTS
GOOGLE_CALENDAR_LIST_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 연동 설정 또는 문제 해결에 대한 지원이 필요하면 저희 지원팀에 문의하세요.