Microsoft SharePoint 통합

개요

에이전트가 SharePoint 사이트, 목록 및 문서 라이브러리에 액세스하고 관리할 수 있도록 합니다. AI 기반 자동화로 사이트 정보를 검색하고, 목록 항목을 관리하고, 파일을 업로드 및 구성하며, SharePoint 워크플로를 간소화합니다.

전제 조건

Microsoft SharePoint 통합을 사용하기 전에 다음 사항을 확인하세요:

활성 구독이 있는 CrewAI AMP 계정
SharePoint 액세스 권한이 있는 Microsoft 계정
통합 페이지를 통해 Microsoft 계정 연결

Microsoft SharePoint 통합 설정

1. Microsoft 계정 연결

CrewAI AMP 통합으로 이동
인증 통합 섹션에서 Microsoft SharePoint 찾기
연결을 클릭하고 OAuth 플로우 완료
SharePoint 사이트 및 파일 액세스에 필요한 권한 부여
통합 설정에서 Enterprise Token 복사

2. 필요한 패키지 설치

uv add crewai-tools

3. 환경 변수 설정

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

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

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

사용 가능한 작업

microsoft_sharepoint/get_sites

설명: 사용자가 액세스할 수 있는 모든 SharePoint 사이트를 가져옵니다.

매개변수:

search (string, 선택사항): 사이트를 필터링하기 위한 검색 쿼리.
select (string, 선택사항): 반환할 특정 속성 선택 (예: ‘displayName,id,webUrl’).
filter (string, 선택사항): OData 구문을 사용하여 결과 필터링.
expand (string, 선택사항): 관련 리소스를 인라인으로 확장.
top (integer, 선택사항): 반환할 항목 수 (최소 1, 최대 999).
skip (integer, 선택사항): 건너뛸 항목 수 (최소 0).
orderby (string, 선택사항): 지정된 속성으로 결과 정렬 (예: ‘displayName desc’).

microsoft_sharepoint/get_site

설명: 특정 SharePoint 사이트에 대한 정보를 가져옵니다.

매개변수:

site_id (string, 필수): SharePoint 사이트의 ID.
select (string, 선택사항): 반환할 특정 속성 선택 (예: ‘displayName,id,webUrl,drives’).
expand (string, 선택사항): 관련 리소스를 인라인으로 확장 (예: ‘drives,lists’).

microsoft_sharepoint/get_drives

설명: SharePoint 사이트의 모든 문서 라이브러리(드라이브)를 나열합니다. 파일 작업을 사용하기 전에 사용 가능한 라이브러리를 찾으려면 이 작업을 사용하세요.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
top (integer, 선택사항): 페이지당 반환할 최대 드라이브 수 (1-999). 기본값: 100
skip_token (string, 선택사항): 다음 결과 페이지를 가져오기 위한 이전 응답의 페이지네이션 토큰.
select (string, 선택사항): 반환할 속성의 쉼표로 구분된 목록 (예: ‘id,name,webUrl,driveType’).

microsoft_sharepoint/get_site_lists

설명: SharePoint 사이트의 모든 목록을 가져옵니다.

매개변수:

site_id (string, 필수): SharePoint 사이트의 ID.

microsoft_sharepoint/get_list

설명: 특정 목록에 대한 정보를 가져옵니다.

매개변수:

site_id (string, 필수): SharePoint 사이트의 ID.
list_id (string, 필수): 목록의 ID.

microsoft_sharepoint/get_list_items

설명: SharePoint 목록에서 항목을 가져옵니다.

매개변수:

site_id (string, 필수): SharePoint 사이트의 ID.
list_id (string, 필수): 목록의 ID.
expand (string, 선택사항): 관련 데이터 확장 (예: ‘fields’).

microsoft_sharepoint/create_list_item

설명: SharePoint 목록에 새 항목을 만듭니다.

매개변수:

site_id (string, 필수): SharePoint 사이트의 ID.
list_id (string, 필수): 목록의 ID.
fields (object, 필수): 새 항목의 필드 값.

microsoft_sharepoint/update_list_item

설명: SharePoint 목록의 항목을 업데이트합니다.

매개변수:

site_id (string, 필수): SharePoint 사이트의 ID.
list_id (string, 필수): 목록의 ID.
item_id (string, 필수): 업데이트할 항목의 ID.
fields (object, 필수): 업데이트할 필드 값.

microsoft_sharepoint/delete_list_item

설명: SharePoint 목록에서 항목을 삭제합니다.

매개변수:

site_id (string, 필수): SharePoint 사이트의 ID.
list_id (string, 필수): 목록의 ID.
item_id (string, 필수): 삭제할 항목의 ID.

