메인 콘텐츠로 건너뛰기

​
개요

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

​
사전 준비 사항

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

​
Gmail 연동 설정

​
1. Gmail 계정 연결하기

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

​
2. 필수 패키지 설치

uv add crewai-tools

​
3. 환경 변수 설정

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

​
사용 가능한 작업

설명: Gmail에서 이메일을 보냅니다.파라미터:
  • toRecipients (array, 필수): 받는 사람 - 하나의 문자열 또는 JSON 배열로 받는 사람을 지정합니다. 
    [
  "recipient1@domain.com",
  "recipient2@domain.com"
]
  • from (string, 필수): 보내는 사람 - 발신자의 이메일을 지정합니다.
  • subject (string, 필수): 제목 - 메시지의 제목을 지정합니다.
  • messageContent (string, 필수): 메시지 내용 - 이메일 메시지의 내용을 일반 텍스트 또는 HTML로 지정합니다.
  • attachments (string, 선택): 첨부파일 - 단일 파일 객체 또는 파일 객체의 JSON 배열을 허용합니다.
  • additionalHeaders (object, 선택): 추가 헤더 - 추가 헤더 필드를 지정할 수 있습니다. 
    {
  "reply-to": "Sender Name <sender@domain.com>"
}
설명: Gmail에서 ID로 이메일을 조회합니다.파라미터:
  • userId (string, 필수): 사용자 ID - 사용자의 이메일 주소를 지정합니다. (예: “user@domain.com”).
  • messageId (string, 필수): 메시지 ID - 조회할 메시지의 ID를 지정합니다.
설명: 고급 필터를 사용하여 Gmail에서 이메일을 검색합니다.파라미터:
  • emailFilterFormula (object, 선택): 불리언 식(OR로 연결된 AND 그룹의 단일 조건)으로 된 필터. 
    {
  "operator": "OR",
  "conditions": [
    {
      "operator": "AND",
      "conditions": [
        {
          "field": "from",
          "operator": "$stringContains",
          "value": "example@domain.com"
        }
      ]
    }
  ]
}
    사용 가능한 필드: 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, 선택): 페이지네이션 파라미터. 
    {
  "pageCursor": "page_cursor_string"
}
설명: Gmail에서 이메일을 삭제합니다.파라미터:
  • userId (string, 필수): 사용자 ID - 사용자의 이메일 주소를 지정합니다. (예: “user@domain.com”).
  • messageId (string, 필수): 메시지 ID - 휴지통으로 보낼 메시지의 ID를 지정합니다.
설명: Gmail에서 연락처를 생성합니다.파라미터:
  • givenName (string, 필수): 이름 - 생성할 연락처의 이름을 지정합니다. (예: “John”).
  • familyName (string, 필수): 성 - 생성할 연락처의 성을 지정합니다. (예: “Doe”).
  • email (string, 필수): 이메일 - 생성할 연락처의 이메일 주소를 지정합니다.
  • additionalFields (object, 선택): 추가 필드 - 기타 연락처 정보를 입력할 수 있습니다. 
    {
  "addresses": [
    {
      "streetAddress": "1000 North St.",
      "city": "Los Angeles"
    }
  ]
}
설명: Gmail에서 리소스 이름으로 연락처를 조회합니다.파라미터:
  • resourceName (string, 필수): 리소스 이름 - 조회할 연락처의 리소스 이름을 지정합니다.
설명: Gmail에서 연락처를 검색합니다.파라미터:
  • searchTerm (string, 필수): 검색어 - 이름, 닉네임, 이메일 주소, 전화번호 또는 조직 연락처 속성에서 유사하거나 정확히 일치하는 항목을 검색할 검색어를 지정합니다.
설명: Gmail에서 연락처를 삭제합니다.파라미터:
  • resourceName (string, 필수): 리소스 이름 - 삭제할 연락처의 리소스 이름을 지정합니다.
