adjust aop to amp docs lang (#4179)

* adjust aop to amp docs lang * whoop no print
2026-01-26 16:48:13 +00:00 · 2026-01-05 15:30:21 -08:00
parent f8deb0fd18
commit 25c0c030ce
203 changed files with 5176 additions and 2715 deletions
--- a/docs/ko/enterprise/features/rbac.mdx
+++ b/docs/ko/enterprise/features/rbac.mdx
@@ -10,7 +10,7 @@ mode: "wide"
 CrewAI AOP의 RBAC는 **조직 수준 역할**과 **자동화(Automation) 수준 가시성**을 결합하여 안전하고 확장 가능한 접근 제어를 제공합니다.

 <Frame>
-  <img src="/images/enterprise/users_and_roles.png" alt="CrewAI AOP RBAC 개요" />
+  <img src="/images/enterprise/users_and_roles.png" alt="CrewAI AMP RBAC 개요" />

 </Frame>

@@ -31,7 +31,8 @@ CrewAI AOP의 RBAC는 **조직 수준 역할**과 **자동화(Automation) 수준
    <b>Settings → Roles</b>로 이동합니다.
  </Step>
  <Step title="역할 선택">
-    <b>Owner</b> 또는 <b>Member</b>를 사용하거나 <b>Create role</b>로 커스텀 역할을 만듭니다.
+    <b>Owner</b> 또는 <b>Member</b>를 사용하거나 <b>Create role</b>로 커스텀
+    역할을 만듭니다.
  </Step>
  <Step title="멤버에 할당">
    사용자들을 선택하여 역할을 지정합니다. 언제든 변경할 수 있습니다.
@@ -40,9 +41,9 @@ CrewAI AOP의 RBAC는 **조직 수준 역할**과 **자동화(Automation) 수준

 ### 구성 요약

-| 영역 | 위치 | 옵션 |
-|:---|:---|:---|
-| 사용자 & 역할 | Settings → Roles | Owner, Member; 커스텀 역할 |
+| 영역          | 위치                               | 옵션                              |
+| :------------ | :--------------------------------- | :-------------------------------- |
+| 사용자 & 역할 | Settings → Roles                   | Owner, Member; 커스텀 역할        |
 | 자동화 가시성 | Automation → Settings → Visibility | Private; 사용자/역할 화이트리스트 |

 ## 자동화 수준 접근 제어
@@ -82,21 +83,26 @@ Private 모드에서는 화이트리스트에 포함된 사용자/역할만 다

 ### Private 모드 접근 결과

-| 동작 | Owner | 화이트리스트 사용자/역할 | 비포함 |
-|:---|:---|:---|:---|
-| 자동화 보기 | ✓ | ✓ | ✗ |
-| 실행/API | ✓ | ✓ | ✗ |
-| 로그/메트릭/설정 | ✓ | ✓ | ✗ |
+| 동작             | Owner | 화이트리스트 사용자/역할 | 비포함 |
+| :--------------- | :---- | :----------------------- | :----- |
+| 자동화 보기      | ✓     | ✓                        | ✗      |
+| 실행/API         | ✓     | ✓                        | ✗      |
+| 로그/메트릭/설정 | ✓     | ✓                        | ✗      |

 <Tip>
-Owner는 항상 접근 가능하며, Private 모드에서는 화이트리스트에 포함된 사용자/역할만 권한이 부여됩니다.
+  Owner는 항상 접근 가능하며, Private 모드에서는 화이트리스트에 포함된
+  사용자/역할만 권한이 부여됩니다.
 </Tip>

 <Frame>
-  <img src="/images/enterprise/visibility.png" alt="CrewAI AOP 가시성 설정" />
+  <img src="/images/enterprise/visibility.png" alt="CrewAI AMP 가시성 설정" />

 </Frame>

-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
+<Card
+  title="도움이 필요하신가요?"
+  icon="headset"
+  href="mailto:support@crewai.com"
+>
  RBAC 구성과 점검에 대한 지원이 필요하면 연락해 주세요.
 </Card>
--- a/docs/ko/enterprise/features/tools-and-integrations.mdx
+++ b/docs/ko/enterprise/features/tools-and-integrations.mdx
@@ -9,221 +9,221 @@ mode: "wide"

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

-<Frame>
-  ![도구 & 통합 개요](/images/enterprise/crew_connectors.png)
-</Frame>
+<Frame>![도구 & 통합 개요](/images/enterprise/crew_connectors.png)</Frame>

 ## 살펴보기

 <Tabs>
  <Tab title="통합" icon="plug">

-  ## 에이전트 앱 (통합)
+## 에이전트 앱 (통합)

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

-  <Steps>
-    <Step title="연결">
-      원하는 앱에서 <b>Connect</b>를 클릭하고 OAuth를 완료합니다.
-    </Step>
-    <Step title="구성">
-      필요에 따라 스코프, 트리거, 사용 가능한 액션을 조정합니다.
-    </Step>
-    <Step title="에이전트에서 사용">
-      연결된 서비스는 에이전트 도구로 사용 가능합니다.
-    </Step>
-  </Steps>
+{" "}
+<Steps>
+  <Step title="연결">
+    원하는 앱에서 <b>Connect</b>를 클릭하고 OAuth를 완료합니다.
+  </Step>
+  <Step title="구성">
+    필요에 따라 스코프, 트리거, 사용 가능한 액션을 조정합니다.
+  </Step>
+  <Step title="에이전트에서 사용">
+    연결된 서비스는 에이전트 도구로 사용 가능합니다.
+  </Step>
+</Steps>

-  <Frame>
-    ![앱 그리드](/images/enterprise/agent-apps.png)
-  </Frame>
+{" "}
+<Frame>![앱 그리드](/images/enterprise/agent-apps.png)</Frame>

-  ### 계정 연결하기
+### 계정 연결하기

-  1. <Link href="https://app.crewai.com/crewai_plus/connectors">Integrations</Link>로 이동
-  2. 원하는 서비스에서 <b>Connect</b> 클릭
-  3. OAuth 플로우 완료 및 스코프 승인
-  4. <Link href="https://app.crewai.com/crewai_plus/settings/integrations">통합 설정</Link>에서 Enterprise Token 복사
+1. <Link href="https://app.crewai.com/crewai_plus/connectors">
+     Integrations
+   </Link>
+   로 이동
+2. 원하는 서비스에서 <b>Connect</b> 클릭
+3. OAuth 플로우 완료 및 스코프 승인
+4. <Link href="https://app.crewai.com/crewai_plus/settings/integrations">
+     통합 설정
+   </Link>
+   에서 Enterprise Token 복사

-  <Frame>
-    ![Enterprise Token](/images/enterprise/enterprise_action_auth_token.png)
-  </Frame>
+{" "}
+<Frame>
+  ![Enterprise Token](/images/enterprise/enterprise_action_auth_token.png)
+</Frame>

-  ### 통합 도구 설치
+### 통합 도구 설치

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

-  ```bash
-  uv add crewai-tools
-  ```
+```bash
+uv add crewai-tools
+```

-  ### 환경 변수 설정
+### 환경 변수 설정

-  <Note>
-    `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
-  </Note>
+{" "}
+<Note>
+  `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
+  `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
+</Note>

-  ```bash
-  export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
-  ```
+```bash
+export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
+```

-  또는 `.env` 파일에 추가하세요:
+또는 `.env` 파일에 추가하세요:

-  ```
-  CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
-  ```
+```
+CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
+```

-  ### 사용 예시
+### 사용 예시

-  <Tip>
-    새로운 간소화된 접근 방식을 사용하여 엔터프라이즈 앱을 통합하세요. Agent 구성에서 앱과 해당 액션을 직접 지정하기만 하면 됩니다.
-  </Tip>
+{" "}
+<Tip>
+  새로운 간소화된 접근 방식을 사용하여 엔터프라이즈 앱을 통합하세요. Agent
+  구성에서 앱과 해당 액션을 직접 지정하기만 하면 됩니다.
+</Tip>

-  ```python
-  from crewai import Agent, Task, Crew
+```python
+from crewai import Agent, Task, Crew

-  # Gmail 기능을 가진 에이전트 생성
-  email_agent = Agent(
-      role="이메일 매니저",
-      goal="이메일 커뮤니케이션 관리",
-      backstory="이메일 관리에 특화된 AI 어시스턴트",
-      apps=['gmail', 'gmail/send_email']  # 정식 이름 'gmail' 사용
-  )
+# Gmail 기능을 가진 에이전트 생성
+email_agent = Agent(
+    role="이메일 매니저",
+    goal="이메일 커뮤니케이션 관리",
+    backstory="이메일 관리에 특화된 AI 어시스턴트",
+    apps=['gmail', 'gmail/send_email']  # 정식 이름 'gmail' 사용
+)

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

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

-  ### 도구 필터링
+### 도구 필터링

-  ```python
-  from crewai import Agent, Task, Crew
+```python
+from crewai import Agent, Task, Crew

-  # 특정 Gmail 액션만 사용하는 에이전트 생성
-  gmail_agent = Agent(
-      role="Gmail 매니저",
-      goal="Gmail 커뮤니케이션 및 알림 관리",
-      backstory="Gmail 커뮤니케이션 조율 AI 어시스턴트",
-      apps=['gmail/fetch_emails']  # 정식 이름과 특정 액션 사용
-  )
+# 특정 Gmail 액션만 사용하는 에이전트 생성
+gmail_agent = Agent(
+    role="Gmail 매니저",
+    goal="Gmail 커뮤니케이션 및 알림 관리",
+    backstory="Gmail 커뮤니케이션 조율 AI 어시스턴트",
+    apps=['gmail/fetch_emails']  # 정식 이름과 특정 액션 사용
+)

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

-  crew = Crew(agents=[gmail_agent], tasks=[notification_task])
-  ```
+crew = Crew(agents=[gmail_agent], tasks=[notification_task])
+```

-  배포된 크루에서는 각 통합의 서비스 설정 페이지에서 사용 가능한 액션을 지정할 수 있습니다.
+배포된 크루에서는 각 통합의 서비스 설정 페이지에서 사용 가능한 액션을 지정할 수 있습니다.

-  <Frame>
-    ![액션 필터링](/images/enterprise/filtering_enterprise_action_tools.png)
-  </Frame>
+{" "}
+<Frame>
+  ![액션 필터링](/images/enterprise/filtering_enterprise_action_tools.png)
+</Frame>

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

-  각 통합을 특정 사용자로 범위 지정할 수 있습니다 (예: 특정 사용자의 Gmail 계정 사용).
+각 통합을 특정 사용자로 범위 지정할 수 있습니다 (예: 특정 사용자의 Gmail 계정 사용).

-  <Tip>
-    팀/사용자별 데이터 접근을 분리해야 할 때 유용합니다.
-  </Tip>
+{" "}
+<Tip>팀/사용자별 데이터 접근을 분리해야 할 때 유용합니다.</Tip>

-  `user_bearer_token`을 사용해 요청 사용자로 인증을 범위 지정합니다. 사용자가 로그인하지 않은 경우 연결된 통합을 사용하지 않으며, 그렇지 않으면 배포에 설정된 기본 토큰을 사용합니다.
+`user_bearer_token`을 사용해 요청 사용자로 인증을 범위 지정합니다. 사용자가 로그인하지 않은 경우 연결된 통합을 사용하지 않으며, 그렇지 않으면 배포에 설정된 기본 토큰을 사용합니다.

-  <Frame>
-    ![사용자 토큰](/images/enterprise/user_bearer_token.png)
-  </Frame>
+{" "}
+<Frame>![사용자 토큰](/images/enterprise/user_bearer_token.png)</Frame>

-  <div id="catalog"></div>
-  ### 카탈로그
+{" "}
+<div id="catalog"></div>
+### 카탈로그

-  #### 커뮤니케이션 & 협업
-  - Gmail — 이메일 및 초안 관리
-  - Slack — 워크스페이스 알림 및 경보
-  - Microsoft — Office 365 및 Teams 통합
+#### 커뮤니케이션 & 협업

-  #### 프로젝트 관리
-  - Jira — 이슈 추적 및 프로젝트 관리
-  - ClickUp — 작업 및 생산성 관리
-  - Asana — 팀 작업 조율
-  - Notion — 페이지 및 데이터베이스 관리
-  - Linear — 버그/프로젝트 추적
-  - GitHub — 리포지토리 및 이슈 관리
+- Gmail — 이메일 및 초안 관리
+- Slack — 워크스페이스 알림 및 경보
+- Microsoft — Office 365 및 Teams 통합

-  #### CRM
-  - Salesforce — 계정 및 기회 관리
-  - HubSpot — 파이프라인/연락처 관리
-  - Zendesk — 고객 지원 티켓 관리
+#### 프로젝트 관리

-  #### 비즈니스 & 금융
-  - Stripe — 결제 처리 및 고객 관리
-  - Shopify — 전자상거래 및 상품 관리
+- Jira — 이슈 추적 및 프로젝트 관리
+- ClickUp — 작업 및 생산성 관리
+- Asana — 팀 작업 조율
+- Notion — 페이지 및 데이터베이스 관리
+- Linear — 버그/프로젝트 추적
+- GitHub — 리포지토리 및 이슈 관리

-  #### 생산성 & 스토리지
-  - Google Sheets — 스프레드시트 동기화
-  - Google Calendar — 일정/이벤트 관리
-  - Box — 파일 스토리지
+#### CRM

-  …더 많은 통합이 추가될 예정입니다!
+- Salesforce — 계정 및 기회 관리
+- HubSpot — 파이프라인/연락처 관리
+- Zendesk — 고객 지원 티켓 관리
+
+#### 비즈니스 & 금융
+
+- Stripe — 결제 처리 및 고객 관리
+- Shopify — 전자상거래 및 상품 관리
+
+#### 생산성 & 스토리지
+
+- Google Sheets — 스프레드시트 동기화
+- Google Calendar — 일정/이벤트 관리
+- Box — 파일 스토리지
+
+…더 많은 통합이 추가될 예정입니다!

  </Tab>
  <Tab title="내부 도구" icon="toolbox">

-  ## 내부 도구
+## 내부 도구

-  로컬에서 도구를 만들고, CrewAI AOP 도구 저장소에 게시한 후, 에이전트에서 사용하세요.
+로컬에서 도구를 만들고, CrewAI AMP 도구 저장소에 게시한 후, 에이전트에서 사용하세요.

-  <Tip>
-  아래 명령을 실행하기 전에 CrewAI AOP 계정에 로그인하세요:
-    ```bash
-    crewai login
-    ```
-  </Tip>
+{" "}
+<Tip>
+  아래 명령을 실행하기 전에 CrewAI AMP 계정에 로그인하세요: ```bash crewai login```
+</Tip>

-  <Frame>
-    ![내부 도구](/images/enterprise/tools-integrations-internal.png)
-  </Frame>
+{" "}
+<Frame>![내부 도구](/images/enterprise/tools-integrations-internal.png)</Frame>

-  <Steps>
-    <Step title="생성">
-      로컬에서 새 도구 생성
-      ```bash
-      crewai tool create your-tool
-      ```
-    </Step>
-    <Step title="게시">
-      도구 저장소에 게시
-      ```bash
-      crewai tool publish
-      ```
-    </Step>
-    <Step title="설치">
-      도구 저장소에서 설치
-      ```bash
-      crewai tool install your-tool
-      ```
-    </Step>
-  </Steps>
+{" "}
+<Steps>
+  <Step title="생성">
+    로컬에서 새 도구 생성 ```bash crewai tool create your-tool ```
+  </Step>
+  <Step title="게시">도구 저장소에 게시 ```bash crewai tool publish ```</Step>
+  <Step title="설치">
+    도구 저장소에서 설치 ```bash crewai tool install your-tool ```
+  </Step>
+</Steps>

-  관리:
+관리:

-  - 이름 및 설명
-  - 가시성 (비공개 / 공개)
-  - 필요한 환경 변수
-  - 버전 이력 및 다운로드
-  - 팀/역할 접근 권한
+- 이름 및 설명
+- 가시성 (비공개 / 공개)
+- 필요한 환경 변수
+- 버전 이력 및 다운로드
+- 팀/역할 접근 권한

-  <Frame>
-    ![도구 설정](/images/enterprise/tool-configs.png)
-  </Frame>
+{" "}
+<Frame>![도구 설정](/images/enterprise/tool-configs.png)</Frame>

  </Tab>
 </Tabs>
@@ -231,10 +231,18 @@ mode: "wide"
 ## 관련 문서

 <CardGroup cols={2}>
-  <Card title="도구 저장소" href="/ko/enterprise/guides/tool-repository" icon="toolbox">
+  <Card
+    title="도구 저장소"
+    href="/ko/enterprise/guides/tool-repository"
+    icon="toolbox"
+  >
    크루 기능을 확장할 수 있도록 도구를 게시하고 설치하세요.
  </Card>
-  <Card title="Webhook 자동화" href="/ko/enterprise/guides/webhook-automation" icon="bolt">
+  <Card
+    title="Webhook 자동화"
+    href="/ko/enterprise/guides/webhook-automation"
+    icon="bolt"
+  >
    워크플로를 자동화하고 외부 플랫폼/서비스와 통합하세요.
  </Card>
 </CardGroup>
--- a/docs/ko/enterprise/features/traces.mdx
+++ b/docs/ko/enterprise/features/traces.mdx
@@ -20,15 +20,13 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출
 - 실행 시간
 - 비용 추정치

-<Frame>
-  ![Traces Overview](/images/enterprise/traces-overview.png)
-</Frame>
+<Frame>![Traces Overview](/images/enterprise/traces-overview.png)</Frame>

 ## 트레이스(Traces) 접근하기

 <Steps>
  <Step title="트레이스 탭으로 이동">
-    CrewAI AOP 대시보드에 들어가면, **트레이스**를 클릭하여 모든 실행 기록을 볼 수 있습니다.
+    CrewAI AMP 대시보드에 들어가면, **트레이스**를 클릭하여 모든 실행 기록을 볼 수 있습니다.
  </Step>

  <Step title="실행 선택하기">
@@ -51,9 +49,7 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출
 - **실행 시간**: crew 런의 전체 소요 시간
 - **예상 비용**: 토큰 사용량을 기반으로 한 대략적인 비용

-<Frame>
-  ![Execution Summary](/images/enterprise/trace-summary.png)
-</Frame>
+<Frame>![Execution Summary](/images/enterprise/trace-summary.png)</Frame>

 ### 2. Tasks & Agents

@@ -64,33 +60,25 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출
 - 상태 (완료/실패)
 - task의 개별 실행 시간

-<Frame>
-  ![Task List](/images/enterprise/trace-tasks.png)
-</Frame>
+<Frame>![Task List](/images/enterprise/trace-tasks.png)</Frame>

 ### 3. 최종 결과

 모든 작업이 완료된 후 crew가 생성한 최종 결과를 표시합니다.

-<Frame>
-  ![최종 결과](/images/enterprise/final-output.png)
-</Frame>
+<Frame>![최종 결과](/images/enterprise/final-output.png)</Frame>

 ### 4. 실행 타임라인

 각 작업이 시작되고 종료된 시점을 시각적으로 표현하여 병목 현상이나 병렬 실행 패턴을 파악하는 데 도움이 됩니다.

-<Frame>
-  ![실행 타임라인](/images/enterprise/trace-timeline.png)
-</Frame>
+<Frame>![실행 타임라인](/images/enterprise/trace-timeline.png)</Frame>

 ### 5. 상세 작업 보기

 타임라인이나 작업 목록에서 특정 작업을 클릭하면 다음을 볼 수 있습니다:

-<Frame>
-  ![상세 작업 보기](/images/enterprise/trace-detailed-task.png)
-</Frame>
+<Frame>![상세 작업 보기](/images/enterprise/trace-detailed-task.png)</Frame>

 - **작업 키**: 작업의 고유 식별자
 - **작업 ID**: 시스템 내의 기술적 식별자
@@ -120,6 +108,7 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출
    <Frame>
      ![Failure Points](/images/enterprise/failure.png)
    </Frame>
+
  </Step>

  <Step title="성능 최적화">
@@ -129,6 +118,7 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출
    - 과도한 토큰 사용
    - 중복된 도구 작업
    - 불필요한 API 호출
+
  </Step>

  <Step title="비용 효율성 향상">
@@ -138,9 +128,15 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출
    - 프롬프트를 더 간결하게 다듬기
    - 자주 액세스하는 정보 캐싱
    - 중복 작업을 최소화하도록 작업 구조화하기
+
  </Step>
 </Steps>

-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
-  트레이스 분석이나 기타 CrewAI 엔터프라이즈 기능에 대한 지원이 필요하시면 저희 지원팀에 문의하세요.
+<Card
+  title="도움이 필요하신가요?"
+  icon="headset"
+  href="mailto:support@crewai.com"
+>
+  트레이스 분석이나 기타 CrewAI 엔터프라이즈 기능에 대한 지원이 필요하시면 저희
+  지원팀에 문의하세요.
 </Card>