microsoft_sharepoint/upload_file_to_library

설명: SharePoint 문서 라이브러리에 파일을 업로드합니다.

매개변수:

site_id (string, 필수): SharePoint 사이트의 ID.
file_path (string, 필수): 파일을 업로드할 경로 (예: ‘folder/fileName.txt’).
content (string, 필수): 업로드할 파일의 내용.

microsoft_sharepoint/list_files

설명: SharePoint 문서 라이브러리에서 파일과 폴더를 가져옵니다. 기본적으로 루트 폴더를 나열하지만 folder_id를 제공하여 하위 폴더로 이동할 수 있습니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
folder_id (string, 선택사항): 내용을 나열할 폴더의 ID. 루트 폴더의 경우 ‘root’를 사용하거나 이전 list_files 호출에서 가져온 폴더 ID를 제공하세요. 기본값: ‘root’
top (integer, 선택사항): 페이지당 반환할 최대 항목 수 (1-1000). 기본값: 50
skip_token (string, 선택사항): 다음 결과 페이지를 가져오기 위한 이전 응답의 페이지네이션 토큰.
orderby (string, 선택사항): 결과 정렬 순서 (예: ‘name asc’, ‘size desc’, ‘lastModifiedDateTime desc’). 기본값: ‘name asc’
filter (string, 선택사항): 결과를 좁히기 위한 OData 필터 (예: ‘file ne null’은 파일만, ‘folder ne null’은 폴더만).
select (string, 선택사항): 반환할 필드의 쉼표로 구분된 목록 (예: ‘id,name,size,folder,file,webUrl,lastModifiedDateTime’).

microsoft_sharepoint/delete_file

설명: SharePoint 문서 라이브러리에서 파일 또는 폴더를 삭제합니다. 폴더의 경우 모든 내용이 재귀적으로 삭제됩니다. 항목은 사이트 휴지통으로 이동됩니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): 삭제할 파일 또는 폴더의 고유 식별자. list_files에서 가져오세요.

microsoft_sharepoint/list_files_by_path

설명: 경로로 SharePoint 문서 라이브러리 폴더의 파일과 폴더를 나열합니다. 깊은 탐색을 위해 여러 list_files 호출보다 더 효율적입니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
folder_path (string, 필수): 앞뒤 슬래시 없이 폴더의 전체 경로 (예: ‘Documents’, ‘Reports/2024/Q1’).
top (integer, 선택사항): 페이지당 반환할 최대 항목 수 (1-1000). 기본값: 50
skip_token (string, 선택사항): 다음 결과 페이지를 가져오기 위한 이전 응답의 페이지네이션 토큰.
orderby (string, 선택사항): 결과 정렬 순서 (예: ‘name asc’, ‘size desc’). 기본값: ‘name asc’
select (string, 선택사항): 반환할 필드의 쉼표로 구분된 목록 (예: ‘id,name,size,folder,file,webUrl,lastModifiedDateTime’).

microsoft_sharepoint/download_file

설명: SharePoint 문서 라이브러리에서 원시 파일 내용을 다운로드합니다. 일반 텍스트 파일(.txt, .csv, .json)에만 사용하세요. Excel 파일의 경우 Excel 전용 작업을 사용하세요. Word 파일의 경우 get_word_document_content를 사용하세요.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): 다운로드할 파일의 고유 식별자. list_files 또는 list_files_by_path에서 가져오세요.

microsoft_sharepoint/get_file_info

설명: SharePoint 문서 라이브러리의 특정 파일 또는 폴더에 대한 자세한 메타데이터를 가져옵니다. 이름, 크기, 생성/수정 날짜 및 작성자 정보가 포함됩니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): 파일 또는 폴더의 고유 식별자. list_files 또는 list_files_by_path에서 가져오세요.
select (string, 선택사항): 반환할 속성의 쉼표로 구분된 목록 (예: ‘id,name,size,createdDateTime,lastModifiedDateTime,webUrl,createdBy,lastModifiedBy’).

microsoft_sharepoint/create_folder

설명: SharePoint 문서 라이브러리에 새 폴더를 만듭니다. 기본적으로 루트에 폴더를 만들며 하위 폴더를 만들려면 parent_id를 사용하세요.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
folder_name (string, 필수): 새 폴더의 이름. 사용할 수 없는 문자: \ / : * ? ” < > |
parent_id (string, 선택사항): 상위 폴더의 ID. 문서 라이브러리 루트의 경우 ‘root’를 사용하거나 list_files에서 가져온 폴더 ID를 제공하세요. 기본값: ‘root’