설명: Gmail에서 임시 저장 메일을 만듭니다.파라미터:
  • toRecipients (array, 선택): 받는 사람 - 하나의 문자열 또는 JSON 배열로 받는 사람을 지정합니다. 
    [
  "recipient1@domain.com",
  "recipient2@domain.com"
]
  • from (string, 선택): 보내는 사람 - 발신자의 이메일을 지정합니다.
  • subject (string, 선택): 제목 - 메시지의 제목을 지정합니다.
  • messageContent (string, 선택): 메시지 내용 - 이메일 메시지의 내용을 일반 텍스트 또는 HTML로 지정합니다.
  • attachments (string, 선택): 첨부파일 - 단일 파일 객체 또는 파일 객체의 JSON 배열을 허용합니다.
  • additionalHeaders (object, 선택): 추가 헤더 - 추가 헤더 필드를 지정할 수 있습니다. 
    {
  "reply-to": "Sender Name <sender@domain.com>"
}

​
사용 예시

​
기본 Gmail 에이전트 설정

from crewai import Agent, Task, Crew

# Create an agent with Gmail capabilities
gmail_agent = Agent(
    role="Email Manager",
    goal="Manage email communications and contacts efficiently",
    backstory="An AI assistant specialized in email management and communication.",
    apps=['gmail']
)

# Task to send a follow-up email
send_email_task = Task(
    description="Send a follow-up email to john@example.com about the project update meeting",
    agent=gmail_agent,
    expected_output="Email sent successfully with confirmation"
)

# Run the task
crew = Crew(
    agents=[gmail_agent],
    tasks=[send_email_task]
)

crew.kickoff()

​
특정 Gmail 도구 필터링


email_coordinator = Agent(
    role="Email Coordinator",
    goal="Coordinate email communications and manage drafts",
    backstory="An AI assistant that focuses on email coordination and draft management.",
    apps=['gmail']
)

# Task to prepare and send emails
email_coordination = Task(
    description="Search for emails from the marketing team, create a summary draft, and send it to stakeholders",
    agent=email_coordinator,
    expected_output="Summary email sent to stakeholders"
)

crew = Crew(
    agents=[email_coordinator],
    tasks=[email_coordination]
)

crew.kickoff()

​
연락처 관리

from crewai import Agent, Task, Crew

contact_manager = Agent(
    role="Contact Manager",
    goal="Manage and organize email contacts efficiently",
    backstory="An experienced contact manager who maintains organized contact databases.",
    apps=['gmail']
)

# Task to manage contacts
contact_task = Task(
    description="""
    1. 'example.com' 도메인에서 연락처를 검색합니다.
    2. 연락처 목록에 없는 최근 이메일 발신자에 대해 새 연락처를 생성합니다.
    3. 최근 상호 작용 데이터를 반영하여 연락처 정보를 업데이트합니다.
    """,
    agent=contact_manager,
    expected_output="새 연락처와 최근 상호 작용으로 연락처 데이터베이스가 업데이트됨"
)

crew = Crew(
    agents=[contact_manager],
    tasks=[contact_task]
)

crew.kickoff()

​
이메일 검색 및 분석

from crewai import Agent, Task, Crew

email_analyst = Agent(
    role="Email Analyst",
    goal="Analyze email patterns and provide insights",
    backstory="An AI assistant that analyzes email data to provide actionable insights.",
    apps=['gmail']
)

# Task to analyze email patterns
analysis_task = Task(
    description="""
    Search for all unread emails from the last 7 days,
    categorize them by sender domain,
    and create a summary report of communication patterns
    """,
    agent=email_analyst,
    expected_output="Email analysis report with communication patterns and recommendations"
)

crew = Crew(
    agents=[email_analyst],
    tasks=[analysis_task]
)

crew.kickoff()

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

from crewai import Agent, Task, Crew

workflow_manager = Agent(
    role="Email Workflow Manager",
    goal="Automate email workflows and responses",
    backstory="An AI assistant that manages automated email workflows and responses.",
    apps=['gmail']
)

# Complex task involving multiple Gmail operations
workflow_task = Task(
    description="""
    1. 지난 24시간 동안 제목에 'urgent'가 포함된 이메일 검색
    2. 각 긴급 이메일에 대한 답장 초안 생성
    3. 발신자에게 자동 확인 이메일 전송
    4. 주의가 필요한 긴급 항목의 요약 보고서 작성
    """,
    agent=workflow_manager,
    expected_output="긴급 이메일이 자동 응답 및 요약 보고서와 함께 처리됨"
)

crew = Crew(
    agents=[workflow_manager],
    tasks=[workflow_task]
)

crew.kickoff()

​
도움 받기

도움이 필요하신가요?

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