메인 콘텐츠로 건너뛰기

개요

에이전트가 Gmail을 통해 이메일, 연락처, 임시 저장 메시지를 관리할 수 있도록 합니다. 이메일을 보내고, 메시지를 검색하며, 연락처를 관리하고, 임시 저장 메시지를 작성하며, AI 기반 자동화를 통해 이메일 커뮤니케이션을 효율화하세요.

사전 준비 사항

Gmail 통합을 사용하기 전에 다음을 확인하세요:
  • 활성 구독이 있는 CrewAI AMP 계정
  • 적절한 권한이 있는 Gmail 계정
  • 통합 페이지를 통해 Gmail 계정 연결

Gmail 연동 설정

1. Gmail 계정 연결하기

  1. CrewAI AMP Integrations로 이동합니다.
  2. 인증 통합 섹션에서 Gmail을 찾습니다.
  3. Connect를 클릭하고 OAuth 흐름을 완료합니다.
  4. 이메일 및 연락처 관리를 위한 필요한 권한을 부여합니다.
  5. 통합 설정에서 Enterprise Token을 복사합니다.

2. 필수 패키지 설치

3. 환경 변수 설정

Agent(apps=[])와 함께 통합을 사용하려면 Enterprise Token으로 CREWAI_PLATFORM_INTEGRATION_TOKEN 환경 변수를 설정해야 합니다.
또는 .env 파일에 추가하세요:

사용 가능한 작업

설명: Gmail에서 이메일을 보냅니다.파라미터:
  • toRecipients (array, 필수): 받는 사람 - 하나의 문자열 또는 JSON 배열로 받는 사람을 지정합니다.
  • from (string, 필수): 보내는 사람 - 발신자의 이메일을 지정합니다.
  • subject (string, 필수): 제목 - 메시지의 제목을 지정합니다.
  • messageContent (string, 필수): 메시지 내용 - 이메일 메시지의 내용을 일반 텍스트 또는 HTML로 지정합니다.
  • attachments (string, 선택): 첨부파일 - 단일 파일 객체 또는 파일 객체의 JSON 배열을 허용합니다.
  • additionalHeaders (object, 선택): 추가 헤더 - 추가 헤더 필드를 지정할 수 있습니다.
설명: Gmail에서 ID로 이메일을 조회합니다.파라미터:
  • userId (string, 필수): 사용자 ID - 사용자의 이메일 주소를 지정합니다. (예: “user@domain.com”).
  • messageId (string, 필수): 메시지 ID - 조회할 메시지의 ID를 지정합니다.
설명: 고급 필터를 사용하여 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에서 이메일을 삭제합니다.파라미터:
  • userId (string, 필수): 사용자 ID - 사용자의 이메일 주소를 지정합니다. (예: “user@domain.com”).
  • messageId (string, 필수): 메시지 ID - 휴지통으로 보낼 메시지의 ID를 지정합니다.
설명: Gmail에서 연락처를 생성합니다.파라미터:
  • givenName (string, 필수): 이름 - 생성할 연락처의 이름을 지정합니다. (예: “John”).
  • familyName (string, 필수): 성 - 생성할 연락처의 성을 지정합니다. (예: “Doe”).
  • email (string, 필수): 이메일 - 생성할 연락처의 이메일 주소를 지정합니다.
  • additionalFields (object, 선택): 추가 필드 - 기타 연락처 정보를 입력할 수 있습니다.
설명: Gmail에서 리소스 이름으로 연락처를 조회합니다.파라미터:
  • resourceName (string, 필수): 리소스 이름 - 조회할 연락처의 리소스 이름을 지정합니다.
설명: Gmail에서 연락처를 검색합니다.파라미터:
  • searchTerm (string, 필수): 검색어 - 이름, 닉네임, 이메일 주소, 전화번호 또는 조직 연락처 속성에서 유사하거나 정확히 일치하는 항목을 검색할 검색어를 지정합니다.
설명: Gmail에서 연락처를 삭제합니다.파라미터:
  • resourceName (string, 필수): 리소스 이름 - 삭제할 연락처의 리소스 이름을 지정합니다.
설명: Gmail에서 임시 저장 메일을 만듭니다.파라미터:
  • toRecipients (array, 선택): 받는 사람 - 하나의 문자열 또는 JSON 배열로 받는 사람을 지정합니다.
  • from (string, 선택): 보내는 사람 - 발신자의 이메일을 지정합니다.
  • subject (string, 선택): 제목 - 메시지의 제목을 지정합니다.
  • messageContent (string, 선택): 메시지 내용 - 이메일 메시지의 내용을 일반 텍스트 또는 HTML로 지정합니다.
  • attachments (string, 선택): 첨부파일 - 단일 파일 객체 또는 파일 객체의 JSON 배열을 허용합니다.
  • additionalHeaders (object, 선택): 추가 헤더 - 추가 헤더 필드를 지정할 수 있습니다.

사용 예시

기본 Gmail 에이전트 설정

특정 Gmail 도구 필터링

연락처 관리

이메일 검색 및 분석

자동화된 이메일 워크플로우

도움 받기

도움이 필요하신가요?

Gmail 통합 설정 또는 문제 해결에 대한 지원이 필요하시다면 저희 지원팀에 문의해 주세요.