microsoft_sharepoint/search_files

설명: 키워드로 SharePoint 문서 라이브러리에서 파일과 폴더를 검색합니다. 파일 이름, 폴더 이름 및 Office 문서의 파일 내용을 검색합니다. 와일드카드나 특수 문자를 사용하지 마세요.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
query (string, 필수): 검색 키워드 (예: ‘report’, ‘budget 2024’). *.txt와 같은 와일드카드는 지원되지 않습니다.
top (integer, 선택사항): 페이지당 반환할 최대 결과 수 (1-1000). 기본값: 50
skip_token (string, 선택사항): 다음 결과 페이지를 가져오기 위한 이전 응답의 페이지네이션 토큰.
select (string, 선택사항): 반환할 필드의 쉼표로 구분된 목록 (예: ‘id,name,size,folder,file,webUrl,lastModifiedDateTime’).

microsoft_sharepoint/copy_file

설명: SharePoint 내에서 파일 또는 폴더를 새 위치로 복사합니다. 원본 항목은 변경되지 않습니다. 대용량 파일의 경우 복사 작업은 비동기적입니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): 복사할 파일 또는 폴더의 고유 식별자. list_files 또는 search_files에서 가져오세요.
destination_folder_id (string, 필수): 대상 폴더의 ID. 루트 폴더의 경우 ‘root’를 사용하거나 list_files에서 가져온 폴더 ID를 사용하세요.
new_name (string, 선택사항): 복사본의 새 이름. 제공하지 않으면 원래 이름이 사용됩니다.

microsoft_sharepoint/move_file

설명: SharePoint 내에서 파일 또는 폴더를 새 위치로 이동합니다. 항목은 원래 위치에서 제거됩니다. 폴더의 경우 모든 내용도 함께 이동됩니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): 이동할 파일 또는 폴더의 고유 식별자. list_files 또는 search_files에서 가져오세요.
destination_folder_id (string, 필수): 대상 폴더의 ID. 루트 폴더의 경우 ‘root’를 사용하거나 list_files에서 가져온 폴더 ID를 사용하세요.
new_name (string, 선택사항): 이동된 항목의 새 이름. 제공하지 않으면 원래 이름이 유지됩니다.

microsoft_sharepoint/get_excel_worksheets

설명: SharePoint 문서 라이브러리에 저장된 Excel 통합 문서의 모든 워크시트(탭)를 나열합니다. 반환된 워크시트 이름을 다른 Excel 작업에 사용하세요.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
select (string, 선택사항): 반환할 속성의 쉼표로 구분된 목록 (예: ‘id,name,position,visibility’).
filter (string, 선택사항): OData 필터 표현식 (예: “visibility eq ‘Visible‘“로 숨겨진 시트 제외).
top (integer, 선택사항): 반환할 최대 워크시트 수. 최소: 1, 최대: 999
orderby (string, 선택사항): 정렬 순서 (예: ‘position asc’로 탭 순서대로 반환).

microsoft_sharepoint/create_excel_worksheet

설명: SharePoint 문서 라이브러리에 저장된 Excel 통합 문서에 새 워크시트(탭)를 만듭니다. 새 시트는 탭 목록의 끝에 추가됩니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
name (string, 필수): 새 워크시트의 이름. 최대 31자. 사용할 수 없는 문자: \ / * ? : [ ]. 통합 문서 내에서 고유해야 합니다.

microsoft_sharepoint/get_excel_range_data

설명: SharePoint에 저장된 Excel 워크시트의 특정 범위에서 셀 값을 가져옵니다. 크기를 모르는 상태에서 모든 데이터를 읽으려면 대신 get_excel_used_range를 사용하세요.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 읽을 워크시트(탭)의 이름. get_excel_worksheets에서 가져오세요. 대소문자를 구분합니다.
range (string, 필수): A1 표기법의 셀 범위 (예: ‘A1:C10’, ‘A:C’, ‘1:5’, ‘A1’).
select (string, 선택사항): 반환할 속성의 쉼표로 구분된 목록 (예: ‘address,values,formulas,numberFormat,text’).

microsoft_sharepoint/update_excel_range_data

설명: SharePoint에 저장된 Excel 워크시트의 특정 범위에 값을 씁니다. 기존 셀 내용을 덮어씁니다. values 배열의 크기는 범위 크기와 정확히 일치해야 합니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 업데이트할 워크시트(탭)의 이름. get_excel_worksheets에서 가져오세요. 대소문자를 구분합니다.
range (string, 필수): 값을 쓸 A1 표기법의 셀 범위 (예: ‘A1:C3’은 3x3 블록).
values (array, 필수): 2D 값 배열 (셀을 포함하는 행). A1:B2의 예: [[“Header1”, “Header2”], [“Value1”, “Value2”]]. 셀을 지우려면 null을 사용하세요.

