andre/crewAI
1
0
Fork 0
mirror of https://github.com/crewAIInc/crewAI.git synced 2026-01-22 22:58:13 +00:00
Code Issues Actions 4 Packages Projects Releases Wiki Activity

adjust aop to amp docs lang (#4179)
Some checks failed
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
Details
CodeQL Advanced / Analyze (python) (push) Has been cancelled
Details
Check Documentation Broken Links / Check broken links (push) Has been cancelled
Details
Notify Downstream / notify-downstream (push) Has been cancelled
Details
Mark stale issues and pull requests / stale (push) Has been cancelled
Details

Browse Source 
* adjust aop to amp docs lang

* whoop no print
This commit is contained in:
Lorenze Jay
2026-01-05 15:30:21 -08:00
committed by GitHub
parent f8deb0fd18
commit 25c0c030ce
203 changed files with 5176 additions and 2715 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/ko/api-reference/introduction.mdx
View File

@@ -1,6 +1,6 @@
---
title: "소개"
description: "CrewAI AOP REST API에 대한 완벽한 참고 자료"
description: "CrewAI AMP REST API에 대한 완벽한 참고 자료"
icon: "code"
mode: "wide"
---
@@ -13,7 +13,7 @@ CrewAI 엔터프라이즈 API 참고 자료에 오신 것을 환영합니다.
<Steps>
<Step title="API 자격 증명 받기">
CrewAI AOP 대시보드에서 자신의 crew 상세 페이지로 이동하여 Status 탭에서 Bearer Token을 복사하세요.
CrewAI AMP 대시보드에서 자신의 crew 상세 페이지로 이동하여 Status 탭에서 Bearer Token을 복사하세요.
</Step>
<Step title="필수 입력값 확인하기">
@@ -47,7 +47,7 @@ curl -H "Authorization: Bearer YOUR_CREW_TOKEN" \
| **User Bearer Token** | 사용자 범위 접근 | 제한된 권한, 사용자별 작업에 적합 |
<Tip>
두 토큰 유형 모두 CrewAI AOP 대시보드의 crew 상세 페이지 Status 탭에서 확인할
두 토큰 유형 모두 CrewAI AMP 대시보드의 crew 상세 페이지 Status 탭에서 확인할
수 있습니다.
</Tip>
@@ -84,7 +84,7 @@ API는 표준 HTTP 상태 코드를 사용합니다:
## 인터랙티브 테스트
<Info>
**왜 "전송" 버튼이 없나요?** 각 CrewAI AOP 사용자는 고유한 crew URL을
**왜 "전송" 버튼이 없나요?** 각 CrewAI AMP 사용자는 고유한 crew URL을
가지므로, 혼동을 피하기 위해 인터랙티브 플레이그라운드 대신 **참조 모드**를
사용합니다. 이를 통해 비작동 전송 버튼 없이 요청이 어떻게 생겼는지 정확히
보여줍니다.

162
docs/ko/concepts/cli.mdx
View File

@@ -5,7 +5,12 @@ icon: terminal
mode: "wide"
---
<Warning>릴리즈 0.140.0부터 CrewAI AOP는 로그인 제공자 마이그레이션 프로세스를 시작했습니다. 이에 따라 CLI를 통한 인증 흐름이 업데이트되었습니다. Google을 통해 로그인하거나 2025년 7월 3일 이후에 계정을 생성한 사용자는 이전 버전의 `crewai` 라이브러리로는 로그인할 수 없습니다.</Warning>
<Warning>
릴리즈 0.140.0부터 CrewAI AOP는 로그인 제공자 마이그레이션 프로세스를
시작했습니다. 이에 따라 CLI를 통한 인증 흐름이 업데이트되었습니다. Google을
통해 로그인하거나 2025년 7월 3일 이후에 계정을 생성한 사용자는 이전 버전의
`crewai` 라이브러리로는 로그인할 수 없습니다.
</Warning>
## 개요
@@ -41,6 +46,7 @@ crewai create [OPTIONS] TYPE NAME
- `NAME`: crew 또는 flow의 이름
예시:
```shell Terminal
crewai create crew my_new_crew
crewai create flow my_new_flow
@@ -57,6 +63,7 @@ crewai version [OPTIONS]
- `--tools`: (선택 사항) 설치된 CrewAI tools의 버전을 표시합니다.
예시:
```shell Terminal
crewai version
crewai version --tools
@@ -74,6 +81,7 @@ crewai train [OPTIONS]
- `-f, --filename TEXT`: 훈련에 사용할 커스텀 파일의 경로 (기본값: "trained_agents_data.pkl")
예시:
```shell Terminal
crewai train -n 10 -f my_training_data.pkl
```
@@ -89,6 +97,7 @@ crewai replay [OPTIONS]
- `-t, --task_id TEXT`: 이 task ID에서부터 crew를 다시 재생하며, 이후의 모든 task를 포함합니다.
예시:
```shell Terminal
crewai replay -t task_123456
```
@@ -118,6 +127,7 @@ crewai reset-memories [OPTIONS]
- `-a, --all`: 모든 메모리 초기화
예시:
```shell Terminal
crewai reset-memories --long --short
crewai reset-memories --all
@@ -135,6 +145,7 @@ crewai test [OPTIONS]
- `-m, --model TEXT`: Crew에서 테스트를 실행할 LLM 모델 (기본값: "gpt-4o-mini")
예시:
```shell Terminal
crewai test -n 5 -m gpt-3.5-turbo
```
@@ -148,12 +159,14 @@ crewai run
```
<Note>
버전 0.103.0부터 `crewai run` 명령은 표준 crew와 flow 모두를 실행하는 데 사용할 수 있습니다. flow의 경우 pyproject.toml에서 유형을 자동으로 감지하여 적절한 명령을 실행합니다. 이제 crew와 flow 모두를 실행하는 권장 방법입니다.
버전 0.103.0부터 `crewai run` 명령은 표준 crew와 flow 모두를 실행하는 데
사용할 수 있습니다. flow의 경우 pyproject.toml에서 유형을 자동으로 감지하여
적절한 명령을 실행합니다. 이제 crew와 flow 모두를 실행하는 권장 방법입니다.
</Note>
<Note>
이 명령들은 CrewAI 프로젝트가 설정된 디렉터리에서 실행해야 합니다.
일부 명령은 프로젝트 구조 내에서 추가 구성 또는 설정이 필요할 수 있습니다.
이 명령들은 CrewAI 프로젝트가 설정된 디렉터리에서 실행해야 합니다. 일부 명령은
프로젝트 구조 내에서 추가 구성 또는 설정이 필요할 수 있습니다.
</Note>
### 9. Chat
@@ -165,6 +178,7 @@ crewai run
```shell Terminal
crewai chat
```
<Note>
이 명령어들은 CrewAI 프로젝트의 루트 디렉터리에서 실행해야 합니다.
</Note>
@@ -182,28 +196,30 @@ def crew(self) -> Crew:
chat_llm="gpt-4o", # LLM for chat orchestration
)
```
</Note>
### 10. 배포
crew 또는 flow를 [CrewAI AOP](https://app.crewai.com)에 배포하세요.
crew 또는 flow를 [CrewAI AMP](https://app.crewai.com)에 배포하세요.
- **인증**: CrewAI AOP에 배포하려면 인증이 필요합니다.
아래 명령어로 로그인하거나 계정을 생성할 수 있습니다:
```shell Terminal
crewai login
```
아래 명령어로 로그인하거나 계정을 생성할 수 있습니다:
```shell Terminal
crewai login
```
- **배포 생성**: 인증이 완료되면, 로컬 프로젝트의 루트에서 crew 또는 flow에 대한 배포를 생성할 수 있습니다.
```shell Terminal
crewai deploy create
```
- 로컬 프로젝트 구성을 읽어옵니다.
- 로컬에서 확인된 환경 변수(`OPENAI_API_KEY`, `SERPER_API_KEY` 등)를 확인하도록 안내합니다. 이 변수들은 Enterprise 플랫폼에 배포할 때 안전하게 저장됩니다. 실행 전에 중요한 키가 로컬(예: `.env` 파일)에 올바르게 구성되어 있는지 확인하세요.
```shell Terminal
crewai deploy create
```
- 로컬 프로젝트 구성을 읽어옵니다.
- 로컬에서 확인된 환경 변수(`OPENAI_API_KEY`, `SERPER_API_KEY` 등)를 확인하도록 안내합니다. 이 변수들은 Enterprise 플랫폼에 배포할 때 안전하게 저장됩니다. 실행 전에 중요한 키가 로컬(예: `.env` 파일)에 올바르게 구성되어 있는지 확인하세요.
### 11. 조직 관리
CrewAI AOP 조직을 관리합니다.
CrewAI AMP 조직을 관리합니다.
```shell Terminal
crewai org [COMMAND] [OPTIONS]
@@ -212,65 +228,79 @@ crewai org [COMMAND] [OPTIONS]
#### 명령어:
- `list`: 사용자가 속한 모든 조직을 나열합니다.
```shell Terminal
crewai org list
```
- `current`: 현재 활성화된 조직을 표시합니다.
```shell Terminal
crewai org current
```
- `switch`: 특정 조직으로 전환합니다.
```shell Terminal
crewai org switch <organization_id>
```
<Note>
이러한 조직 관리 명령어를 사용하려면 CrewAI AOP에 인증되어 있어야 합니다.
이러한 조직 관리 명령어를 사용하려면 CrewAI AOP에 인증되어 있어야 합니다.
</Note>
- **배포 생성** (계속):
- 배포를 해당 원격 GitHub 저장소에 연결합니다 (일반적으로 자동으로 감지됩니다).
- 배포를 해당 원격 GitHub 저장소에 연결합니다 (일반적으로 자동으로 감지됩니다).
- **Crew 배포**: 인증이 완료되면 crew 또는 flow를 CrewAI AOP에 배포할 수 있습니다.
```shell Terminal
crewai deploy push
```
- CrewAI AOP 플랫폼에서 배포 프로세스를 시작합니다.
- 성공적으로 시작되면, Deployment created successfully! 메시지와 함께 Deployment Name 및 고유한 Deployment ID(UUID)가 출력됩니다.
```shell Terminal
crewai deploy push
```
- CrewAI AMP 플랫폼에서 배포 프로세스를 시작합니다.
- 성공적으로 시작되면, Deployment created successfully! 메시지와 함께 Deployment Name 및 고유한 Deployment ID(UUID)가 출력됩니다.
- **배포 상태**: 배포 상태를 확인하려면 다음을 사용합니다:
```shell Terminal
crewai deploy status
```
이 명령은 가장 최근의 배포 시도에 대한 최신 배포 상태(예: `Building Images for Crew`, `Deploy Enqueued`, `Online`)를 가져옵니다.
```shell Terminal
crewai deploy status
```
이 명령은 가장 최근의 배포 시도에 대한 최신 배포 상태(예: `Building Images for Crew`, `Deploy Enqueued`, `Online`)를 가져옵니다.
- **배포 로그**: 배포 로그를 확인하려면 다음을 사용합니다:
```shell Terminal
crewai deploy logs
```
이 명령은 배포 로그를 터미널로 스트리밍합니다.
```shell Terminal
crewai deploy logs
```
이 명령은 배포 로그를 터미널로 스트리밍합니다.
- **배포 목록**: 모든 배포를 나열하려면 다음을 사용합니다:
```shell Terminal
crewai deploy list
```
이 명령은 모든 배포를 나열합니다.
```shell Terminal
crewai deploy list
```
이 명령은 모든 배포를 나열합니다.
- **배포 삭제**: 배포를 삭제하려면 다음을 사용합니다:
```shell Terminal
crewai deploy remove
```
이 명령은 CrewAI AOP 플랫폼에서 배포를 삭제합니다.
```shell Terminal
crewai deploy remove
```
이 명령은 CrewAI AMP 플랫폼에서 배포를 삭제합니다.
- **도움말 명령어**: CLI에 대한 도움말을 보려면 다음을 사용합니다:
```shell Terminal
crewai deploy --help
```
이 명령은 CrewAI Deploy CLI에 대한 도움말 메시지를 표시합니다.
```shell Terminal
crewai deploy --help
```
이 명령은 CrewAI Deploy CLI에 대한 도움말 메시지를 표시합니다.
CLI를 사용하여 [CrewAI AOP](http://app.crewai.com)에 crew를 배포하는 단계별 시연은 아래 비디오 튜토리얼을 참조하십시오.
CLI를 사용하여 [CrewAI AMP](http://app.crewai.com)에 crew를 배포하는 단계별 시연은 아래 비디오 튜토리얼을 참조하십시오.
<iframe
className="w-full aspect-video rounded-xl"
@@ -283,7 +313,7 @@ CLI를 사용하여 [CrewAI AOP](http://app.crewai.com)에 crew를 배포하는
### 11. API 키
```crewai create crew``` 명령어를 실행하면, CLI에서 선택할 수 있는 LLM 제공업체 목록이 표시되고, 그 다음으로 선택한 제공업체에 대한 모델 선택이 이어집니다.
`crewai create crew` 명령어를 실행하면, CLI에서 선택할 수 있는 LLM 제공업체 목록이 표시되고, 그 다음으로 선택한 제공업체에 대한 모델 선택이 이어집니다.
LLM 제공업체와 모델을 선택하면, API 키를 입력하라는 메시지가 표시됩니다.
@@ -291,11 +321,11 @@ LLM 제공업체와 모델을 선택하면, API 키를 입력하라는 메시지
다음은 CLI에서 제안하는 가장 인기 있는 LLM 공급자 목록입니다:
* OpenAI
* Groq
* Anthropic
* Google Gemini
* SambaNova
- OpenAI
- Groq
- Anthropic
- Google Gemini
- SambaNova
공급자를 선택하면, CLI가 해당 공급자에서 사용 가능한 모델을 보여주고 API 키 입력을 요청합니다.
@@ -307,7 +337,7 @@ LLM 제공업체와 모델을 선택하면, API 키를 입력하라는 메시지
각 공급자의 Key 이름은 다음 링크에서 확인할 수 있습니다:
* [LiteLLM 공급자](https://docs.litellm.ai/docs/providers)
- [LiteLLM 공급자](https://docs.litellm.ai/docs/providers)
### 12. 구성 관리
@@ -320,23 +350,26 @@ crewai config [COMMAND] [OPTIONS]
#### 명령어:
- `list`: 모든 CLI 구성 매개변수 표시
```shell Terminal
crewai config list
```
- `set`: CLI 구성 매개변수 설정
```shell Terminal
crewai config set <key> <value>
```
- `reset`: 모든 CLI 구성 매개변수를 기본값으로 초기화
```shell Terminal
crewai config reset
```
#### 사용 가능한 구성 파라미터
- `enterprise_base_url`: CrewAI AOP 인스턴스의 기본 URL
- `enterprise_base_url`: CrewAI AMP 인스턴스의 기본 URL
- `oauth2_provider`: 인증에 사용되는 OAuth2 공급자 (예: workos, okta, auth0)
- `oauth2_audience`: OAuth2 audience 값으로, 일반적으로 대상 API 또는 리소스를 식별하는 데 사용됨
- `oauth2_client_id`: 인증 요청 시 사용되는 공급자가 발급한 OAuth2 클라이언트 ID
@@ -345,42 +378,49 @@ crewai config reset
#### 예시
현재 설정 표시:
```shell Terminal
crewai config list
```
예시 출력:
| 설정 | 값 | 설명 |
| :------------------- | :---------------------- | :------------------------------------------------------------------- |
| enterprise_base_url | https://app.crewai.com | CrewAI AOP 인스턴스의 기본 URL |
| org_name | Not set | 현재 활성화된 조직의 이름 |
| org_uuid | Not set | 현재 활성화된 조직의 UUID |
| oauth2_provider | workos | 인증에 사용되는 OAuth2 제공자 (예: workos, okta, auth0) |
| oauth2_audience | client_01YYY | 일반적으로 대상 API/리소스를 식별하는 데 사용되는 OAuth2 audience 값 |
| oauth2_client_id | client_01XXX | 제공자로부터 발급된 OAuth2 client ID (인증 요청 시 사용) |
| oauth2_domain | login.crewai.com | OAuth2 제공자의 도메인 (예: your-org.auth0.com) |
| 설정 | 값 | 설명 |
| :------------------ | :--------------------- | :------------------------------------------------------------------- |
| enterprise_base_url | https://app.crewai.com | CrewAI AMP 인스턴스의 기본 URL |
| org_name | Not set | 현재 활성화된 조직의 이름 |
| org_uuid | Not set | 현재 활성화된 조직의 UUID |
| oauth2_provider | workos | 인증에 사용되는 OAuth2 제공자 (예: workos, okta, auth0) |
| oauth2_audience | client_01YYY | 일반적으로 대상 API/리소스를 식별하는 데 사용되는 OAuth2 audience 값 |
| oauth2_client_id | client_01XXX | 제공자로부터 발급된 OAuth2 client ID (인증 요청 시 사용) |
| oauth2_domain | login.crewai.com | OAuth2 제공자의 도메인 (예: your-org.auth0.com) |
엔터프라이즈 기본 URL 설정:
```shell Terminal
crewai config set enterprise_base_url https://my-enterprise.crewai.com
```
OAuth2 제공자 설정:
```shell Terminal
crewai config set oauth2_provider auth0
```
OAuth2 도메인 설정:
```shell Terminal
crewai config set oauth2_domain my-company.auth0.com
```
모든 설정을 기본값으로 재설정:
```shell Terminal
crewai config reset
```
<Note>
설정 값은 `~/.config/crewai/settings.json`에 저장됩니다. 조직 이름과 UUID와 같은 일부 설정 값은 읽기 전용이며 인증 및 조직 명령을 통해 관리됩니다. 도구 저장소 관련 설정은 숨겨져 있으며 사용자가 직접 설정할 수 없습니다.
설정 값은 `~/.config/crewai/settings.json`에 저장됩니다. 조직 이름과 UUID와
같은 일부 설정 값은 읽기 전용이며 인증 및 조직 명령을 통해 관리됩니다. 도구
저장소 관련 설정은 숨겨져 있으며 사용자가 직접 설정할 수 없습니다.
</Note>

32
docs/ko/enterprise/features/rbac.mdx
View File

@@ -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>

330
docs/ko/enterprise/features/tools-and-integrations.mdx
View File

@@ -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>

38
docs/ko/enterprise/features/traces.mdx
View File

@@ -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>

86
docs/ko/enterprise/guides/automation-triggers.mdx
View File

@@ -1,11 +1,11 @@
---
title: "트리거 개요"
description: "CrewAI AOP 트리거의 동작 방식과 관리 방법, 그리고 통합별 플레이북을 한눈에 확인하세요"
description: "CrewAI AMP 트리거의 동작 방식과 관리 방법, 그리고 통합별 플레이북을 한눈에 확인하세요"
icon: "bolt"
mode: "wide"
---
CrewAI AOP 트리거는 팀이 이미 사용하고 있는 도구의 실시간 이벤트와 자동화를 연결합니다. 폴링이나 수동 실행 대신, 트리거는 새로운 이메일, 캘린더 업데이트, CRM 상태 변화 등을 감지하여 지정한 크루 또는 플로우를 즉시 실행합니다.
CrewAI AMP 트리거는 팀이 이미 사용하고 있는 도구의 실시간 이벤트와 자동화를 연결합니다. 폴링이나 수동 실행 대신, 트리거는 새로운 이메일, 캘린더 업데이트, CRM 상태 변화 등을 감지하여 지정한 크루 또는 플로우를 즉시 실행합니다.
<iframe
className="w-full aspect-video rounded-xl"
@@ -25,37 +25,61 @@ CrewAI AOP 트리거는 팀이 이미 사용하고 있는 도구의 실시간
<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 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="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="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="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="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="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="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="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>
@@ -77,7 +101,10 @@ CrewAI AOP 트리거는 팀이 이미 사용하고 있는 도구의 실시간
2. **Triggers** 탭을 클릭하여 사용 가능한 통합을 확인합니다.
<Frame>
<img src="/images/enterprise/list-available-triggers.png" alt="사용 가능한 트리거 목록" />
<img
src="/images/enterprise/list-available-triggers.png"
alt="사용 가능한 트리거 목록"
/>
</Frame>
### 트리거 활성화/비활성화
@@ -123,6 +150,7 @@ crewai triggers list
```
이 명령은 연결된 통합을 기반으로 사용 가능한 모든 트리거를 표시합니다:
- 통합 이름 및 연결 상태
- 사용 가능한 트리거 유형
- 트리거 이름 및 설명
@@ -142,6 +170,7 @@ crewai triggers run microsoft_onedrive/file_changed
```
이 명령은:
- 로컬에서 크루를 실행합니다
- 완전하고 실제적인 트리거 payload를 전달합니다
- 프로덕션에서 크루가 호출되는 방식을 정확히 시뮬레이션합니다
@@ -221,17 +250,20 @@ def delegate_to_crew(self, crewai_trigger_payload: dict = None):
## 문제 해결
**트리거가 실행되지 않나요?**
- 배포의 Triggers 탭에서 트리거가 활성화되어 있는지 확인하세요
- Tools & Integrations에서 통합 연결 상태를 확인하세요
- 필요한 모든 환경 변수가 올바르게 구성되어 있는지 확인하세요
**실행 중 오류가 발생하나요?**
- 실행 로그에서 오류 세부 정보를 확인하세요
- `crewai triggers run <트리거_이름>`을 사용하여 로컬에서 테스트하고 정확한 payload 구조를 확인하세요
- 크루가 `crewai_trigger_payload` 매개변수를 처리할 수 있는지 확인하세요
- 크루가 트리거 payload에 포함되지 않은 매개변수를 기대하지 않는지 확인하세요
**개발 문제:**
- 배포하기 전에 항상 `crewai triggers run <trigger>`로 테스트하여 전체 payload를 확인하세요
- `crewai run`은 트리거 호출을 시뮬레이션하지 않으므로 `crewai triggers run`을 대신 사용하세요
- `crewai triggers list`를 사용하여 연결된 통합에 사용 가능한 트리거를 확인하세요

8
docs/ko/enterprise/guides/azure-openai-setup.mdx
View File

@@ -19,8 +19,8 @@ mode: "wide"
</Frame>
</Step>
<Step title="CrewAI AOP 연결 구성">
4. 다른 탭에서 `CrewAI AOP > LLM Connections`를 엽니다. LLM Connection에 이름을 지정하고, 공급자로 Azure를 선택한 다음, Azure에서 선택한 것과 동일한 모델을 선택하세요.
<Step title="CrewAI AMP 연결 구성">
4. 다른 탭에서 `CrewAI AMP > LLM Connections`를 엽니다. LLM Connection에 이름을 지정하고, 공급자로 Azure를 선택한 다음, Azure에서 선택한 것과 동일한 모델을 선택하세요.
5. 같은 페이지에서 3단계에서 가져온 환경 변수를 추가하세요:
- 하나는 `AZURE_DEPLOYMENT_TARGET_URL` (Target URI 사용)로 명명합니다. URL은 다음과 같이 표시됩니다: https://your-deployment.openai.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2024-08-01-preview
- 다른 하나는 `AZURE_API_KEY` (Key 사용)로 명명합니다.
@@ -28,7 +28,7 @@ mode: "wide"
</Step>
<Step title="기본 구성 설정">
7. `CrewAI AOP > Settings > Defaults > Crew Studio LLM Settings`에서 새 LLM Connection과 모델을 기본값으로 설정합니다.
7. `CrewAI AMP > Settings > Defaults > Crew Studio LLM Settings`에서 새 LLM Connection과 모델을 기본값으로 설정합니다.
</Step>
<Step title="네트워크 액세스 구성">
@@ -37,6 +37,7 @@ mode: "wide"
- `Resource Management > Networking`으로 이동합니다.
- `Allow access from all networks`가 활성화되어 있는지 확인하세요. 이 설정이 제한되어 있으면 CrewAI가 Azure OpenAI 엔드포인트에 접근하지 못할 수 있습니다.
</Step>
</Steps>
## 확인
@@ -46,6 +47,7 @@ mode: "wide"
## 문제 해결
문제가 발생한 경우:
- Target URI 형식이 예상 패턴과 일치하는지 확인하세요
- API 키가 올바르고 적절한 권한을 가지고 있는지 확인하세요
- 네트워크 액세스가 CrewAI 연결을 허용하도록 구성되어 있는지 확인하세요

12
docs/ko/enterprise/guides/build-crew.mdx
View File

@@ -7,7 +7,7 @@ mode: "wide"
## 개요
[CrewAI AOP](https://app.crewai.com)는 프로덕션 환경에서 AI 에이전트를 **생성**, **배포** 및 **관리**하는 과정을 간소화합니다.
[CrewAI AMP](https://app.crewai.com)는 프로덕션 환경에서 AI 에이전트를 **생성**, **배포** 및 **관리**하는 과정을 간소화합니다.
## 시작하기
@@ -23,20 +23,22 @@ mode: "wide"
### 설치 및 설정
<Card title="표준 설치 따라하기" icon="wrench" href="/ko/installation">
CrewAI CLI를 설정하고 첫 번째 프로젝트를 생성하기 위해 표준 설치 가이드를 따라주세요.
CrewAI CLI를 설정하고 첫 번째 프로젝트를 생성하기 위해 표준 설치 가이드를
따라주세요.
</Card>
### 크루 구성하기
<Card title="빠른 시작 튜토리얼" icon="rocket" href="/ko/quickstart">
YAML 구성을 사용하여 첫 번째 에이전트 크루를 만드는 방법은 빠른 시작 가이드를 따라주세요.
YAML 구성을 사용하여 첫 번째 에이전트 크루를 만드는 방법은 빠른 시작 가이드를
따라주세요.
</Card>
## 지원 및 리소스
Enterprise 전용 지원 또는 문의가 필요하신 경우, [support@crewai.com](mailto:support@crewai.com)으로 저희 전담 지원팀에 연락해 주시기 바랍니다.
<Card title="데모 예약" icon="calendar" href="mailto:support@crewai.com">
Enterprise 기능과 해당 기능이 귀사의 조직에 어떻게 도움이 될 수 있는지 알아보시려면 저희 팀과 상담 일정을 예약하세요.
Enterprise 기능과 해당 기능이 귀사의 조직에 어떻게 도움이 될 수 있는지
알아보시려면 저희 팀과 상담 일정을 예약하세요.
</Card>

36
docs/ko/enterprise/guides/deploy-crew.mdx
View File

@@ -6,14 +6,17 @@ mode: "wide"
---
<Note>
로컬에서 또는 Crew Studio를 통해 crew를 생성한 후, 다음 단계는 이를 CrewAI AOP 플랫폼에 배포하는 것입니다. 본 가이드에서는 다양한 배포 방법을 다루며, 여러분의 워크플로우에 가장 적합한 방식을 선택할 수 있도록 안내합니다.
로컬에서 또는 Crew Studio를 통해 crew를 생성한 후, 다음 단계는 이를 CrewAI AMP
플랫폼에 배포하는 것입니다. 본 가이드에서는 다양한 배포 방법을 다루며,
여러분의 워크플로우에 가장 적합한 방식을 선택할 수 있도록 안내합니다.
</Note>
## 사전 준비 사항
<CardGroup cols={2}>
<Card title="배포 준비가 된 Crew" icon="users">
작동 중인 crew가 로컬에서 빌드되었거나 Crew Studio를 통해 생성되어 있어야 합니다.
작동 중인 crew가 로컬에서 빌드되었거나 Crew Studio를 통해 생성되어 있어야
합니다.
</Card>
<Card title="GitHub 저장소" icon="github">
crew 코드가 GitHub 저장소에 있어야 합니다(GitHub 연동 방식의 경우).
@@ -39,10 +42,10 @@ CLI는 로컬에서 개발된 crew를 Enterprise 플랫폼에 가장 빠르게
</Step>
<Step title="Enterprise 플랫폼에 인증">
먼저, CrewAI AOP 플랫폼에 CLI를 인증해야 합니다:
먼저, CrewAI AMP 플랫폼에 CLI를 인증해야 합니다:
```bash
# 이미 CrewAI AOP 계정이 있거나 새로 생성하고 싶을 때:
# 이미 CrewAI AMP 계정이 있거나 새로 생성하고 싶을 때:
crewai login
```
@@ -124,19 +127,19 @@ crewai deploy remove <deployment_id>
## 옵션 2: 웹 인터페이스를 통한 직접 배포
GitHub 계정을 연결하여 CrewAI AOP 웹 인터페이스를 통해 crews를 직접 배포할 수도 있습니다. 이 방법은 로컬 머신에서 CLI를 사용할 필요가 없습니다.
GitHub 계정을 연결하여 CrewAI AMP 웹 인터페이스를 통해 crews를 직접 배포할 수도 있습니다. 이 방법은 로컬 머신에서 CLI를 사용할 필요가 없습니다.
<Steps>
<Step title="GitHub로 푸시하기">
crew를 GitHub 저장소에 푸시해야 합니다. 아직 crew를 만들지 않았다면, [이 튜토리얼](/ko/quickstart)을 따라할 수 있습니다.
crew를 GitHub 저장소에 푸시해야 합니다. 아직 crew를 만들지 않았다면, [이 튜토리얼](/ko/quickstart)을 따라할 수 있습니다.
</Step>
<Step title="GitHub를 CrewAI AOP에 연결하기">
1. [CrewAI AOP](https://app.crewai.com)에 로그인합니다.
1. [CrewAI AMP](https://app.crewai.com)에 로그인합니다.
2. "Connect GitHub" 버튼을 클릭합니다.
<Frame>
@@ -190,7 +193,8 @@ GitHub 계정을 연결하여 CrewAI AOP 웹 인터페이스를 통해 crews를
## ⚠️ 환경 변수 보안 요구사항
<Warning>
**중요**: CrewAI AOP는 환경 변수 이름에 대한 보안 제한이 있으며, 이를 따르지 않을 경우 배포가 실패할 수 있습니다.
**중요**: CrewAI AOP는 환경 변수 이름에 대한 보안 제한이 있으며, 이를 따르지
않을 경우 배포가 실패할 수 있습니다.
</Warning>
### 차단된 환경 변수 패턴
@@ -198,12 +202,14 @@ GitHub 계정을 연결하여 CrewAI AOP 웹 인터페이스를 통해 crews를
보안상의 이유로, 다음과 같은 환경 변수 명명 패턴은 **자동으로 필터링**되며 배포에 문제가 발생할 수 있습니다:
**차단된 패턴:**
- `_TOKEN`으로 끝나는 변수 (예: `MY_API_TOKEN`)
- `_PASSWORD`로 끝나는 변수 (예: `DB_PASSWORD`)
- `_SECRET`로 끝나는 변수 (예: `API_SECRET`)
- 특정 상황에서 `_KEY`로 끝나는 변수
**특정 차단 변수:**
- `GITHUB_USER`, `GITHUB_TOKEN`
- `AWS_REGION`, `AWS_DEFAULT_REGION`
- 다양한 내부 CrewAI 시스템 변수
@@ -211,6 +217,7 @@ GitHub 계정을 연결하여 CrewAI AOP 웹 인터페이스를 통해 crews를
### 허용된 예외
일부 변수는 차단된 패턴과 일치하더라도 명시적으로 허용됩니다:
- `AZURE_AD_TOKEN`
- `AZURE_OPENAI_AD_TOKEN`
- `ENTERPRISE_ACTION_TOKEN`
@@ -240,7 +247,8 @@ API_CONFIG=secret123
4. **변경 내용 문서화**: 팀을 위해 이름이 변경된 변수를 기록
<Tip>
배포 실패 시, 환경 변수 에러 메시지가 난해하다면 먼저 변수 이름이 이 패턴을 따르는지 확인하세요.
배포 실패 시, 환경 변수 에러 메시지가 난해하다면 먼저 변수 이름이 이 패턴을
따르는지 확인하세요.
</Tip>
### 배포된 Crew와 상호작용하기
@@ -248,6 +256,7 @@ API_CONFIG=secret123
배포가 완료되면 다음을 통해 crew에 접근할 수 있습니다:
1. **REST API**: 플랫폼에서 아래의 주요 경로가 포함된 고유한 HTTPS 엔드포인트를 생성합니다:
- `/inputs`: 필요한 입력 파라미터 목록
- `/kickoff`: 제공된 입력값으로 실행 시작
- `/status/{kickoff_id}`: 실행 상태 확인
@@ -286,6 +295,11 @@ Enterprise 플랫폼은 또한 다음을 제공합니다:
- **Custom Tools Repository**: 도구 생성, 공유 및 설치
- **Crew Studio**: 코드를 작성하지 않고 채팅 인터페이스를 통해 crew 빌드
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Enterprise 플랫폼의 배포 문제 또는 문의 사항이 있으시면 지원팀에 연락해 주십시오.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Enterprise 플랫폼의 배포 문제 또는 문의 사항이 있으시면 지원팀에 연락해
주십시오.
</Card>

51
docs/ko/enterprise/guides/enable-crew-studio.mdx
View File

@@ -6,7 +6,8 @@ mode: "wide"
---
<Tip>
Crew Studio는 대화형 인터페이스를 통해 빠르게 Crew를 스캐폴딩하거나 구축할 수 있는 강력한 **노코드/로우코드** 도구입니다.
Crew Studio는 대화형 인터페이스를 통해 빠르게 Crew를 스캐폴딩하거나 구축할 수
있는 강력한 **노코드/로우코드** 도구입니다.
</Tip>
## Crew Studio란?
@@ -24,7 +25,7 @@ Crew Studio를 사용하면 다음과 같은 작업이 가능합니다:
- 적절한 tool 선택
- 필요한 입력값 구성
- 커스터마이징을 위한 다운로드 가능한 코드 생성
- CrewAI AOP 플랫폼에 직접 배포
- CrewAI AMP 플랫폼에 직접 배포
## 구성 단계
@@ -32,7 +33,7 @@ Crew Studio를 사용하기 전에 LLM 연결을 구성해야 합니다:
<Steps>
<Step title="LLM 연결 설정">
CrewAI AOP 대시보드의 **LLM Connections** 탭으로 이동하여 새 LLM 연결을 만듭니다.
CrewAI AMP 대시보드의 **LLM Connections** 탭으로 이동하여 새 LLM 연결을 만듭니다.
<Note>
CrewAI에서 지원하는 원하는 LLM 공급자를 자유롭게 사용하실 수 있습니다.
@@ -52,6 +53,7 @@ Crew Studio를 사용하기 전에 LLM 연결을 구성해야 합니다:
<Frame>
![LLM 연결 구성](/images/enterprise/llm-connection-config.png)
</Frame>
</Step>
<Step title="연결 추가 확인">
@@ -60,6 +62,7 @@ Crew Studio를 사용하기 전에 LLM 연결을 구성해야 합니다:
<Frame>
![연결 추가됨](/images/enterprise/connection-added.png)
</Frame>
</Step>
<Step title="LLM 기본값 구성">
@@ -73,6 +76,7 @@ Crew Studio를 사용하기 전에 LLM 연결을 구성해야 합니다:
<Frame>
![LLM 기본값 구성](/images/enterprise/llm-defaults.png)
</Frame>
</Step>
</Steps>
@@ -82,7 +86,7 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시
<Steps>
<Step title="Studio 접속">
CrewAI AOP 대시보드에서 **Studio** 섹션으로 이동하세요.
CrewAI AMP 대시보드에서 **Studio** 섹션으로 이동하세요.
</Step>
<Step title="대화 시작">
@@ -93,6 +97,7 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시
```
Crew Assistant는 귀하의 요구 사항을 더 잘 이해하기 위해 추가 질문을 할 것입니다.
</Step>
<Step title="생성된 crew 검토">
@@ -104,14 +109,16 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시
- 사용할 도구
이 단계에서 구성 내용을 세부적으로 수정할 수 있습니다.
</Step>
<Step title="배포 또는 다운로드">
구성에 만족하면 다음을 수행할 수 있습니다:
- 생성된 코드를 다운로드하여 로컬에서 커스터마이징
- crew를 CrewAI AOP 플랫폼에 직접 배포
- crew를 CrewAI AMP 플랫폼에 직접 배포
- 구성을 수정하고 crew를 재생성
</Step>
<Step title="crew 테스트">
@@ -120,7 +127,8 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시
</Steps>
<Tip>
최상의 결과를 얻으려면 crew가 달성해야 할 목표를 명확하고 상세하게 설명하세요. 원하는 입력값과 예상 결과를 설명에 포함시키는 것이 좋습니다.
최상의 결과를 얻으려면 crew가 달성해야 할 목표를 명확하고 상세하게 설명하세요.
원하는 입력값과 예상 결과를 설명에 포함시키는 것이 좋습니다.
</Tip>
## 예시 워크플로우
@@ -134,11 +142,13 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시
```md
I need a crew that can analyze financial news and provide investment recommendations
```
</Step>
<Step title="질문에 답하기">
crew assistant가 요구 사항을 구체화할 수 있도록 하는 추가 질문에 답변하세요.
</Step>
{" "}
<Step title="질문에 답하기">
crew assistant가 요구 사항을 구체화할 수 있도록 하는 추가 질문에 답변하세요.
</Step>
<Step title="계획 검토하기">
생성된 crew 계획을 검토하세요. 여기에는 다음과 같은 항목이 포함될 수 있습니다:
@@ -146,21 +156,28 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시
- 금융 뉴스를 수집하는 Research Agent
- 데이터를 해석하는 Analysis Agent
- 투자 조언을 제공하는 Recommendations Agent
</Step>
<Step title="승인 또는 수정">
계획을 승인하거나 필요하다면 변경을 요청하세요.
</Step>
{" "}
<Step title="승인 또는 수정">
계획을 승인하거나 필요하다면 변경을 요청하세요.
</Step>
<Step title="다운로드 또는 배포">
사용자화를 위해 코드를 다운로드하거나 플랫폼에 직접 배포하세요.
</Step>
{" "}
<Step title="다운로드 또는 배포">
사용자화를 위해 코드를 다운로드하거나 플랫폼에 직접 배포하세요.
</Step>
<Step title="테스트 및 개선">
샘플 입력으로 crew를 테스트하고 필요에 따라 개선하세요.
</Step>
</Steps>
<Card title="도움이 필요하세요?" icon="headset" href="mailto:support@crewai.com">
Crew Studio 또는 기타 CrewAI AOP 기능 지원이 필요하다면 지원팀에 문의하세요.
<Card
title="도움이 필요하세요?"
icon="headset"
href="mailto:support@crewai.com"
>
Crew Studio 또는 기타 CrewAI AMP 기능 지원이 필요하다면 지원팀에 문의하세요.
</Card>

18
docs/ko/enterprise/guides/gmail-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Use the Gmail Trigger to kick off your deployed crews when Gmail events happen in connected accounts, such as receiving a new email or messages matching a label/filter.
<Tip>
Make sure Gmail is connected in Tools & Integrations and the trigger is enabled for your deployment.
Make sure Gmail is connected in Tools & Integrations and the trigger is
enabled for your deployment.
</Tip>
## Enabling the Gmail Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **Gmail** and switch the toggle to enable
<Frame>
<img src="/images/enterprise/trigger-selected.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/trigger-selected.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Process new emails
@@ -68,7 +72,8 @@ crewai triggers run gmail/new_email_received
`crewai triggers run` 명령은 완전한 Gmail payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.
<Warning>
개발 중에는 `crewai triggers run gmail/new_email_received`을 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.
개발 중에는 `crewai triggers run gmail/new_email_received`을 사용하세요
(`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.
</Warning>
## Monitoring Executions
@@ -76,7 +81,10 @@ crewai triggers run gmail/new_email_received
Track history and performance of triggered runs:
<Frame>
<img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />
<img
src="/images/enterprise/list-executions.png"
alt="List of executions triggered by automation"
/>
</Frame>
## Troubleshooting

18
docs/ko/enterprise/guides/google-calendar-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Use the Google Calendar trigger to launch automations whenever calendar events change. Common use cases include briefing a team before a meeting, notifying stakeholders when a critical event is cancelled, or summarizing daily schedules.
<Tip>
Make sure Google Calendar is connected in **Tools & Integrations** and enabled for the deployment you want to automate.
Make sure Google Calendar is connected in **Tools & Integrations** and enabled
for the deployment you want to automate.
</Tip>
## Enabling the Google Calendar Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **Google Calendar** and switch the toggle to enable
<Frame>
<img src="/images/enterprise/calendar-trigger.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/calendar-trigger.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Summarize meeting details
@@ -54,7 +58,8 @@ crewai triggers run google_calendar/event_changed
`crewai triggers run` 명령은 완전한 Calendar payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.
<Warning>
개발 중에는 `crewai triggers run google_calendar/event_changed`를 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.
개발 중에는 `crewai triggers run google_calendar/event_changed`를 사용하세요
(`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.
</Warning>
## Monitoring Executions
@@ -62,7 +67,10 @@ crewai triggers run google_calendar/event_changed
The **Executions** list in the deployment dashboard tracks every triggered run and surfaces payload metadata, output summaries, and errors.
<Frame>
<img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />
<img
src="/images/enterprise/list-executions.png"
alt="List of executions triggered by automation"
/>
</Frame>
## Troubleshooting

18
docs/ko/enterprise/guides/google-drive-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Trigger your automations when files are created, updated, or removed in Google Drive. Typical workflows include summarizing newly uploaded content, enforcing sharing policies, or notifying owners when critical files change.
<Tip>
Connect Google Drive in **Tools & Integrations** and confirm the trigger is enabled for the automation you want to monitor.
Connect Google Drive in **Tools & Integrations** and confirm the trigger is
enabled for the automation you want to monitor.
</Tip>
## Enabling the Google Drive Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **Google Drive** and switch the toggle to enable
<Frame>
<img src="/images/enterprise/gdrive-trigger.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/gdrive-trigger.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Summarize file activity
@@ -51,7 +55,8 @@ crewai triggers run google_drive/file_changed
`crewai triggers run` 명령은 완전한 Drive payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.
<Warning>
개발 중에는 `crewai triggers run google_drive/file_changed`를 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.
개발 중에는 `crewai triggers run google_drive/file_changed`를 사용하세요
(`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.
</Warning>
## Monitoring Executions
@@ -59,7 +64,10 @@ crewai triggers run google_drive/file_changed
Track history and performance of triggered runs with the **Executions** list in the deployment dashboard.
<Frame>
<img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />
<img
src="/images/enterprise/list-executions.png"
alt="List of executions triggered by automation"
/>
</Frame>
## Troubleshooting

75
docs/ko/enterprise/guides/hubspot-trigger.mdx
View File

@@ -9,44 +9,53 @@ mode: "wide"
## 사전 준비 사항
- CrewAI AOP 계정
- CrewAI AMP 계정
- [HubSpot Workflows](https://knowledge.hubspot.com/workflows/create-workflows) 기능이 활성화된 HubSpot 계정
## 설정 단계
<Steps>
<Step title="HubSpot 계정을 CrewAI AOP와 연결하기">
- `CrewAI AOP 계정 > 트리거`에 로그인합니다.
- 사용 가능한 트리거 목록에서 `HubSpot`을 선택합니다.
- CrewAI AOP와 연결하고자 하는 HubSpot 계정을 선택합니다.
- 화면에 나타나는 안내에 따라 CrewAI AOP가 HubSpot 계정에 접근하도록 승인합니다.
- HubSpot이 CrewAI AOP와 성공적으로 연결되면 확인 메시지가 표시됩니다.
</Step>
<Step title="HubSpot 워크플로우 생성하기">
- `HubSpot 계정 > 자동화 > 워크플로우 > 새 워크플로우`에 로그인합니다.
- 필요에 맞는 워크플로우 유형을 선택합니다 (예: 처음부터 시작).
- 워크플로우 빌더에서 더하기(+) 아이콘을 클릭하여 새로운 작업을 추가합니다.
- `통합 앱 > CrewAI > Crew 시작하기`를 선택합니다.
- 시작할 Crew를 선택합니다.
- `저장`을 클릭하여 워크플로우에 작업을 추가합니다.
<Frame>
<img src="/images/enterprise/hubspot-workflow-1.png" alt="HubSpot Workflow 1" />
</Frame>
</Step>
<Step title="Crew 결과를 다른 작업과 함께 사용하기">
- Crew 시작 단계 이후, 더하기(+) 아이콘을 클릭하여 새로운 작업을 추가합니다.
- 예를 들어, 내부 이메일 알림을 전송하려면 `커뮤니케이션 > 내부 이메일 알림 전송`을 선택합니다.
- 본문 필드에서 `데이터 삽입`을 클릭하고, `다음에서 속성 또는 작업 결과 보기 > 작업 결과 > Crew 결과`를 선택하여 이메일에 Crew 데이터를 포함합니다.
<Frame>
<img src="/images/enterprise/hubspot-workflow-2.png" alt="HubSpot Workflow 2" />
</Frame>
- 필요에 따라 추가 작업을 구성합니다.
- 모든 워크플로우 단계를 검토하여 올바르게 설정되었는지 확인합니다.
- 워크플로우를 활성화합니다.
<Frame>
<img src="/images/enterprise/hubspot-workflow-3.png" alt="HubSpot Workflow 3" />
</Frame>
</Step>
<Step title="HubSpot 계정을 CrewAI AOP와 연결하기">
- `CrewAI AMP 계정 > 트리거`에 로그인합니다. - 사용 가능한 트리거 목록에서
`HubSpot`을 선택합니다. - CrewAI AOP와 연결하고자 하는 HubSpot 계정을
선택합니다. - 화면에 나타나는 안내에 따라 CrewAI AOP가 HubSpot 계정에
접근하도록 승인합니다. - HubSpot이 CrewAI AOP와 성공적으로 연결되면 확인
메시지가 표시됩니다.
</Step>
<Step title="HubSpot 워크플로우 생성하기">
- `HubSpot 계정 > 자동화 > 워크플로우 > 새 워크플로우`에 로그인합니다. -
필요에 맞는 워크플로우 유형을 선택합니다 (예: 처음부터 시작). - 워크플로우
빌더에서 더하기(+) 아이콘을 클릭하여 새로운 작업을 추가합니다. - `통합 앱 >
CrewAI > Crew 시작하기`를 선택합니다. - 시작할 Crew를 선택합니다. - `저장`을
클릭하여 워크플로우에 작업을 추가합니다.
<Frame>
<img
src="/images/enterprise/hubspot-workflow-1.png"
alt="HubSpot Workflow 1"
/>
</Frame>
</Step>
<Step title="Crew 결과를 다른 작업과 함께 사용하기">
- Crew 시작 단계 이후, 더하기(+) 아이콘을 클릭하여 새로운 작업을 추가합니다.
- 예를 들어, 내부 이메일 알림을 전송하려면 `커뮤니케이션 > 내부 이메일 알림
전송`을 선택합니다. - 본문 필드에서 `데이터 삽입`을 클릭하고, `다음에서 속성
또는 작업 결과 보기 > 작업 결과 > Crew 결과`를 선택하여 이메일에 Crew
데이터를 포함합니다.
<Frame>
<img
src="/images/enterprise/hubspot-workflow-2.png"
alt="HubSpot Workflow 2"
/>
</Frame>
- 필요에 따라 추가 작업을 구성합니다. - 모든 워크플로우 단계를
검토하여 올바르게 설정되었는지 확인합니다. - 워크플로우를 활성화합니다.
<Frame>
<img
src="/images/enterprise/hubspot-workflow-3.png"
alt="HubSpot Workflow 3"
/>
</Frame>
</Step>
</Steps>
사용 가능한 작업과 사용자 지정 옵션에 대한 자세한 정보는 [HubSpot 워크플로우 문서](https://knowledge.hubspot.com/workflows/create-workflows)를 참고하세요.

40
docs/ko/enterprise/guides/kickoff-crew.mdx
View File

@@ -7,19 +7,17 @@ mode: "wide"
## 개요
Crew를 CrewAI AOP 플랫폼에 배포한 후에는 웹 인터페이스 또는 API를 통해 실행을 시작할 수 있습니다. 이 가이드는 두 가지 접근 방식을 모두 다룹니다.
Crew를 CrewAI AMP 플랫폼에 배포한 후에는 웹 인터페이스 또는 API를 통해 실행을 시작할 수 있습니다. 이 가이드는 두 가지 접근 방식을 모두 다룹니다.
## 방법 1: 웹 인터페이스 사용
### 1단계: 배포된 Crew로 이동하기
1. [CrewAI AOP](https://app.crewai.com)에 로그인합니다.
1. [CrewAI AMP](https://app.crewai.com)에 로그인합니다.
2. 프로젝트 목록에서 crew 이름을 클릭합니다.
3. crew의 상세 페이지로 이동합니다.
<Frame>
![Crew Dashboard](/images/enterprise/crew-dashboard.png)
</Frame>
<Frame>![Crew Dashboard](/images/enterprise/crew-dashboard.png)</Frame>
### 2단계: 실행 시작
@@ -31,9 +29,7 @@ crew의 상세 페이지에서 실행을 시작할 수 있는 두 가지 옵션
2. JSON 에디터에서 crew에 필요한 입력 파라미터를 입력합니다.
3. `Send Request` 버튼을 클릭합니다.
<Frame>
![Kickoff Endpoint](/images/enterprise/kickoff-endpoint.png)
</Frame>
<Frame>![Kickoff Endpoint](/images/enterprise/kickoff-endpoint.png)</Frame>
#### 옵션 B: 시각적 인터페이스 사용
@@ -41,9 +37,7 @@ crew의 상세 페이지에서 실행을 시작할 수 있는 두 가지 옵션
2. 양식 필드에 필요한 입력값을 입력합니다.
3. `Run Crew` 버튼을 클릭합니다.
<Frame>
![Run Crew](/images/enterprise/run-crew.png)
</Frame>
<Frame>![Run Crew](/images/enterprise/run-crew.png)</Frame>
### 3단계: 실행 진행 상황 모니터링
@@ -52,9 +46,7 @@ crew의 상세 페이지에서 실행을 시작할 수 있는 두 가지 옵션
1. `kickoff_id`가 포함된 응답을 받게 됩니다. - **이 ID를 복사하세요**
2. 이 ID는 실행을 추적하는 데 필수적입니다
<Frame>
![작업 ID 복사](/images/enterprise/copy-task-id.png)
</Frame>
<Frame>![작업 ID 복사](/images/enterprise/copy-task-id.png)</Frame>
### 4단계: 실행 상태 확인
@@ -64,11 +56,10 @@ crew의 상세 페이지에서 실행을 시작할 수 있는 두 가지 옵션
2. 지정된 필드에 `kickoff_id`를 붙여넣으세요
3. "Get Status" 버튼을 클릭하세요
<Frame>
![Get Status](/images/enterprise/get-status.png)
</Frame>
<Frame>![Get Status](/images/enterprise/get-status.png)</Frame>
상태 응답에는 다음이 표시됩니다:
- 현재 실행 상태(`running`, `completed` 등)
- 진행 중인 작업에 대한 세부 정보
- 지금까지 생성된 모든 출력
@@ -83,7 +74,7 @@ crew의 상세 페이지에서 실행을 시작할 수 있는 두 가지 옵션
## 방법 2: API 사용
CrewAI AOP REST API를 사용하여 프로그래밍 방식으로 crews를 시작할 수도 있습니다.
CrewAI AMP REST API를 사용하여 프로그래밍 방식으로 crews를 시작할 수도 있습니다.
### 인증
@@ -122,7 +113,7 @@ curl -X GET \
응답은 예를 들어 다음과 같이 필수 입력 파라미터 배열을 포함한 JSON 객체로 반환됩니다:
```json
{"inputs":["topic","current_year"]}
{ "inputs": ["topic", "current_year"] }
```
이 예시에서는 해당 crew에서 두 개의 입력값인 `topic`과 `current_year`를 필요로 함을 보여줍니다.
@@ -142,7 +133,7 @@ curl -X POST \
응답에는 추적에 필요한 `kickoff_id`가 포함됩니다:
```json
{"kickoff_id":"abcd1234-5678-90ef-ghij-klmnopqrstuv"}
{ "kickoff_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv" }
```
### 3단계: 실행 상태 확인
@@ -181,6 +172,11 @@ curl -X GET \
2. "Traces" 탭에서 단계별 실행 세부 정보를 검토하세요
3. 트레이스 세부 정보에서 LLM 응답과 도구 사용 내역을 확인하세요
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
실행 문제 또는 엔터프라이즈 플랫폼 관련 질문이 있으신 경우, 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
실행 문제 또는 엔터프라이즈 플랫폼 관련 질문이 있으신 경우, 지원팀에
문의하세요.
</Card>

14
docs/ko/enterprise/guides/microsoft-teams-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Use the Microsoft Teams trigger to start automations whenever a new chat is created. Common patterns include summarizing inbound requests, routing urgent messages to support teams, or creating follow-up tasks in other systems.
<Tip>
Confirm Microsoft Teams is connected under **Tools & Integrations** and enabled in the **Triggers** tab for your deployment.
Confirm Microsoft Teams is connected under **Tools & Integrations** and
enabled in the **Triggers** tab for your deployment.
</Tip>
## Enabling the Microsoft Teams Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **Microsoft Teams** and switch the toggle to enable
<Frame caption="Microsoft Teams trigger connection">
<img src="/images/enterprise/msteams-trigger.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/msteams-trigger.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Summarize a new chat thread
@@ -52,7 +56,9 @@ crewai triggers run microsoft_teams/teams_message_created
`crewai triggers run` 명령은 완전한 Teams payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.
<Warning>
개발 중에는 `crewai triggers run microsoft_teams/teams_message_created`를 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.
개발 중에는 `crewai triggers run microsoft_teams/teams_message_created`를
사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를
받습니다.
</Warning>
## Troubleshooting

13
docs/ko/enterprise/guides/onedrive-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Start automations when files change inside OneDrive. You can generate audit summaries, notify security teams about external sharing, or update downstream line-of-business systems with new document metadata.
<Tip>
Connect OneDrive in **Tools & Integrations** and toggle the trigger on for your deployment.
Connect OneDrive in **Tools & Integrations** and toggle the trigger on for
your deployment.
</Tip>
## Enabling the OneDrive Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **OneDrive** and switch the toggle to enable
<Frame caption="Microsoft OneDrive trigger connection">
<img src="/images/enterprise/onedrive-trigger.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/onedrive-trigger.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Audit file permissions
@@ -51,7 +55,8 @@ crewai triggers run microsoft_onedrive/file_changed
`crewai triggers run` 명령은 완전한 OneDrive payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.
<Warning>
개발 중에는 `crewai triggers run microsoft_onedrive/file_changed`를 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.
개발 중에는 `crewai triggers run microsoft_onedrive/file_changed`를 사용하세요
(`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.
</Warning>
## Troubleshooting

14
docs/ko/enterprise/guides/outlook-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Automate responses when Outlook delivers a new message or when an event is removed from the calendar. Teams commonly route escalations, file tickets, or alert attendees of cancellations.
<Tip>
Connect Outlook in **Tools & Integrations** and ensure the trigger is enabled for your deployment.
Connect Outlook in **Tools & Integrations** and ensure the trigger is enabled
for your deployment.
</Tip>
## Enabling the Outlook Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **Outlook** and switch the toggle to enable
<Frame caption="Microsoft Outlook trigger connection">
<img src="/images/enterprise/outlook-trigger.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/outlook-trigger.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Summarize a new email
@@ -51,7 +55,9 @@ crewai triggers run microsoft_outlook/email_received
`crewai triggers run` 명령은 완전한 Outlook payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.
<Warning>
개발 중에는 `crewai triggers run microsoft_outlook/email_received`를 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.
개발 중에는 `crewai triggers run microsoft_outlook/email_received`를
사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를
받습니다.
</Warning>
## Troubleshooting

16
docs/ko/enterprise/guides/react-component-export.mdx
View File

@@ -1,11 +1,11 @@
---
title: "React 컴포넌트 내보내기"
description: "CrewAI AOP React 컴포넌트를 애플리케이션에 내보내고 통합하는 방법을 알아보세요"
description: "CrewAI AMP React 컴포넌트를 애플리케이션에 내보내고 통합하는 방법을 알아보세요"
icon: "react"
mode: "wide"
---
이 가이드는 CrewAI AOP crew를 React 컴포넌트로 내보내고 이를 여러분의 애플리케이션에 통합하는 방법을 설명합니다.
이 가이드는 CrewAI AMP crew를 React 컴포넌트로 내보내고 이를 여러분의 애플리케이션에 통합하는 방법을 설명합니다.
## React 컴포넌트 내보내기
@@ -17,6 +17,7 @@ mode: "wide"
<img src="/images/enterprise/export-react-component.png" alt="React 컴포넌트 내보내기" />
</Frame>
</Step>
</Steps>
## 리액트 환경 설정
@@ -83,6 +84,7 @@ mode: "wide"
```
- 개발 서버가 시작되며, 기본 웹 브라우저가 자동으로 http://localhost:3000 을 열고 리액트 앱이 실행되는 것을 확인할 수 있습니다.
</Step>
</Steps>
## 커스터마이징
@@ -90,10 +92,16 @@ mode: "wide"
그런 다음 `CrewLead.jsx`를 커스터마이즈하여 색상, 제목 등을 추가할 수 있습니다.
<Frame>
<img src="/images/enterprise/customise-react-component.png" alt="React 컴포넌트 커스터마이즈" />
<img
src="/images/enterprise/customise-react-component.png"
alt="React 컴포넌트 커스터마이즈"
/>
</Frame>
<Frame>
<img src="/images/enterprise/customise-react-component-2.png" alt="React 컴포넌트 커스터마이즈" />
<img
src="/images/enterprise/customise-react-component-2.png"
alt="React 컴포넌트 커스터마이즈"
/>
</Frame>
## 다음 단계

4
docs/ko/enterprise/guides/salesforce-trigger.mdx
View File

@@ -31,7 +31,7 @@ Salesforce는 기업이 영업, 서비스, 마케팅 운영을 효율화할 수
Salesforce 트리거를 설정하려면:
1. **지원팀 문의**: Salesforce 트리거 설정을 위해 CrewAI AOP 지원팀에 연락하세요.
1. **지원팀 문의**: Salesforce 트리거 설정을 위해 CrewAI AMP 지원팀에 연락하세요.
2. **요구 사항 검토**: 필요한 Salesforce 권한과 API 액세스 권한이 있는지 확인하세요.
3. **연결 구성**: 지원팀과 협력하여 CrewAI와 귀하의 Salesforce 인스턴스 간의 연결을 설정하세요.
4. **트리거 테스트**: 트리거가 귀하의 특정 사용 사례에 맞게 올바르게 작동하는지 확인하세요.
@@ -47,4 +47,4 @@ Salesforce 트리거를 설정하려면:
## 다음 단계
자세한 설정 지침 및 고급 구성 옵션에 대해서는 CrewAI AOP 지원팀에 문의해 주시기 바랍니다. 지원팀은 귀하의 특정 Salesforce 환경과 비즈니스 요구에 맞는 맞춤형 안내를 제공해 드릴 수 있습니다.
자세한 설정 지침 및 고급 구성 옵션에 대해서는 CrewAI AMP 지원팀에 문의해 주시기 바랍니다. 지원팀은 귀하의 특정 Salesforce 환경과 비즈니스 요구에 맞는 맞춤형 안내를 제공해 드릴 수 있습니다.

124
docs/ko/enterprise/guides/team-management.mdx
View File

@@ -1,40 +1,38 @@
---
title: "팀 관리"
description: "CrewAI AOP 조직에서 팀원을 초대하고 관리하는 방법을 알아보세요"
description: "CrewAI AMP 조직에서 팀원을 초대하고 관리하는 방법을 알아보세요"
icon: "users"
mode: "wide"
---
CrewAI AOP 계정의 관리자라면 새로운 팀원을 조직에 쉽게 초대할 수 있습니다. 이 안내서는 단계별로 프로세스를 안내합니다.
CrewAI AMP 계정의 관리자라면 새로운 팀원을 조직에 쉽게 초대할 수 있습니다. 이 안내서는 단계별로 프로세스를 안내합니다.
## 팀 멤버 초대하기
<Steps>
<Step title="설정 페이지 접속">
- CrewAI AOP 계정에 로그인합니다
- 대시보드 오른쪽 상단에 있는 기어 아이콘(⚙️)을 찾습니다
- 기어 아이콘을 클릭하여 **설정** 페이지에 접속합니다:
<Frame>
<img src="/images/enterprise/settings-page.png" alt="Settings Page" />
</Frame>
</Step>
<Step title="멤버 섹션으로 이동">
- 설정 페이지에서 `Members` 탭이 보입니다
- `Members` 탭을 클릭하여 **멤버** 페이지에 접속합니다:
<Frame>
<img src="/images/enterprise/members-tab.png" alt="Members Tab" />
</Frame>
</Step>
<Step title="새 멤버 초대">
- 멤버 섹션에서 현재 멤버 목록(본인 포함)을 확인할 수 있습니다
- `Email` 입력 필드를 찾습니다
- 초대하고자 하는 사람의 이메일 주소를 입력합니다
- `Invite` 버튼을 클릭하여 초대장을 보냅니다
</Step>
<Step title="필요에 따라 반복">
- 이 과정을 반복하여 여러 팀 멤버를 초대할 수 있습니다
- 초대한 각 멤버는 조직에 가입할 수 있는 이메일 초대장을 받게 됩니다
</Step>
<Step title="설정 페이지 접속">
- CrewAI AMP 계정에 로그인합니다 - 대시보드 오른쪽 상단에 있는 기어
아이콘(⚙️)을 찾습니다 - 기어 아이콘을 클릭하여 **설정** 페이지에 접속합니다:
<Frame>
<img src="/images/enterprise/settings-page.png" alt="Settings Page" />
</Frame>
</Step>
<Step title="멤버 섹션으로 이동">
- 설정 페이지에서 `Members` 탭이 보입니다 - `Members` 탭을 클릭하여 **멤버**
페이지에 접속합니다:
<Frame>
<img src="/images/enterprise/members-tab.png" alt="Members Tab" />
</Frame>
</Step>
<Step title="새 멤버 초대">
- 멤버 섹션에서 현재 멤버 목록(본인 포함)을 확인할 수 있습니다 - `Email`
입력 필드를 찾습니다 - 초대하고자 하는 사람의 이메일 주소를 입력합니다 -
`Invite` 버튼을 클릭하여 초대장을 보냅니다
</Step>
<Step title="필요에 따라 반복">
- 이 과정을 반복하여 여러 팀 멤버를 초대할 수 있습니다 - 초대한 각 멤버는
조직에 가입할 수 있는 이메일 초대장을 받게 됩니다
</Step>
</Steps>
## 역할 추가하기
@@ -42,40 +40,42 @@ CrewAI AOP 계정의 관리자라면 새로운 팀원을 조직에 쉽게 초대
플랫폼의 다양한 부분에 대한 접근 권한을 제어하기 위해 팀원들에게 역할을 추가할 수 있습니다.
<Steps>
<Step title="설정 페이지 접근">
- CrewAI AOP 계정에 로그인하세요
- 대시보드 오른쪽 상단에서 기어 아이콘(⚙️)을 찾으세요
- 기어 아이콘을 클릭하여 **설정** 페이지에 접근하세요:
<Frame>
<img src="/images/enterprise/settings-page.png" alt="설정 페이지" />
</Frame>
</Step>
<Step title="멤버 섹션으로 이동">
- 설정 페이지에서 `Roles` 탭을 확인할 수 있습니다
- `Roles` 탭을 클릭하여 **Roles** 페이지로 이동하세요.
<Frame>
<img src="/images/enterprise/roles-tab.png" alt="Roles 탭" />
</Frame>
- 새로운 역할을 추가하려면 `Add Role` 버튼을 클릭하세요.
- 역할의 세부 정보와 권한을 입력한 후 `Create Role` 버튼을 클릭하여 역할을 생성하세요.
<Frame>
<img src="/images/enterprise/add-role-modal.png" alt="Add Role 모달" />
</Frame>
</Step>
<Step title="멤버에게 역할 추가하기">
- 멤버 섹션에서 현재 멤버(본인 포함) 목록을 확인할 수 있습니다
<Frame>
<img src="/images/enterprise/member-accepted-invitation.png" alt="멤버 초대 수락 완료" />
</Frame>
- 멤버가 초대를 수락하면 역할을 추가할 수 있습니다.
- 다시 `Roles` 탭으로 이동하세요
- 역할을 추가할 멤버로 이동한 후 `Role` 열에서 드롭다운을 클릭하세요
- 멤버에게 추가할 역할을 선택하세요
- `Update` 버튼을 클릭하여 역할을 저장하세요
<Frame>
<img src="/images/enterprise/assign-role.png" alt="멤버에 역할 추가" />
</Frame>
</Step>
<Step title="설정 페이지 접근">
- CrewAI AMP 계정에 로그인하세요 - 대시보드 오른쪽 상단에서 기어
아이콘(⚙️)을 찾으세요 - 기어 아이콘을 클릭하여 **설정** 페이지에 접근하세요:
<Frame>
<img src="/images/enterprise/settings-page.png" alt="설정 페이지" />
</Frame>
</Step>
<Step title="멤버 섹션으로 이동">
- 설정 페이지에서 `Roles` 탭을 확인할 수 있습니다 - `Roles` 탭을 클릭하여
**Roles** 페이지로 이동하세요.
<Frame>
<img src="/images/enterprise/roles-tab.png" alt="Roles 탭" />
</Frame>
- 새로운 역할을 추가하려면 `Add Role` 버튼을 클릭하세요. - 역할의
세부 정보와 권한을 입력한 후 `Create Role` 버튼을 클릭하여 역할을
생성하세요.
<Frame>
<img src="/images/enterprise/add-role-modal.png" alt="Add Role 모달" />
</Frame>
</Step>
<Step title="멤버에게 역할 추가하기">
- 멤버 섹션에서 현재 멤버(본인 포함) 목록을 확인할 수 있습니다
<Frame>
<img
src="/images/enterprise/member-accepted-invitation.png"
alt="멤버 초대 수락 완료"
/>
</Frame>
- 멤버가 초대를 수락하면 역할을 추가할 수 있습니다. - 다시 `Roles`
탭으로 이동하세요 - 역할을 추가할 멤버로 이동한 후 `Role` 열에서 드롭다운을
클릭하세요 - 멤버에게 추가할 역할을 선택하세요 - `Update` 버튼을 클릭하여
역할을 저장하세요
<Frame>
<img src="/images/enterprise/assign-role.png" alt="멤버에 역할 추가" />
</Frame>
</Step>
</Steps>
## 중요 참고 사항
@@ -85,4 +85,4 @@ CrewAI AOP 계정의 관리자라면 새로운 팀원을 조직에 쉽게 초대
- **초대 수락**: 초대된 멤버는 조직에 가입하기 위해 초대를 수락해야 합니다
- **이메일 알림**: 팀 멤버에게 초대 이메일(스팸 폴더 포함)을 확인하도록 안내할 수 있습니다
이 단계들을 따르면 팀을 손쉽게 확장하고 CrewAI AOP 조직 내에서 더욱 효과적으로 협업할 수 있습니다.
이 단계들을 따르면 팀을 손쉽게 확장하고 CrewAI AMP 조직 내에서 더욱 효과적으로 협업할 수 있습니다.

16
docs/ko/enterprise/guides/tool-repository.mdx
View File

@@ -20,11 +20,11 @@ Tool Repository는 CrewAI 도구를 위한 패키지 관리자입니다. 사용
Tool Repository를 사용하기 전에 다음이 준비되어 있어야 합니다:
- [CrewAI AOP](https://app.crewai.com) 계정
- [CrewAI AMP](https://app.crewai.com) 계정
- [CrewAI CLI](/ko/concepts/cli#cli) 설치됨
- uv>=0.5.0 이 설치되어 있어야 합니다. [업그레이드 방법](https://docs.astral.sh/uv/getting-started/installation/#upgrading-uv)을 참고하세요.
- [Git](https://git-scm.com) 설치 및 구성 완료
- CrewAI AOP 조직에서 도구를 게시하거나 설치할 수 있는 액세스 권한
- CrewAI AMP 조직에서 도구를 게시하거나 설치할 수 있는 액세스 권한
## 도구 설치
@@ -85,13 +85,13 @@ crewai tool publish
도구를 삭제하려면:
1. [CrewAI AOP](https://app.crewai.com)로 이동합니다.
1. [CrewAI AMP](https://app.crewai.com)로 이동합니다.
2. **Tools**로 이동합니다.
3. 도구를 선택합니다.
4. **Delete**를 클릭합니다.
<Warning>
삭제는 영구적입니다. 삭제된 도구는 복구하거나 다시 설치할 수 없습니다.
삭제는 영구적입니다. 삭제된 도구는 복구하거나 다시 설치할 수 없습니다.
</Warning>
## 보안 점검
@@ -100,8 +100,12 @@ crewai tool publish
도구의 보안 점검 상태는 다음에서 확인할 수 있습니다:
`CrewAI AOP > Tools > Your Tool > Versions`
`CrewAI AMP > Tools > Your Tool > Versions`
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
API 통합 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의해 주세요.
</Card>

44
docs/ko/enterprise/guides/update-crew.mdx
View File

@@ -6,8 +6,9 @@ mode: "wide"
---
<Note>
CrewAI AOP에 crew를 배포한 후, 코드, 보안 설정 또는 구성을 업데이트해야 할 수 있습니다.
이 가이드는 이러한 일반적인 업데이트 작업을 수행하는 방법을 설명합니다.
CrewAI AOP에 crew를 배포한 후, 코드, 보안 설정 또는 구성을 업데이트해야 할 수
있습니다. 이 가이드는 이러한 일반적인 업데이트 작업을 수행하는 방법을
설명합니다.
</Note>
## 왜 Crew를 업데이트해야 하나요?
@@ -15,6 +16,7 @@ CrewAI AOP에 crew를 배포한 후, 코드, 보안 설정 또는 구성을 업
CrewAI는 기본적으로 GitHub 업데이트를 자동으로 반영하지 않으므로, 배포 시 `Auto-update` 옵션을 선택하지 않았다면 수동으로 업데이트를 트리거해야 합니다.
Crew 배포를 업데이트하고 싶은 이유는 여러 가지가 있을 수 있습니다:
- GitHub에 푸시한 최신 커밋으로 코드를 업데이트하고 싶은 경우
- 보안상의 이유로 bearer 토큰을 재설정하고 싶은 경우
- 환경 변수를 업데이트하고 싶은 경우
@@ -23,12 +25,10 @@ Crew 배포를 업데이트하고 싶은 이유는 여러 가지가 있을 수
GitHub 저장소에 새로운 커밋을 푸시한 후 배포를 업데이트하려면 다음 단계를 따르세요:
1. CrewAI AOP 플랫폼에서 자신의 crew로 이동하세요.
1. CrewAI AMP 플랫폼에서 자신의 crew로 이동하세요.
2. crew 상세 페이지에서 `Re-deploy` 버튼을 클릭하세요.
<Frame>
![Re-deploy Button](/images/enterprise/redeploy-button.png)
</Frame>
<Frame>![Re-deploy Button](/images/enterprise/redeploy-button.png)</Frame>
이 작업을 수행하면 진행률 표시줄을 통해 추적할 수 있는 업데이트가 트리거됩니다. 시스템은 저장소에서 최신 코드를 가져와서 배포를 다시 빌드합니다.
@@ -36,16 +36,15 @@ GitHub 저장소에 새로운 커밋을 푸시한 후 배포를 업데이트하
현재 토큰이 유출되었을 가능성이 있다고 의심되는 경우 등, 새 베어러 토큰을 생성해야 한다면 다음 단계를 따르세요:
1. CrewAI AOP 플랫폼에서 해당 crew로 이동하세요.
1. CrewAI AMP 플랫폼에서 해당 crew로 이동하세요.
2. `Bearer Token` 섹션을 찾으세요.
3. 현재 토큰 옆에 있는 `Reset` 버튼을 클릭하세요.
<Frame>
![Reset Token](/images/enterprise/reset-token.png)
</Frame>
<Frame>![Reset Token](/images/enterprise/reset-token.png)</Frame>
<Warning>
베어러 토큰을 재설정하면 이전 토큰은 즉시 사용할 수 없게 됩니다. 이전 토큰을 사용하고 있는 모든 애플리케이션이나 스크립트에서 토큰을 반드시 업데이트하세요.
베어러 토큰을 재설정하면 이전 토큰은 즉시 사용할 수 없게 됩니다. 이전 토큰을
사용하고 있는 모든 애플리케이션이나 스크립트에서 토큰을 반드시 업데이트하세요.
</Warning>
## 3. 환경 변수 업데이트하기
@@ -54,22 +53,19 @@ crew의 환경 변수를 업데이트하려면 다음 단계를 따르세요:
1. 먼저 crew 이름을 클릭하여 배포 페이지에 접속합니다.
<Frame>
![환경 변수 버튼](/images/enterprise/env-vars-button.png)
</Frame>
<Frame>![환경 변수 버튼](/images/enterprise/env-vars-button.png)</Frame>
2. `Environment Variables` 섹션을 찾습니다 (`Settings` 아이콘을 클릭해야 접근할 수 있습니다)
3. 제공된 필드에서 기존 변수를 수정하거나 새 변수를 추가합니다
4. 수정한 각 변수 옆의 `Update` 버튼을 클릭합니다
<Frame>
![환경 변수 업데이트](/images/enterprise/update-env-vars.png)
</Frame>
<Frame>![환경 변수 업데이트](/images/enterprise/update-env-vars.png)</Frame>
5. 마지막으로, 변경 사항을 적용하려면 페이지 하단의 `Update Deployment` 버튼을 클릭합니다
<Note>
환경 변수를 업데이트하면 새로운 배포가 트리거되지만, 이는 환경 설정만 업데이트하며 코드 자체는 변경되지 않습니다.
환경 변수를 업데이트하면 새로운 배포가 트리거되지만, 이는 환경 설정만
업데이트하며 코드 자체는 변경되지 않습니다.
</Note>
## 업데이트 후
@@ -81,9 +77,15 @@ crew의 환경 변수를 업데이트하려면 다음 단계를 따르세요:
3. 완료되면 변경 사항이 예상대로 작동하는지 crew를 테스트합니다
<Tip>
업데이트 후 문제가 발생하면 플랫폼에서 배포 로그를 확인하거나 지원팀에 문의하여 도움을 받을 수 있습니다.
업데이트 후 문제가 발생하면 플랫폼에서 배포 로그를 확인하거나 지원팀에
문의하여 도움을 받을 수 있습니다.
</Tip>
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
crew 업데이트나 배포 문제 해결에 대해 지원이 필요하시면 지원팀에 문의해 주세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
crew 업데이트나 배포 문제 해결에 대해 지원이 필요하시면 지원팀에 문의해
주세요.
</Card>

8
docs/ko/enterprise/guides/webhook-automation.mdx
View File

@@ -1,6 +1,6 @@
---
title: "웹후크 자동화"
description: "ActivePieces, Zapier, Make.com과 같은 플랫폼을 사용하여 CrewAI AOP 워크플로우를 웹후크로 자동화하세요"
description: "ActivePieces, Zapier, Make.com과 같은 플랫폼을 사용하여 CrewAI AMP 워크플로우를 웹후크로 자동화하세요"
icon: "webhook"
mode: "wide"
---
@@ -11,7 +11,7 @@ CrewAI AOP를 사용하면 웹훅을 통해 워크플로우를 자동화할 수
<Steps>
<Step title="Kickoff 인터페이스 접근">
- CrewAI AOP 대시보드로 이동하세요.
- CrewAI AMP 대시보드로 이동하세요.
- crew 실행을 시작할 때 사용하는 `/kickoff` 섹션을 찾으세요.
<Frame>
<img src="/images/enterprise/kickoff-interface.png" alt="Kickoff 인터페이스" />
@@ -44,7 +44,7 @@ CrewAI AOP를 사용하면 웹훅을 통해 워크플로우를 자동화할 수
3. HTTP 액션 단계를 추가하세요.
- 액션을 `Send HTTP request`로 설정하세요.
- 메소드는 `POST`로 사용하세요.
- URL은 CrewAI AOP kickoff 엔드포인트로 설정하세요.
- URL은 CrewAI AMP kickoff 엔드포인트로 설정하세요.
- 필요한 헤더 추가 (예: `Bearer Token`)
<Frame>
<img src="/images/enterprise/activepieces-headers.png" alt="ActivePieces 헤더" />
@@ -76,6 +76,7 @@ CrewAI AOP를 사용하면 웹훅을 통해 워크플로우를 자동화할 수
<img src="/images/enterprise/activepieces-email.png" alt="ActivePieces 이메일" />
</Frame>
</Step>
</Steps>
## Webhook 출력 예시
@@ -121,4 +122,5 @@ CrewAI AOP를 사용하면 웹훅을 통해 워크플로우를 자동화할 수
}
```
</Tab>
</Tabs>

17
docs/ko/enterprise/guides/zapier-trigger.mdx
View File

@@ -9,7 +9,7 @@ mode: "wide"
## 사전 요구 사항
- CrewAI AOP 계정
- CrewAI AMP 계정
- Zapier 계정
- Slack 계정 (이 특정 예시에 해당)
@@ -32,7 +32,7 @@ mode: "wide"
- 아직 Slack 계정을 연결하지 않았다면 연결하세요.
</Step>
<Step title="CrewAI AOP 액션 구성">
<Step title="CrewAI AMP 액션 구성">
- Zap에 새 액션 단계를 추가합니다.
- CrewAI+를 액션 앱으로, Kickoff를 액션 이벤트로 선택합니다.
@@ -41,8 +41,8 @@ mode: "wide"
</Frame>
</Step>
<Step title="CrewAI AOP 계정 연결">
- CrewAI AOP 계정을 연결하세요.
<Step title="CrewAI AMP 계정 연결">
- CrewAI AMP 계정을 연결하세요.
- 워크플로에 적합한 Crew를 선택하세요.
<Frame>
@@ -51,7 +51,7 @@ mode: "wide"
- Slack 메시지의 데이터를 사용하여 Crew의 입력값을 구성하세요.
</Step>
<Step title="CrewAI AOP 출력 포맷팅">
<Step title="CrewAI AMP 출력 포맷팅">
- CrewAI AOP에서 출력된 텍스트를 포맷팅하기 위해 추가 액션 단계를 추가합니다.
- Zapier의 포매팅 도구를 사용하여 Markdown 출력을 HTML로 변환합니다.
@@ -67,7 +67,7 @@ mode: "wide"
- 포맷팅된 출력을 이메일로 전송하는 마지막 액션 단계를 추가합니다.
- 원하는 이메일 서비스를 선택하세요 (예: Gmail, Outlook).
- 수신자, 제목, 본문 등 이메일 상세 정보를 구성하세요.
- 포맷팅된 CrewAI AOP 출력을 이메일 본문에 삽입합니다.
- 포맷팅된 CrewAI AMP 출력을 이메일 본문에 삽입합니다.
<Frame>
<img src="/images/enterprise/zapier-7.png" alt="Zapier 7" />
@@ -93,12 +93,13 @@ mode: "wide"
<img src="/images/enterprise/zapier-9.png" alt="Zapier 12" />
</Frame>
</Step>
</Steps>
## 성공을 위한 팁
- CrewAI AOP 입력값이 Slack 메시지에서 올바르게 매핑되었는지 확인하세요.
- CrewAI AMP 입력값이 Slack 메시지에서 올바르게 매핑되었는지 확인하세요.
- Zap을 활성화하기 전에 철저히 테스트하여 잠재적인 문제를 미리 파악하세요.
- 워크플로우 내에서 발생할 수 있는 실패 상황을 관리하기 위해 오류 처리 단계를 추가하는 것을 고려하세요.
이 단계를 따르면 Slack 메시지로 트리거되는 자동화된 워크플로우와 CrewAI AOP 출력이 포함된 이메일 알림을 설정할 수 있습니다.
이 단계를 따르면 Slack 메시지로 트리거되는 자동화된 워크플로우와 CrewAI AMP 출력이 포함된 이메일 알림을 설정할 수 있습니다.

19
docs/ko/enterprise/integrations/asana.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Asana 연동을 사용하기 전에 다음을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 권한이 있는 Asana 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Asana 계정 연결
@@ -21,7 +21,7 @@ Asana 연동을 사용하기 전에 다음을 확인하세요:
### 1. Asana 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. 인증 통합 섹션에서 **Asana**를 찾습니다.
3. **Connect**를 클릭하고 OAuth 플로우를 완료합니다.
4. 작업 및 프로젝트 관리를 위한 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -58,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `task` (string, 필수): 작업 ID - 댓글이 추가될 작업의 ID입니다. 댓글 작성자는 현재 인증된 사용자입니다.
- `text` (string, 필수): 텍스트 (예: "This is a comment.").
</Accordion>
<Accordion title="asana/create_project">
@@ -68,6 +70,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `workspace` (string, 필수): 워크스페이스 - Connect Portal Workflow 설정을 사용해 사용자가 프로젝트를 생성할 워크스페이스를 선택할 수 있도록 합니다. 공란인 경우 기본적으로 사용자의 첫 번째 워크스페이스가 선택됩니다.
- `team` (string, 선택): 팀 - Connect Portal Workflow 설정을 사용해 사용자가 이 프로젝트를 공유할 팀을 선택할 수 있도록 합니다. 공란인 경우 기본적으로 사용자의 첫 번째 팀이 선택됩니다.
- `notes` (string, 선택): 노트 (예: "These are things we need to purchase.").
</Accordion>
<Accordion title="asana/get_projects">
@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `archived` (string, 선택): 보관됨 - 보관된 프로젝트를 보려면 "true", 활성 프로젝트만 보려면 "false", 보관됨과 활성 모두 보려면 "default"를 선택합니다.
- 옵션: `default`, `true`, `false`
</Accordion>
<Accordion title="asana/get_project_by_id">
@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `projectFilterId` (string, 필수): 프로젝트 ID.
</Accordion>
<Accordion title="asana/create_task">
@@ -97,6 +102,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `dueAtDate` (string, 선택): 마감 시각 - 이 작업이 완료되어야 하는 날짜와 시간 (ISO 타임스탬프) 입니다. Due On과 함께 사용할 수 없습니다. (예: "2019-09-15T02:06:58.147Z").
- `assignee` (string, 선택): 담당자 - 이 작업이 할당될 Asana 사용자의 ID입니다. Connect Portal Workflow 설정을 사용해 사용자가 담당자를 선택할 수 있도록 합니다.
- `gid` (string, 선택): 외부 ID - 이 작업과 연결할 애플리케이션의 ID입니다. 이 ID를 사용하여 이후 작업 업데이트를 동기화할 수 있습니다.
</Accordion>
<Accordion title="asana/update_task">
@@ -112,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `dueAtDate` (string, 선택): 마감 시각 - 이 작업이 완료되어야 하는 날짜와 시간 (ISO 타임스탬프) 입니다. Due On과 함께 사용할 수 없습니다. (예: "2019-09-15T02:06:58.147Z").
- `assignee` (string, 선택): 담당자 - 이 작업이 할당될 Asana 사용자의 ID입니다. Connect Portal Workflow 설정을 사용해 사용자가 담당자를 선택할 수 있도록 합니다.
- `gid` (string, 선택): 외부 ID - 이 작업과 연결할 애플리케이션의 ID입니다. 이 ID를 사용하여 이후 작업 업데이트를 동기화할 수 있습니다.
</Accordion>
<Accordion title="asana/get_tasks">
@@ -122,6 +129,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `project` (string, 선택): 프로젝트 - 작업을 필터링할 프로젝트의 ID입니다. Connect Portal Workflow 설정을 사용해 사용자가 프로젝트를 선택할 수 있도록 합니다.
- `assignee` (string, 선택): 담당자 - 작업을 필터링할 담당자의 ID입니다. Connect Portal Workflow 설정을 사용해 사용자가 담당자를 선택할 수 있도록 합니다.
- `completedSince` (string, 선택): 이후 완료됨 - 미완료이거나 해당 시간(ISO 또는 Unix 타임스탬프) 이후에 완료된 작업만 반환합니다. (예: "2014-04-25T16:15:47-04:00").
</Accordion>
<Accordion title="asana/get_tasks_by_id">
@@ -129,6 +137,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `taskId` (string, 필수): 작업 ID.
</Accordion>
<Accordion title="asana/get_task_by_external_id">
@@ -136,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `gid` (string, 필수): 외부 ID - 이 작업이 애플리케이션과 연동(또는 동기화)된 ID입니다.
</Accordion>
<Accordion title="asana/add_task_to_section">
@@ -146,6 +156,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `taskId` (string, 필수): 작업 ID - 작업의 ID입니다. (예: "1204619611402340").
- `beforeTaskId` (string, 선택): 이전 작업 ID - 이 작업이 삽입될 섹션 내의 작업 ID입니다. 이후 작업 ID와 함께 사용할 수 없습니다. (예: "1204619611402340").
- `afterTaskId` (string, 선택): 이후 작업 ID - 이 작업이 삽입될 섹션 내의 작업 ID입니다. 이전 작업 ID와 함께 사용할 수 없습니다. (예: "1204619611402340").
</Accordion>
<Accordion title="asana/get_teams">
@@ -153,12 +164,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `workspace` (string, 필수): 워크스페이스 - 인증된 사용자가 볼 수 있는 이 워크스페이스 내의 팀을 반환합니다.
</Accordion>
<Accordion title="asana/get_workspaces">
**설명:** Asana에서 워크스페이스 목록을 가져옵니다.
**매개변수:** 필요 없음.
</Accordion>
</AccordionGroup>

16
docs/ko/enterprise/integrations/box.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Box 통합을 사용하기 전에 다음을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 권한이 있는 Box 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Box 계정 연결
@@ -21,7 +21,7 @@ Box 통합을 사용하기 전에 다음을 확인하세요:
### 1. Box 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. 인증 통합 섹션에서 **Box**를 찾습니다.
3. **Connect**를 클릭하고 OAuth 흐름을 완료합니다.
4. 파일 및 폴더 관리를 위한 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -66,6 +67,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
}
```
- `file` (string, 필수): 파일 URL - 파일 크기는 50MB 미만이어야 합니다. (예시: "https://picsum.photos/200/300").
</Accordion>
<Accordion title="box/save_file_from_object">
@@ -75,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `file` (string, 필수): 파일 - 파일 데이터를 포함하는 파일 객체를 허용합니다. 파일 크기는 50MB 미만이어야 합니다.
- `fileName` (string, 필수): 파일명 (예시: "qwerty.png").
- `folder` (string, 선택): 폴더 - Connect Portal Workflow Settings를 사용하여 사용자가 파일의 폴더 목적지를 선택할 수 있도록 합니다. 비워두면 기본적으로 사용자의 루트 폴더에 저장됩니다.
</Accordion>
<Accordion title="box/get_file_by_id">
@@ -82,6 +85,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `fileId` (string, 필수): 파일 ID - 파일을 나타내는 고유 식별자. (예시: "12345").
</Accordion>
<Accordion title="box/list_files">
@@ -107,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
]
}
```
</Accordion>
<Accordion title="box/create_folder">
@@ -120,6 +125,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"id": "123456"
}
```
</Accordion>
<Accordion title="box/move_folder">
@@ -134,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"id": "123456"
}
```
</Accordion>
<Accordion title="box/get_folder_by_id">
@@ -141,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `folderId` (string, 필수): 폴더 ID - 폴더를 나타내는 고유 식별자. (예시: "0").
</Accordion>
<Accordion title="box/search_folders">
@@ -166,6 +174,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
]
}
```
</Accordion>
<Accordion title="box/delete_folder">
@@ -174,6 +183,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `folderId` (string, 필수): 폴더 ID - 폴더를 나타내는 고유 식별자. (예시: "0").
- `recursive` (boolean, 선택): 재귀적 삭제 - 폴더가 비어 있지 않을 경우, 폴더와 그 모든 내용을 재귀적으로 삭제합니다.
</Accordion>
</AccordionGroup>

27
docs/ko/enterprise/integrations/clickup.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
ClickUp 통합을 사용하기 전에 다음을 준비해야 합니다:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 권한이 있는 ClickUp 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 ClickUp 계정 연결
@@ -21,7 +21,7 @@ ClickUp 통합을 사용하기 전에 다음을 준비해야 합니다:
### 1. ClickUp 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. 인증 통합 섹션에서 **ClickUp**을 찾습니다.
3. **Connect**를 클릭하고 OAuth 과정을 완료합니다.
4. 작업 및 프로젝트 관리에 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -75,6 +76,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
}
```
사용 가능한 필드: `space_ids%5B%5D`, `project_ids%5B%5D`, `list_ids%5B%5D`, `statuses%5B%5D`, `include_closed`, `assignees%5B%5D`, `tags%5B%5D`, `due_date_gt`, `due_date_lt`, `date_created_gt`, `date_created_lt`, `date_updated_gt`, `date_updated_lt`
</Accordion>
<Accordion title="clickup/get_task_in_list">
@@ -83,6 +85,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `listId` (string, 필수): 목록 - 작업을 가져올 목록을 선택합니다. 사용자가 ClickUp 목록을 선택할 수 있도록 Connect Portal 사용자 설정을 사용하세요.
- `taskFilterFormula` (string, 선택): 지정된 필터와 일치하는 작업을 검색합니다. 예: name=task1.
</Accordion>
<Accordion title="clickup/create_task">
@@ -96,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `assignees` (string, 선택): 담당자 - 이 작업에 할당할 멤버(또는 멤버 ID 배열)를 선택합니다. 사용자가 ClickUp 멤버를 선택할 수 있도록 Connect Portal 사용자 설정을 사용하세요.
- `dueDate` (string, 선택): 마감일 - 이 작업의 마감일을 지정합니다.
- `additionalFields` (string, 선택): 추가 필드 - 이 작업에 포함할 추가 필드를 JSON으로 지정합니다.
</Accordion>
<Accordion title="clickup/update_task">
@@ -110,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `assignees` (string, 선택): 담당자 - 이 작업에 할당할 멤버(또는 멤버 ID 배열)를 선택합니다. 사용자가 ClickUp 멤버를 선택할 수 있도록 Connect Portal 사용자 설정을 사용하세요.
- `dueDate` (string, 선택): 마감일 - 이 작업의 마감일을 지정합니다.
- `additionalFields` (string, 선택): 추가 필드 - 이 작업에 포함할 추가 필드를 JSON으로 지정합니다.
</Accordion>
<Accordion title="clickup/delete_task">
@@ -117,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `taskId` (string, 필수): 작업 ID - 삭제할 작업의 ID입니다.
</Accordion>
<Accordion title="clickup/get_list">
@@ -124,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `spaceId` (string, 필수): 스페이스 ID - 목록이 포함된 스페이스의 ID입니다.
</Accordion>
<Accordion title="clickup/get_custom_fields_in_list">
@@ -131,6 +138,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `listId` (string, 필수): 목록 ID - 사용자 정의 필드를 가져올 목록의 ID입니다.
</Accordion>
<Accordion title="clickup/get_all_fields_in_list">
@@ -138,6 +146,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `listId` (string, 필수): 목록 ID - 모든 필드를 가져올 목록의 ID입니다.
</Accordion>
<Accordion title="clickup/get_space">
@@ -145,6 +154,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `spaceId` (string, 선택): 스페이스 ID - 조회할 스페이스의 ID입니다.
</Accordion>
<Accordion title="clickup/get_folders">
@@ -152,12 +162,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `spaceId` (string, 필수): 스페이스 ID - 폴더가 포함된 스페이스의 ID입니다.
</Accordion>
<Accordion title="clickup/get_member">
**설명:** ClickUp에서 멤버 정보를 가져옵니다.
**파라미터:** 필요 없음.
</Accordion>
</AccordionGroup>
@@ -282,6 +294,11 @@ crew.kickoff()
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
ClickUp 연동 설정 또는 문제 해결에 대한 지원이 필요하신 경우 저희 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
ClickUp 연동 설정 또는 문제 해결에 대한 지원이 필요하신 경우 저희 지원팀에
문의하세요.
</Card>

23
docs/ko/enterprise/integrations/github.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
GitHub 통합을 사용하기 전에 다음을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 해당 리포지토리에 대한 적절한 권한이 있는 GitHub 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 GitHub 계정 연결 완료
@@ -21,7 +21,7 @@ GitHub 통합을 사용하기 전에 다음을 확인하세요:
### 1. GitHub 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. 인증 통합 섹션에서 **GitHub**을 찾습니다.
3. **Connect**를 클릭하고 OAuth 흐름을 완료합니다.
4. 리포지토리 및 이슈 관리를 위한 필수 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -61,6 +62,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `title` (string, 필수): 이슈 제목 - 생성할 이슈의 제목을 지정합니다.
- `body` (string, 선택): 이슈 본문 - 생성할 이슈의 본문 내용을 지정합니다.
- `assignees` (string, 선택): 담당자 - 이 이슈의 담당자 GitHub 로그인을 문자열 배열로 지정합니다. (예시: `["octocat"]`).
</Accordion>
<Accordion title="github/update_issue">
@@ -75,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `assignees` (string, 선택): 담당자 - 이 이슈의 담당자 GitHub 로그인을 문자열 배열로 지정합니다. (예시: `["octocat"]`).
- `state` (string, 선택): 상태 - 이슈의 변경된 상태를 지정합니다.
- 옵션: `open`, `closed`
</Accordion>
<Accordion title="github/get_issue_by_number">
@@ -84,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `owner` (string, 필수): 소유자 - 이 이슈와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: "abc").
- `repo` (string, 필수): 저장소 - 이 이슈와 연관된 저장소 이름을 지정합니다.
- `issue_number` (string, 필수): 이슈 번호 - 가져올 이슈의 번호를 지정합니다.
</Accordion>
<Accordion title="github/lock_issue">
@@ -95,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `issue_number` (string, 필수): 이슈 번호 - 잠글 이슈의 번호를 지정합니다.
- `lock_reason` (string, 필수): 잠금 사유 - 이슈 또는 풀 리퀘스트 대화에 대한 잠금 이유를 지정합니다.
- 옵션: `off-topic`, `too heated`, `resolved`, `spam`
</Accordion>
<Accordion title="github/search_issue">
@@ -122,6 +127,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
}
```
사용 가능한 필드: `assignee`, `creator`, `mentioned`, `labels`
</Accordion>
<Accordion title="github/create_release">
@@ -140,6 +146,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `discussion_category_name` (string, 선택): 토론 카테고리 이름 - 지정 시, 해당 카테고리의 토론이 생성되어 릴리스와 연결됩니다. 값은 저장소에 이미 존재하는 카테고리여야 합니다.
- `generate_release_notes` (string, 선택): 릴리스 노트 - 지정한 이름과 본문을 사용하여 릴리스 노트를 자동으로 생성할지 여부를 지정합니다.
- 옵션: `true`, `false`
</Accordion>
<Accordion title="github/update_release">
@@ -159,6 +166,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `discussion_category_name` (string, 선택): 토론 카테고리 이름 - 지정 시, 해당 카테고리의 토론이 생성되어 릴리스와 연결됩니다. 값은 저장소에 이미 존재하는 카테고리여야 합니다.
- `generate_release_notes` (string, 선택): 릴리스 노트 - 지정한 이름과 본문을 사용하여 릴리스 노트를 자동으로 생성할지 여부를 지정합니다.
- 옵션: `true`, `false`
</Accordion>
<Accordion title="github/get_release_by_id">
@@ -168,6 +176,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `owner` (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: "abc").
- `repo` (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.
- `id` (string, 필수): 릴리스 ID - 조회할 릴리스의 ID를 지정합니다.
</Accordion>
<Accordion title="github/get_release_by_tag_name">
@@ -177,6 +186,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `owner` (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: "abc").
- `repo` (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.
- `tag_name` (string, 필수): 이름 - 가져올 릴리스의 태그를 지정합니다. (예시: "v1.0.0").
</Accordion>
<Accordion title="github/delete_release">
@@ -186,6 +196,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `owner` (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: "abc").
- `repo` (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.
- `id` (string, 필수): 릴리스 ID - 삭제할 릴리스의 ID를 지정합니다.
</Accordion>
</AccordionGroup>
@@ -312,6 +323,10 @@ crew.kickoff()
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
GitHub 통합 설정 또는 문제 해결에 대해 지원팀에 문의하세요.
</Card>

25
docs/ko/enterprise/integrations/gmail.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Gmail 통합을 사용하기 전에 다음을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 권한이 있는 Gmail 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Gmail 계정 연결
@@ -21,7 +21,7 @@ Gmail 통합을 사용하기 전에 다음을 확인하세요:
### 1. Gmail 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. 인증 통합 섹션에서 **Gmail**을 찾습니다.
3. **Connect**를 클릭하고 OAuth 흐름을 완료합니다.
4. 이메일 및 연락처 관리를 위한 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -73,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"reply-to": "Sender Name <sender@domain.com>"
}
```
</Accordion>
<Accordion title="gmail/get_email_by_id">
@@ -81,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `userId` (string, 필수): 사용자 ID - 사용자의 이메일 주소를 지정합니다. (예: "user@domain.com").
- `messageId` (string, 필수): 메시지 ID - 조회할 메시지의 ID를 지정합니다.
</Accordion>
<Accordion title="gmail/fetch_emails">
@@ -112,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"pageCursor": "page_cursor_string"
}
```
</Accordion>
<Accordion title="gmail/delete_email">
@@ -120,6 +124,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `userId` (string, 필수): 사용자 ID - 사용자의 이메일 주소를 지정합니다. (예: "user@domain.com").
- `messageId` (string, 필수): 메시지 ID - 휴지통으로 보낼 메시지의 ID를 지정합니다.
</Accordion>
<Accordion title="gmail/create_a_contact">
@@ -140,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
]
}
```
</Accordion>
<Accordion title="gmail/get_contact_by_resource_name">
@@ -147,6 +153,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `resourceName` (string, 필수): 리소스 이름 - 조회할 연락처의 리소스 이름을 지정합니다.
</Accordion>
<Accordion title="gmail/search_for_contact">
@@ -154,6 +161,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `searchTerm` (string, 필수): 검색어 - 이름, 닉네임, 이메일 주소, 전화번호 또는 조직 연락처 속성에서 유사하거나 정확히 일치하는 항목을 검색할 검색어를 지정합니다.
</Accordion>
<Accordion title="gmail/delete_contact">
@@ -161,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `resourceName` (string, 필수): 리소스 이름 - 삭제할 연락처의 리소스 이름을 지정합니다.
</Accordion>
<Accordion title="gmail/create_draft">
@@ -184,6 +193,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"reply-to": "Sender Name <sender@domain.com>"
}
```
</Accordion>
</AccordionGroup>
@@ -340,6 +350,11 @@ crew.kickoff()
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Gmail 통합 설정 또는 문제 해결에 대한 지원이 필요하시다면 저희 지원팀에 문의해 주세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Gmail 통합 설정 또는 문제 해결에 대한 지원이 필요하시다면 저희 지원팀에 문의해
주세요.
</Card>

33
docs/ko/enterprise/integrations/google_calendar.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Google Calendar 통합을 사용하기 전에 다음을 준비해야 합니다:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- Google Calendar에 접근 가능한 Google 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정을 연결 완료
@@ -21,7 +21,7 @@ Google Calendar 통합을 사용하기 전에 다음을 준비해야 합니다:
### 1. Google 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. 인증 통합 섹션에서 **Google Calendar**를 찾습니다.
3. **Connect**를 클릭하고 OAuth 과정을 완료합니다.
4. 캘린더 및 연락처 접근 권한을 허용합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -65,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `eventDescription` (string, 선택): 이벤트 설명.
- `eventId` (string, 선택): 이벤트 ID - 이 이벤트와 연결할 애플리케이션의 ID입니다. 이후 이 ID를 사용하여 이벤트를 동기화할 수 있습니다.
- `includeMeetLink` (boolean, 선택): Google Meet 링크 포함 여부? - 이 이벤트에 대해 Google Meet 컨퍼런스 링크를 자동으로 생성합니다.
</Accordion>
<Accordion title="google_calendar/update_event">
@@ -79,6 +81,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `attendees` (string, 선택): 참석자 - 이메일 주소 배열 또는 쉼표로 구분된 이메일 주소 허용.
- `eventLocation` (string, 선택): 이벤트 위치.
- `eventDescription` (string, 선택): 이벤트 설명.
</Accordion>
<Accordion title="google_calendar/view_events">
@@ -88,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `calendar` (string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.
- `after` (string, 선택): 이후 - 제공된 날짜 이후에 시작하는 이벤트를 필터링합니다 (밀리초 단위의 Unix 또는 ISO 타임스탬프). (예시: "2025-04-12T10:00:00Z 또는 1712908800000").
- `before` (string, 선택): 이전 - 제공된 날짜 이전에 종료되는 이벤트를 필터링합니다 (밀리초 단위의 Unix 또는 ISO 타임스탬프). (예시: "2025-04-12T10:00:00Z 또는 1712908800000").
</Accordion>
<Accordion title="google_calendar/get_event_by_id">
@@ -96,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `eventId` (string, 필수): 이벤트 ID.
- `calendar` (string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.
</Accordion>
<Accordion title="google_calendar/delete_event">
@@ -104,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `eventId` (string, 필수): 이벤트 ID - 삭제할 캘린더 이벤트의 ID입니다.
- `calendar` (string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.
</Accordion>
<Accordion title="google_calendar/get_contacts">
@@ -116,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"pageCursor": "page_cursor_string"
}
```
</Accordion>
<Accordion title="google_calendar/search_contacts">
@@ -123,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `query` (string, 선택): 연락처를 검색할 검색 쿼리.
</Accordion>
<Accordion title="google_calendar/list_directory_people">
@@ -135,6 +143,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"pageCursor": "page_cursor_string"
}
```
</Accordion>
<Accordion title="google_calendar/search_directory_people">
@@ -148,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"pageCursor": "page_cursor_string"
}
```
</Accordion>
<Accordion title="google_calendar/list_other_contacts">
@@ -160,6 +170,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"pageCursor": "page_cursor_string"
}
```
</Accordion>
<Accordion title="google_calendar/search_other_contacts">
@@ -167,6 +178,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `query` (string, 선택): 연락처를 검색할 검색 쿼리.
</Accordion>
<Accordion title="google_calendar/get_availability">
@@ -187,6 +199,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
}
]
```
</Accordion>
</AccordionGroup>
@@ -348,33 +361,43 @@ crew.kickoff()
### 일반적인 문제
**인증 오류**
- Google 계정에 캘린더 접근에 필요한 권한이 있는지 확인하세요
- OAuth 연결에 Google Calendar API에 필요한 모든 범위가 포함되어 있는지 확인하세요
- 캘린더 공유 설정이 필요한 접근 수준을 허용하는지 확인하세요
**이벤트 생성 문제**
- 시간 형식이 올바른지(ISO8601 또는 Unix 타임스탬프) 확인하세요
- 참석자 이메일 주소가 올바르게 형식화되어 있는지 확인하세요
- 대상 캘린더가 존재하며 접근 가능한지 확인하세요
- 올바른 시간대가 지정되어 있는지 확인하세요
**가용성 및 시간 충돌**
- 가용성 확인 시 시간 범위에 올바른 ISO 형식을 사용하세요
- 모든 작업에서 시간대가 일관성 있는지 확인하세요
- 여러 캘린더를 확인할 때 캘린더 ID가 올바른지 확인하세요
**연락처 및 사용자 검색**
- 검색 쿼리가 올바르게 형식화되어 있는지 확인하세요
- 디렉터리 접근 권한이 부여되었는지 확인하세요
- 연락처 정보가 최신이며 접근 가능한지 확인하세요
**이벤트 업데이트 및 삭제**
- 이벤트 ID가 올바르며 이벤트가 존재하는지 확인하세요
- 이벤트를 편집할 수 있는 권한이 있는지 확인하세요
- 캘린더 소유권이 수정 작업을 허용하는지 확인하세요
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Google Calendar 연동 설정 또는 문제 해결에 대한 지원이 필요하면 저희 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Google Calendar 연동 설정 또는 문제 해결에 대한 지원이 필요하면 저희 지원팀에
문의하세요.
</Card>

32
docs/ko/enterprise/integrations/google_contacts.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Google Contacts 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- Google Contacts 액세스 권한이 있는 Google 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정 연결
@@ -21,7 +21,7 @@ Google Contacts 통합을 사용하기 전에 다음 사항을 확인하세요:
### 1. Google 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
2. 인증 통합 섹션에서 **Google Contacts** 찾기
3. **연결**을 클릭하고 OAuth 플로우 완료
4. 연락처 및 디렉토리 액세스에 필요한 권한 부여
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -61,6 +62,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `personFields` (string, 선택사항): 포함할 필드 (예: 'names,emailAddresses,phoneNumbers'). 기본값: names,emailAddresses,phoneNumbers
- `requestSyncToken` (boolean, 선택사항): 응답에 동기화 토큰을 포함할지 여부. 기본값: false
- `sortOrder` (string, 선택사항): 연결을 정렬할 순서. 옵션: LAST_MODIFIED_ASCENDING, LAST_MODIFIED_DESCENDING, FIRST_NAME_ASCENDING, LAST_NAME_ASCENDING
</Accordion>
<Accordion title="google_contacts/search_contacts">
@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `pageSize` (integer, 선택사항): 반환할 결과 수. 최소: 1, 최대: 30
- `pageToken` (string, 선택사항): 반환할 결과 페이지를 지정하는 토큰.
- `sources` (array, 선택사항): 검색할 소스. 옵션: READ_SOURCE_TYPE_CONTACT, READ_SOURCE_TYPE_PROFILE. 기본값: READ_SOURCE_TYPE_CONTACT
</Accordion>
<Accordion title="google_contacts/list_directory_people">
@@ -84,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `readMask` (string, 선택사항): 읽을 필드 (예: 'names,emailAddresses')
- `requestSyncToken` (boolean, 선택사항): 응답에 동기화 토큰을 포함할지 여부. 기본값: false
- `mergeSources` (array, 선택사항): 디렉토리 사람 응답에 병합할 추가 데이터. 옵션: CONTACT
</Accordion>
<Accordion title="google_contacts/search_directory_people">
@@ -94,6 +98,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `sources` (string, 필수): 디렉토리 소스 ('DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE' 사용)
- `pageSize` (integer, 선택사항): 반환할 결과 수
- `readMask` (string, 선택사항): 읽을 필드
</Accordion>
<Accordion title="google_contacts/list_other_contacts">
@@ -104,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `pageToken` (string, 선택사항): 반환할 결과 페이지를 지정하는 토큰.
- `readMask` (string, 선택사항): 읽을 필드
- `requestSyncToken` (boolean, 선택사항): 응답에 동기화 토큰을 포함할지 여부. 기본값: false
</Accordion>
<Accordion title="google_contacts/search_other_contacts">
@@ -113,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `query` (string, 필수): 검색 쿼리
- `readMask` (string, 필수): 읽을 필드 (예: 'names,emailAddresses')
- `pageSize` (integer, 선택사항): 결과 수
</Accordion>
<Accordion title="google_contacts/get_person">
@@ -121,6 +128,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `resourceName` (string, 필수): 가져올 사람의 리소스 이름 (예: 'people/c123456789')
- `personFields` (string, 선택사항): 포함할 필드 (예: 'names,emailAddresses,phoneNumbers'). 기본값: names,emailAddresses,phoneNumbers
</Accordion>
<Accordion title="google_contacts/create_contact">
@@ -132,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `phoneNumbers` (array, 선택사항): 전화번호들. 각 항목은 `value` (string, 전화번호)와 `type` (string, 'home', 'work', 'mobile', 'other', 기본값 'other')이 있는 객체.
- `addresses` (array, 선택사항): 우편 주소들. 각 항목은 `formattedValue` (string, 형식화된 주소)와 `type` (string, 'home', 'work', 'other', 기본값 'other')이 있는 객체.
- `organizations` (array, 선택사항): 조직/회사들. 각 항목은 `name` (string, 조직 이름), `title` (string, 직책), `type` (string, 'work', 'other', 기본값 'work')이 있는 객체.
</Accordion>
<Accordion title="google_contacts/update_contact">
@@ -143,6 +152,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `names` (array, 선택사항): 사람의 이름들. 각 항목은 `givenName` (string), `familyName` (string), `displayName` (string)이 있는 객체.
- `emailAddresses` (array, 선택사항): 이메일 주소들. 각 항목은 `value` (string, 이메일 주소)와 `type` (string, 'home', 'work', 'other')이 있는 객체.
- `phoneNumbers` (array, 선택사항): 전화번호들. 각 항목은 `value` (string, 전화번호)와 `type` (string, 'home', 'work', 'mobile', 'other')이 있는 객체.
</Accordion>
<Accordion title="google_contacts/delete_contact">
@@ -150,6 +160,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `resourceName` (string, 필수): 삭제할 사람의 리소스 이름 (예: 'people/c123456789').
</Accordion>
<Accordion title="google_contacts/batch_get_people">
@@ -158,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `resourceNames` (array, 필수): 가져올 사람들의 리소스 이름 (최대 200개 항목).
- `personFields` (string, 선택사항): 포함할 필드 (예: 'names,emailAddresses,phoneNumbers'). 기본값: names,emailAddresses,phoneNumbers
</Accordion>
<Accordion title="google_contacts/list_contact_groups">
@@ -167,6 +179,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `pageSize` (integer, 선택사항): 반환할 연락처 그룹 수. 최소: 1, 최대: 1000
- `pageToken` (string, 선택사항): 반환할 결과 페이지를 지정하는 토큰.
- `groupFields` (string, 선택사항): 포함할 필드 (예: 'name,memberCount,clientData'). 기본값: name,memberCount
</Accordion>
<Accordion title="google_contacts/get_contact_group">
@@ -176,6 +189,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `resourceName` (string, 필수): 연락처 그룹의 리소스 이름 (예: 'contactGroups/myContactGroup').
- `maxMembers` (integer, 선택사항): 포함할 최대 멤버 수. 최소: 0, 최대: 20000
- `groupFields` (string, 선택사항): 포함할 필드 (예: 'name,memberCount,clientData'). 기본값: name,memberCount
</Accordion>
<Accordion title="google_contacts/create_contact_group">
@@ -184,6 +198,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `name` (string, 필수): 연락처 그룹의 이름.
- `clientData` (array, 선택사항): 클라이언트별 데이터. 각 항목은 `key` (string)와 `value` (string)가 있는 객체.
</Accordion>
</AccordionGroup>
@@ -223,15 +238,22 @@ crew.kickoff()
### 일반적인 문제
**인증 오류**
- Google 계정이 연락처 및 디렉토리 액세스에 필요한 권한을 가지고 있는지 확인하세요.
- OAuth 연결이 Google People API에 필요한 모든 범위를 포함하는지 확인하세요.
**연락처 생성/업데이트 문제**
- 연락처 생성 시 `email`과 같은 필수 필드가 제공되는지 확인하세요.
- 연락처를 업데이트하거나 삭제할 때 `resourceName`이 올바른지 확인하세요.
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Google Contacts 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Google Contacts 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에
문의하세요.
</Card>

26
docs/ko/enterprise/integrations/google_docs.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Google Docs 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- Google Docs 액세스 권한이 있는 Google 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정 연결
@@ -21,7 +21,7 @@ Google Docs 통합을 사용하기 전에 다음 사항을 확인하세요:
### 1. Google 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
2. 인증 통합 섹션에서 **Google Docs** 찾기
3. **연결**을 클릭하고 OAuth 플로우 완료
4. 문서 액세스에 필요한 권한 부여
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `title` (string, 선택사항): 새 문서의 제목.
</Accordion>
<Accordion title="google_docs/get_document">
@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `documentId` (string, 필수): 검색할 문서의 ID.
- `includeTabsContent` (boolean, 선택사항): 탭 내용을 포함할지 여부. 기본값: false
- `suggestionsViewMode` (string, 선택사항): 문서에 적용할 제안 보기 모드. 옵션: DEFAULT_FOR_CURRENT_ACCESS, PREVIEW_SUGGESTIONS_ACCEPTED, PREVIEW_WITHOUT_SUGGESTIONS. 기본값: DEFAULT_FOR_CURRENT_ACCESS
</Accordion>
<Accordion title="google_docs/batch_update">
@@ -75,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `documentId` (string, 필수): 업데이트할 문서의 ID.
- `requests` (array, 필수): 문서에 적용할 업데이트 목록. 각 항목은 요청을 나타내는 객체.
- `writeControl` (object, 선택사항): 쓰기 요청이 실행되는 방식을 제어합니다. `requiredRevisionId` (string)와 `targetRevisionId` (string)를 포함.
</Accordion>
<Accordion title="google_docs/insert_text">
@@ -84,6 +88,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `documentId` (string, 필수): 업데이트할 문서의 ID.
- `text` (string, 필수): 삽입할 텍스트.
- `index` (integer, 선택사항): 텍스트를 삽입할 0 기반 인덱스. 기본값: 1
</Accordion>
<Accordion title="google_docs/replace_text">
@@ -94,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `containsText` (string, 필수): 찾아서 교체할 텍스트.
- `replaceText` (string, 필수): 교체할 텍스트.
- `matchCase` (boolean, 선택사항): 검색이 대소문자를 구분할지 여부. 기본값: false
</Accordion>
<Accordion title="google_docs/delete_content_range">
@@ -103,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `documentId` (string, 필수): 업데이트할 문서의 ID.
- `startIndex` (integer, 필수): 삭제할 범위의 시작 인덱스.
- `endIndex` (integer, 필수): 삭제할 범위의 끝 인덱스.
</Accordion>
<Accordion title="google_docs/insert_page_break">
@@ -111,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `documentId` (string, 필수): 업데이트할 문서의 ID.
- `index` (integer, 선택사항): 페이지 나누기를 삽입할 0 기반 인덱스. 기본값: 1
</Accordion>
<Accordion title="google_docs/create_named_range">
@@ -121,6 +129,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `name` (string, 필수): 명명된 범위의 이름.
- `startIndex` (integer, 필수): 범위의 시작 인덱스.
- `endIndex` (integer, 필수): 범위의 끝 인덱스.
</Accordion>
</AccordionGroup>
@@ -160,15 +169,22 @@ crew.kickoff()
### 일반적인 문제
**인증 오류**
- Google 계정이 Google Docs 액세스에 필요한 권한을 가지고 있는지 확인하세요.
- OAuth 연결이 필요한 모든 범위(`https://www.googleapis.com/auth/documents`)를 포함하는지 확인하세요.
**문서 ID 문제**
- 문서 ID가 올바른지 다시 확인하세요.
- 문서가 존재하고 계정에서 액세스할 수 있는지 확인하세요.
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Google Docs 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Google Docs 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에
문의하세요.
</Card>

16
docs/ko/enterprise/integrations/google_drive.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Google Drive 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- Google Drive 액세스 권한이 있는 Google 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정 연결
@@ -21,7 +21,7 @@ Google Drive 통합을 사용하기 전에 다음 사항을 확인하세요:
### 1. Google 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
2. 인증 통합 섹션에서 **Google Drive**를 찾습니다.
3. **연결**을 클릭하고 OAuth 과정을 완료합니다.
4. 파일 및 폴더 관리에 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -57,6 +58,11 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Google Drive 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Google Drive 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에
문의하세요.
</Card>

25
docs/ko/enterprise/integrations/google_sheets.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Google Sheets 통합을 사용하기 전에 다음을 확인하세요:
- 활성 구독이 되어 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 되어 있는 [CrewAI AMP](https://app.crewai.com) 계정
- Google Sheets에 액세스할 수 있는 Google 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정 연결
- 데이터 작업을 위한 올바른 열 헤더가 있는 스프레드시트
@@ -22,7 +22,7 @@ Google Sheets 통합을 사용하기 전에 다음을 확인하세요:
### 1. Google 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. 인증 통합 섹션에서 **Google Sheets**를 찾습니다.
3. **Connect**를 클릭하고 OAuth 흐름을 완료합니다.
4. 스프레드시트 접근에 필요한 권한을 허용합니다.
@@ -37,7 +37,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -59,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `spreadsheetId` (string, 필수): 스프레드시트 - Connect Portal Workflow Settings를 사용하여 사용자가 스프레드시트를 선택할 수 있도록 합니다. 선택한 스프레드시트의 첫 번째 워크시트를 기본값으로 사용합니다.
- `limit` (string, 선택): 행 제한 - 반환할 최대 행 수를 제한합니다.
</Accordion>
<Accordion title="google_sheets/append_values">
@@ -76,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"columnName4": "columnValue4"
}
```
</Accordion>
<Accordion title="google_sheets/update_values">
@@ -112,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"columnName4": "newValue4"
}
```
</Accordion>
</AccordionGroup>
@@ -273,38 +277,49 @@ crew.kickoff()
### 일반적인 문제
**권한 오류**
- Google 계정이 대상 스프레드시트에 대해 편집 권한이 있는지 확인하세요
- OAuth 연결에 Google Sheets API에 필요한 scope가 포함되어 있는지 검증하세요
- 스프레드시트가 인증된 계정과 공유되어 있는지 확인하세요
**스프레드시트 구조 문제**
- 행을 생성하거나 업데이트하기 전에 워크시트에 올바른 열 헤더가 있는지 확인하세요
- `additionalFields`의 열 이름이 실제 열 헤더와 일치하는지 검증하세요
- 지정된 워크시트가 스프레드시트에 존재하는지 확인하세요
**데이터 유형 및 형식 문제**
- 데이터 값이 각 열에 대해 예상되는 형식과 일치하는지 확인하세요
- 날짜 열에는 올바른 날짜 형식(ISO 형식 권장)을 사용하세요
- 숫자 열에 입력되는 값이 적절한 형식인지 검증하세요
**필터 수식 문제**
- 필터 수식이 부정 정규형(disjunctive normal form)의 올바른 JSON 구조를 따르는지 확인하세요
- 실제 열 헤더와 일치하는 유효한 필드명을 사용하세요
- 복잡한 다중 조건 쿼리를 작성하기 전에 간단한 필터로 테스트하세요
- 연산자 유형이 열의 데이터 유형과 일치하는지 검증하세요
**행 제한 및 성능**
- `GOOGLE_SHEETS_GET_ROW`를 사용할 때 행 제한에 유의하세요
- 대용량 데이터셋의 경우 페이지네이션을 고려하세요
- 처리되는 데이터의 양을 줄이기 위해 구체적인 필터를 사용하세요
**업데이트 작업**
- 필터 조건이 업데이트하려는 행을 정확하게 식별하는지 확인하세요
- 대규모 업데이트 전에 작은 데이터셋으로 필터 조건을 테스트하세요
- 모든 필수 필드가 업데이트 작업에 포함되어 있는지 검증하세요
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Google Sheets 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 저희 지원팀으로 문의해 주세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Google Sheets 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 저희
지원팀으로 문의해 주세요.
</Card>

28
docs/ko/enterprise/integrations/google_slides.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Google Slides 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- Google Slides 액세스 권한이 있는 Google 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정 연결
@@ -21,7 +21,7 @@ Google Slides 통합을 사용하기 전에 다음 사항을 확인하세요:
### 1. Google 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
2. 인증 통합 섹션에서 **Google Slides** 찾기
3. **연결**을 클릭하고 OAuth 플로우 완료
4. 프레젠테이션, 스프레드시트 및 드라이브 액세스에 필요한 권한 부여
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `title` (string, 필수): 프레젠테이션의 제목.
</Accordion>
<Accordion title="google_slides/get_presentation">
@@ -65,6 +67,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `presentationId` (string, 필수): 검색할 프레젠테이션의 ID.
- `fields` (string, 선택사항): 응답에 포함할 필드. 성능 향상을 위해 필요한 데이터만 반환하는 데 사용.
</Accordion>
<Accordion title="google_slides/batch_update_presentation">
@@ -74,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `presentationId` (string, 필수): 업데이트할 프레젠테이션의 ID.
- `requests` (array, 필수): 프레젠테이션에 적용할 업데이트 목록. 각 항목은 요청을 나타내는 객체.
- `writeControl` (object, 선택사항): 쓰기 요청이 실행되는 방식을 제어합니다. `requiredRevisionId` (string)를 포함.
</Accordion>
<Accordion title="google_slides/get_page">
@@ -82,6 +86,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `presentationId` (string, 필수): 프레젠테이션의 ID.
- `pageObjectId` (string, 필수): 검색할 페이지의 ID.
</Accordion>
<Accordion title="google_slides/get_thumbnail">
@@ -90,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `presentationId` (string, 필수): 프레젠테이션의 ID.
- `pageObjectId` (string, 필수): 썸네일 생성을 위한 페이지의 ID.
</Accordion>
<Accordion title="google_slides/import_data_from_sheet">
@@ -99,6 +105,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `presentationId` (string, 필수): 프레젠테이션의 ID.
- `sheetId` (string, 필수): 가져올 Google 시트의 ID.
- `dataRange` (string, 필수): 시트에서 가져올 데이터 범위.
</Accordion>
<Accordion title="google_slides/upload_file_to_drive">
@@ -107,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file` (string, 필수): 업로드할 파일 데이터.
- `presentationId` (string, 필수): 업로드된 파일을 연결할 프레젠테이션의 ID.
</Accordion>
<Accordion title="google_slides/link_file_to_presentation">
@@ -115,6 +123,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `presentationId` (string, 필수): 프레젠테이션의 ID.
- `fileId` (string, 필수): 연결할 파일의 ID.
</Accordion>
<Accordion title="google_slides/get_all_presentations">
@@ -123,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `pageSize` (integer, 선택사항): 페이지당 반환할 프레젠테이션 수.
- `pageToken` (string, 선택사항): 페이지네이션을 위한 토큰.
</Accordion>
<Accordion title="google_slides/delete_presentation">
@@ -130,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `presentationId` (string, 필수): 삭제할 프레젠테이션의 ID.
</Accordion>
</AccordionGroup>
@@ -169,15 +180,22 @@ crew.kickoff()
### 일반적인 문제
**인증 오류**
- Google 계정이 Google Slides 및 Google Drive 액세스에 필요한 권한을 가지고 있는지 확인하세요.
- OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.
**프레젠테이션/페이지 ID 문제**
- 프레젠테이션 ID와 페이지 객체 ID가 올바른지 다시 확인하세요.
- 프레젠테이션이나 페이지가 존재하고 액세스할 수 있는지 확인하세요.
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Google Slides 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Google Slides 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에
문의하세요.
</Card>

45
docs/ko/enterprise/integrations/hubspot.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
HubSpot 통합을 사용하기 전에 다음을 확인하세요.
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 권한이 있는 HubSpot 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 HubSpot 계정이 연결되어 있음
@@ -21,7 +21,7 @@ HubSpot 통합을 사용하기 전에 다음을 확인하세요.
### 1. HubSpot 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. 인증 통합 섹션에서 **HubSpot**을 찾습니다.
3. **Connect**를 클릭하고 OAuth 플로우를 완료합니다.
4. 회사 및 연락처 관리를 위한 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -115,6 +116,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `web_technologies` (string, 선택): 사용한 웹 기술. 미리 정의된 값 중 하나여야 합니다.
- `website` (string, 선택): 웹사이트 URL.
- `founded_year` (string, 선택): 설립 연도.
</Accordion>
<Accordion title="hubspot/create_contact">
@@ -214,6 +216,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `hs_whatsapp_phone_number` (string, 선택): WhatsApp 전화번호.
- `work_email` (string, 선택): 업무용 이메일.
- `hs_googleplusid` (string, 선택): googleplus ID.
</Accordion>
<Accordion title="hubspot/create_deal">
@@ -229,6 +232,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `dealtype` (string, 선택): 거래 유형. 사용 가능한 값: `newbusiness`, `existingbusiness`.
- `description` (string, 선택): 거래 설명.
- `hs_priority` (string, 선택): 거래 우선순위. 사용 가능한 값: `low`, `medium`, `high`.
</Accordion>
<Accordion title="hubspot/create_record_engagements">
@@ -246,6 +250,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `hs_meeting_body` (string, 선택): 미팅 설명. (`MEETING`에서 사용)
- `hs_meeting_start_time` (string, 선택): 미팅 시작 시간. (`MEETING`에서 사용)
- `hs_meeting_end_time` (string, 선택): 미팅 종료 시간. (`MEETING`에서 사용)
</Accordion>
<Accordion title="hubspot/update_company">
@@ -263,6 +268,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `numberofemployees` (number, 선택): 직원 수.
- `annualrevenue` (number, 선택): 연간 매출.
- `description` (string, 선택): 설명.
</Accordion>
<Accordion title="hubspot/create_record_any">
@@ -271,6 +277,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordType` (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
- 추가 파라미터는 커스텀 오브젝트의 스키마에 따라 다릅니다.
</Accordion>
<Accordion title="hubspot/update_contact">
@@ -285,6 +292,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `company` (string, 선택): 회사명.
- `jobtitle` (string, 선택): 직책.
- `lifecyclestage` (string, 선택): 라이프사이클 단계.
</Accordion>
<Accordion title="hubspot/update_deal">
@@ -298,6 +306,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `pipeline` (string, 선택): 거래가 속한 파이프라인.
- `closedate` (string, 선택): 예상 마감일.
- `dealtype` (string, 선택): 거래 유형.
</Accordion>
<Accordion title="hubspot/update_record_engagements">
@@ -309,6 +318,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `hs_task_subject` (string, 선택): 작업 제목.
- `hs_task_body` (string, 선택): 작업 노트.
- `hs_task_status` (string, 선택): 작업 상태.
</Accordion>
<Accordion title="hubspot/update_record_any">
@@ -318,6 +328,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `recordId` (string, 필수): 업데이트할 레코드의 ID.
- `recordType` (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
- 추가 파라미터는 커스텀 오브젝트의 스키마에 따라 다릅니다.
</Accordion>
<Accordion title="hubspot/list_companies">
@@ -325,6 +336,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.
</Accordion>
<Accordion title="hubspot/list_contacts">
@@ -332,6 +344,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.
</Accordion>
<Accordion title="hubspot/list_deals">
@@ -339,6 +352,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.
</Accordion>
<Accordion title="hubspot/get_records_engagements">
@@ -347,6 +361,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `objectName` (string, 필수): 가져올 참여 유형(예: "notes").
- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.
</Accordion>
<Accordion title="hubspot/get_records_any">
@@ -355,6 +370,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordType` (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.
</Accordion>
<Accordion title="hubspot/get_company">
@@ -362,6 +378,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): 가져올 회사의 ID.
</Accordion>
<Accordion title="hubspot/get_contact">
@@ -369,6 +386,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): 가져올 연락처의 ID.
</Accordion>
<Accordion title="hubspot/get_deal">
@@ -376,6 +394,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): 가져올 거래의 ID.
</Accordion>
<Accordion title="hubspot/get_record_by_id_engagements">
@@ -383,6 +402,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): 가져올 참여의 ID.
</Accordion>
<Accordion title="hubspot/get_record_by_id_any">
@@ -391,6 +411,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordType` (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
- `recordId` (string, 필수): 가져올 레코드의 ID.
</Accordion>
<Accordion title="hubspot/search_companies">
@@ -399,6 +420,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `filterFormula` (object, 선택): 분리 정규형(OR of ANDs) 필터.
- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.
</Accordion>
<Accordion title="hubspot/search_contacts">
@@ -407,6 +429,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `filterFormula` (object, 선택): 분리 정규형(OR of ANDs) 필터.
- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.
</Accordion>
<Accordion title="hubspot/search_deals">
@@ -415,6 +438,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `filterFormula` (object, 선택): 분리 정규형(OR of ANDs) 필터.
- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.
</Accordion>
<Accordion title="hubspot/search_records_engagements">
@@ -423,6 +447,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `engagementFilterFormula` (object, 선택): 참여 필터.
- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.
</Accordion>
<Accordion title="hubspot/search_records_any">
@@ -432,6 +457,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `recordType` (string, 필수): 검색할 오브젝트 타입 ID.
- `filterFormula` (string, 선택): 적용할 필터 수식.
- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.
</Accordion>
<Accordion title="hubspot/delete_record_companies">
@@ -439,6 +465,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): 삭제할 회사의 ID.
</Accordion>
<Accordion title="hubspot/delete_record_contacts">
@@ -446,6 +473,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): 삭제할 연락처의 ID.
</Accordion>
<Accordion title="hubspot/delete_record_deals">
@@ -453,6 +481,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): 삭제할 거래의 ID.
</Accordion>
<Accordion title="hubspot/delete_record_engagements">
@@ -460,6 +489,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): 삭제할 참여의 ID.
</Accordion>
<Accordion title="hubspot/delete_record_any">
@@ -468,6 +498,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordType` (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
- `recordId` (string, 필수): 삭제할 레코드의 ID.
</Accordion>
<Accordion title="hubspot/get_contacts_by_list_id">
@@ -476,6 +507,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `listId` (string, 필수): 연락처를 가져올 리스트의 ID.
- `paginationParameters` (object, 선택): 이후 페이지를 위해 `pageCursor` 사용.
</Accordion>
<Accordion title="hubspot/describe_action_schema">
@@ -484,6 +516,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordType` (string, 필수): 오브젝트 타입 ID(예: 'companies').
- `operation` (string, 필수): 작업 유형(예: 'CREATE_RECORD').
</Accordion>
</AccordionGroup>
@@ -577,6 +610,10 @@ crew.kickoff()
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
HubSpot 연동 설정 또는 문제 해결에 도움이 필요하시면 지원팀에 문의해 주세요.
</Card>

34
docs/ko/enterprise/integrations/jira.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Jira 통합을 사용하기 전에 다음을 준비하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 프로젝트 권한이 있는 Jira 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Jira 계정 연결
@@ -21,7 +21,7 @@ Jira 통합을 사용하기 전에 다음을 준비하세요:
### 1. Jira 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. **Jira**를 인증 통합 섹션에서 찾습니다.
3. **Connect**를 클릭하고 OAuth 절차를 완료합니다.
4. 이슈 및 프로젝트 관리를 위한 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -70,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"customfield_10001": "value"
}
```
</Accordion>
<Accordion title="jira/update_issue">
@@ -85,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- 옵션: `description`, `descriptionJSON`
- `description` (string, 선택): 설명 - 이슈에 대한 자세한 설명입니다. 이 필드는 'descriptionType'이 'description'일 때만 나타납니다.
- `additionalFields` (string, 선택): 추가 필드 - 포함해야 하는 다른 필드를 JSON 형식으로 지정하세요.
</Accordion>
<Accordion title="jira/get_issue_by_key">
@@ -92,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `issueKey` (string, 필수): 이슈 키 (예시: "TEST-1234").
</Accordion>
<Accordion title="jira/filter_issues">
@@ -118,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
```
사용 가능한 연산자: `$stringExactlyMatches`, `$stringDoesNotExactlyMatch`, `$stringIsIn`, `$stringIsNotIn`, `$stringContains`, `$stringDoesNotContain`, `$stringGreaterThan`, `$stringLessThan`
- `limit` (string, 선택): 결과 제한 - 반환되는 최대 이슈 수를 제한합니다. 입력하지 않으면 기본값은 10입니다.
</Accordion>
<Accordion title="jira/search_by_jql">
@@ -131,12 +136,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"pageCursor": "cursor_string"
}
```
</Accordion>
<Accordion title="jira/update_issue_any">
**설명:** Jira에서 임의의 이슈를 업데이트합니다. 이 기능의 속성 스키마를 얻으려면 DESCRIBE_ACTION_SCHEMA를 사용하세요.
**파라미터:** 특정 파라미터 없음 - 예상 스키마를 먼저 확인하려면 JIRA_DESCRIBE_ACTION_SCHEMA를 사용하세요.
</Accordion>
<Accordion title="jira/describe_action_schema">
@@ -146,6 +153,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `issueTypeId` (string, 필수): 이슈 유형 ID.
- `projectKey` (string, 필수): 프로젝트 키.
- `operation` (string, 필수): 작업 유형 값(예: CREATE_ISSUE 또는 UPDATE_ISSUE).
</Accordion>
<Accordion title="jira/get_projects">
@@ -158,6 +166,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"pageCursor": "cursor_string"
}
```
</Accordion>
<Accordion title="jira/get_issue_types_by_project">
@@ -165,12 +174,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `project` (string, 필수): 프로젝트 키.
</Accordion>
<Accordion title="jira/get_issue_types">
**설명:** Jira에서 모든 이슈 유형을 조회합니다.
**파라미터:** 필요 없음.
</Accordion>
<Accordion title="jira/get_issue_status_by_project">
@@ -178,6 +189,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `project` (string, 필수): 프로젝트 키.
</Accordion>
<Accordion title="jira/get_all_assignees_by_project">
@@ -185,6 +197,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `project` (string, 필수): 프로젝트 키.
</Accordion>
</AccordionGroup>
@@ -347,37 +360,48 @@ crew.kickoff()
### 일반적인 문제
**권한 오류**
- Jira 계정이 대상 프로젝트에 필요한 권한을 가지고 있는지 확인하세요
- OAuth 연결에 Jira API에 필요한 범위가 포함되어 있는지 확인하세요
- 지정된 프로젝트에서 이슈 생성/편집 권한이 있는지 확인하세요
**잘못된 프로젝트 또는 이슈 키**
- 프로젝트 키와 이슈 키가 올바른 형식(예: "PROJ-123")인지 다시 확인하세요
- 프로젝트가 존재하며 계정으로 접근 가능한지 확인하세요
- 이슈 키가 실제로 존재하는 이슈를 참조하는지 확인하세요
**이슈 유형 및 상태 관련 문제**
- 프로젝트에 대한 유효한 이슈 유형을 얻으려면 JIRA_GET_ISSUE_TYPES_BY_PROJECT를 사용하세요
- 유효한 상태를 얻으려면 JIRA_GET_ISSUE_STATUS_BY_PROJECT를 사용하세요
- 이슈 유형과 상태가 대상 프로젝트에 제공되는지 확인하세요
**JQL 쿼리 문제**
- API 호출에 사용하기 전에 Jira의 이슈 검색에서 JQL 쿼리를 테스트하세요
- JQL에 사용된 필드명이 정확하게 철자되어 있고, Jira 인스턴스에 존재하는지 확인하세요
- 복잡한 쿼리에는 올바른 JQL 문법을 사용하세요
**커스텀 필드 및 스키마 문제**
- 복잡한 이슈 유형에 대해 올바른 스키마를 얻으려면 JIRA_DESCRIBE_ACTION_SCHEMA를 사용하세요
- 커스텀 필드 ID가 정확한지 확인하세요 (예: "customfield_10001")
- 커스텀 필드가 대상 프로젝트와 이슈 유형에서 사용 가능한지 확인하세요
**필터 공식 문제**
- 필터 공식이 올바른 JSON 구조(불리언 합의 정규형)를 따르는지 확인하세요
- Jira 구성에 존재하는 유효한 필드명을 사용하세요
- 복잡한 다중 조건 쿼리를 만들기 전에 간단한 필터를 테스트하세요
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Jira 연동 설정 또는 문제 해결에 대한 지원이 필요하시면 저희 지원팀에 문의하십시오.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Jira 연동 설정 또는 문제 해결에 대한 지원이 필요하시면 저희 지원팀에
문의하십시오.
</Card>

33
docs/ko/enterprise/integrations/linear.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Linear 통합을 사용하기 전에 다음을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 워크스페이스 권한이 있는 Linear 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)에서 Linear 계정 연결
@@ -21,7 +21,7 @@ Linear 통합을 사용하기 전에 다음을 확인하세요:
### 1. Linear 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. 인증 통합( Authentication Integrations ) 섹션에서 **Linear**를 찾습니다.
3. **Connect**를 클릭하고 OAuth 절차를 완료합니다.
4. 이슈 및 프로젝트 관리를 위한 필수 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -70,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"labelIds": ["a70bdf0f-530a-4887-857d-46151b52b47c"]
}
```
</Accordion>
<Accordion title="linear/update_issue">
@@ -90,6 +92,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"labelIds": ["a70bdf0f-530a-4887-857d-46151b52b47c"]
}
```
</Accordion>
<Accordion title="linear/get_issue_by_id">
@@ -97,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `issueId` (string, 필수): 이슈 ID - 가져올 이슈의 레코드 ID를 지정합니다. (예: "90fbc706-18cd-42c9-ae66-6bd344cc8977").
</Accordion>
<Accordion title="linear/get_issue_by_issue_identifier">
@@ -104,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `externalId` (string, 필수): 외부 ID - 가져올 이슈의 사람이 읽을 수 있는 이슈 식별자를 지정합니다. (예: "ABC-1").
</Accordion>
<Accordion title="linear/search_issue">
@@ -131,6 +136,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
```
사용 가능한 필드: `title`, `number`, `project`, `createdAt`
사용 가능한 연산자: `$stringExactlyMatches`, `$stringDoesNotExactlyMatch`, `$stringIsIn`, `$stringIsNotIn`, `$stringStartsWith`, `$stringDoesNotStartWith`, `$stringEndsWith`, `$stringDoesNotEndWith`, `$stringContains`, `$stringDoesNotContain`, `$stringGreaterThan`, `$stringLessThan`, `$numberGreaterThanOrEqualTo`, `$numberLessThanOrEqualTo`, `$numberGreaterThan`, `$numberLessThan`, `$dateTimeAfter`, `$dateTimeBefore`
</Accordion>
<Accordion title="linear/delete_issue">
@@ -138,6 +144,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `issueId` (string, 필수): 이슈 ID - 삭제할 이슈의 레코드 ID를 지정합니다. (예: "90fbc706-18cd-42c9-ae66-6bd344cc8977").
</Accordion>
<Accordion title="linear/archive_issue">
@@ -145,6 +152,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `issueId` (string, 필수): 이슈 ID - 아카이브할 이슈의 레코드 ID를 지정합니다. (예: "90fbc706-18cd-42c9-ae66-6bd344cc8977").
</Accordion>
<Accordion title="linear/create_sub_issue">
@@ -161,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"lead": "linear_user_id"
}
```
</Accordion>
<Accordion title="linear/create_project">
@@ -183,6 +192,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"description": ""
}
```
</Accordion>
<Accordion title="linear/update_project">
@@ -199,6 +209,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
"description": ""
}
```
</Accordion>
<Accordion title="linear/get_project_by_id">
@@ -206,6 +217,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `projectId` (string, 필수): 프로젝트 ID - 가져올 프로젝트의 프로젝트 ID를 지정합니다. (예: "a6634484-6061-4ac7-9739-7dc5e52c796b").
</Accordion>
<Accordion title="linear/delete_project">
@@ -213,6 +225,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `projectId` (string, 필수): 프로젝트 ID - 삭제할 프로젝트의 프로젝트 ID를 지정합니다. (예: "a6634484-6061-4ac7-9739-7dc5e52c796b").
</Accordion>
<Accordion title="linear/search_teams">
@@ -238,6 +251,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
}
```
사용 가능한 필드: `id`, `name`
</Accordion>
</AccordionGroup>
@@ -400,43 +414,54 @@ crew.kickoff()
### 일반적인 문제
**권한 오류**
- Linear 계정이 대상 워크스페이스에 필요한 권한을 가지고 있는지 확인하세요
- OAuth 연결에 Linear API에 필요한 스코프가 포함되어 있는지 확인하세요
- 워크스페이스에서 이슈 및 프로젝트를 생성/편집할 권한이 있는지 확인하세요
**잘못된 ID 및 참조**
- 팀 ID, 이슈 ID, 프로젝트 ID가 올바른 UUID 형식인지 다시 한번 확인하세요
- 참조된 엔티티(팀, 프로젝트, 사이클)가 존재하며 접근 가능한지 확인하세요
- 이슈 식별자가 올바른 형식(예: "ABC-1")을 따르는지 검증하세요
**팀 및 프로젝트 연관 문제**
- 이슈나 프로젝트를 생성하기 전에 LINEAR_SEARCH_TEAMS를 사용하여 유효한 팀 ID를 조회하세요
- 워크스페이스 내에 팀이 존재하고 활성화되어 있는지 확인하세요
- 팀 ID가 올바르게 UUID 형식으로 구성되어 있는지 검증하세요
**이슈 상태 및 우선순위 문제**
- 상태 ID가 팀의 유효한 워크플로우 상태를 참조하는지 확인하세요
- 우선순위 값이 Linear 구성에서 허용된 범위 내에 있는지 확인하세요
- 참조하기 전에 사용자 지정 필드와 라벨이 존재하는지 검증하세요
**날짜 및 시간 형식 문제**
- 마감일 및 타임스탬프에 ISO 8601 형식을 사용하세요
- 마감일 계산 시 타임존을 올바로 처리하는지 확인하세요
- 마감일의 날짜 값이 유효하며 미래인지 검증하세요
**검색 및 필터 문제**
- 검색 쿼리가 올바르게 형식화되어 있으며 비어 있지 않은지 확인하세요
- 필터 공식에서 유효한 필드 이름을 사용하세요: `title`, `number`, `project`, `createdAt`
- 복잡한 다중 조건 쿼리를 만들기 전에 단순한 필터를 먼저 테스트해 보세요
- 연산자 타입이 필터링 대상 필드의 데이터 타입과 일치하는지 확인하세요
**서브이슈 생성 문제**
- 상위 이슈 ID가 유효하고 접근 가능한지 확인하세요
- 서브이슈의 팀 ID가 상위 이슈 팀과 일치하거나 호환되는지 검증하세요
- 상위 이슈가 이미 보관/삭제되지 않았는지 확인하세요
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Linear 연동 설정 또는 문제 해결에 대해 지원팀에 문의하세요.
</Card>

34
docs/ko/enterprise/integrations/microsoft_excel.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Microsoft Excel 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- Excel 및 OneDrive/SharePoint 액세스 권한이 있는 Microsoft 365 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결
@@ -21,7 +21,7 @@ Microsoft Excel 통합을 사용하기 전에 다음 사항을 확인하세요:
### 1. Microsoft 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
2. 인증 통합 섹션에서 **Microsoft Excel** 찾기
3. **연결**을 클릭하고 OAuth 플로우 완료
4. 파일 및 Excel 통합 문서 액세스에 필요한 권한 부여
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -58,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_path` (string, 필수): 통합 문서를 만들 경로 (예: 'MyWorkbook.xlsx')
- `worksheets` (array, 선택사항): 만들 초기 워크시트들. 각 항목은 `name` (string, 워크시트 이름)이 있는 객체.
</Accordion>
<Accordion title="microsoft_excel/get_workbooks">
@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `expand` (string, 선택사항): 관련 리소스를 인라인으로 확장.
- `top` (integer, 선택사항): 반환할 항목 수 (최소 1, 최대 999).
- `orderby` (string, 선택사항): 지정된 속성으로 결과 정렬.
</Accordion>
<Accordion title="microsoft_excel/get_worksheets">
@@ -81,6 +84,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `expand` (string, 선택사항): 관련 리소스를 인라인으로 확장.
- `top` (integer, 선택사항): 반환할 항목 수 (최소 1, 최대 999).
- `orderby` (string, 선택사항): 지정된 속성으로 결과 정렬.
</Accordion>
<Accordion title="microsoft_excel/create_worksheet">
@@ -89,6 +93,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_id` (string, 필수): Excel 파일의 ID.
- `name` (string, 필수): 새 워크시트의 이름.
</Accordion>
<Accordion title="microsoft_excel/get_range_data">
@@ -98,6 +103,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `file_id` (string, 필수): Excel 파일의 ID.
- `worksheet_name` (string, 필수): 워크시트의 이름.
- `range` (string, 필수): 범위 주소 (예: 'A1:C10').
</Accordion>
<Accordion title="microsoft_excel/update_range_data">
@@ -108,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `worksheet_name` (string, 필수): 워크시트의 이름.
- `range` (string, 필수): 범위 주소 (예: 'A1:C10').
- `values` (array, 필수): 범위에 설정할 값들의 2D 배열. 각 내부 배열은 행을 나타내며, 요소는 string, number 또는 integer일 수 있음.
</Accordion>
<Accordion title="microsoft_excel/add_table">
@@ -118,6 +125,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `worksheet_name` (string, 필수): 워크시트의 이름.
- `range` (string, 필수): 테이블의 범위 (예: 'A1:D10').
- `has_headers` (boolean, 선택사항): 첫 번째 행이 헤더를 포함하는지 여부. 기본값: true.
</Accordion>
<Accordion title="microsoft_excel/get_tables">
@@ -126,6 +134,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_id` (string, 필수): Excel 파일의 ID.
- `worksheet_name` (string, 필수): 워크시트의 이름.
</Accordion>
<Accordion title="microsoft_excel/add_table_row">
@@ -136,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `worksheet_name` (string, 필수): 워크시트의 이름.
- `table_name` (string, 필수): 테이블의 이름.
- `values` (array, 필수): 새 행의 값들 배열. 요소는 string, number 또는 integer일 수 있음.
</Accordion>
<Accordion title="microsoft_excel/create_chart">
@@ -147,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `chart_type` (string, 필수): 차트 유형 (예: 'ColumnClustered', 'Line', 'Pie').
- `source_data` (string, 필수): 차트의 데이터 범위 (예: 'A1:B10').
- `series_by` (string, 선택사항): 데이터 해석 방법 ('Auto', 'Columns' 또는 'Rows'). 기본값: 'Auto'.
</Accordion>
<Accordion title="microsoft_excel/get_cell">
@@ -157,6 +168,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `worksheet_name` (string, 필수): 워크시트의 이름.
- `row` (integer, 필수): 행 번호 (0 기반).
- `column` (integer, 필수): 열 번호 (0 기반).
</Accordion>
<Accordion title="microsoft_excel/get_used_range">
@@ -165,6 +177,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_id` (string, 필수): Excel 파일의 ID.
- `worksheet_name` (string, 필수): 워크시트의 이름.
</Accordion>
<Accordion title="microsoft_excel/list_charts">
@@ -173,6 +186,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_id` (string, 필수): Excel 파일의 ID.
- `worksheet_name` (string, 필수): 워크시트의 이름.
</Accordion>
<Accordion title="microsoft_excel/delete_worksheet">
@@ -181,6 +195,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_id` (string, 필수): Excel 파일의 ID.
- `worksheet_name` (string, 필수): 삭제할 워크시트의 이름.
</Accordion>
<Accordion title="microsoft_excel/delete_table">
@@ -190,6 +205,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `file_id` (string, 필수): Excel 파일의 ID.
- `worksheet_name` (string, 필수): 워크시트의 이름.
- `table_name` (string, 필수): 삭제할 테이블의 이름.
</Accordion>
<Accordion title="microsoft_excel/list_names">
@@ -197,6 +213,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_id` (string, 필수): Excel 파일의 ID.
</Accordion>
</AccordionGroup>
@@ -236,15 +253,22 @@ crew.kickoff()
### 일반적인 문제
**인증 오류**
- Microsoft 계정이 파일 액세스에 필요한 권한을 가지고 있는지 확인하세요 (예: `Files.Read.All`, `Files.ReadWrite.All`).
- OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.
**파일 생성 문제**
- 통합 문서를 만들 때 `file_path`가 `.xlsx` 확장자로 끝나는지 확인하세요.
- 대상 위치(OneDrive/SharePoint)에 쓰기 권한이 있는지 확인하세요.
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Microsoft Excel 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Microsoft Excel 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에
문의하세요.
</Card>

29
docs/ko/enterprise/integrations/microsoft_onedrive.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Microsoft OneDrive 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- OneDrive 액세스 권한이 있는 Microsoft 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결
@@ -21,7 +21,7 @@ Microsoft OneDrive 통합을 사용하기 전에 다음 사항을 확인하세
### 1. Microsoft 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
2. 인증 통합 섹션에서 **Microsoft OneDrive** 찾기
3. **연결**을 클릭하고 OAuth 플로우 완료
4. 파일 액세스에 필요한 권한 부여
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -59,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `top` (integer, 선택사항): 검색할 항목 수 (최대 1000). 기본값: 50.
- `orderby` (string, 선택사항): 필드별 정렬 (예: "name asc", "lastModifiedDateTime desc"). 기본값: "name asc".
- `filter` (string, 선택사항): OData 필터 표현식.
</Accordion>
<Accordion title="microsoft_onedrive/get_file_info">
@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `item_id` (string, 필수): 파일 또는 폴더의 ID.
</Accordion>
<Accordion title="microsoft_onedrive/download_file">
@@ -73,6 +76,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `item_id` (string, 필수): 다운로드할 파일의 ID.
</Accordion>
<Accordion title="microsoft_onedrive/upload_file">
@@ -81,6 +85,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_name` (string, 필수): 업로드할 파일의 이름.
- `content` (string, 필수): Base64로 인코딩된 파일 내용.
</Accordion>
<Accordion title="microsoft_onedrive/create_folder">
@@ -88,6 +93,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `folder_name` (string, 필수): 만들 폴더의 이름.
</Accordion>
<Accordion title="microsoft_onedrive/delete_item">
@@ -95,6 +101,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `item_id` (string, 필수): 삭제할 파일 또는 폴더의 ID.
</Accordion>
<Accordion title="microsoft_onedrive/copy_item">
@@ -104,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `item_id` (string, 필수): 복사할 파일 또는 폴더의 ID.
- `parent_id` (string, 선택사항): 대상 폴더의 ID (선택사항, 기본값은 루트).
- `new_name` (string, 선택사항): 복사된 항목의 새 이름 (선택사항).
</Accordion>
<Accordion title="microsoft_onedrive/move_item">
@@ -113,6 +121,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `item_id` (string, 필수): 이동할 파일 또는 폴더의 ID.
- `parent_id` (string, 필수): 대상 폴더의 ID.
- `new_name` (string, 선택사항): 항목의 새 이름 (선택사항).
</Accordion>
<Accordion title="microsoft_onedrive/search_files">
@@ -121,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `query` (string, 필수): 검색 쿼리 문자열.
- `top` (integer, 선택사항): 반환할 결과 수 (최대 1000). 기본값: 50.
</Accordion>
<Accordion title="microsoft_onedrive/share_item">
@@ -130,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `item_id` (string, 필수): 공유할 파일 또는 폴더의 ID.
- `type` (string, 선택사항): 공유 링크 유형. 옵션: view, edit, embed. 기본값: view.
- `scope` (string, 선택사항): 공유 링크 범위. 옵션: anonymous, organization. 기본값: anonymous.
</Accordion>
<Accordion title="microsoft_onedrive/get_thumbnails">
@@ -137,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `item_id` (string, 필수): 파일의 ID.
</Accordion>
</AccordionGroup>
@@ -176,15 +188,22 @@ crew.kickoff()
### 일반적인 문제
**인증 오류**
- Microsoft 계정이 파일 액세스에 필요한 권한을 가지고 있는지 확인하세요 (예: `Files.Read`, `Files.ReadWrite`).
- OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.
**파일 업로드 문제**
- 파일 업로드 시 `file_name`과 `content`가 제공되는지 확인하세요.
- 바이너리 파일의 경우 내용이 Base64로 인코딩되어야 합니다.
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Microsoft OneDrive 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Microsoft OneDrive 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에
문의하세요.
</Card>

24
docs/ko/enterprise/integrations/microsoft_outlook.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Microsoft Outlook 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- Outlook 액세스 권한이 있는 Microsoft 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결
@@ -21,7 +21,7 @@ Microsoft Outlook 통합을 사용하기 전에 다음 사항을 확인하세요
### 1. Microsoft 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
2. 인증 통합 섹션에서 **Microsoft Outlook** 찾기
3. **연결**을 클릭하고 OAuth 플로우 완료
4. 이메일, 캘린더 및 연락처 액세스에 필요한 권한 부여
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -62,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `orderby` (string, 선택사항): 필드별 정렬 (예: "receivedDateTime desc"). 기본값: "receivedDateTime desc".
- `select` (string, 선택사항): 반환할 특정 속성 선택.
- `expand` (string, 선택사항): 관련 리소스를 인라인으로 확장.
</Accordion>
<Accordion title="microsoft_outlook/send_email">
@@ -77,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `importance` (string, 선택사항): 메시지 중요도 수준. 옵션: low, normal, high. 기본값: normal.
- `reply_to` (array, 선택사항): 회신용 이메일 주소 배열.
- `save_to_sent_items` (boolean, 선택사항): 보낸 편지함 폴더에 메시지를 저장할지 여부. 기본값: true.
</Accordion>
<Accordion title="microsoft_outlook/get_calendar_events">
@@ -87,6 +90,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `skip` (integer, 선택사항): 건너뛸 이벤트 수. 기본값: 0.
- `filter` (string, 선택사항): OData 필터 표현식 (예: "start/dateTime ge '2024-01-01T00:00:00Z'").
- `orderby` (string, 선택사항): 필드별 정렬 (예: "start/dateTime asc"). 기본값: "start/dateTime asc".
</Accordion>
<Accordion title="microsoft_outlook/create_calendar_event">
@@ -100,6 +104,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `timezone` (string, 선택사항): 시간대 (예: 'Pacific Standard Time'). 기본값: UTC.
- `location` (string, 선택사항): 이벤트 위치.
- `attendees` (array, 선택사항): 참석자의 이메일 주소 배열.
</Accordion>
<Accordion title="microsoft_outlook/get_contacts">
@@ -110,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `skip` (integer, 선택사항): 건너뛸 연락처 수. 기본값: 0.
- `filter` (string, 선택사항): OData 필터 표현식.
- `orderby` (string, 선택사항): 필드별 정렬 (예: "displayName asc"). 기본값: "displayName asc".
</Accordion>
<Accordion title="microsoft_outlook/create_contact">
@@ -124,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `homePhones` (array, 선택사항): 집 전화번호 배열.
- `jobTitle` (string, 선택사항): 연락처의 직책.
- `companyName` (string, 선택사항): 연락처의 회사 이름.
</Accordion>
</AccordionGroup>
@@ -163,15 +170,22 @@ crew.kickoff()
### 일반적인 문제
**인증 오류**
- Microsoft 계정이 이메일, 캘린더 및 연락처 액세스에 필요한 권한을 가지고 있는지 확인하세요.
- 필요한 범위: `Mail.Read`, `Mail.Send`, `Calendars.Read`, `Calendars.ReadWrite`, `Contacts.Read`, `Contacts.ReadWrite`.
**이메일 보내기 문제**
- `send_email`에 `to_recipients`, `subject`, `body`가 제공되는지 확인하세요.
- 이메일 주소가 올바르게 형식화되어 있는지 확인하세요.
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Microsoft Outlook 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Microsoft Outlook 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에
문의하세요.
</Card>

29
docs/ko/enterprise/integrations/microsoft_sharepoint.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Microsoft SharePoint 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- SharePoint 액세스 권한이 있는 Microsoft 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결
@@ -21,7 +21,7 @@ Microsoft SharePoint 통합을 사용하기 전에 다음 사항을 확인하세
### 1. Microsoft 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
2. 인증 통합 섹션에서 **Microsoft SharePoint** 찾기
3. **연결**을 클릭하고 OAuth 플로우 완료
4. SharePoint 사이트 및 파일 액세스에 필요한 권한 부여
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -63,6 +64,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `top` (integer, 선택사항): 반환할 항목 수 (최소 1, 최대 999).
- `skip` (integer, 선택사항): 건너뛸 항목 수 (최소 0).
- `orderby` (string, 선택사항): 지정된 속성으로 결과 정렬 (예: 'displayName desc').
</Accordion>
<Accordion title="microsoft_sharepoint/get_site">
@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `site_id` (string, 필수): SharePoint 사이트의 ID.
- `select` (string, 선택사항): 반환할 특정 속성 선택 (예: 'displayName,id,webUrl,drives').
- `expand` (string, 선택사항): 관련 리소스를 인라인으로 확장 (예: 'drives,lists').
</Accordion>
<Accordion title="microsoft_sharepoint/get_site_lists">
@@ -79,6 +82,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `site_id` (string, 필수): SharePoint 사이트의 ID.
</Accordion>
<Accordion title="microsoft_sharepoint/get_list">
@@ -87,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `site_id` (string, 필수): SharePoint 사이트의 ID.
- `list_id` (string, 필수): 목록의 ID.
</Accordion>
<Accordion title="microsoft_sharepoint/get_list_items">
@@ -96,6 +101,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `site_id` (string, 필수): SharePoint 사이트의 ID.
- `list_id` (string, 필수): 목록의 ID.
- `expand` (string, 선택사항): 관련 데이터 확장 (예: 'fields').
</Accordion>
<Accordion title="microsoft_sharepoint/create_list_item">
@@ -105,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `site_id` (string, 필수): SharePoint 사이트의 ID.
- `list_id` (string, 필수): 목록의 ID.
- `fields` (object, 필수): 새 항목의 필드 값.
</Accordion>
<Accordion title="microsoft_sharepoint/update_list_item">
@@ -115,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `list_id` (string, 필수): 목록의 ID.
- `item_id` (string, 필수): 업데이트할 항목의 ID.
- `fields` (object, 필수): 업데이트할 필드 값.
</Accordion>
<Accordion title="microsoft_sharepoint/delete_list_item">
@@ -124,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `site_id` (string, 필수): SharePoint 사이트의 ID.
- `list_id` (string, 필수): 목록의 ID.
- `item_id` (string, 필수): 삭제할 항목의 ID.
</Accordion>
<Accordion title="microsoft_sharepoint/upload_file_to_library">
@@ -133,6 +142,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `site_id` (string, 필수): SharePoint 사이트의 ID.
- `file_path` (string, 필수): 파일을 업로드할 경로 (예: 'folder/fileName.txt').
- `content` (string, 필수): 업로드할 파일의 내용.
</Accordion>
<Accordion title="microsoft_sharepoint/get_drive_items">
@@ -140,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `site_id` (string, 필수): SharePoint 사이트의 ID.
</Accordion>
<Accordion title="microsoft_sharepoint/delete_drive_item">
@@ -148,6 +159,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `site_id` (string, 필수): SharePoint 사이트의 ID.
- `item_id` (string, 필수): 삭제할 파일 또는 폴더의 ID.
</Accordion>
</AccordionGroup>
@@ -187,15 +199,22 @@ crew.kickoff()
### 일반적인 문제
**인증 오류**
- Microsoft 계정이 SharePoint 액세스에 필요한 권한을 가지고 있는지 확인하세요 (예: `Sites.Read.All`, `Sites.ReadWrite.All`).
- OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.
**사이트/목록/항목 ID 문제**
- 사이트, 목록, 항목 ID가 올바른지 다시 확인하세요.
- 참조된 리소스가 존재하고 액세스할 수 있는지 확인하세요.
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Microsoft SharePoint 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Microsoft SharePoint 통합 설정 또는 문제 해결에 대한 지원이 필요하시면
지원팀에 문의하세요.
</Card>

24
docs/ko/enterprise/integrations/microsoft_teams.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Microsoft Teams 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- Teams 액세스 권한이 있는 Microsoft 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결
@@ -21,7 +21,7 @@ Microsoft Teams 통합을 사용하기 전에 다음 사항을 확인하세요:
### 1. Microsoft 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
2. 인증 통합 섹션에서 **Microsoft Teams** 찾기
3. **연결**을 클릭하고 OAuth 플로우 완료
4. Teams 액세스에 필요한 권한 부여
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- 매개변수가 필요하지 않습니다.
</Accordion>
<Accordion title="microsoft_teams/get_channels">
@@ -64,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `team_id` (string, 필수): 팀의 ID.
</Accordion>
<Accordion title="microsoft_teams/send_message">
@@ -74,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `channel_id` (string, 필수): 채널의 ID.
- `message` (string, 필수): 메시지 내용.
- `content_type` (string, 선택사항): 콘텐츠 유형 (html 또는 text). 옵션: html, text. 기본값: text.
</Accordion>
<Accordion title="microsoft_teams/get_messages">
@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `team_id` (string, 필수): 팀의 ID.
- `channel_id` (string, 필수): 채널의 ID.
- `top` (integer, 선택사항): 검색할 메시지 수 (최대 50). 기본값: 20.
</Accordion>
<Accordion title="microsoft_teams/create_meeting">
@@ -92,6 +97,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `subject` (string, 필수): 회의 제목/제목.
- `startDateTime` (string, 필수): 회의 시작 시간 (시간대가 포함된 ISO 8601 형식).
- `endDateTime` (string, 필수): 회의 종료 시간 (시간대가 포함된 ISO 8601 형식).
</Accordion>
<Accordion title="microsoft_teams/search_online_meetings_by_join_url">
@@ -99,6 +105,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `join_web_url` (string, 필수): 검색할 회의의 웹 참가 URL.
</Accordion>
</AccordionGroup>
@@ -138,15 +145,22 @@ crew.kickoff()
### 일반적인 문제
**인증 오류**
- Microsoft 계정이 Teams 액세스에 필요한 권한을 가지고 있는지 확인하세요.
- 필요한 범위: `Team.ReadBasic.All`, `Channel.ReadBasic.All`, `ChannelMessage.Send`, `ChannelMessage.Read.All`, `OnlineMeetings.ReadWrite`, `OnlineMeetings.Read`.
**팀 및 채널 액세스**
- 액세스하려는 팀의 멤버인지 확인하세요.
- 팀 및 채널 ID가 올바른지 다시 확인하세요.
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Microsoft Teams 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Microsoft Teams 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에
문의하세요.
</Card>

23
docs/ko/enterprise/integrations/microsoft_word.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Microsoft Word 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- Word 및 OneDrive/SharePoint 액세스 권한이 있는 Microsoft 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결
@@ -21,7 +21,7 @@ Microsoft Word 통합을 사용하기 전에 다음 사항을 확인하세요:
### 1. Microsoft 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동
2. 인증 통합 섹션에서 **Microsoft Word** 찾기
3. **연결**을 클릭하고 OAuth 플로우 완료
4. 파일 액세스에 필요한 권한 부여
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -61,6 +62,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `expand` (string, 선택사항): 관련 리소스를 인라인으로 확장.
- `top` (integer, 선택사항): 반환할 항목 수 (최소 1, 최대 999).
- `orderby` (string, 선택사항): 지정된 속성으로 결과 정렬.
</Accordion>
<Accordion title="microsoft_word/create_text_document">
@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_name` (string, 필수): 텍스트 문서의 이름 (.txt로 끝나야 함).
- `content` (string, 선택사항): 문서의 텍스트 내용. 기본값: "API를 통해 생성된 새 텍스트 문서입니다."
</Accordion>
<Accordion title="microsoft_word/get_document_content">
@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_id` (string, 필수): 문서의 ID.
</Accordion>
<Accordion title="microsoft_word/get_document_properties">
@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_id` (string, 필수): 문서의 ID.
</Accordion>
<Accordion title="microsoft_word/delete_document">
@@ -90,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `file_id` (string, 필수): 삭제할 문서의 ID.
</Accordion>
</AccordionGroup>
@@ -129,15 +135,22 @@ crew.kickoff()
### 일반적인 문제
**인증 오류**
- Microsoft 계정이 파일 액세스에 필요한 권한을 가지고 있는지 확인하세요 (예: `Files.Read.All`, `Files.ReadWrite.All`).
- OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.
**파일 생성 문제**
- 텍스트 문서를 만들 때 `file_name`이 `.txt` 확장자로 끝나는지 확인하세요.
- 대상 위치(OneDrive/SharePoint)에 쓰기 권한이 있는지 확인하세요.
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Microsoft Word 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Microsoft Word 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에
문의하세요.
</Card>

30
docs/ko/enterprise/integrations/notion.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Notion 통합을 사용하기 전에 다음을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 워크스페이스 권한이 있는 Notion 계정
- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Notion 계정을 연결함
@@ -21,7 +21,7 @@ Notion 통합을 사용하기 전에 다음을 확인하세요:
### 1. Notion 계정 연결하기
1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.
2. 인증 통합(Auhtentication Integrations) 섹션에서 **Notion**을(를) 찾습니다.
3. **Connect**를 클릭하고 OAuth 플로우를 완료합니다.
4. 페이지 및 데이터베이스 관리를 위한 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -107,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
}
}
```
</Accordion>
<Accordion title="notion/update_page">
@@ -141,6 +143,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
}
}
```
</Accordion>
<Accordion title="notion/get_page_by_id">
@@ -148,6 +151,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `pageId` (string, 필수): 페이지 ID - 가져올 페이지의 ID를 지정합니다. (예: "59833787-2cf9-4fdf-8782-e53db20768a5").
</Accordion>
<Accordion title="notion/archive_page">
@@ -155,6 +159,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `pageId` (string, 필수): 페이지 ID - 보관할 페이지의 ID를 지정합니다. (예: "59833787-2cf9-4fdf-8782-e53db20768a5").
</Accordion>
<Accordion title="notion/search_pages">
@@ -180,6 +185,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
}
```
사용 가능한 필드: `query`, `filter.value`, `direction`, `page_size`
</Accordion>
<Accordion title="notion/get_page_content">
@@ -187,6 +193,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `blockId` (string, 필수): 페이지 ID - 해당 블록이나 페이지의 모든 자식 블록을 순서대로 가져오기 위해 Block 또는 Page ID를 지정합니다. (예: "59833787-2cf9-4fdf-8782-e53db20768a5").
</Accordion>
<Accordion title="notion/update_block">
@@ -274,6 +281,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
}
}
```
</Accordion>
<Accordion title="notion/get_block_by_id">
@@ -281,6 +289,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `blockId` (string, 필수): 블록 ID - 가져올 블록의 ID를 지정합니다. (예: "9bc30ad4-9373-46a5-84ab-0a7845ee52e6").
</Accordion>
<Accordion title="notion/delete_block">
@@ -288,6 +297,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `blockId` (string, 필수): 블록 ID - 삭제할 블록의 ID를 지정합니다. (예: "9bc30ad4-9373-46a5-84ab-0a7845ee52e6").
</Accordion>
</AccordionGroup>
@@ -452,47 +462,59 @@ crew.kickoff()
### 일반적인 문제
**권한 오류**
- Notion 계정이 대상 워크스페이스에 대한 편집 권한이 있는지 확인하세요
- OAuth 연결에 Notion API에 필요한 범위가 포함되어 있는지 확인하세요
- 페이지와 데이터베이스가 인증된 통합에 공유되어 있는지 확인하세요
**잘못된 페이지 및 블록 ID**
- 페이지 ID 및 블록 ID가 올바른 UUID 형식인지 다시 확인하세요
- 참조되는 페이지와 블록이 존재하고 접근 가능한지 확인하세요
- 새 페이지를 생성할 때 상위 페이지 또는 데이터베이스 ID가 유효한지 검증하세요
**속성 스키마 문제**
- 데이터베이스에 페이지를 생성할 때 페이지 속성이 데이터베이스 스키마와 일치하는지 확인하세요
- 대상 데이터베이스에 대해 속성 이름과 타입이 올바른지 확인하세요
- 페이지를 생성하거나 업데이트할 때 필수 속성이 포함되어 있는지 확인하세요
**콘텐츠 블록 구조**
- 블록 콘텐츠가 Notion의 리치 텍스트 형식 사양을 따르는지 확인하세요
- 중첩된 블록 구조가 올바르게 포맷되어 있는지 확인하세요
- 미디어 URL이 접근 가능하며 올바른 형식인지 확인하세요
**검색 및 필터 문제**
- 검색 쿼리가 올바르게 포맷되어 있고 비어 있지 않은지 확인하세요
- 필터 공식에서 유효한 필드명을 사용하세요: `query`, `filter.value`, `direction`, `page_size`
- 복잡한 필터 조건을 만들기 전에 간단한 검색을 테스트하세요
**상위-하위 관계**
- 하위 페이지를 생성하기 전에 상위 페이지 또는 데이터베이스가 존재하는지 확인하세요
- 상위 컨테이너에 대한 적절한 권한이 있는지 확인하세요
- 데이터베이스 스키마가 설정하려는 속성을 허용하는지 확인하세요
**리치 텍스트 및 미디어 콘텐츠**
- 외부 이미지, PDF, 북마크의 URL이 접근 가능한지 확인하세요
- 리치 텍스트 포매팅이 Notion의 API 사양을 따르는지 확인하세요
- 코드 블록의 언어 타입이 Notion에서 지원되는지 확인하세요
**아카이브 및 삭제 작업**
- 아카이브(복구 가능)와 삭제(영구적)의 차이를 이해하세요
- 대상 콘텐츠를 아카이브 또는 삭제할 수 있는 권한이 있는지 확인하세요
- 여러 페이지 또는 블록에 영향을 줄 수 있는 대량 작업은 신중히 진행하세요
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Notion 연동 설정 또는 문제 해결에 대해 지원팀에 문의해 주세요.
</Card>

52
docs/ko/enterprise/integrations/salesforce.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Salesforce 통합을 사용하기 전에 다음을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 권한이 있는 Salesforce 계정
- [통합 페이지](https://app.crewai.com/integrations)를 통해 Salesforce 계정 연결
@@ -21,7 +21,7 @@ Salesforce 통합을 사용하기 전에 다음을 확인하세요:
### 1. Salesforce 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
2. 인증 통합 섹션에서 **Salesforce**를 찾습니다.
3. **연결**을 클릭하고 OAuth 과정을 완료합니다.
4. CRM 및 영업 관리에 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -65,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `Title` (string, 선택): 담당자의 직함(예: CEO 또는 Vice President 등)
- `Description` (string, 선택): Contact에 대한 설명
- `additionalFields` (object, 선택): 사용자 정의 Contact 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/create_record_lead">
@@ -81,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `Status` (string, 선택): 리드 상태 - 리드 상태를 선택하려면 Connect Portal Workflow 설정을 사용하세요
- `Description` (string, 선택): Lead에 대한 설명
- `additionalFields` (object, 선택): 사용자 정의 Lead 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/create_record_opportunity">
@@ -96,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `OwnerId` (string, 선택): 이 Opportunity를 담당하는 Salesforce 사용자
- `NextStep` (string, 선택): Opportunity 마감을 위한 다음 작업의 설명
- `additionalFields` (object, 선택): 사용자 정의 Opportunity 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/create_record_task">
@@ -114,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `isReminderSet` (boolean, 선택): 알림 설정 여부
- `reminderDateTime` (string, 선택): 알림 날짜/시간(ISO 형식)
- `additionalFields` (object, 선택): 사용자 정의 Task 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/create_record_account">
@@ -126,12 +131,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `Phone` (string, 선택): 전화번호
- `Description` (string, 선택): Account 설명
- `additionalFields` (object, 선택): 사용자 정의 Account 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/create_record_any">
**설명:** Salesforce에서 모든 오브젝트 유형의 레코드를 생성합니다.
**참고:** 이 기능은 사용자 정의 또는 알려지지 않은 오브젝트 유형의 레코드를 생성할 때 유연하게 사용할 수 있습니다.
</Accordion>
</AccordionGroup>
@@ -150,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `Title` (string, 선택): 연락처의 직함
- `Description` (string, 선택): 연락처에 대한 설명
- `additionalFields` (object, 선택): 커스텀 연락처 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/update_record_lead">
@@ -167,6 +175,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `Status` (string, 선택): 리드 상태
- `Description` (string, 선택): 리드에 대한 설명
- `additionalFields` (object, 선택): 커스텀 리드 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/update_record_opportunity">
@@ -183,6 +192,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `OwnerId` (string, 선택): 이 기회를 담당하는 Salesforce 사용자
- `NextStep` (string, 선택): 기회 마감을 위한 다음 작업의 설명
- `additionalFields` (object, 선택): 커스텀 기회 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/update_record_task">
@@ -201,6 +211,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `isReminderSet` (boolean, 선택): 알림 설정 여부
- `reminderDateTime` (string, 선택): 알림 날짜/시간 (ISO 형식)
- `additionalFields` (object, 선택): 커스텀 작업 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/update_record_account">
@@ -214,12 +225,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `Phone` (string, 선택): 전화번호
- `Description` (string, 선택): 계정 설명
- `additionalFields` (object, 선택): 커스텀 계정 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/update_record_any">
**설명:** Salesforce에서 어떤 객체 유형이든 레코드를 업데이트합니다.
**참고:** 이는 커스텀 또는 미확인 객체 유형의 레코드 업데이트를 위한 유연한 도구입니다.
</Accordion>
</AccordionGroup>
@@ -231,6 +244,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): Contact의 레코드 ID
</Accordion>
<Accordion title="salesforce/get_record_by_id_lead">
@@ -238,6 +252,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): Lead의 레코드 ID
</Accordion>
<Accordion title="salesforce/get_record_by_id_opportunity">
@@ -245,6 +260,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): Opportunity의 레코드 ID
</Accordion>
<Accordion title="salesforce/get_record_by_id_task">
@@ -252,6 +268,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): Task의 레코드 ID
</Accordion>
<Accordion title="salesforce/get_record_by_id_account">
@@ -259,6 +276,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordId` (string, 필수): Account의 레코드 ID
</Accordion>
<Accordion title="salesforce/get_record_by_id_any">
@@ -267,6 +285,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `recordType` (string, 필수): 레코드 유형 (예: "CustomObject__c")
- `recordId` (string, 필수): 레코드 ID
</Accordion>
</AccordionGroup>
@@ -282,6 +301,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/search_records_lead">
@@ -293,6 +313,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/search_records_opportunity">
@@ -304,6 +325,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/search_records_task">
@@ -315,6 +337,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/search_records_account">
@@ -326,6 +349,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/search_records_any">
@@ -336,6 +360,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `filterFormula` (string, 선택): 필터 검색 조건
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
</AccordionGroup>
@@ -348,6 +373,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_lead">
@@ -356,6 +382,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_opportunity">
@@ -364,6 +391,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_task">
@@ -372,6 +400,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_account">
@@ -380,6 +409,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_any">
@@ -389,6 +419,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `recordType` (string, 필수): 레코드 유형
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
</AccordionGroup>
@@ -409,6 +440,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `description` (string, 선택): 필드 설명
- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
- `defaultFieldValue` (string, 선택): 필드의 기본값
</Accordion>
<Accordion title="salesforce/create_custom_field_lead">
@@ -425,6 +457,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `description` (string, 선택): 필드 설명
- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
- `defaultFieldValue` (string, 선택): 필드의 기본값
</Accordion>
<Accordion title="salesforce/create_custom_field_opportunity">
@@ -441,6 +474,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `description` (string, 선택): 필드 설명
- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
- `defaultFieldValue` (string, 선택): 필드의 기본값
</Accordion>
<Accordion title="salesforce/create_custom_field_task">
@@ -457,6 +491,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `description` (string, 선택): 필드 설명
- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
- `defaultFieldValue` (string, 선택): 필드의 기본값
</Accordion>
<Accordion title="salesforce/create_custom_field_account">
@@ -473,12 +508,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `description` (string, 선택): 필드 설명
- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
- `defaultFieldValue` (string, 선택): 필드의 기본값
</Accordion>
<Accordion title="salesforce/create_custom_field_any">
**설명:** 모든 오브젝트 타입에 대한 커스텀 필드를 배포합니다.
**참고:** 커스텀 또는 미지의 오브젝트 타입에 커스텀 필드를 생성할 수 있는 유연한 도구입니다.
</Accordion>
</AccordionGroup>
@@ -490,6 +527,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `query` (string, 필수): SOQL 쿼리 (예: "SELECT Id, Name FROM Account WHERE Name = 'Example'")
</Accordion>
<Accordion title="salesforce/create_custom_object">
@@ -500,6 +538,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `pluralLabel` (string, 필수): 복수형 라벨 (예: "Accounts")
- `description` (string, 선택): 커스텀 오브젝트에 대한 설명
- `recordName` (string, 필수): 레이아웃과 검색에 표시되는 레코드 이름 (예: "Account Name")
</Accordion>
<Accordion title="salesforce/describe_action_schema">
@@ -510,6 +549,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `operation` (string, 필수): 작업 타입 (예: "CREATE_RECORD" 또는 "UPDATE_RECORD")
**참고:** 커스텀 오브젝트 작업 시, 해당 스키마를 이해하기 위해 제일 먼저 이 기능을 사용하세요.
</Accordion>
</AccordionGroup>
@@ -637,6 +677,10 @@ crew.kickoff()
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Salesforce 통합 설정 또는 문제 해결에 대해 지원팀에 문의하세요.
</Card>

30
docs/ko/enterprise/integrations/shopify.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Shopify 연동을 사용하기 전에 다음을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 관리자 권한이 있는 Shopify 스토어
- [통합 페이지](https://app.crewai.com/integrations)를 통해 Shopify 스토어 연결
@@ -21,7 +21,7 @@ Shopify 연동을 사용하기 전에 다음을 확인하세요:
### 1. Shopify 스토어 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
2. 인증 통합 섹션에서 **Shopify**를 찾습니다.
3. **연결**을 클릭하고 OAuth 과정을 완료합니다.
4. 스토어 및 제품 관리에 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -64,6 +65,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `updatedAtMin` (string, 선택): 이 날짜 이후에 업데이트된 고객만 반환 (ISO 또는 Unix 타임스탬프)
- `updatedAtMax` (string, 선택): 이 날짜 이전에 업데이트된 고객만 반환 (ISO 또는 Unix 타임스탬프)
- `limit` (string, 선택): 반환할 최대 고객 수 (기본값 250)
</Accordion>
<Accordion title="shopify/search_customers">
@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `filterFormula` (object, 선택): 필드별 연산자가 포함된 불리언 합정규형의 고급 필터
- `limit` (string, 선택): 반환할 최대 고객 수 (기본값 250)
</Accordion>
<Accordion title="shopify/create_customer">
@@ -93,6 +96,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `note` (string, 선택): 고객 메모
- `sendEmailInvite` (boolean, 선택): 이메일 초대장 전송 여부
- `metafields` (object, 선택): 추가 메타필드(JSON 형식)
</Accordion>
<Accordion title="shopify/update_customer">
@@ -115,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `note` (string, 선택): 고객 메모
- `sendEmailInvite` (boolean, 선택): 이메일 초대장 전송 여부
- `metafields` (object, 선택): 추가 메타필드(JSON 형식)
</Accordion>
</AccordionGroup>
@@ -131,6 +136,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `updatedAtMin` (string, optional): 이 날짜 이후에 업데이트된 주문만 반환 (ISO 또는 Unix 타임스탬프)
- `updatedAtMax` (string, optional): 이 날짜 이전에 업데이트된 주문만 반환 (ISO 또는 Unix 타임스탬프)
- `limit` (string, optional): 반환할 주문의 최대 개수 (기본값: 250)
</Accordion>
<Accordion title="shopify/create_order">
@@ -144,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `financialStatus` (string, optional): 결제 상태 - 옵션: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided
- `inventoryBehaviour` (string, optional): 인벤토리 동작 - 옵션: bypass, decrement_ignoring_policy, decrement_obeying_policy
- `note` (string, optional): 주문 메모
</Accordion>
<Accordion title="shopify/update_order">
@@ -158,6 +165,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `financialStatus` (string, optional): 결제 상태 - 옵션: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided
- `inventoryBehaviour` (string, optional): 인벤토리 동작 - 옵션: bypass, decrement_ignoring_policy, decrement_obeying_policy
- `note` (string, optional): 주문 메모
</Accordion>
<Accordion title="shopify/get_abandoned_carts">
@@ -170,6 +178,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `createdAtMin` (string, optional): 이 날짜 이후에 생성된 장바구니만 반환 (ISO 또는 Unix 타임스탬프)
- `createdAtMax` (string, optional): 이 날짜 이전에 생성된 장바구니만 반환 (ISO 또는 Unix 타임스탬프)
- `limit` (string, optional): 반환할 장바구니의 최대 개수 (기본값: 250)
</Accordion>
</AccordionGroup>
@@ -190,6 +199,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `updatedAtMin` (string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이후에 수정된 제품만 반환
- `updatedAtMax` (string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이전에 수정된 제품만 반환
- `limit` (string, optional): 반환할 최대 제품 수 (기본값: 250)
</Accordion>
<Accordion title="shopify/create_product">
@@ -206,6 +216,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `imageUrl` (string, optional): 제품 이미지 URL
- `isPublished` (boolean, optional): 제품 공개 여부
- `publishToPointToSale` (boolean, optional): 포인트 오브 세일(Point of Sale)에 공개 여부
</Accordion>
<Accordion title="shopify/update_product">
@@ -223,6 +234,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `imageUrl` (string, optional): 제품 이미지 URL
- `isPublished` (boolean, optional): 제품 공개 여부
- `publishToPointToSale` (boolean, optional): 포인트 오브 세일(Point of Sale)에 공개 여부
</Accordion>
</AccordionGroup>
@@ -234,6 +246,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `productFilterFormula` (object, 선택): id, title, vendor, status, handle, tag, created_at, updated_at, published_at와 같은 필드를 지원하는 불리언 정규합형(DNF) 기반의 고급 필터
</Accordion>
<Accordion title="shopify/create_product_graphql">
@@ -247,6 +260,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `tags` (string, 선택): 배열 또는 쉼표로 구분된 리스트 형태의 제품 태그
- `media` (object, 선택): 대체 텍스트, 콘텐츠 유형 및 소스 URL을 가진 미디어 객체
- `additionalFields` (object, 선택): status, requiresSellingPlan, giftCard와 같은 추가 제품 필드
</Accordion>
<Accordion title="shopify/update_product_graphql">
@@ -261,6 +275,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `tags` (string, 선택): 배열 또는 쉼표로 구분된 리스트 형태의 제품 태그
- `media` (object, 선택): 대체 텍스트, 콘텐츠 유형 및 소스 URL을 포함한 업데이트된 미디어 객체
- `additionalFields` (object, 선택): status, requiresSellingPlan, giftCard와 같은 추가 제품 필드
</Accordion>
</AccordionGroup>
@@ -387,6 +402,11 @@ crew.kickoff()
### 도움 받기
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
Shopify 연동 설정 또는 문제 해결에 관한 지원이 필요하시면 고객 지원팀에 문의해 주세요.
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Shopify 연동 설정 또는 문제 해결에 관한 지원이 필요하시면 고객 지원팀에 문의해
주세요.
</Card>

22
docs/ko/enterprise/integrations/slack.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Slack 통합을 사용하기 전에 다음을 확인하십시오:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 권한이 있는 Slack 워크스페이스
- [통합 페이지](https://app.crewai.com/integrations)를 통해 Slack 워크스페이스를 연결함
@@ -21,7 +21,7 @@ Slack 통합을 사용하기 전에 다음을 확인하십시오:
### 1. Slack 워크스페이스 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
2. 인증 통합 섹션에서 **Slack**을 찾습니다.
3. **연결**을 클릭하고 OAuth 과정을 완료합니다.
4. 팀 커뮤니케이션에 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -59,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- 파라미터 없음 - 모든 채널 멤버를 조회합니다
</Accordion>
<Accordion title="slack/get_user_by_email">
@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `email` (string, 필수): 워크스페이스 내 사용자의 이메일 주소
</Accordion>
<Accordion title="slack/get_users_by_name">
@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `displayName` (string, 필수): 검색할 사용자의 표시 이름
- `paginationParameters` (object, 선택): 페이지네이션 설정
- `pageCursor` (string, 선택): 페이지네이션을 위한 페이지 커서
</Accordion>
</AccordionGroup>
@@ -87,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- 파라미터가 필요하지 않습니다 - 접근 가능한 모든 채널을 조회합니다
</Accordion>
</AccordionGroup>
@@ -103,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `botIcon` (string, 필수): 봇 아이콘 - 이미지 URL 또는 이모지(e.g., ":dog:") 모두 가능합니다.
- `blocks` (object, 선택): 첨부파일 및 인터랙티브 요소 등이 포함된 풍부한 메시지 포맷팅을 위한 Slack Block Kit JSON
- `authenticatedUser` (boolean, 선택): true이면 메시지가 애플리케이션이 아니라 인증된 Slack 사용자로부터 보낸 것처럼 표시됩니다(기본값은 false)
</Accordion>
<Accordion title="slack/send_direct_message">
@@ -115,6 +121,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `botIcon` (string, 필수): 봇 아이콘 - 이미지 URL 또는 이모지(e.g., ":dog:") 모두 가능합니다.
- `blocks` (object, 선택): 첨부파일 및 인터랙티브 요소 등이 포함된 풍부한 메시지 포맷팅을 위한 Slack Block Kit JSON
- `authenticatedUser` (boolean, 선택): true이면 메시지가 애플리케이션이 아니라 인증된 Slack 사용자로부터 보낸 것처럼 표시됩니다(기본값은 false)
</Accordion>
</AccordionGroup>
@@ -132,6 +139,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `from:@john in:#general` - #general 채널에서 John이 보낸 메시지 검색
- `has:link after:2023-01-01` - 2023년 1월 1일 이후에 링크가 포함된 메시지 검색
- `in:@channel before:yesterday` - 특정 채널에서 어제 이전에 작성된 메시지 검색
</Accordion>
</AccordionGroup>
@@ -140,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
Slack의 Block Kit을 사용하면 풍부하고 상호작용이 가능한 메시지를 생성할 수 있습니다. 다음은 `blocks` 매개변수를 사용하는 방법에 대한 몇 가지 예시입니다:
### 첨부 파일이 있는 간단한 텍스트
```json
[
{
@@ -154,6 +163,7 @@ Slack의 Block Kit을 사용하면 풍부하고 상호작용이 가능한 메시
```
### 섹션을 활용한 리치 포매팅
```json
[
{
@@ -298,6 +308,10 @@ crew.kickoff()
## 지원 문의
<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Slack 연동 설정 또는 문제 해결에 대해 지원팀에 문의하세요.
</Card>

18
docs/ko/enterprise/integrations/stripe.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Stripe 통합을 사용하기 전에 다음 사항을 확인하세요:
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 API 권한이 있는 Stripe 계정
- [통합 페이지](https://app.crewai.com/integrations)를 통해 Stripe 계정 연결
@@ -21,7 +21,7 @@ Stripe 통합을 사용하기 전에 다음 사항을 확인하세요:
### 1. Stripe 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
2. 인증 통합 섹션에서 **Stripe**를 찾습니다.
3. **연결**을 클릭하고 OAuth 과정을 완료합니다.
4. 결제 처리에 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -62,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `name` (string, 선택): 고객의 전체 이름
- `description` (string, 선택): 내부 참조용 고객 설명
- `metadataCreateCustomer` (object, 선택): 추가 메타데이터를 key-value 쌍으로 입력 (예: `{"field1": 1, "field2": 2}`)
</Accordion>
<Accordion title="stripe/get_customer_by_id">
@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `idGetCustomer` (string, 필수): 조회할 Stripe 고객 ID
</Accordion>
<Accordion title="stripe/get_customers">
@@ -79,6 +82,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `createdAfter` (string, 선택): 이 날짜 이후 생성된 고객 필터링 (유닉스 타임스탬프)
- `createdBefore` (string, 선택): 이 날짜 이전 생성된 고객 필터링 (유닉스 타임스탬프)
- `limitGetCustomers` (string, 선택): 반환할 최대 고객 수 (기본값 10)
</Accordion>
<Accordion title="stripe/update_customer">
@@ -90,6 +94,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `name` (string, 선택): 업데이트할 고객 이름
- `description` (string, 선택): 업데이트할 고객 설명
- `metadataUpdateCustomer` (object, 선택): 업데이트할 메타데이터를 key-value 쌍으로 입력
</Accordion>
</AccordionGroup>
@@ -103,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `customerIdCreateSubscription` (string, 필수): 구독이 생성될 고객 ID
- `plan` (string, 필수): 구독을 위한 플랜 ID - 사용자가 플랜을 선택할 수 있도록 Connect Portal Workflow Settings를 사용하세요
- `metadataCreateSubscription` (object, 선택): 구독에 대한 추가 메타데이터
</Accordion>
<Accordion title="stripe/get_subscriptions">
@@ -112,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `customerIdGetSubscriptions` (string, 선택): 고객 ID로 구독을 필터링
- `subscriptionStatus` (string, 선택): 구독 상태별 필터링 - 옵션: incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid
- `limitGetSubscriptions` (string, 선택): 반환할 구독의 최대 개수(기본값은 10)
</Accordion>
</AccordionGroup>
@@ -125,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `productName` (string, 필수): 제품 이름
- `description` (string, 선택): 제품 설명
- `metadataProduct` (object, 선택): 키-값 쌍으로 구성된 추가 제품 메타데이터
</Accordion>
<Accordion title="stripe/get_product_by_id">
@@ -132,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `productId` (string, 필수): 조회할 Stripe 제품 ID
</Accordion>
<Accordion title="stripe/get_products">
@@ -141,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `createdAfter` (string, 선택): 이 날짜 이후 생성된 제품만 필터링 (Unix 타임스탬프)
- `createdBefore` (string, 선택): 이 날짜 이전 생성된 제품만 필터링 (Unix 타임스탬프)
- `limitGetProducts` (string, 선택): 반환할 최대 제품 수 (기본값 10)
</Accordion>
</AccordionGroup>
@@ -154,6 +164,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `balanceTransactionType` (string, 선택 사항): 거래 유형별 필터 - 옵션: charge, refund, payment, payment_refund
- `paginationParameters` (object, 선택 사항): 페이지네이션 설정
- `pageCursor` (string, 선택 사항): 페이지네이션을 위한 페이지 커서
</Accordion>
<Accordion title="stripe/get_plans">
@@ -163,6 +174,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `isPlanActive` (boolean, 선택 사항): 플랜 상태별 필터 - true는 활성 플랜, false는 비활성 플랜
- `paginationParameters` (object, 선택 사항): 페이지네이션 설정
- `pageCursor` (string, 선택 사항): 페이지네이션을 위한 페이지 커서
</Accordion>
</AccordionGroup>

18
docs/ko/enterprise/integrations/zendesk.mdx
View File

@@ -13,7 +13,7 @@ mode: "wide"
Zendesk 통합을 사용하기 전에 다음을 확인하세요.
- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 API 권한이 있는 Zendesk 계정
- [통합 페이지](https://app.crewai.com/integrations)를 통해 Zendesk 계정 연결
@@ -21,7 +21,7 @@ Zendesk 통합을 사용하기 전에 다음을 확인하세요.
### 1. Zendesk 계정 연결
1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.
2. 인증 통합 섹션에서 **Zendesk**를 찾습니다.
3. **연결**을 클릭하고 OAuth 과정을 완료합니다.
4. 티켓 및 사용자 관리에 필요한 권한을 부여합니다.
@@ -36,7 +36,8 @@ uv add crewai-tools
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
@@ -70,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `ticketTags` (string, 선택): 적용할 태그 배열 (예: `["enterprise", "other_tag"]`)
- `ticketExternalId` (string, 선택): 티켓을 로컬 레코드와 연결할 외부 ID
- `ticketCustomFields` (object, 선택): JSON 형식의 사용자 정의 필드 값
</Accordion>
<Accordion title="zendesk/update_ticket">
@@ -88,6 +90,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `ticketTags` (string, 선택): 업데이트된 태그 배열
- `ticketExternalId` (string, 선택): 업데이트된 외부 ID
- `ticketCustomFields` (object, 선택): 업데이트된 사용자 정의 필드 값
</Accordion>
<Accordion title="zendesk/get_ticket_by_id">
@@ -95,6 +98,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `ticketId` (string, 필수): 조회할 티켓의 ID (예: "35436")
</Accordion>
<Accordion title="zendesk/add_comment_to_ticket">
@@ -105,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `commentBody` (string, 필수): 댓글 메시지 (일반 텍스트 또는 HTML 지원, 예: "도움을 주셔서 감사합니다!")
- `isInternalNote` (boolean, 선택): 공개 답글 대신 내부 노트로 설정하려면 true (기본값: false)
- `isPublic` (boolean, 선택): 공개 댓글이면 true, 내부 노트이면 false
</Accordion>
<Accordion title="zendesk/search_tickets">
@@ -126,6 +131,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `dueDate` (object, 선택): 마감일로 필터링 (연산자와 값)
- `sort_by` (string, 선택): 정렬 필드 - 옵션: created_at, updated_at, priority, status, ticket_type
- `sort_order` (string, 선택): 정렬 방향 - 옵션: asc, desc
</Accordion>
</AccordionGroup>
@@ -143,6 +149,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `externalId` (string, 선택): 다른 시스템의 고유 식별자
- `details` (string, 선택): 추가 사용자 정보
- `notes` (string, 선택): 사용자에 대한 내부 메모
</Accordion>
<Accordion title="zendesk/update_user">
@@ -157,6 +164,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `externalId` (string, 선택): 업데이트된 외부 ID
- `details` (string, 선택): 업데이트된 사용자 상세 정보
- `notes` (string, 선택): 업데이트된 내부 메모
</Accordion>
<Accordion title="zendesk/get_user_by_id">
@@ -164,6 +172,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**매개변수:**
- `userId` (string, 필수): 조회할 사용자 ID
</Accordion>
<Accordion title="zendesk/search_users">
@@ -176,6 +185,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `externalId` (string, 선택): 외부 ID로 필터링
- `sort_by` (string, 선택): 정렬 필드 - 옵션: created_at, updated_at
- `sort_order` (string, 선택): 정렬 방향 - 옵션: asc, desc
</Accordion>
</AccordionGroup>
@@ -188,6 +198,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
**파라미터:**
- `paginationParameters` (object, 선택 사항): 페이지네이션 설정
- `pageCursor` (string, 선택 사항): 페이지네이션을 위한 페이지 커서
</Accordion>
<Accordion title="zendesk/get_ticket_audits">
@@ -197,6 +208,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
- `ticketId` (string, 선택 사항): 특정 티켓의 감사를 조회합니다(비워두면 모든 비보관된 티켓의 감사를 조회, 예: "1234")
- `paginationParameters` (object, 선택 사항): 페이지네이션 설정
- `pageCursor` (string, 선택 사항): 페이지네이션을 위한 페이지 커서
</Accordion>
</AccordionGroup>

13
docs/ko/enterprise/introduction.mdx
View File

@@ -7,10 +7,13 @@ mode: "wide"
## 소개
CrewAI AOP(Agent Operation Platform)는 프로덕션 환경에서 crew와 agent를 배포, 모니터링, 확장할 수 있는 플랫폼을 제공합니다.
CrewAI AMP(Agent Management Platform)는 프로덕션 환경에서 crew와 agent를 배포, 모니터링, 확장할 수 있는 플랫폼을 제공합니다.
<Frame>
<img src="/images/enterprise/crewai-enterprise-dashboard.png" alt="CrewAI AOP Dashboard" />
<img
src="/images/enterprise/crewai-enterprise-dashboard.png"
alt="CrewAI AMP Dashboard"
/>
</Frame>
CrewAI AOP는 오픈 소스 프레임워크의 강력함에 프로덕션 배포, 협업, 확장성을 위한 기능을 더했습니다. crew를 관리형 인프라에 배포하고, 실행을 실시간으로 모니터링하세요.
@@ -57,11 +60,7 @@ CrewAI AOP는 오픈 소스 프레임워크의 강력함에 프로덕션 배포,
<Steps>
<Step title="계정 가입하기">
[app.crewai.com](https://app.crewai.com)에서 계정을 생성하세요
<Card
title="가입하기"
icon="user"
href="https://app.crewai.com/signup"
>
<Card title="가입하기" icon="user" href="https://app.crewai.com/signup">
가입하기
</Card>
</Step>

30
docs/ko/installation.mdx
View File

@@ -6,6 +6,7 @@ mode: "wide"
---
## 비디오 튜토리얼
설치 과정을 단계별로 시연하는 비디오 튜토리얼을 시청하세요:
<iframe
@@ -18,15 +19,18 @@ mode: "wide"
></iframe>
## 텍스트 튜토리얼
<Note>
**Python 버전 요구 사항**
CrewAI는 `Python >=3.10 및 <3.14`가 필요합니다. 버전을 확인하는 방법은 다음과 같습니다:
```bash
python3 --version
```
CrewAI는 `Python >=3.10 및 <3.14`가 필요합니다. 버전을 확인하는 방법은 다음과 같습니다:
```bash
python3 --version
```
Python을 업데이트해야 하는 경우, [python.org/downloads](https://python.org/downloads)를 방문하세요.
Python을 업데이트해야 하는 경우, [python.org/downloads](https://python.org/downloads)를 방문하세요.
</Note>
CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다. 프로젝트 설정과 실행을 간소화하여 원활한 경험을 제공합니다.
@@ -89,6 +93,7 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다
```
<Check>설치가 완료되었습니다! 이제 첫 번째 crew를 만들 준비가 되었습니다! 🎉</Check>
</Step>
</Steps>
# CrewAI 프로젝트 생성하기
@@ -122,6 +127,7 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다
├── agents.yaml
└── tasks.yaml
```
</Step>
<Step title="프로젝트 커스터마이즈">
@@ -138,6 +144,7 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다
- `agents.yaml` 및 `tasks.yaml`을 편집하여 crew의 동작을 정의하는 것부터 시작하세요.
- API 키와 같은 민감한 정보는 `.env` 파일에 보관하세요.
</Step>
<Step title="Crew 실행하기">
@@ -161,13 +168,15 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다
<Note type="info">
팀과 조직을 위해, CrewAI는 설치 복잡성을 없애는 엔터프라이즈 배포 옵션을 제공합니다:
### CrewAI AOP (SaaS)
### CrewAI AMP (SaaS)
- 설치가 전혀 필요하지 않습니다 - [app.crewai.com](https://app.crewai.com)에서 무료로 가입하세요
- 자동 업데이트 및 유지 보수
- 관리형 인프라 및 확장성 지원
- 코딩 없이 Crew 생성
### CrewAI Factory (자가 호스팅)
- 귀하의 인프라를 위한 컨테이너화된 배포
- 온프레미스 배포를 포함하여 모든 하이퍼스케일러 지원
- 기존 보안 시스템과의 통합
@@ -180,12 +189,9 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다
## 다음 단계
<CardGroup cols={2}>
<Card
title="첫 번째 Agent 만들기"
icon="code"
href="/ko/quickstart"
>
빠른 시작 가이드를 따라 CrewAI 에이전트를 처음 만들어보고 직접 경험해 보세요.
<Card title="첫 번째 Agent 만들기" icon="code" href="/ko/quickstart">
빠른 시작 가이드를 따라 CrewAI 에이전트를 처음 만들어보고 직접 경험해
보세요.
</Card>
<Card
title="커뮤니티 참여하기"

169
docs/ko/learn/llm-selection-guide.mdx
View File

@@ -1,7 +1,7 @@
---
title: '전략적 LLM 선택 가이드'
description: 'CrewAI AI 에이전트를 위한 적합한 LLM 선택 및 효과적인 작업과 에이전트 정의 작성에 대한 전략적 프레임워크'
icon: 'brain-circuit'
title: "전략적 LLM 선택 가이드"
description: "CrewAI AI 에이전트를 위한 적합한 LLM 선택 및 효과적인 작업과 에이전트 정의 작성에 대한 전략적 프레임워크"
icon: "brain-circuit"
mode: "wide"
---
@@ -10,23 +10,33 @@ mode: "wide"
처방적인 모델 추천보다는, **사고 프레임워크**를 제안하여 특정 사용 사례, 제약 조건, 요구 사항에 따라 정보에 입각한 결정을 내릴 수 있도록 돕고자 합니다. LLM 환경은 빠르게 변화하고 있으며, 새로운 모델이 정기적으로 등장하고 기존 모델도 자주 업데이트되고 있습니다. 가장 중요한 것은 어떤 특정 모델이 제공되는지와 상관없이 평가를 위한 체계적인 접근법을 개발하는 것입니다.
<Note>
이 가이드는 LLM 환경이 빠르게 변화하고 있기 때문에 특정 모델 추천보다는 전략적 사고에 초점을 맞추고 있습니다.
이 가이드는 LLM 환경이 빠르게 변화하고 있기 때문에 특정 모델 추천보다는 전략적
사고에 초점을 맞추고 있습니다.
</Note>
## 빠른 결정 프레임워크
<Steps>
<Step title="작업 분석">
먼저, 작업이 실제로 무엇을 요구하는지 깊이 이해하세요. 필요한 인지 복잡성, 요구되는 추론의 깊이, 기대되는 출력 형식, 모델이 처리해야 할 맥락의 양을 고려합니다. 이러한 기본 분석이 이후의 모든 결정을 안내할 것입니다.
먼저, 작업이 실제로 무엇을 요구하는지 깊이 이해하세요. 필요한 인지 복잡성,
요구되는 추론의 깊이, 기대되는 출력 형식, 모델이 처리해야 할 맥락의 양을
고려합니다. 이러한 기본 분석이 이후의 모든 결정을 안내할 것입니다.
</Step>
<Step title="모델 역량 매핑">
요구 사항을 이해한 후, 이를 모델의 강점에 매핑하세요. 서로 다른 모델 계열은 작업 유형에 따라 특화되어 있습니다. 일부는 추론 및 분석에 최적화되어 있고, 일부는 창의성이나 콘텐츠 생성, 또 다른 일부는 속도와 효율성에 최적화되어 있습니다.
요구 사항을 이해한 후, 이를 모델의 강점에 매핑하세요. 서로 다른 모델 계열은
작업 유형에 따라 특화되어 있습니다. 일부는 추론 및 분석에 최적화되어 있고,
일부는 창의성이나 콘텐츠 생성, 또 다른 일부는 속도와 효율성에 최적화되어
있습니다.
</Step>
<Step title="제약 조건 고려">
예산 제한, 지연 시간 요구사항, 데이터 프라이버시 필요성, 인프라 역량 등 실제 운영상의 제약 조건을 반영하세요. 이론적으로 가장 좋은 모델이 실제로는 최선의 선택이 아닐 수 있습니다.
예산 제한, 지연 시간 요구사항, 데이터 프라이버시 필요성, 인프라 역량 등 실제
운영상의 제약 조건을 반영하세요. 이론적으로 가장 좋은 모델이 실제로는 최선의
선택이 아닐 수 있습니다.
</Step>
<Step title="테스트 및 반복">
신뢰할 수 있고 잘 이해된 모델로 시작하여, 특정 사용 사례에서 실제 성능을 바탕으로 최적화하세요. 실제 결과는 이론적 벤치마크와 다를 수 있으므로, 경험적 테스트가 매우 중요합니다.
신뢰할 수 있고 잘 이해된 모델로 시작하여, 특정 사용 사례에서 실제 성능을
바탕으로 최적화하세요. 실제 결과는 이론적 벤치마크와 다를 수 있으므로,
경험적 테스트가 매우 중요합니다.
</Step>
</Steps>
@@ -43,6 +53,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이
- **Complex Tasks**는 다단계 추론, 전략적 사고, 모호하거나 불완전한 정보를 처리하는 능력을 필요로 합니다. 여러 데이터 소스를 분석하거나, 포괄적 전략을 개발하거나, 더 작은 구성 요소로 분해해야 하는 문제 해결 작업 등이 이에 해당합니다. 모델은 여러 추론 단계를 거치는 동안 맥락을 유지해야 하며, 명시적으로 언급되지 않은 내용을 추론해야 할 때가 많습니다.
- **Creative Tasks**는 새롭고, 흥미로우며, 맥락에 적합한 콘텐츠를 생성하는 데 중점을 둔 새로운 인지적 능력을 요구합니다. 여기에는 스토리텔링, 마케팅 카피 작성, 창의적 문제 해결이 포함됩니다. 모델은 뉘앙스, 톤, 대상 청중을 이해하고, 공식적이지 않고 진정성 있고 흥미로운 콘텐츠를 제작해야 합니다.
</Tab>
<Tab title="Output Requirements">
@@ -51,6 +62,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이
- **Creative Content** 출력은 기술적 역량과 창의적 감각의 균형을 필요로 합니다. 모델은 대상 청중, 톤, 브랜드 보이스를 이해하고, 독자의 관심을 끌며 특정 커뮤니케이션 목표를 달성하는 콘텐츠를 제작할 수 있어야 합니다. 이 영역의 품질은 주관적인 경우가 많으며, 다양한 맥락과 목적에 맞게 글쓰기 스타일을 조정할 수 있는 모델이 필요합니다.
- **Technical Content**는 구조화된 데이터와 창의적 콘텐츠의 중간에 위치하며, 정확성과 명확성을 모두 필요로 합니다. 문서화, 코드 생성, 기술 분석 등은 정밀하면서도 포괄적으로 작성되어야 하며, 대상이 되는 청중에게 효과적으로 전달되어야 합니다. 모델은 복잡한 기술 개념을 이해하고 이를 명확하게 설명할 수 있어야 합니다.
</Tab>
<Tab title="Context Needs">
@@ -59,6 +71,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이
- **Long Context** 요구 사항은 방대한 문서 작업, 장기간 대화, 복잡한 다중 파트 작업을 처리할 때 발생합니다. 모델은 수천 토큰에 걸쳐 일관성을 유지해야 하며, 앞선 정보를 정확히 참조할 수 있어야 합니다. 이는 문서 분석, 포괄적 연구, 정교한 대화 시스템에 매우 중요한 기능입니다.
- **Very Long Context** 시나리오는 현재 가능한 한계를 뛰어넘는 경우로, 대규모 문서 처리, 광범위한 연구 종합, 복잡한 다중 세션 상호작용 등이 있습니다. 이러한 활용 사례는 확장된 컨텍스트 처리를 위해 특별히 설계된 모델이 필요하며, 종종 컨텍스트 길이와 처리 속도 간의 절충이 발생합니다.
</Tab>
</Tabs>
@@ -73,6 +86,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이
Reasoning 모델의 강점은 확장된 reasoning 체인에서 논리적 일관성을 유지하고, 복잡한 문제를 관리 가능한 구성 요소로 나눌 수 있다는 점에 있습니다. 전략적 계획, 복잡한 분석, 그리고 응답 속도보다 reasoning의 질이 더 중요한 상황에서 특히 가치가 있습니다.
하지만 reasoning 모델은 속도와 비용 면에서 트레이드오프가 따르는 경우가 많습니다. 또한 그들의 고도화된 reasoning 역량이 필요 없는 창의적인 작업이나 간단한 작업에는 덜 적합할 수 있습니다. 체계적이고 단계적인 분석이 요구되는 진정한 복잡성이 관련된 작업에서 이러한 모델을 고려하십시오.
</Accordion>
<Accordion title="General Purpose Models" icon="microchip">
@@ -81,6 +95,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이
General purpose 모델의 주요 장점은 다양한 유형의 작업에서 예측 가능한 신뢰성과 일관성입니다. 조사, 분석, 콘텐츠 제작, 데이터 처리 등 대부분의 표준 비즈니스 작업을 충분히 처리할 수 있습니다. 이로 인해 다양한 워크플로우 전반에서 일관된 성능이 필요한 팀에 매우 적합한 선택이 됩니다.
General purpose 모델은 특정 도메인에서 특화된 대안들이 보여주는 최고 성능에는 미치지 않을 수 있지만, 운영의 단순성과 모델 관리의 복잡성 감소라는 이점이 있습니다. 신규 프로젝트의 시작점으로 가장 좋은 선택인 경우가 많으며, 팀이 구체적인 필요를 이해하고 나서 특화 모델로 최적화할 수 있습니다.
</Accordion>
<Accordion title="Fast & Efficient Models" icon="bolt">
@@ -89,6 +104,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이
이러한 모델은 일상적인 운영, 간단한 데이터 처리, 함수 호출, 대용량 작업 등 인지적 요구가 비교적 단순한 시나리오에서 뛰어납니다. 많은 요청을 신속하게 처리해야 하거나 예산 제약 내에서 운영되어야 하는 애플리케이션에 특히 유용합니다.
효율적인 모델에서 가장 중요한 고려사항은 그들의 역량이 귀하의 작업 요구와 일치하는지 확인하는 것입니다. 많은 일상적 작업은 효과적으로 처리할 수 있지만, Nuanced한 이해, 복잡한 reasoning, 혹은 고도화된 콘텐츠 생성이 필요한 작업에는 어려움을 겪을 수 있습니다. 정교함보다 속도와 비용이 더 중요한 명확하고 일상적인 작업에 가장 적합합니다.
</Accordion>
<Accordion title="Creative Models" icon="pen">
@@ -97,6 +113,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이
Creative 모델의 강점은 다양한 대상에 맞춰 글쓰기 스타일을 조정하고, 일관된 목소리와 톤을 유지하며, 독자를 효과적으로 사로잡는 콘텐츠를 생성할 수 있다는 점입니다. 스토리텔링, 마케팅 카피, 브랜드 커뮤니케이션 등 창의성과 몰입이 주요 목적이 되는 콘텐츠 작업에서 더 우수한 성과를 보입니다.
Creative 모델을 선택할 때는 단순한 텍스트 생성 능력뿐 아니라, 대상, 맥락, 목적에 대한 이해력도 함께 고려해야 합니다. 최상의 creative 모델은 특정 브랜드 목소리에 맞게 출력 내용을 조정하고, 다양한 대상 그룹을 타깃팅하며, 긴 콘텐츠에서도 일관성을 유지할 수 있습니다.
</Accordion>
<Accordion title="Open Source Models" icon="code">
@@ -105,6 +122,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이
Open source 모델의 주요 이점으로는 토큰당 비용의 제거, 특정 용도에 맞춘 파인튜닝 가능성, 완전한 데이터 프라이버시, 외부 API 제공자에 대한 의존성 해소가 있습니다. 특히 엄격한 데이터 프라이버시 요구사항, 예산 제약, 특정 맞춤화 필요가 있는 조직에 매우 유용합니다.
그러나 open source 모델은 효과적으로 배포 및 유지관리하기 위해 더 많은 기술 전문성이 필요합니다. 팀에서는 인프라 비용, 모델 관리 복잡성, 지속적인 모델 업데이트 및 최적화를 위한 지속적인 노력을 고려해야 합니다. 기술적 오버헤드를 감안하면 전체 소유 비용이 클라우드 기반 대안보다 높을 수 있습니다.
</Accordion>
</AccordionGroup>
@@ -113,7 +131,8 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이
### a. 멀티-모델 접근 방식
<Tip>
동일 crew 내에서 다양한 목적에 맞는 서로 다른 모델을 사용해 성능과 비용을 모두 최적화할 수 있습니다.
동일 crew 내에서 다양한 목적에 맞는 서로 다른 모델을 사용해 성능과 비용을 모두
최적화할 수 있습니다.
</Tip>
가장 정교하게 구현된 CrewAI의 경우, 여러 개의 모델을 전략적으로 활용하여 각 agent의 역할과 요구 사항에 맞는 모델을 지정합니다. 이 접근 방식은 각 작업 유형에 가장 적합한 모델을 사용함으로써 성능과 비용을 모두 최적화할 수 있게 해줍니다.
@@ -177,6 +196,7 @@ crew = Crew(
효과적인 Manager LLM은 올바른 위임 결정을 내리기 위한 강력한 추론 능력, 예측 가능한 조정을 보장하는 일관된 성능, 여러 에이전트의 상태를 동시에 추적하기 위한 탁월한 컨텍스트 관리가 필요합니다. 이 모델은 다양한 에이전트의 역량과 한계를 이해하고, 효율성과 품질을 최적화하기 위해 작업 할당을 최적화해야 합니다.
Manager LLM은 모든 작업에 관여하기 때문에 비용 고려가 특히 중요합니다. 모델은 효과적인 조정을 위한 충분한 역량을 제공하면서도, 잦은 사용에도 비용 효율적이어야 합니다. 이는 종종 가장 정교한 모델의 높은 가격 없이도 충분한 추론 능력을 제공하는 모델을 찾는 것을 의미합니다.
</Tab>
<Tab title="Function Calling LLM">
@@ -185,6 +205,7 @@ crew = Crew(
Function calling LLM에서 가장 중요한 특성은 창의성이나 정교한 추론력보다는 정확성과 신뢰성입니다. 모델은 자연어 요청에서 올바른 파라미터를 일관되게 추출하고, 도구 응답을 적절히 처리해야 합니다. 도구 사용은 여러 번의 왕복 작업이 수반될 수 있으므로 속도도 중요합니다.
많은 팀들은, 창의적이거나 추론에 특화된 모델보다는, 특화된 function calling 모델이나 도구 지원이 강력한 범용 모델이 이 역할에 더 적합하다는 것을 발견합니다. 핵심은 모델이 자연어 지침과 구조화된 도구 호출 간의 간극을 신뢰성 있게 연결할 수 있도록 하는 것입니다.
</Tab>
<Tab title="Agent-Specific Overrides">
@@ -193,6 +214,7 @@ crew = Crew(
에이전트별 재정의를 고려해야 하는 경우는 에이전트의 역할이 다른 crew 구성원과 본질적으로 다른 역량을 요구할 때입니다. 예를 들어, 창의적 글쓰기에 특화된 에이전트는 콘텐츠 생성에 최적화된 모델이 도움이 될 수 있고, 데이터 분석 에이전트는 추론에 중점을 둔 모델로 더 나은 성과를 거둘 수 있습니다.
에이전트별 재정의를 적용할 때의 과제는 최적화와 운영 복잡도 간의 균형을 유지하는 것입니다. 모델이 하나 추가될 때마다 배포, 모니터링, 비용 관리의 복잡성이 늘어납니다. 따라서 팀은 성능 향상 효과가 추가 복잡성을 정당화할 수 있는 에이전트에만 재정의를 집중해야 합니다.
</Tab>
</Tabs>
@@ -209,6 +231,7 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적
효과적인 작업 설명은 에이전트가 더 넓은 목적과 그들이 반드시 지켜야 할 제한사항을 이해할 수 있도록 관련 맥락 및 제약 조건을 포함합니다. 복잡한 작업을 체계적으로 실행할 수 있는 집중된 단계로 분할하여, 여러 측면이 뒤섞이고 접근하기 어려운 압도적인 목표로 제시하지 않습니다.
일반적인 실수로는 목표가 너무 모호하다거나, 필요한 맥락을 제공하지 않는다거나, 성공 기준이 불분명하다거나, 관련 없는 여러 작업을 하나의 설명으로 결합하는 경우가 있습니다. 목표는 단일의 명확한 목적에 집중하며, 에이전트가 성공할 수 있을 정도로 충분한 정보를 제공하는 것입니다.
</Accordion>
<Accordion title="예상 산출물 가이드라인" icon="bullseye">
@@ -217,6 +240,7 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적
최고의 산출물 가이드라인은 품질 지표에 대한 구체적인 예시를 제공하고, 완료 기준을 에이전트와 인간 평가자 모두가 작업의 성공적 완료 여부를 평가할 수 있을 만큼 명확하게 정의합니다. 이는 모호함을 줄이고 여러 작업 실행 간 일관된 결과를 보장하는 데 도움이 됩니다.
어떤 작업에나 적용할 수 있을 정도로 일반적인 산출물 설명, 에이전트가 구조를 추측해야 하는 형식 명세 누락, 평가가 어려운 불분명한 품질 기준, 에이전트가 기대치를 이해하도록 도와주는 예시 또는 템플릿 미제공 등은 피해야 합니다.
</Accordion>
</AccordionGroup>
@@ -229,6 +253,7 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적
순차적 의존성을 효과적으로 구현하기 위해서는 context 파라미터를 사용하여 관련 작업을 연쇄시키고, 작업의 진행을 통해 점진적으로 복잡성을 구축하며, 각 작업이 다음 작업에 의미 있는 입력값이 될 수 있는 산출물을 생성하도록 해야 합니다. 목표는 의존된 작업 간의 논리적 흐름을 유지하면서 불필요한 병목을 피하는 것입니다.
순차적 의존성은 한 작업에서 다른 작업으로 명확한 논리적 진행이 있고, 한 작업의 산출물이 다음 작업의 품질이나 실행 가능성을 실제로 향상시킬 때 가장 효과적입니다. 그러나 적절히 관리되지 않을 경우 병목 현상이 발생할 수 있으니, 반드시 진정으로 필요한 의존성과 단순히 편의상 설정된 의존성을 구분해야 합니다.
</Tab>
<Tab title="병렬 실행">
@@ -237,6 +262,7 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적
성공적인 병렬 실행을 위해서는 실제로 독립적으로 수행이 가능한 작업을 식별하고, 관련되지만 분리된 작업 스트림을 효과적으로 그룹화하며, 병렬로 진행된 작업을 최종 결과물로 통합해야 할 때 결과 통합을 계획해야 합니다. 핵심은 병렬 작업이 전체 품질을 저하하는 충돌이나 중복을 만들지 않도록 하는 것입니다.
여러 개의 독립적인 연구 스트림이나 서로 의존하지 않는 다양한 분석, 동시에 개발이 가능한 콘텐츠 생성 작업이 있을 때 병렬 실행을 고려하십시오. 다만, 자원 할당에 주의하고, 병렬 실행이 모델의 가용 용량이나 예산을 초과하지 않도록 해야 합니다.
</Tab>
</Tabs>
@@ -245,7 +271,8 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적
### a. 역할 기반 LLM 선택
<Warning>
일반적인 에이전트 역할은 올바른 LLM을 선택할 수 없게 만듭니다. 구체적인 역할은 목표에 맞춘 모델 최적화를 가능하게 합니다.
일반적인 에이전트 역할은 올바른 LLM을 선택할 수 없게 만듭니다. 구체적인 역할은
목표에 맞춘 모델 최적화를 가능하게 합니다.
</Warning>
에이전트 역할의 구체성은 최적의 성능을 위해 어떤 LLM의 능력이 가장 중요한지를 직접적으로 결정합니다. 이는 에이전트의 책임에 정확히 맞는 모델 강점을 연결할 수 있는 전략적 기회를 만듭니다.
@@ -253,6 +280,7 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적
**일반 역할 vs. 구체적 역할이 LLM 선택에 미치는 영향:**
역할을 정의할 때 에이전트가 다룰 작업에 가장 가치 있는 특정 도메인 지식, 작업 방식, 의사결정 프레임워크를 고려하세요. 역할 정의가 더 구체적이고 상황에 맞을수록 모델이 그 역할을 효과적으로 구현할 수 있습니다.
```python
# ✅ 특정 역할 - 명확한 LLM 요구
specific_agent = Agent(
@@ -273,7 +301,9 @@ specific_agent = Agent(
### b. 모델 컨텍스트 증폭기로서의 백스토리
<Info>
전략적으로 구성된 백스토리는 도메인 특화 컨텍스트를 제공하여 일반적인 프롬프트로는 달성할 수 없는 수준으로 선택한 LLM의 효율성을 획기적으로 높여줍니다.
전략적으로 구성된 백스토리는 도메인 특화 컨텍스트를 제공하여 일반적인
프롬프트로는 달성할 수 없는 수준으로 선택한 LLM의 효율성을 획기적으로
높여줍니다.
</Info>
잘 설계된 백스토리는 LLM을 단순한 범용 모델에서 전문적인 전문가로 탈바꿈시켜 줍니다. 이는 비용 최적화 관점에서 특히 중요합니다. 효율적인 모델이라도 컨텍스트가 잘 구축되면, 적절한 컨텍스트 없이 고가의 모델보다 더 뛰어난 성능을 발휘할 수 있습니다.
@@ -300,6 +330,7 @@ domain_expert = Agent(
```
**LLM 성능을 높여주는 백스토리 요소:**
- **도메인 경험**: "10년 이상의 엔터프라이즈 SaaS 영업 경력"
- **특정 전문성**: "시리즈 B+ 라운드의 기술 실사 전문"
- **업무 스타일**: "명확한 문서화와 데이터 기반 의사결정을 선호"
@@ -332,6 +363,7 @@ tech_writer = Agent(
```
**정렬 체크리스트:**
- ✅ **역할 특이성**: 명확한 도메인과 책임
- ✅ **LLM 적합도**: 모델의 강점이 역할 요구사항과 일치
- ✅ **백스토리 깊이**: LLM이 활용할 수 있는 도메인 맥락 제공
@@ -353,6 +385,7 @@ tech_writer = Agent(
- 도구에 크게 의존하는 agent가 있습니까?
**Action**: 현재 agent 역할을 문서화하고 최적화 기회를 식별하세요.
</Step>
<Step title="Crew 수준 전략 구현" icon="users-gear">
@@ -369,6 +402,7 @@ tech_writer = Agent(
```
**Action**: 개별 agent 최적화 전에 crew의 기본 LLM을 설정하세요.
</Step>
<Step title="고임팩트 agent 최적화" icon="star">
@@ -390,16 +424,18 @@ tech_writer = Agent(
```
**Action**: 복잡도의 80%를 처리하는 agent 20%를 업그레이드하세요.
</Step>
<Step title="엔터프라이즈 테스트로 검증" icon="test-tube">
**agent를 프로덕션에 배포한 후:**
- [CrewAI AOP platform](https://app.crewai.com)을 활용하여 모델 선택을 A/B 테스트하세요
- [CrewAI AMP platform](https://app.crewai.com)을 활용하여 모델 선택을 A/B 테스트하세요
- 실제 입력으로 여러 번 반복 테스트하여 일관성과 성능을 측정하세요
- 최적화된 셋업 전반의 비용과 성능을 비교하세요
- 팀과 결과를 공유하여 협업 의사결정을 지원하세요
**Action**: 테스트 플랫폼을 활용해 추측이 아닌 데이터 기반 검증을 실행하세요.
</Step>
</Steps>
@@ -412,6 +448,7 @@ tech_writer = Agent(
예를 들어, 비즈니스 전략 개발, 여러 출처에서 인사이트를 도출해야 하는 복잡한 데이터 분석, 각 단계가 이전 분석을 기반으로 해야 하는 다단계 문제 해결, 다양한 변수 및 이들의 상호작용을 고려해야 하는 전략적 계획 수립 업무에 reasoning 모델을 고려해 보세요.
그러나 reasoning 모델은 일반적으로 더 높은 비용과 느린 응답 시간을 수반하므로, 복잡한 사고가 필요한 작업에서 실질적인 가치를 제공할 때에만 사용하는 것이 좋으며, 복잡한 reasoning이 필요하지 않은 단순한 작업에는 권장되지 않습니다.
</Tab>
<Tab title="Creative Models">
@@ -420,6 +457,7 @@ tech_writer = Agent(
creative 모델은 블로그 포스트 작성 및 기사 생성, 독자를 끌어들이고 설득해야 하는 마케팅 카피, 창의적인 스토리텔링 및 내러티브 개발, 목소리와 톤이 중요한 브랜드 커뮤니케이션 등에 적합합니다. 이 모델은 일반 목적 모델보다 뉘앙스와 맥락을 더 잘 이해할 수 있습니다.
creative 모델은 정밀성과 사실적 정확성이 스타일이나 참여도보다 더 중요한 기술적 또는 분석적 작업에는 덜 적합할 수 있습니다. 결과물의 창의적·의사소통적 측면이 성공의 주요 요인일 때 사용하는 것이 가장 좋습니다.
</Tab>
<Tab title="Efficient Models">
@@ -428,6 +466,7 @@ tech_writer = Agent(
efficient 모델은 데이터 처리 및 변환 작업, 단순한 서식 지정 및 정리 작업, 정밀성이 중요하고 복잡함보다는 정확성이 필요한 함수 호출 및 도구 사용, 1회 작업당 비용이 중대한 고볼륨 작업에 적합합니다.
efficient 모델에서는 해당 모델의 역량이 작업 요구 사항과 일치하는지 확인하는 것이 핵심입니다. 다양한 반복 작업을 효과적으로 처리할 수 있지만, 뉘앙스 이해, 복잡한 reasoning, 고도화된 콘텐츠 생성이 필요한 작업에서는 한계가 있을 수 있습니다.
</Tab>
<Tab title="Open Source Models">
@@ -436,6 +475,7 @@ tech_writer = Agent(
예를 들어, 데이터 프라이버시가 최우선인 사내 도구, 외부 API를 사용할 수 없는 프라이버시 민감형 애플리케이션, 토큰 단위 가격이 부담스러운 비용 최적화 배포, 모델 수정 또는 파인튜닝이 필요한 상황에서 open source 모델을 고려해 보세요.
단, open source 모델은 효과적으로 배포하고 유지하기 위해 더 많은 기술 전문성이 요구됩니다. 인프라, 기술적 오버헤드, 지속적인 유지보수를 포함한 전체 소유 비용을 종합적으로 평가해야 합니다.
</Tab>
</Tabs>
@@ -455,6 +495,7 @@ tech_writer = Agent(
# 처리 agent는 효율적인 모델 사용
processor = Agent(role="Data Processor", llm=LLM(model="gpt-4o-mini"))
```
</Accordion>
<Accordion title="Crew 수준과 Agent 수준 LLM 계층 혼동" icon="shuffle">
@@ -474,6 +515,7 @@ tech_writer = Agent(
# agent는 특별히 지정하지 않으면 crew LLM을 상속받음
agent1 = Agent(llm=LLM(model="claude-3-5-sonnet")) # 특정 요구에 따라 오버라이드
```
</Accordion>
<Accordion title="함수 호출 모델 미스매치" icon="screwdriver-wrench">
@@ -492,6 +534,7 @@ tech_writer = Agent(
llm=LLM(model="claude-3-5-sonnet") # 도구 사용에 강점
)
```
</Accordion>
<Accordion title="테스트 없는 조기 최적화" icon="gear">
@@ -507,6 +550,7 @@ tech_writer = Agent(
# 성능을 테스트하고, 필요에 따라 특정 agent만 최적화
# Enterprise 플랫폼 테스트를 통해 개선 사항 검증
```
</Accordion>
<Accordion title="컨텍스트·메모리 한계 간과" icon="brain">
@@ -515,6 +559,7 @@ tech_writer = Agent(
**실제 예시**: 여러 차례 반복되는 업무나 agent 간 활발한 소통이 필요한 crew에 대화 내역을 오래 유지해야 하는데, 짧은 컨텍스트 모델을 사용한 경우.
**CrewAI 솔루션**: crew의 소통 패턴에 맞춰 컨텍스트 처리 능력을 갖춘 모델을 선택.
</Accordion>
</AccordionGroup>
@@ -522,26 +567,36 @@ tech_writer = Agent(
<Steps>
<Step title="간단하게 시작하기" icon="play">
신뢰할 수 있고, 잘 알려져 있으며, 널리 지원되는 범용 모델로 시작하세요. 이것은 최적화된 특수한 필요에 집중하기 전에 귀하의 특정 요구사항과 성능 기대치를 이해할 수 있는 안정적인 기초를 제공합니다.
신뢰할 수 있고, 잘 알려져 있으며, 널리 지원되는 범용 모델로 시작하세요.
이것은 최적화된 특수한 필요에 집중하기 전에 귀하의 특정 요구사항과 성능
기대치를 이해할 수 있는 안정적인 기초를 제공합니다.
</Step>
<Step title="중요한 것 측정하기" icon="chart-line">
일반적인 벤치마크에만 의존하지 말고, 귀하의 특정 사용 사례와 비즈니스 요구에 부합하는 지표를 개발하세요. 이론적 성능 지표가 아니라 성공에 직접적으로 영향을 미치는 결과 측정에 집중하세요.
일반적인 벤치마크에만 의존하지 말고, 귀하의 특정 사용 사례와 비즈니스 요구에
부합하는 지표를 개발하세요. 이론적 성능 지표가 아니라 성공에 직접적으로
영향을 미치는 결과 측정에 집중하세요.
</Step>
<Step title="결과에 기반한 반복" icon="arrows-rotate">
이론적 고려사항이나 일반적인 권장사항이 아니라, 귀하의 특정 상황에서 관찰된 성능에 따라 모델을 변경하세요. 실제 성능은 벤치마크 결과나 일반적인 평판과는 크게 다를 수 있습니다.
이론적 고려사항이나 일반적인 권장사항이 아니라, 귀하의 특정 상황에서 관찰된
성능에 따라 모델을 변경하세요. 실제 성능은 벤치마크 결과나 일반적인 평판과는
크게 다를 수 있습니다.
</Step>
<Step title="총 비용 고려하기" icon="calculator">
모델 비용, 개발 시간, 유지 보수 오버헤드, 운영 복잡성 등 소유에 드는 전체 비용을 평가하세요. 토큰당 가장 저렴한 모델이 모든 요소를 고려했을 때 반드시 가장 비용 효율적이지는 않을 수 있습니다.
모델 비용, 개발 시간, 유지 보수 오버헤드, 운영 복잡성 등 소유에 드는 전체
비용을 평가하세요. 토큰당 가장 저렴한 모델이 모든 요소를 고려했을 때 반드시
가장 비용 효율적이지는 않을 수 있습니다.
</Step>
</Steps>
<Tip>
먼저 귀하의 요구사항을 이해하는 데 집중한 후, 그 요구와 가장 잘 맞는 모델을 선택하세요. 최상의 LLM 선택은 운영상의 제약 조건 내에서 꾸준히 원하는 결과를 제공하는 것입니다.
먼저 귀하의 요구사항을 이해하는 데 집중한 후, 그 요구와 가장 잘 맞는 모델을
선택하세요. 최상의 LLM 선택은 운영상의 제약 조건 내에서 꾸준히 원하는 결과를
제공하는 것입니다.
</Tip>
### 엔터프라이즈급 모델 검증
LLM 선택을 최적화하고자 하는 팀을 위해 **CrewAI AOP 플랫폼**은 기본적인 CLI 테스트를 훨씬 능가하는 정교한 테스트 기능을 제공합니다. 이 플랫폼은 데이터 기반의 LLM 전략 의사결정을 지원하는 종합적인 모델 평가를 가능하게 합니다.
LLM 선택을 최적화하고자 하는 팀을 위해 **CrewAI AMP 플랫폼**은 기본적인 CLI 테스트를 훨씬 능가하는 정교한 테스트 기능을 제공합니다. 이 플랫폼은 데이터 기반의 LLM 전략 의사결정을 지원하는 종합적인 모델 평가를 가능하게 합니다.
<Frame>
![엔터프라이즈 테스트 인터페이스](/images/enterprise/enterprise-testing.png)
@@ -562,7 +617,9 @@ LLM 선택을 최적화하고자 하는 팀을 위해 **CrewAI AOP 플랫폼**
지금 [app.crewai.com](https://app.crewai.com)에서 시작하세요!
<Info>
Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터 기반 프로세스로 혁신하여, 본 가이드의 원칙을 실제 사용 사례와 요구 사항에 맞게 검증할 수 있도록 해줍니다.
Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터 기반 프로세스로
혁신하여, 본 가이드의 원칙을 실제 사용 사례와 요구 사항에 맞게 검증할 수
있도록 해줍니다.
</Info>
## 주요 원칙 요약
@@ -572,21 +629,25 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터
이론적 능력이나 일반적인 평판이 아니라, 작업에 실제로 필요한 것에 따라 모델을 선택하세요.
</Card>
<Card title="능력 일치" icon="puzzle-piece">
최적의 성능을 위해 모델의 강점을 agent의 역할 및 책임과 일치시키세요.
</Card>
{" "}
<Card title="능력 일치" icon="puzzle-piece">
최적의 성능을 위해 모델의 강점을 agent의 역할 및 책임과 일치시키세요.
</Card>
<Card title="전략적 일관성" icon="link">
관련 구성 요소와 워크플로 전반에 걸쳐 일관된 모델 선택 전략을 유지하세요.
</Card>
{" "}
<Card title="전략적 일관성" icon="link">
관련 구성 요소와 워크플로 전반에 걸쳐 일관된 모델 선택 전략을 유지하세요.
</Card>
<Card title="실용적 테스트" icon="flask">
벤치마크에만 의존하지 말고 실제 사용을 통해 선택을 검증하세요.
</Card>
{" "}
<Card title="실용적 테스트" icon="flask">
벤치마크에만 의존하지 말고 실제 사용을 통해 선택을 검증하세요.
</Card>
<Card title="반복적 개선" icon="arrow-up">
단순하게 시작하고 실제 성능과 필요에 따라 최적화하세요.
</Card>
{" "}
<Card title="반복적 개선" icon="arrow-up">
단순하게 시작하고 실제 성능과 필요에 따라 최적화하세요.
</Card>
<Card title="운영적 균형" icon="scale-balanced">
성능 요구사항과 비용 및 복잡성 제약을 균형 있게 맞추세요.
@@ -594,13 +655,19 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터
</CardGroup>
<Check>
기억하세요: 최고의 LLM 선택이란 운영상의 제약 내에서 일관되게 필요한 결과를 제공하는 모델입니다. 먼저 요구사항을 정확히 이해하는 데 집중한 후, 그에 가장 잘 맞는 모델을 선택하세요.
기억하세요: 최고의 LLM 선택이란 운영상의 제약 내에서 일관되게 필요한 결과를
제공하는 모델입니다. 먼저 요구사항을 정확히 이해하는 데 집중한 후, 그에 가장
잘 맞는 모델을 선택하세요.
</Check>
## 현재 모델 현황 (2025년 6월)
<Warning>
**특정 시점의 스냅샷**: 아래 모델 순위는 2025년 6월 기준으로, [LMSys Arena](https://arena.lmsys.org/), [Artificial Analysis](https://artificialanalysis.ai/) 및 기타 주요 벤치마크에서 집계된 최신 리더보드 결과입니다. LLM의 성능, 가용성, 가격은 빠르게 변동됩니다. 항상 귀하의 특정 사용 사례와 데이터로 직접 평가를 진행하시기 바랍니다.
**특정 시점의 스냅샷**: 아래 모델 순위는 2025년 6월 기준으로, [LMSys
Arena](https://arena.lmsys.org/), [Artificial
Analysis](https://artificialanalysis.ai/) 및 기타 주요 벤치마크에서 집계된
최신 리더보드 결과입니다. LLM의 성능, 가용성, 가격은 빠르게 변동됩니다. 항상
귀하의 특정 사용 사례와 데이터로 직접 평가를 진행하시기 바랍니다.
</Warning>
### 카테고리별 주요 모델
@@ -608,7 +675,10 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터
아래 표는 다양한 카테고리에서 현재 최고의 성능을 보이는 대표적인 모델들을 보여주며, CrewAI 에이전트에 적합한 모델 선택에 대한 가이드를 제공합니다:
<Note>
이 표와 지표는 각 카테고리에서 선별된 주요 모델을 보여주기 위한 것으로, 전체를 포괄하지 않습니다. 여기 소개되지 않은 훌륭한 모델들도 많이 존재합니다. 이 표의 목적은 완전한 목록을 제공하는 것이 아니라, 어떤 능력을 갖춘 모델을 찾아야 하는지 예시를 제시하는 것입니다.
이 표와 지표는 각 카테고리에서 선별된 주요 모델을 보여주기 위한 것으로, 전체를
포괄하지 않습니다. 여기 소개되지 않은 훌륭한 모델들도 많이 존재합니다. 이 표의
목적은 완전한 목록을 제공하는 것이 아니라, 어떤 능력을 갖춘 모델을 찾아야
하는지 예시를 제시하는 것입니다.
</Note>
<Tabs>
@@ -624,6 +694,7 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터
| **Qwen3 235B (Reasoning)** | 62 | $2.63 | 보통 | reasoning 작업을 위한 오픈소스 대안 |
이 모델들은 다단계 reasoning에 뛰어나며, 전략을 개발하거나 다른 에이전트를 조정하거나 복잡한 정보를 분석해야 하는 에이전트에 이상적입니다.
</Tab>
<Tab title="Coding & Technical">
@@ -638,6 +709,7 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터
| **Llama 3.1 405B** | 좋음 | 81.1% | $3.50 | 도구 사용이 많은 워크플로우를 위한 function calling LLM |
이 모델들은 코드 생성, 디버깅, 기술 문제 해결에 최적화되어 있어, 개발 중심 팀에 적합합니다.
</Tab>
<Tab title="Speed & Efficiency">
@@ -652,6 +724,7 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터
| **Nova Micro** | 높음 | 0.30s | $0.04 | 단순·빠른 작업 처리 |
이 모델들은 속도와 효율을 우선시하며, 일상적 운영 또는 신속한 응답이 필요한 에이전트에게 최적입니다. **팁**: 이러한 모델을 Groq와 같은 빠른 추론 제공자와 함께 사용하면 더욱 우수한 성능을 낼 수 있습니다. 특히 Llama와 같은 오픈소스 모델에 적합합니다.
</Tab>
<Tab title="Balanced Performance">
@@ -666,6 +739,7 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터
| **Qwen3 32B** | 44 | 좋음 | $1.23 | 예산 친화적 다재다능성 |
이 모델들은 다양한 측면에서 우수한 성능을 제공하며, 여러 작업이 혼합된 팀에 적합합니다.
</Tab>
</Tabs>
@@ -676,24 +750,28 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터
**퍼포먼스가 우선 순위일 때**: 매니저 LLM 또는 중요한 에이전트 역할에는 **o3**, **Gemini 2.5 Pro**, **Claude 4 Sonnet**과 같은 최상위 모델을 사용하세요. 이 모델들은 복잡한 reasoning 및 coordination에 탁월하지만 비용이 더 높습니다.
**전략**: 프리미엄 모델이 전략적 사고를 담당하고, 효율적인 모델이 일상적 operation을 처리하는 멀티 모델 접근법을 구현하세요.
</Accordion>
<Accordion title="Cost-Conscious Crews" icon="dollar-sign">
**예산이 주요 제약일 때**: **DeepSeek R1**, **Llama 4 Scout**, **Gemini 2.0 Flash**와 같은 모델에 집중하세요. 이 모델들은 훨씬 낮은 비용으로 강력한 퍼포먼스를 제공합니다.
**전략**: 대부분의 에이전트에는 비용 효율이 높은 모델을 사용하고, 가장 중요한 decision-making 역할에만 프리미엄 모델을 남겨두세요.
</Accordion>
<Accordion title="Specialized Workflows" icon="screwdriver-wrench">
**특정 도메인 전문성이 필요할 때**: 주된 사용 사례에 최적화된 모델을 선택하세요. 코딩에는 **Claude 4** 시리즈, 리서치에는 **Gemini 2.5 Pro**, function calling에는 **Llama 405B**를 사용하세요.
**전략**: crew의 주요 기능에 따라 모델을 선택해, 핵심 역량이 모델의 강점과 일치하도록 하세요.
</Accordion>
<Accordion title="Enterprise & Privacy" icon="shield">
**데이터 민감한 operation의 경우**: 로컬에서 배포 가능하면서 경쟁력 있는 퍼포먼스를 유지하는 오픈 소스 모델인 **Llama 4** 시리즈, **DeepSeek V3**, **Qwen3** 등을 고려하세요.
**전략**: 사설 인프라에 오픈 소스 모델을 배포하여, 데이터 제어를 위해 필요한 퍼포먼스 손실을 감수하세요.
</Accordion>
</AccordionGroup>
@@ -706,7 +784,10 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터
- **오픈 소스의 실효성**: 오픈 소스와 독점 모델 간의 격차가 계속 좁혀지고 있으며, Llama 4 Maverick 및 DeepSeek V3와 같은 모델이 매력적인 가격대에서 경쟁력 있는 성능을 제공합니다. 특히 빠른 추론을 제공하는 업체들은 오픈 소스 모델과 함께 탁월한 속도-비용 비율을 제공하는 경우가 많아 독점 모델보다 우위에 서기도 합니다.
<Info>
**테스트는 필수입니다**: 리더보드 순위는 일반적인 가이드라인을 제공하지만, 귀하의 특정 사용 사례, 프롬프트 스타일, 평가 기준에 따라 결과가 달라질 수 있습니다. 최종 결정을 내리기 전에 반드시 실제 작업과 데이터로 후보 모델을 테스트해 보세요.
**테스트는 필수입니다**: 리더보드 순위는 일반적인 가이드라인을 제공하지만,
귀하의 특정 사용 사례, 프롬프트 스타일, 평가 기준에 따라 결과가 달라질 수
있습니다. 최종 결정을 내리기 전에 반드시 실제 작업과 데이터로 후보 모델을
테스트해 보세요.
</Info>
### 실질적인 구현 전략
@@ -716,13 +797,19 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터
여러 차원에서 우수한 성능을 제공하며 실제 환경에서 광범위하게 검증된 **GPT-4.1**, **Claude 3.7 Sonnet**, **Gemini 2.0 Flash**와 같은 잘 알려진 모델부터 시작하십시오.
</Step>
<Step title="특화된 요구 사항 식별">
crew에 코드 작성, reasoning, 속도 등 특정 요구가 있는지 확인하고, 이러한 요구에 부합하는 **Claude 4 Sonnet**(개발용) 또는 **o3**(복잡한 분석용)과 같은 특화 모델을 고려하십시오. 속도가 중요한 애플리케이션의 경우, 모델 선택과 더불어 **Groq**와 같은 빠른 추론 제공자를 고려할 수 있습니다.
</Step>
{" "}
<Step title="특화된 요구 사항 식별">
crew에 코드 작성, reasoning, 속도 등 특정 요구가 있는지 확인하고, 이러한
요구에 부합하는 **Claude 4 Sonnet**(개발용) 또는 **o3**(복잡한 분석용)과 같은
특화 모델을 고려하십시오. 속도가 중요한 애플리케이션의 경우, 모델 선택과
더불어 **Groq**와 같은 빠른 추론 제공자를 고려할 수 있습니다.
</Step>
<Step title="다중 모델 전략 구현">
각 에이전트의 역할에 따라 다양한 모델을 사용하세요. 관리자와 복잡한 작업에는 고성능 모델을, 일상적 운영에는 효율적인 모델을 적용합니다.
</Step>
{" "}
<Step title="다중 모델 전략 구현">
각 에이전트의 역할에 따라 다양한 모델을 사용하세요. 관리자와 복잡한 작업에는
고성능 모델을, 일상적 운영에는 효율적인 모델을 적용합니다.
</Step>
<Step title="모니터링 및 최적화">
사용 사례와 관련된 성능 지표를 추적하고, 새로운 모델이 출시되거나 가격이 변동될 때 모델 선택을 조정할 준비를 하십시오.

10
docs/ko/mcp/dsl-integration.mdx
View File

@@ -10,7 +10,9 @@ mode: "wide"
CrewAI의 MCP DSL(Domain Specific Language) 통합은 에이전트를 MCP(Model Context Protocol) 서버에 연결하는 **가장 간단한 방법**을 제공합니다. 에이전트에 `mcps` 필드만 추가하면 CrewAI가 모든 복잡성을 자동으로 처리합니다.
<Info>
이는 대부분의 MCP 사용 사례에 **권장되는 접근 방식**입니다. 수동 연결 관리가 필요한 고급 시나리오의 경우 [MCPServerAdapter](/ko/mcp/overview#advanced-mcpserveradapter)를 참조하세요.
이는 대부분의 MCP 사용 사례에 **권장되는 접근 방식**입니다. 수동 연결 관리가
필요한 고급 시나리오의 경우
[MCPServerAdapter](/ko/mcp/overview#advanced-mcpserveradapter)를 참조하세요.
</Info>
## 기본 사용법
@@ -60,9 +62,9 @@ agent = Agent(
"https://mcp.exa.ai/mcp?api_key=your_key#web_search_exa"
```
### CrewAI AOP 마켓플레이스
### CrewAI AMP 마켓플레이스
CrewAI AOP 마켓플레이스의 도구에 액세스하세요:
CrewAI AMP 마켓플레이스의 도구에 액세스하세요:
```python
# 모든 도구가 포함된 전체 서비스
@@ -97,7 +99,7 @@ multi_source_agent = Agent(
"https://mcp.exa.ai/mcp?api_key=your_exa_key&profile=research",
"https://weather.api.com/mcp#get_current_conditions",
# CrewAI AOP 마켓플레이스
# CrewAI AMP 마켓플레이스
"crewai-amp:financial-insights",
"crewai-amp:academic-research#pubmed_search",
"crewai-amp:market-intelligence#competitor_analysis"

54
docs/ko/mcp/overview.mdx
View File

@@ -1,6 +1,6 @@
---
title: 'CrewAI에서 MCP 서버를 도구로 활용하기'
description: '`crewai-tools` 라이브러리를 사용하여 MCP 서버를 CrewAI agent에 도구로 통합하는 방법을 알아봅니다.'
title: "CrewAI에서 MCP 서버를 도구로 활용하기"
description: "`crewai-tools` 라이브러리를 사용하여 MCP 서버를 CrewAI agent에 도구로 통합하는 방법을 알아봅니다."
icon: plug
mode: "wide"
---
@@ -25,7 +25,7 @@ agent = Agent(
mcps=[
"https://mcp.exa.ai/mcp?api_key=your_key", # 외부 MCP 서버
"https://api.weather.com/mcp#get_forecast", # 서버의 특정 도구
"crewai-amp:financial-data", # CrewAI AOP 마켓플레이스
"crewai-amp:financial-data", # CrewAI AMP 마켓플레이스
"crewai-amp:research-tools#pubmed_search" # 특정 AMP 도구
]
)
@@ -43,6 +43,7 @@ agent = Agent(
- **Streamable HTTP**: 원격 서버용 (유연하며 잠재적으로 양방향 통신이 가능, 주로 SSE를 활용한 서버-클라이언트 스트림 제공, HTTP 기반)
## 비디오 튜토리얼
CrewAI와 MCP 통합에 대한 종합적인 안내를 위해 이 비디오 튜토리얼을 시청하세요:
<iframe
@@ -120,6 +121,7 @@ with MCPServerAdapter(server_params, connect_timeout=60) as mcp_tools:
)
# ... 나머지 crew 설정 ...
```
이 일반적인 패턴은 도구를 통합하는 방법을 보여줍니다. 각 transport에 맞춘 구체적인 예시는 아래의 상세 가이드를 참고하세요.
## 필터링 도구
@@ -206,6 +208,7 @@ class CrewWithMCP:
- `mcp_server_params`를 지정하지 않으면 `get_mcp_tools()`는 빈 리스트를 반환하여 MCP 설정 여부와 상관없이 동일한 코드 경로를 사용할 수 있습니다.
따라서 여러 에이전트에서 `get_mcp_tools()`를 호출하거나 환경에 따라 MCP 사용을 토글하더라도 안전하게 동작합니다.
</Tip>
### 연결 타임아웃 구성
@@ -266,21 +269,13 @@ class CrewWithCustomTimeout:
## MCP 통합 탐색
<CardGroup cols={2}>
<Card
title="Stdio 전송"
icon="server"
href="/ko/mcp/stdio"
color="#3B82F6"
>
표준 입력/출력을 통해 로컬 MCP 서버에 연결합니다. 스크립트와 로컬 실행 파일에 이상적입니다.
<Card title="Stdio 전송" icon="server" href="/ko/mcp/stdio" color="#3B82F6">
표준 입력/출력을 통해 로컬 MCP 서버에 연결합니다. 스크립트와 로컬 실행
파일에 이상적입니다.
</Card>
<Card
title="SSE 전송"
icon="wifi"
href="/ko/mcp/sse"
color="#10B981"
>
실시간 데이터 스트리밍을 위해 Server-Sent Events를 사용하여 원격 MCP 서버와 통합합니다.
<Card title="SSE 전송" icon="wifi" href="/ko/mcp/sse" color="#10B981">
실시간 데이터 스트리밍을 위해 Server-Sent Events를 사용하여 원격 MCP 서버와
통합합니다.
</Card>
<Card
title="스트림 가능한 HTTP 전송"
@@ -288,7 +283,8 @@ class CrewWithCustomTimeout:
href="/ko/mcp/streamable-http"
color="#F59E0B"
>
유연한 스트림 가능한 HTTP를 활용하여 원격 MCP 서버와 안정적으로 통신할 수 있습니다.
유연한 스트림 가능한 HTTP를 활용하여 원격 MCP 서버와 안정적으로 통신할 수
있습니다.
</Card>
<Card
title="다중 서버 연결"
@@ -304,27 +300,30 @@ class CrewWithCustomTimeout:
href="/ko/mcp/security"
color="#EF4444"
>
에이전트를 안전하게 보호하기 위한 MCP 통합의 중요한 보안 모범 사례를 검토하세요.
에이전트를 안전하게 보호하기 위한 MCP 통합의 중요한 보안 모범 사례를
검토하세요.
</Card>
</CardGroup>
CrewAI와의 MCP 통합에 대한 전체 데모와 예제를 보려면 이 저장소를 확인하세요! 👇
<Card
title="GitHub 저장소"
icon="github"
href="https://github.com/tonykipkemboi/crewai-mcp-demo"
target="_blank"
title="GitHub 저장소"
icon="github"
href="https://github.com/tonykipkemboi/crewai-mcp-demo"
target="_blank"
>
CrewAI MCP 데모
CrewAI MCP 데모
</Card>
## MCP와 함께 안전하게 사용하기
<Warning>
항상 MCP 서버를 사용하기 전에 해당 서버를 신뢰할 수 있는지 확인하세요.
항상 MCP 서버를 사용하기 전에 해당 서버를 신뢰할 수 있는지 확인하세요.
</Warning>
#### 보안 경고: DNS 리바인딩 공격
SSE 전송은 적절하게 보안되지 않은 경우 DNS 리바인딩 공격에 취약할 수 있습니다.
이를 방지하려면 다음을 수행하세요:
@@ -337,5 +336,6 @@ SSE 전송은 적절하게 보안되지 않은 경우 DNS 리바인딩 공격에
자세한 내용은 [Anthropic의 MCP 전송 보안 문서](https://modelcontextprotocol.io/docs/concepts/transports#security-considerations)를 참고하세요.
### 제한 사항
* **지원되는 프리미티브**: 현재 `MCPServerAdapter`는 주로 MCP `tools`를 어댑팅하는 기능을 지원합니다. 다른 MCP 프리미티브(예: `prompts` 또는 `resources`)는 현재 이 어댑터를 통해 CrewAI 컴포넌트로 직접 통합되어 있지 않습니다.
* **출력 처리**: 어댑터는 일반적으로 MCP tool의 주요 텍스트 출력(예: `.content[0].text`)을 처리합니다. 복잡하거나 멀티모달 출력의 경우 이 패턴에 맞지 않으면 별도의 커스텀 처리가 필요할 수 있습니다.
- **지원되는 프리미티브**: 현재 `MCPServerAdapter`는 주로 MCP `tools`를 어댑팅하는 기능을 지원합니다. 다른 MCP 프리미티브(예: `prompts` 또는 `resources`)는 현재 이 어댑터를 통해 CrewAI 컴포넌트로 직접 통합되어 있지 않습니다.
- **출력 처리**: 어댑터는 일반적으로 MCP tool의 주요 텍스트 출력(예: `.content[0].text`)을 처리합니다. 복잡하거나 멀티모달 출력의 경우 이 패턴에 맞지 않으면 별도의 커스텀 처리가 필요할 수 있습니다.

23
docs/ko/observability/tracing.mdx
View File

@@ -1,6 +1,6 @@
---
title: CrewAI Tracing
description: CrewAI AOP 플랫폼을 사용한 CrewAI Crews 및 Flows의 내장 추적
description: CrewAI AMP 플랫폼을 사용한 CrewAI Crews 및 Flows의 내장 추적
icon: magnifying-glass-chart
mode: "wide"
---
@@ -9,7 +9,7 @@ mode: "wide"
CrewAI는 Crews와 Flows를 실시간으로 모니터링하고 디버깅할 수 있는 내장 추적 기능을 제공합니다. 이 가이드는 CrewAI의 통합 관측 가능성 플랫폼을 사용하여 **Crews**와 **Flows** 모두에 대한 추적을 활성화하는 방법을 보여줍니다.
> **CrewAI Tracing이란?** CrewAI의 내장 추적은 agent 결정, 작업 실행 타임라인, 도구 사용, LLM 호출을 포함한 AI agent에 대한 포괄적인 관측 가능성을 제공하며, 모두 [CrewAI AOP 플랫폼](https://app.crewai.com)을 통해 액세스할 수 있습니다.
> **CrewAI Tracing이란?** CrewAI의 내장 추적은 agent 결정, 작업 실행 타임라인, 도구 사용, LLM 호출을 포함한 AI agent에 대한 포괄적인 관측 가능성을 제공하며, 모두 [CrewAI AMP 플랫폼](https://app.crewai.com)을 통해 액세스할 수 있습니다.
![CrewAI Tracing Interface](/images/crewai-tracing.png)
@@ -17,7 +17,7 @@ CrewAI는 Crews와 Flows를 실시간으로 모니터링하고 디버깅할 수
CrewAI 추적을 사용하기 전에 다음이 필요합니다:
1. **CrewAI AOP 계정**: [app.crewai.com](https://app.crewai.com)에서 무료 계정에 가입하세요
1. **CrewAI AMP 계정**: [app.crewai.com](https://app.crewai.com)에서 무료 계정에 가입하세요
2. **CLI 인증**: CrewAI CLI를 사용하여 로컬 환경을 인증하세요
```bash
@@ -26,9 +26,9 @@ crewai login
## 설정 지침
### 1단계: CrewAI AOP 계정 생성
### 1단계: CrewAI AMP 계정 생성
[app.crewai.com](https://app.crewai.com)을 방문하여 무료 계정을 만드세요. 이를 통해 추적, 메트릭을 보고 crews를 관리할 수 있는 CrewAI AOP 플랫폼에 액세스할 수 있습니다.
[app.crewai.com](https://app.crewai.com)을 방문하여 무료 계정을 만드세요. 이를 통해 추적, 메트릭을 보고 crews를 관리할 수 있는 CrewAI AMP 플랫폼에 액세스할 수 있습니다.
### 2단계: CrewAI CLI 설치 및 인증
@@ -38,16 +38,17 @@ crewai login
uv add crewai[tools]
```
그런 다음 CrewAI AOP 계정으로 CLI를 인증하세요:
그런 다음 CrewAI AMP 계정으로 CLI를 인증하세요:
```bash
crewai login
```
이 명령은 다음을 수행합니다:
1. 브라우저에서 인증 페이지를 엽니다
2. 장치 코드를 입력하라는 메시지를 표시합니다
3. CrewAI AOP 계정으로 로컬 환경을 인증합니다
3. CrewAI AMP 계정으로 로컬 환경을 인증합니다
4. 로컬 개발을 위한 추적 기능을 활성화합니다
### 3단계: Crew에서 추적 활성화
@@ -147,13 +148,12 @@ flow = ExampleFlow(tracing=True)
result = flow.kickoff()
```
### 5단계: CrewAI AOP 대시보드에서 추적 보기
### 5단계: CrewAI AMP 대시보드에서 추적 보기
crew 또는 flow를 실행한 후 CrewAI AOP 대시보드에서 CrewAI 애플리케이션이 생성한 추적을 볼 수 있습니다. agent 상호 작용, 도구 사용 및 LLM 호출의 세부 단계를 볼 수 있습니다.
crew 또는 flow를 실행한 후 CrewAI AMP 대시보드에서 CrewAI 애플리케이션이 생성한 추적을 볼 수 있습니다. agent 상호 작용, 도구 사용 및 LLM 호출의 세부 단계를 볼 수 있습니다.
아래 링크를 클릭하여 추적을 보거나 대시보드의 추적 탭으로 이동하세요 [여기](https://app.crewai.com/crewai_plus/trace_batches)
![CrewAI Tracing Interface](/images/view-traces.png)
### 대안: 환경 변수 구성
환경 변수를 설정하여 전역적으로 추적을 활성화할 수도 있습니다:
@@ -172,7 +172,7 @@ CREWAI_TRACING_ENABLED=true
## 추적 보기
### CrewAI AOP 대시보드 액세스
### CrewAI AMP 대시보드 액세스
1. [app.crewai.com](https://app.crewai.com)을 방문하여 계정에 로그인하세요
2. 프로젝트 대시보드로 이동하세요
@@ -190,6 +190,7 @@ CrewAI 추적은 다음에 대한 포괄적인 가시성을 제공합니다:
- **오류 추적**: 세부 오류 정보 및 스택 추적
### 추적 기능
- **실행 타임라인**: 실행의 다양한 단계를 클릭하여 확인하세요
- **세부 로그**: 디버깅을 위한 포괄적인 로그에 액세스하세요
- **성능 분석**: 실행 패턴을 분석하고 성능을 최적화하세요

78
docs/ko/quickstart.mdx
View File

@@ -58,6 +58,7 @@ mode: "wide"
your ability to turn complex data into clear and concise reports, making
it easy for others to understand and act on the information you provide.
```
</Step>
<Step title="`tasks.yaml` 파일 수정하기">
```yaml tasks.yaml
@@ -81,6 +82,7 @@ mode: "wide"
agent: reporting_analyst
output_file: report.md
```
</Step>
<Step title="`crew.py` 파일 수정하기">
```python crew.py
@@ -136,6 +138,7 @@ mode: "wide"
verbose=True,
)
```
</Step>
<Step title="[선택 사항] crew 실행 전/후 함수 추가">
```python crew.py
@@ -160,6 +163,7 @@ mode: "wide"
# ... remaining code
```
</Step>
<Step title="crew에 커스텀 입력값 전달하기">
예를 들어, crew에 `topic` 입력값을 넘겨 연구 및 보고서 출력을 맞춤화할 수 있습니다.
@@ -178,6 +182,7 @@ mode: "wide"
}
LatestAiDevelopmentCrew().crew().kickoff(inputs=inputs)
```
</Step>
<Step title="환경 변수 설정">
crew를 실행하기 전에 `.env` 파일에 아래 키가 환경 변수로 설정되어 있는지 확인하세요:
@@ -209,24 +214,24 @@ mode: "wide"
</Step>
<Step title="엔터프라이즈 대안: Crew Studio에서 생성">
CrewAI AOP 사용자는 코드를 작성하지 않고도 동일한 crew를 생성할 수 있습니다:
CrewAI AMP 사용자는 코드를 작성하지 않고도 동일한 crew를 생성할 수 있습니다:
1. CrewAI AOP 계정에 로그인하세요([app.crewai.com](https://app.crewai.com)에서 무료 계정 만들기)
2. Crew Studio 열기
3. 구현하려는 자동화 내용을 입력하세요
4. 미션을 시각적으로 생성하고 순차적으로 연결하세요
5. 입력값을 구성하고 "Download Code" 또는 "Deploy"를 클릭하세요
1. CrewAI AMP 계정에 로그인하세요([app.crewai.com](https://app.crewai.com)에서 무료 계정 만들기)
2. Crew Studio 열기
3. 구현하려는 자동화 내용을 입력하세요
4. 미션을 시각적으로 생성하고 순차적으로 연결하세요
5. 입력값을 구성하고 "Download Code" 또는 "Deploy"를 클릭하세요
![Crew Studio Quickstart](/images/enterprise/crew-studio-interface.png)
![Crew Studio Quickstart](/images/enterprise/crew-studio-interface.png)
<Card title="CrewAI AOP 체험하기" icon="rocket" href="https://app.crewai.com">
<Card title="CrewAI AMP 체험하기" icon="rocket" href="https://app.crewai.com">
CrewAI AOP에서 무료 계정을 시작하세요
</Card>
</Step>
<Step title="최종 보고서 확인하기">
콘솔에서 출력 결과를 확인할 수 있으며 프로젝트 루트에 `report.md` 파일로 최종 보고서가 생성됩니다.
보고서 예시는 다음과 같습니다:
보고서 예시는 다음과 같습니다:
<CodeGroup>
```markdown output/report.md
@@ -289,6 +294,7 @@ mode: "wide"
## 8. Conclusion
The emergence of AI agents is undeniably reshaping the workplace landscape in 5. With their ability to automate tasks, enhance efficiency, and improve decision-making, AI agents are critical in driving operational success. Organizations must embrace and adapt to AI developments to thrive in an increasingly digital business environment.
```
</CodeGroup>
</Step>
</Steps>
@@ -297,6 +303,7 @@ mode: "wide"
축하합니다!
crew 프로젝트 설정이 완료되었으며, 이제 자신만의 agentic workflow 구축을 바로 시작하실 수 있습니다!
</Check>
### 명명 일관성에 대한 참고
@@ -308,41 +315,44 @@ YAML 파일(`agents.yaml` 및 `tasks.yaml`)에서 사용하는 이름은 Python
#### 예시 참조
<Tip>
`agents.yaml` (`email_summarizer`) 파일에서 에이전트 이름과 `crew.py` (`email_summarizer`) 파일에서 메서드 이름이 동일하게 사용되는 점에 주목하세요.
`agents.yaml` (`email_summarizer`) 파일에서 에이전트 이름과 `crew.py`
(`email_summarizer`) 파일에서 메서드 이름이 동일하게 사용되는 점에 주목하세요.
</Tip>
```yaml agents.yaml
email_summarizer:
role: >
Email Summarizer
goal: >
Summarize emails into a concise and clear summary
backstory: >
You will create a 5 bullet point summary of the report
llm: provider/model-id # Add your choice of model here
role: >
Email Summarizer
goal: >
Summarize emails into a concise and clear summary
backstory: >
You will create a 5 bullet point summary of the report
llm: provider/model-id # Add your choice of model here
```
<Tip>
`tasks.yaml` (`email_summarizer_task`) 파일에서 태스크 이름과 `crew.py` (`email_summarizer_task`) 파일에서 메서드 이름이 동일하게 사용되는 점에 주목하세요.
`tasks.yaml` (`email_summarizer_task`) 파일에서 태스크 이름과 `crew.py`
(`email_summarizer_task`) 파일에서 메서드 이름이 동일하게 사용되는 점에
주목하세요.
</Tip>
```yaml tasks.yaml
email_summarizer_task:
description: >
Summarize the email into a 5 bullet point summary
expected_output: >
A 5 bullet point summary of the email
agent: email_summarizer
context:
- reporting_task
- research_task
description: >
Summarize the email into a 5 bullet point summary
expected_output: >
A 5 bullet point summary of the email
agent: email_summarizer
context:
- reporting_task
- research_task
```
## Crew 배포하기
production 환경에 crew를 배포하는 가장 쉬운 방법은 [CrewAI AOP](http://app.crewai.com)를 통해서입니다.
production 환경에 crew를 배포하는 가장 쉬운 방법은 [CrewAI AMP](http://app.crewai.com)를 통해서입니다.
CLI를 사용하여 [CrewAI AOP](http://app.crewai.com)에 crew를 배포하는 단계별 시연은 이 영상 튜토리얼을 참고하세요.
CLI를 사용하여 [CrewAI AMP](http://app.crewai.com)에 crew를 배포하는 단계별 시연은 이 영상 튜토리얼을 참고하세요.
<iframe
className="w-full aspect-video rounded-xl"
@@ -354,18 +364,16 @@ CLI를 사용하여 [CrewAI AOP](http://app.crewai.com)에 crew를 배포하는
></iframe>
<CardGroup cols={2}>
<Card
title="Enterprise에 배포"
icon="rocket"
href="http://app.crewai.com"
>
CrewAI AOP로 시작하여 몇 번의 클릭만으로 production 환경에 crew를 배포하세요.
<Card title="Enterprise에 배포" icon="rocket" href="http://app.crewai.com">
CrewAI AOP로 시작하여 몇 번의 클릭만으로 production 환경에 crew를
배포하세요.
</Card>
<Card
title="커뮤니티 참여하기"
icon="comments"
href="https://community.crewai.com"
>
오픈 소스 커뮤니티에 참여하여 아이디어를 나누고, 프로젝트를 공유하며, 다른 CrewAI 개발자들과 소통하세요.
오픈 소스 커뮤니티에 참여하여 아이디어를 나누고, 프로젝트를 공유하며, 다른
CrewAI 개발자들과 소통하세요.
</Card>
</CardGroup>