통합 플레이북
아래 가이드는 각 통합을 활성화하고 테스트하는 방법을 자세히 설명합니다.Gmail 트리거
Google Calendar 트리거
Google Drive 트리거
Outlook 트리거
OneDrive 트리거
Microsoft Teams 트리거
HubSpot 트리거
Salesforce 트리거
Slack 트리거
Zapier 트리거
트리거 기능
- 실시간 대응 – 조건이 충족되면 자동으로 워크플로우 실행
- 외부 시스템 연동 – Gmail, Outlook, OneDrive, JIRA, Slack, Stripe 등과 연결
- 자동화 확장성 – 수동 개입 없이 대량 이벤트 처리
- 컨텍스트 유지 – 트리거 데이터를 크루와 플로우에서 바로 활용
트리거 관리
사용 가능한 트리거 보기
- CrewAI 대시보드에서 자동화를 선택합니다.
- Triggers 탭을 클릭하여 사용 가능한 통합을 확인합니다.

트리거 활성화/비활성화

- 파랑 (활성) – 이벤트 발생 시 자동 실행
- 회색 (비활성) – 이벤트 무시
트리거 실행 모니터링
트리거 실행 내역과 상태를 대시보드에서 확인하세요.
트리거 기반 자동화 구성
설정 체크리스트
- Tools & Integrations에서 해당 서비스를 연결하고 OAuth 또는 API 설정을 완료했나요?
- 자동화에서 트리거 토글을 활성화했나요?
- 필요한 환경 변수(토큰, 테넌트 ID, 시크릿 등)를 설정했나요?
- 첫 번째 작업에서 트리거 payload를 파싱하도록 구성했나요?
allow_crewai_trigger_context
옵션으로 컨텍스트 자동 주입 여부를 결정했나요?- 웹훅 로그, CrewAI 실행 기록, 외부 알림 등 모니터링을 준비했나요?
CLI로 로컬에서 트리거 테스트
CrewAI CLI는 프로덕션에 배포하기 전에 트리거 기반 자동화를 개발하고 테스트할 수 있는 강력한 명령을 제공합니다.사용 가능한 트리거 목록 보기
연결된 통합에 사용 가능한 모든 트리거를 확인하세요:- 통합 이름 및 연결 상태
- 사용 가능한 트리거 유형
- 트리거 이름 및 설명
트리거 실행 시뮬레이션
배포 전에 실제 트리거 payload로 크루를 테스트하세요:- 로컬에서 크루를 실행합니다
- 완전하고 실제적인 트리거 payload를 전달합니다
- 프로덕션에서 크루가 호출되는 방식을 정확히 시뮬레이션합니다
중요한 개발 노트:
- 개발 중 트리거 실행을 시뮬레이션하려면
crewai triggers run <trigger>
를 사용하세요 crewai run
을 사용하면 트리거 호출을 시뮬레이션하지 않으며 트리거 payload를 전달하지 않습니다- 배포 후에는 실제 트리거 payload로 크루가 실행됩니다
- 크루가 트리거 payload에 없는 매개변수를 기대하면 실행이 실패할 수 있습니다
트리거와 Crew 연동
플로우와의 통합
Payload 접근
플로우에서 Crew 실행
문제 해결
트리거가 실행되지 않나요?- 배포의 Triggers 탭에서 트리거가 활성화되어 있는지 확인하세요
- Tools & Integrations에서 통합 연결 상태를 확인하세요
- 필요한 모든 환경 변수가 올바르게 구성되어 있는지 확인하세요
- 실행 로그에서 오류 세부 정보를 확인하세요
crewai triggers run <트리거_이름>
을 사용하여 로컬에서 테스트하고 정확한 payload 구조를 확인하세요- 크루가
crewai_trigger_payload
매개변수를 처리할 수 있는지 확인하세요 - 크루가 트리거 payload에 포함되지 않은 매개변수를 기대하지 않는지 확인하세요
- 배포하기 전에 항상
crewai triggers run <trigger>
로 테스트하여 전체 payload를 확인하세요 crewai run
은 트리거 호출을 시뮬레이션하지 않으므로crewai triggers run
을 대신 사용하세요crewai triggers list
를 사용하여 연결된 통합에 사용 가능한 트리거를 확인하세요- 배포 후 크루는 실제 트리거 payload를 받으므로 먼저 로컬에서 철저히 테스트하세요