microsoft_sharepoint/get_excel_used_range_metadata

설명: 실제 셀 값 없이 워크시트에서 사용된 범위의 메타데이터(주소 및 크기)만 반환합니다. 대용량 파일에서 데이터를 청크로 읽기 전에 스프레드시트 크기를 파악하는 데 이상적입니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 읽을 워크시트(탭)의 이름. get_excel_worksheets에서 가져오세요. 대소문자를 구분합니다.

microsoft_sharepoint/get_excel_used_range

설명: SharePoint에 저장된 워크시트에서 데이터가 포함된 모든 셀을 가져옵니다. 2MB보다 큰 파일에는 사용하지 마세요. 대용량 파일의 경우 먼저 get_excel_used_range_metadata를 사용한 다음 get_excel_range_data로 작은 청크로 읽으세요.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 읽을 워크시트(탭)의 이름. get_excel_worksheets에서 가져오세요. 대소문자를 구분합니다.
select (string, 선택사항): 반환할 속성의 쉼표로 구분된 목록 (예: ‘address,values,formulas,numberFormat,text,rowCount,columnCount’).

microsoft_sharepoint/get_excel_cell

설명: SharePoint의 Excel 파일에서 행과 열 인덱스로 단일 셀의 값을 가져옵니다. 인덱스는 0 기반입니다 (행 0 = Excel 행 1, 열 0 = 열 A).

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 워크시트(탭)의 이름. get_excel_worksheets에서 가져오세요. 대소문자를 구분합니다.
row (integer, 필수): 0 기반 행 인덱스 (행 0 = Excel 행 1). 유효 범위: 0-1048575
column (integer, 필수): 0 기반 열 인덱스 (열 0 = A, 열 1 = B). 유효 범위: 0-16383
select (string, 선택사항): 반환할 속성의 쉼표로 구분된 목록 (예: ‘address,values,formulas,numberFormat,text’).

microsoft_sharepoint/add_excel_table

설명: 셀 범위를 필터링, 정렬 및 구조화된 데이터 기능이 있는 서식이 지정된 Excel 테이블로 변환합니다. 테이블을 만들면 add_excel_table_row로 데이터를 추가할 수 있습니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 데이터 범위가 포함된 워크시트의 이름. get_excel_worksheets에서 가져오세요.
range (string, 필수): 헤더와 데이터를 포함하여 테이블로 변환할 셀 범위 (예: ‘A1:D10’에서 A1:D1은 열 헤더).
has_headers (boolean, 선택사항): 첫 번째 행에 열 헤더가 포함되어 있으면 true로 설정. 기본값: true

microsoft_sharepoint/get_excel_tables

설명: SharePoint에 저장된 특정 Excel 워크시트의 모든 테이블을 나열합니다. id, name, showHeaders 및 showTotals를 포함한 테이블 속성을 반환합니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 테이블을 가져올 워크시트의 이름. get_excel_worksheets에서 가져오세요.

microsoft_sharepoint/add_excel_table_row

설명: SharePoint 파일의 Excel 테이블 끝에 새 행을 추가합니다. values 배열은 테이블의 열 수와 같은 수의 요소를 가져야 합니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 테이블이 포함된 워크시트의 이름. get_excel_worksheets에서 가져오세요.
table_name (string, 필수): 행을 추가할 테이블의 이름 (예: ‘Table1’). get_excel_tables에서 가져오세요. 대소문자를 구분합니다.
values (array, 필수): 새 행의 셀 값 배열로 테이블 순서대로 열당 하나씩 (예: [“John Doe”, “[email protected]”, 25]).

microsoft_sharepoint/get_excel_table_data

설명: SharePoint 파일의 Excel 테이블에서 모든 행을 데이터 범위로 가져옵니다. 정확한 범위를 알 필요가 없으므로 구조화된 테이블 작업 시 get_excel_range_data보다 쉽습니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 테이블이 포함된 워크시트의 이름. get_excel_worksheets에서 가져오세요.
table_name (string, 필수): 데이터를 가져올 테이블의 이름 (예: ‘Table1’). get_excel_tables에서 가져오세요. 대소문자를 구분합니다.
select (string, 선택사항): 반환할 속성의 쉼표로 구분된 목록 (예: ‘address,values,formulas,numberFormat,text’).

microsoft_sharepoint/create_excel_chart

