chore(docs): bring AMP doc refresh from release/v1.0.0 into main (#3637)

* WIP: v1 docs (#3626) (cherry picked from commit d46e20fa09bcd2f5916282f5553ddeb7183bd92c) * docs: parity for all translations * docs: full name of acronym AMP * docs: fix lingering unused code * docs: expand contextual options in docs.json * docs: add contextual action to request feature on GitHub * chore: tidy docs formatting
2026-05-03 08:12:39 +00:00 · 2025-10-02 11:36:04 -04:00
parent f47e0c82c4
commit bf9e0423f2
242 changed files with 8999 additions and 3637 deletions
--- a/docs/ko/enterprise/guides/automation-triggers.mdx
+++ b/docs/ko/enterprise/guides/automation-triggers.mdx
@@ -1,75 +1,130 @@
 ---
-title: "자동화 트리거"
-description: "연결된 통합에서 특정 이벤트가 발생할 때 CrewAI 워크플로우를 자동으로 실행합니다"
+title: "트리거 개요"
+description: "CrewAI AMP 트리거의 동작 방식과 관리 방법, 그리고 통합별 플레이북을 한눈에 확인하세요"
 icon: "bolt"
 mode: "wide"
 ---

-자동화 트리거를 사용하면 연결된 통합에서 특정 이벤트가 발생할 때 CrewAI 배포를 자동으로 실행할 수 있어, 비즈니스 시스템의 실시간 변화에 반응하는 강력한 이벤트 기반 워크플로우를 만들 수 있습니다.
+CrewAI AMP 트리거는 팀이 이미 사용하고 있는 도구의 실시간 이벤트와 자동화를 연결합니다. 폴링이나 수동 실행 대신, 트리거는 새로운 이메일, 캘린더 업데이트, CRM 상태 변화 등을 감지하여 지정한 크루 또는 플로우를 즉시 실행합니다.

-## 개요
+<iframe
+  className="w-full aspect-video rounded-xl"
+  src="https://www.youtube.com/embed/TpQ45lAZh48"
+  title="CrewAI 트리거 개요"
+  frameBorder="0"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+  allowFullScreen
+></iframe>

-자동화 트리거를 사용하면 다음을 수행할 수 있습니다:
+### 통합 플레이북

- **실시간 이벤트에 응답** - 특정 조건이 충족될 때 워크플로우를 자동으로 실행
- **외부 시스템과 통합** - Gmail, Outlook, OneDrive, JIRA, Slack, Stripe 등의 플랫폼과 연결
- **자동화 확장** - 수동 개입 없이 대용량 이벤트 처리
- **컨텍스트 유지** - crew와 flow 내에서 트리거 데이터에 액세스
+아래 가이드는 각 통합을 활성화하고 테스트하는 방법을 자세히 설명합니다.

-## 자동화 트리거 관리
+<CardGroup cols={2}>
+  <Card title="Gmail 트리거" icon="envelope">
+    <a href="/ko/enterprise/guides/gmail-trigger">새로운 이메일이나 스레드 업데이트에 맞춰 크루를 실행하세요.</a>
+  </Card>
+
+  <Card title="Google Calendar 트리거" icon="calendar-days">
+    <a href="/ko/enterprise/guides/google-calendar-trigger">캘린더 이벤트 생성, 수정, 취소에 대응하세요.</a>
+  </Card>
+
+  <Card title="Google Drive 트리거" icon="folder-open">
+    <a href="/ko/enterprise/guides/google-drive-trigger">Drive 파일 업로드, 수정, 삭제를 감시하세요.</a>
+  </Card>
+
+  <Card title="Outlook 트리거" icon="envelope-open">
+    <a href="/ko/enterprise/guides/outlook-trigger">Outlook의 새로운 메일이나 삭제된 이벤트에 대응하세요.</a>
+  </Card>
+
+  <Card title="OneDrive 트리거" icon="cloud">
+    <a href="/ko/enterprise/guides/onedrive-trigger">OneDrive 파일 활동 및 공유 변경 사항을 감사하세요.</a>
+  </Card>
+
+  <Card title="Microsoft Teams 트리거" icon="comments">
+    <a href="/ko/enterprise/guides/microsoft-teams-trigger">새로운 Teams 채팅이 생성될 때 워크플로우를 시작하세요.</a>
+  </Card>
+
+  <Card title="HubSpot 트리거" icon="hubspot">
+    <a href="/ko/enterprise/guides/hubspot-trigger">HubSpot 워크플로우와 라이프사이클 이벤트에서 자동화를 실행하세요.</a>
+  </Card>
+
+  <Card title="Salesforce 트리거" icon="salesforce">
+    <a href="/ko/enterprise/guides/salesforce-trigger">Salesforce 프로세스를 CrewAI 크루와 연결해 CRM 자동화를 구현하세요.</a>
+  </Card>
+
+  <Card title="Slack 트리거" icon="slack">
+    <a href="/ko/enterprise/guides/slack-trigger">Slack 슬래시 명령으로 크루를 바로 실행하세요.</a>
+  </Card>
+
+  <Card title="Zapier 트리거" icon="bolt">
+    <a href="/ko/enterprise/guides/zapier-trigger">CrewAI를 수천 개의 Zapier 지원 앱과 연동하세요.</a>
+  </Card>
+</CardGroup>
+
+## 트리거 기능
+
+- **실시간 대응** – 조건이 충족되면 자동으로 워크플로우 실행
+- **외부 시스템 연동** – Gmail, Outlook, OneDrive, JIRA, Slack, Stripe 등과 연결
+- **자동화 확장성** – 수동 개입 없이 대량 이벤트 처리
+- **컨텍스트 유지** – 트리거 데이터를 크루와 플로우에서 바로 활용
+
+## 트리거 관리

 ### 사용 가능한 트리거 보기

-자동화 트리거에 액세스하고 관리하려면:
-
-1. CrewAI 대시보드에서 배포로 이동
-2. **트리거** 탭을 클릭하여 사용 가능한 모든 트리거 통합 보기
+1. CrewAI 대시보드에서 자동화를 선택합니다.
+2. **Triggers** 탭을 클릭하여 사용 가능한 통합을 확인합니다.

 <Frame>
-  <img src="/images/enterprise/list-available-triggers.png" alt="사용 가능한 자동화 트리거 목록" />
+  <img src="/images/enterprise/list-available-triggers.png" alt="사용 가능한 트리거 목록" />
 </Frame>

-이 보기는 배포에 사용 가능한 모든 트리거 통합과 현재 연결 상태를 보여줍니다.
-
-### 트리거 활성화 및 비활성화
-
-각 트리거는 토글 스위치를 사용하여 쉽게 활성화하거나 비활성화할 수 있습니다:
+### 트리거 활성화/비활성화

 <Frame>
-  <img src="/images/enterprise/trigger-selected.png" alt="토글로 트리거 활성화 또는 비활성화" />
+  <img src="/images/enterprise/trigger-selected.png" alt="트리거 토글" />
 </Frame>

- **활성화됨 (파란색 토글)**: 트리거가 활성 상태이며 지정된 이벤트가 발생할 때 배포를 자동으로 실행합니다
- **비활성화됨 (회색 토글)**: 트리거가 비활성 상태이며 이벤트에 응답하지 않습니다
+- **파랑 (활성)** – 이벤트 발생 시 자동 실행
+- **회색 (비활성)** – 이벤트 무시

-토글을 클릭하기만 하면 트리거 상태를 변경할 수 있습니다. 변경 사항은 즉시 적용됩니다.
+토글 버튼을 클릭하면 즉시 적용됩니다.

 ### 트리거 실행 모니터링

-트리거된 실행의 성능과 기록을 추적합니다:
+트리거 실행 내역과 상태를 대시보드에서 확인하세요.

 <Frame>
-  <img src="/images/enterprise/list-executions.png" alt="자동화에 의해 트리거된 실행 목록" />
+  <img src="/images/enterprise/list-executions.png" alt="트리거 실행 내역" />
 </Frame>

-## 자동화 구축
+## 트리거 기반 자동화 구성

-자동화를 구축하기 전에 crew와 flow가 받을 트리거 페이로드의 구조를 이해하는 것이 도움이 됩니다.
+### 설정 체크리스트

-### 페이로드 샘플 저장소
+- **Tools & Integrations**에서 해당 서비스를 연결하고 OAuth 또는 API 설정을 완료했나요?
+- 자동화에서 트리거 토글을 활성화했나요?
+- 필요한 환경 변수(토큰, 테넌트 ID, 시크릿 등)를 설정했나요?
+- 첫 번째 작업에서 트리거 payload를 파싱하도록 구성했나요?
+- `allow_crewai_trigger_context` 옵션으로 컨텍스트 자동 주입 여부를 결정했나요?
+- 웹훅 로그, CrewAI 실행 기록, 외부 알림 등 모니터링을 준비했나요?

-자동화를 구축하고 테스트하는 데 도움이 되도록 다양한 트리거 소스의 샘플 페이로드가 포함된 포괄적인 저장소를 유지 관리하고 있습니다:
+### Payload & Crew 예제 저장소

-**🔗 [CrewAI Enterprise 트리거 페이로드 샘플](https://github.com/crewAIInc/crewai-enterprise-trigger-payload-samples)**
+| 통합 | 동작 시점 | Payload 예제 | Crew 예제 |
+| :-- | :-- | :-- | :-- |
+| Gmail | 신규 메일, 스레드 업데이트 | [Gmail payload](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/gmail) | [`new-email-crew.py`, `gmail-alert-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/gmail) |
+| Google Calendar | 이벤트 생성/수정/시작/종료/취소 | [Calendar payload](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/google_calendar) | [`calendar-event-crew.py`, `calendar-meeting-crew.py`, `calendar-working-location-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/google_calendar) |
+| Google Drive | 파일 생성/수정/삭제 | [Drive payload](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/google_drive) | [`drive-file-crew.py`, `drive-file-deletion-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/google_drive) |
+| Outlook | 새 이메일, 이벤트 제거 | [Outlook payload](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/outlook) | [`outlook-message-crew.py`, `outlook-event-removal-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/outlook) |
+| OneDrive | 파일 작업(생성, 수정, 공유, 삭제) | [OneDrive payload](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/onedrive) | [`onedrive-file-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/onedrive) |
+| HubSpot | 레코드 생성/업데이트(연락처, 회사, 딜) | [HubSpot payload](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/hubspot) | [`hubspot-company-crew.py`, `hubspot-contact-crew.py`, `hubspot-record-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/hubspot) |
+| Microsoft Teams | 채팅 생성 | [Teams payload](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/microsoft-teams) | [`teams-chat-created-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/microsoft-teams) |

-이 저장소에는 다음이 포함되어 있습니다:
+예제 payload를 참고해 파싱 로직을 검증하고, 제공되는 crew를 복사해 실제 데이터로 교체하세요.

- **실제 페이로드 예제** - 다양한 트리거 소스(Gmail, Google Drive 등)에서 가져온 예제
- **페이로드 구조 문서** - 형식과 사용 가능한 필드를 보여주는 문서
-
-### Crew와 트리거
-
-기존 crew 정의는 트리거와 완벽하게 작동하며, 받은 페이로드를 분석하는 작업만 있으면 됩니다:
+### 트리거와 Crew 연동

 ```python
@CrewBase
@@ -95,15 +150,9 @@ class MyAutomatedCrew:
        )
 ```

-crew는 자동으로 트리거 페이로드를 받고 표준 CrewAI 컨텍스트 메커니즘을 통해 액세스할 수 있습니다.
+### 플로우와의 통합

-### Flow와의 통합
-
-flow의 경우 트리거 데이터 처리 방법을 더 세밀하게 제어할 수 있습니다:
-
-#### 트리거 페이로드 액세스
-
-flow의 모든 `@start()` 메서드는 `crewai_trigger_payload`라는 추가 매개변수를 허용합니다:
+#### Payload 접근

 ```python
 from crewai.flow import Flow, start, listen
@@ -111,62 +160,48 @@ from crewai.flow import Flow, start, listen
 class MyAutomatedFlow(Flow):
    @start()
    def handle_trigger(self, crewai_trigger_payload: dict = None):
-        """
-        이 start 메서드는 트리거 데이터를 받을 수 있습니다
-        """
        if crewai_trigger_payload:
-            # 트리거 데이터 처리
            trigger_id = crewai_trigger_payload.get('id')
            event_data = crewai_trigger_payload.get('payload', {})
-
-            # 다른 메서드에서 사용할 수 있도록 flow 상태에 저장
            self.state.trigger_id = trigger_id
            self.state.trigger_type = event_data
-
            return event_data
-
-        # 수동 실행 처리
        return None

    @listen(handle_trigger)
    def process_data(self, trigger_data):
-        """
-        트리거 데이터 처리
-        """
        # ... 트리거 처리
 ```

-#### Flow에서 Crew 트리거하기
-
-트리거된 flow 내에서 crew를 시작할 때 트리거 페이로드를 전달합니다:
+#### 플로우에서 Crew 실행

 ```python
@start()
 def delegate_to_crew(self, crewai_trigger_payload: dict = None):
-    """
-    전문 crew에 처리 위임
-    """
    crew = MySpecializedCrew()
-
-    # crew에 트리거 페이로드 전달
    result = crew.crew().kickoff(
        inputs={
-            'a_custom_parameter': "custom_value",
+            'custom_parameter': "custom_value",
            'crewai_trigger_payload': crewai_trigger_payload
        },
    )
-
    return result
 ```

 ## 문제 해결

-**트리거가 작동하지 않는 경우:**
- 트리거가 활성화되어 있는지 확인
- 통합 연결 상태 확인
+**트리거가 실행되지 않나요?**
+- 트리거가 활성 상태인지 확인하세요.
+- 통합 연결 상태를 확인하세요.

-**실행 실패:**
- 오류 세부 정보는 실행 로그 확인
- 개발 중인 경우 입력에 올바른 페이로드가 포함된 `crewai_trigger_payload` 매개변수가 포함되어 있는지 확인
+**실행 중 오류가 발생하나요?**
+- 실행 로그에서 오류 메시지를 확인하세요.
+- 개발 중이라면 `crewai_trigger_payload`가 올바른 데이터로 전달되고 있는지 확인하세요.

-자동화 트리거는 CrewAI 배포를 기존 비즈니스 프로세스 및 도구와 완벽하게 통합할 수 있는 반응형 이벤트 기반 시스템으로 변환합니다.
+트리거를 활용하면 CrewAI 자동화를 이벤트 기반 시스템으로 전환하여 기존 비즈니스 프로세스와 도구에 자연스럽게 녹여낼 수 있습니다.
+
+<Callout icon="github" title="예제 저장소">
+  <a href="https://github.com/crewAIInc/crewai-enterprise-trigger-examples">
+    CrewAI AMP Trigger Examples
+  </a>
+</Callout>