메인 콘텐츠로 건너뛰기

개요

도구 & 통합은 서드파티 애플리케이션을 연결하고 에이전트가 런타임에 사용할 내부 도구를 관리하는 중앙 허브입니다.
도구 & 통합 개요

살펴보기

  • 통합
  • 내부 도구

에이전트 앱 (통합)

Gmail, Google Drive, HubSpot, Slack 등 OAuth 기반 서비스에 연결하여 에이전트 액션을 활성화하세요.
1

연결

원하는 앱에서 Connect를 클릭하고 OAuth를 완료합니다.
2

구성

필요에 따라 스코프, 트리거, 사용 가능한 액션을 조정합니다.
3

에이전트에서 사용

연결된 서비스는 에이전트 도구로 사용 가능합니다.
앱 그리드

계정 연결하기

  1. Integrations로 이동
  2. 원하는 서비스에서 Connect 클릭
  3. OAuth 플로우 완료 및 스코프 승인
  4. Integration 탭에서 Enterprise Token 복사
Enterprise Token

통합 도구 설치

로컬에서 통합을 사용하려면 최신 crewai-tools 패키지를 설치하세요.
uv add crewai-tools

사용 예시

인증된 모든 서비스는 도구로 제공됩니다. 에이전트에 CrewaiEnterpriseTools를 추가하세요.
from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)
print(enterprise_tools)

email_agent = Agent(
    role="이메일 매니저",
    goal="이메일 커뮤니케이션 관리",
    backstory="이메일 관리에 특화된 AI 어시스턴트",
    tools=enterprise_tools
)

email_task = Task(
    description="프로젝트 업데이트에 대한 후속 이메일 작성 및 전송",
    agent=email_agent,
    expected_output="이메일 전송 성공 확인"
)

crew = Crew(agents=[email_agent], tasks=[email_task])
crew.kickoff()

도구 필터링

from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    actions_list=["gmail_find_email"]
)

gmail_tool = enterprise_tools["gmail_find_email"]

gmail_agent = Agent(
    role="Gmail 매니저",
    goal="Gmail 커뮤니케이션 및 알림 관리",
    backstory="Gmail 커뮤니케이션 조율 AI 어시스턴트",
    tools=[gmail_tool]
)

notification_task = Task(
    description="john@example.com에서 온 이메일 찾기",
    agent=gmail_agent,
    expected_output="john@example.com의 이메일을 찾았다는 확인"
)

crew = Crew(agents=[gmail_agent], tasks=[notification_task])
배포된 크루에서는 각 통합의 서비스 설정 페이지에서 사용 가능한 액션을 지정할 수 있습니다.
액션 필터링

범위 지정 배포 (다중 사용자 조직)

각 통합을 특정 사용자로 범위 지정할 수 있습니다 (예: 특정 사용자의 Gmail 계정 사용).
팀/사용자별 데이터 접근을 분리해야 할 때 유용합니다.
user_bearer_token을 사용해 요청 사용자로 인증을 범위 지정합니다. 사용자가 로그인하지 않은 경우 연결된 통합을 사용하지 않으며, 그렇지 않으면 배포에 설정된 기본 토큰을 사용합니다.
사용자 토큰

카탈로그

커뮤니케이션 & 협업

  • Gmail — 이메일 및 초안 관리
  • Slack — 워크스페이스 알림 및 경보
  • Microsoft — Office 365 및 Teams 통합

프로젝트 관리

  • Jira — 이슈 추적 및 프로젝트 관리
  • ClickUp — 작업 및 생산성 관리
  • Asana — 팀 작업 조율
  • Notion — 페이지 및 데이터베이스 관리
  • Linear — 버그/프로젝트 추적
  • GitHub — 리포지토리 및 이슈 관리

CRM

  • Salesforce — 계정 및 기회 관리
  • HubSpot — 파이프라인/연락처 관리
  • Zendesk — 고객 지원 티켓 관리

비즈니스 & 금융

  • Stripe — 결제 처리 및 고객 관리
  • Shopify — 전자상거래 및 상품 관리

생산성 & 스토리지

  • Google Sheets — 스프레드시트 동기화
  • Google Calendar — 일정/이벤트 관리
  • Box — 파일 스토리지
…더 많은 통합이 추가될 예정입니다!

관련 문서