설명: SharePoint에 저장된 Excel 워크시트에 데이터 범위에서 차트 시각화를 만듭니다. 차트는 워크시트에 포함됩니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 차트를 만들 워크시트의 이름. get_excel_worksheets에서 가져오세요.
chart_type (string, 필수): 차트 유형 (예: ‘ColumnClustered’, ‘ColumnStacked’, ‘Line’, ‘LineMarkers’, ‘Pie’, ‘Bar’, ‘BarClustered’, ‘Area’, ‘Scatter’, ‘Doughnut’).
source_data (string, 필수): 헤더를 포함한 A1 표기법의 차트 데이터 범위 (예: ‘A1:B10’).
series_by (string, 선택사항): 데이터 계열 구성 방법: ‘Auto’, ‘Columns’ 또는 ‘Rows’. 기본값: ‘Auto’

microsoft_sharepoint/list_excel_charts

설명: SharePoint에 저장된 Excel 워크시트에 포함된 모든 차트를 나열합니다. id, name, chartType, height, width 및 position을 포함한 차트 속성을 반환합니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 차트를 나열할 워크시트의 이름. get_excel_worksheets에서 가져오세요.

microsoft_sharepoint/delete_excel_worksheet

설명: SharePoint에 저장된 Excel 통합 문서에서 워크시트(탭)와 모든 내용을 영구적으로 제거합니다. 실행 취소할 수 없습니다. 통합 문서에는 최소 하나의 워크시트가 있어야 합니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 삭제할 워크시트의 이름. 대소문자를 구분합니다. 이 시트의 모든 데이터, 테이블 및 차트가 영구적으로 제거됩니다.

microsoft_sharepoint/delete_excel_table

설명: SharePoint의 Excel 워크시트에서 테이블을 제거합니다. 테이블 구조(필터링, 서식, 테이블 기능)는 삭제되지만 기본 셀 데이터는 보존됩니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.
worksheet_name (string, 필수): 테이블이 포함된 워크시트의 이름. get_excel_worksheets에서 가져오세요.
table_name (string, 필수): 삭제할 테이블의 이름 (예: ‘Table1’). get_excel_tables에서 가져오세요. 테이블 삭제 후에도 셀의 데이터는 유지됩니다.

microsoft_sharepoint/list_excel_names

설명: SharePoint에 저장된 Excel 통합 문서에 정의된 모든 명명된 범위를 가져옵니다. 명명된 범위는 셀 범위에 대한 사용자 정의 레이블입니다 (예: ‘SalesData’는 A1:D100을 가리킴).

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Excel 파일의 고유 식별자. list_files 또는 search_files에서 가져오세요.

microsoft_sharepoint/get_word_document_content

설명: SharePoint 문서 라이브러리에 저장된 Word 문서(.docx)에서 텍스트 내용을 다운로드하고 추출합니다. SharePoint에서 Word 문서를 읽는 권장 방법입니다.

매개변수:

site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
item_id (string, 필수): SharePoint에 있는 Word 문서(.docx)의 고유 식별자. list_files 또는 search_files에서 가져오세요.

사용 예제

기본 Microsoft SharePoint 에이전트 설정

from crewai import Agent, Task, Crew

# Microsoft SharePoint 기능을 가진 에이전트 생성
sharepoint_agent = Agent(
    role="SharePoint 관리자",
    goal="SharePoint 사이트, 목록 및 문서를 효율적으로 관리",
    backstory="Microsoft SharePoint 관리 및 콘텐츠 관리 전문 AI 어시스턴트.",
    apps=['microsoft_sharepoint']  # 모든 SharePoint 작업을 사용할 수 있습니다
)

# 모든 사이트 가져오기 작업
get_sites_task = Task(
    description="액세스할 수 있는 모든 SharePoint 사이트를 나열하세요.",
    agent=sharepoint_agent,
    expected_output="표시 이름과 URL이 포함된 SharePoint 사이트 목록."
)

# 작업 실행
crew = Crew(
    agents=[sharepoint_agent],
    tasks=[get_sites_task]
)

crew.kickoff()

문제 해결

일반적인 문제

인증 오류

Microsoft 계정이 SharePoint 액세스에 필요한 권한을 가지고 있는지 확인하세요 (예: Sites.Read.All, Sites.ReadWrite.All).
OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.

사이트/목록/항목 ID 문제

사이트, 목록, 항목 ID가 올바른지 다시 확인하세요.
참조된 리소스가 존재하고 액세스할 수 있는지 확인하세요.

도움 받기

도움이 필요하신가요?

Microsoft SharePoint 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.