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

* 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

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>