개요
에이전트가 Gmail을 통해 이메일, 연락처, 임시 저장 메시지를 관리할 수 있도록 합니다. 이메일을 보내고, 메시지를 검색하며, 연락처를 관리하고, 임시 저장 메시지를 작성하며, AI 기반 자동화를 통해 이메일 커뮤니케이션을 효율화하세요.사전 준비 사항
Gmail 통합을 사용하기 전에 다음을 확인하세요:- 활성 구독이 있는 CrewAI Enterprise 계정
- 적절한 권한이 있는 Gmail 계정
- 통합 페이지를 통해 Gmail 계정 연결
Gmail 연동 설정
1. Gmail 계정 연결하기
- CrewAI Enterprise Integrations로 이동합니다.
- 인증 통합 섹션에서 Gmail을 찾습니다.
- Connect를 클릭하고 OAuth 흐름을 완료합니다.
- 이메일 및 연락처 관리를 위한 필요한 권한을 부여합니다.
- Account Settings에서 Enterprise Token을 복사합니다.
2. 필수 패키지 설치
사용 가능한 작업
GMAIL_SEND_EMAIL
GMAIL_SEND_EMAIL
설명: Gmail에서 이메일을 보냅니다.파라미터:
toRecipients
(array, 필수): 받는 사람 - 하나의 문자열 또는 JSON 배열로 받는 사람을 지정합니다.from
(string, 필수): 보내는 사람 - 발신자의 이메일을 지정합니다.subject
(string, 필수): 제목 - 메시지의 제목을 지정합니다.messageContent
(string, 필수): 메시지 내용 - 이메일 메시지의 내용을 일반 텍스트 또는 HTML로 지정합니다.attachments
(string, 선택): 첨부파일 - 단일 파일 객체 또는 파일 객체의 JSON 배열을 허용합니다.additionalHeaders
(object, 선택): 추가 헤더 - 추가 헤더 필드를 지정할 수 있습니다.
GMAIL_GET_EMAIL_BY_ID
GMAIL_GET_EMAIL_BY_ID
설명: Gmail에서 ID로 이메일을 조회합니다.파라미터:
userId
(string, 필수): 사용자 ID - 사용자의 이메일 주소를 지정합니다. (예: “user@domain.com”).messageId
(string, 필수): 메시지 ID - 조회할 메시지의 ID를 지정합니다.
GMAIL_SEARCH_FOR_EMAIL
GMAIL_SEARCH_FOR_EMAIL
설명: 고급 필터를 사용하여 Gmail에서 이메일을 검색합니다.파라미터:
emailFilterFormula
(object, 선택): 불리언 식(OR로 연결된 AND 그룹의 단일 조건)으로 된 필터.사용 가능한 필드:from
,to
,date
,label
,subject
,cc
,bcc
,category
,deliveredto:
,size
,filename
,older_than
,newer_than
,list
,is:important
,is:unread
,is:snoozed
,is:starred
,is:read
,has:drive
,has:document
,has:spreadsheet
,has:presentation
,has:attachment
,has:youtube
,has:userlabels
paginationParameters
(object, 선택): 페이지네이션 파라미터.
GMAIL_DELETE_EMAIL
GMAIL_DELETE_EMAIL
설명: Gmail에서 이메일을 삭제합니다.파라미터:
userId
(string, 필수): 사용자 ID - 사용자의 이메일 주소를 지정합니다. (예: “user@domain.com”).messageId
(string, 필수): 메시지 ID - 휴지통으로 보낼 메시지의 ID를 지정합니다.
GMAIL_CREATE_A_CONTACT
GMAIL_CREATE_A_CONTACT
설명: Gmail에서 연락처를 생성합니다.파라미터:
givenName
(string, 필수): 이름 - 생성할 연락처의 이름을 지정합니다. (예: “John”).familyName
(string, 필수): 성 - 생성할 연락처의 성을 지정합니다. (예: “Doe”).email
(string, 필수): 이메일 - 생성할 연락처의 이메일 주소를 지정합니다.additionalFields
(object, 선택): 추가 필드 - 기타 연락처 정보를 입력할 수 있습니다.
GMAIL_GET_CONTACT_BY_RESOURCE_NAME
GMAIL_GET_CONTACT_BY_RESOURCE_NAME
설명: Gmail에서 리소스 이름으로 연락처를 조회합니다.파라미터:
resourceName
(string, 필수): 리소스 이름 - 조회할 연락처의 리소스 이름을 지정합니다.
GMAIL_SEARCH_FOR_CONTACT
GMAIL_SEARCH_FOR_CONTACT
설명: Gmail에서 연락처를 검색합니다.파라미터:
searchTerm
(string, 필수): 검색어 - 이름, 닉네임, 이메일 주소, 전화번호 또는 조직 연락처 속성에서 유사하거나 정확히 일치하는 항목을 검색할 검색어를 지정합니다.
GMAIL_DELETE_CONTACT
GMAIL_DELETE_CONTACT
설명: Gmail에서 연락처를 삭제합니다.파라미터:
resourceName
(string, 필수): 리소스 이름 - 삭제할 연락처의 리소스 이름을 지정합니다.
GMAIL_CREATE_DRAFT
GMAIL_CREATE_DRAFT
설명: Gmail에서 임시 저장 메일을 만듭니다.파라미터:
toRecipients
(array, 선택): 받는 사람 - 하나의 문자열 또는 JSON 배열로 받는 사람을 지정합니다.from
(string, 선택): 보내는 사람 - 발신자의 이메일을 지정합니다.subject
(string, 선택): 제목 - 메시지의 제목을 지정합니다.messageContent
(string, 선택): 메시지 내용 - 이메일 메시지의 내용을 일반 텍스트 또는 HTML로 지정합니다.attachments
(string, 선택): 첨부파일 - 단일 파일 객체 또는 파일 객체의 JSON 배열을 허용합니다.additionalHeaders
(object, 선택): 추가 헤더 - 추가 헤더 필드를 지정할 수 있습니다.
사용 예시
기본 Gmail 에이전트 설정
특정 Gmail 도구 필터링
연락처 관리
이메일 검색 및 분석
자동화된 이메일 워크플로우
도움 받기
도움이 필요하신가요?
Gmail 통합 설정 또는 문제 해결에 대한 지원이 필요하시다면 저희 지원팀에 문의해 주세요.