메인 콘텐츠로 건너뛰기

​
개요

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

​
전제 조건

Microsoft SharePoint 통합을 사용하기 전에 다음 사항을 확인하세요:
  • 활성 구독이 있는 CrewAI AMP 계정
  • SharePoint 액세스 권한이 있는 Microsoft 계정
  • 통합 페이지를 통해 Microsoft 계정 연결

​
Microsoft SharePoint 통합 설정

​
1. Microsoft 계정 연결

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

​
2. 필요한 패키지 설치

uv add crewai-tools

​
3. 환경 변수 설정

Agent(apps=[])와 함께 통합을 사용하려면 Enterprise Token으로 CREWAI_PLATFORM_INTEGRATION_TOKEN 환경 변수를 설정해야 합니다.
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
또는 .env 파일에 추가하세요: 
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

​
사용 가능한 작업

설명: 사용자가 액세스할 수 있는 모든 SharePoint 사이트를 가져옵니다.매개변수:
  • search (string, 선택사항): 사이트를 필터링하기 위한 검색 쿼리.
  • select (string, 선택사항): 반환할 특정 속성 선택 (예: ‘displayName,id,webUrl’).
  • filter (string, 선택사항): OData 구문을 사용하여 결과 필터링.
  • expand (string, 선택사항): 관련 리소스를 인라인으로 확장.
  • top (integer, 선택사항): 반환할 항목 수 (최소 1, 최대 999).
  • skip (integer, 선택사항): 건너뛸 항목 수 (최소 0).
  • orderby (string, 선택사항): 지정된 속성으로 결과 정렬 (예: ‘displayName desc’).
설명: 특정 SharePoint 사이트에 대한 정보를 가져옵니다.매개변수:
  • site_id (string, 필수): SharePoint 사이트의 ID.
  • select (string, 선택사항): 반환할 특정 속성 선택 (예: ‘displayName,id,webUrl,drives’).
  • expand (string, 선택사항): 관련 리소스를 인라인으로 확장 (예: ‘drives,lists’).
설명: SharePoint 사이트의 모든 문서 라이브러리(드라이브)를 나열합니다. 파일 작업을 사용하기 전에 사용 가능한 라이브러리를 찾으려면 이 작업을 사용하세요.매개변수:
  • site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
  • top (integer, 선택사항): 페이지당 반환할 최대 드라이브 수 (1-999). 기본값: 100
  • skip_token (string, 선택사항): 다음 결과 페이지를 가져오기 위한 이전 응답의 페이지네이션 토큰.
  • select (string, 선택사항): 반환할 속성의 쉼표로 구분된 목록 (예: ‘id,name,webUrl,driveType’).
설명: SharePoint 사이트의 모든 목록을 가져옵니다.매개변수:
  • site_id (string, 필수): SharePoint 사이트의 ID.
설명: 특정 목록에 대한 정보를 가져옵니다.매개변수:
  • site_id (string, 필수): SharePoint 사이트의 ID.
  • list_id (string, 필수): 목록의 ID.
설명: SharePoint 목록에서 항목을 가져옵니다.매개변수:
  • site_id (string, 필수): SharePoint 사이트의 ID.
  • list_id (string, 필수): 목록의 ID.
  • expand (string, 선택사항): 관련 데이터 확장 (예: ‘fields’).
설명: SharePoint 목록에 새 항목을 만듭니다.매개변수:
  • site_id (string, 필수): SharePoint 사이트의 ID.
  • list_id (string, 필수): 목록의 ID.
  • fields (object, 필수): 새 항목의 필드 값.
설명: SharePoint 목록의 항목을 업데이트합니다.매개변수:
  • site_id (string, 필수): SharePoint 사이트의 ID.
  • list_id (string, 필수): 목록의 ID.
  • item_id (string, 필수): 업데이트할 항목의 ID.
  • fields (object, 필수): 업데이트할 필드 값.
설명: SharePoint 목록에서 항목을 삭제합니다.매개변수:
  • site_id (string, 필수): SharePoint 사이트의 ID.
  • list_id (string, 필수): 목록의 ID.
  • item_id (string, 필수): 삭제할 항목의 ID.
설명: SharePoint 문서 라이브러리에 파일을 업로드합니다.매개변수:
  • site_id (string, 필수): SharePoint 사이트의 ID.
  • file_path (string, 필수): 파일을 업로드할 경로 (예: ‘folder/fileName.txt’).
  • content (string, 필수): 업로드할 파일의 내용.
설명: 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’).
설명: SharePoint 문서 라이브러리에서 파일 또는 폴더를 삭제합니다. 폴더의 경우 모든 내용이 재귀적으로 삭제됩니다. 항목은 사이트 휴지통으로 이동됩니다.매개변수:
  • site_id (string, 필수): get_sites에서 가져온 전체 SharePoint 사이트 식별자.
  • drive_id (string, 필수): 문서 라이브러리의 ID. 먼저 get_drives를 호출하여 유효한 드라이브 ID를 가져오세요.
  • item_id (string, 필수): 삭제할 파일 또는 폴더의 고유 식별자. list_files에서 가져오세요.
설명: 경로로 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’).
설명: 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에서 가져오세요.
설명: 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’).
설명: 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’
설명: 키워드로 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’).
설명: 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, 선택사항): 복사본의 새 이름. 제공하지 않으면 원래 이름이 사용됩니다.
설명: 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, 선택사항): 이동된 항목의 새 이름. 제공하지 않으면 원래 이름이 유지됩니다.
설명: 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’로 탭 순서대로 반환).
설명: 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자. 사용할 수 없는 문자: \ / * ? : [ ]. 통합 문서 내에서 고유해야 합니다.
설명: 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’).
설명: 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을 사용하세요.
설명: 실제 셀 값 없이 워크시트에서 사용된 범위의 메타데이터(주소 및 크기)만 반환합니다. 대용량 파일에서 데이터를 청크로 읽기 전에 스프레드시트 크기를 파악하는 데 이상적입니다.매개변수:
  • 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에서 가져오세요. 대소문자를 구분합니다.
설명: 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’).
설명: 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’).
설명: 셀 범위를 필터링, 정렬 및 구조화된 데이터 기능이 있는 서식이 지정된 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
설명: 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에서 가져오세요.
설명: 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]).
설명: 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’).
설명: 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’
설명: 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에서 가져오세요.
설명: 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, 필수): 삭제할 워크시트의 이름. 대소문자를 구분합니다. 이 시트의 모든 데이터, 테이블 및 차트가 영구적으로 제거됩니다.
설명: 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에서 가져오세요. 테이블 삭제 후에도 셀의 데이터는 유지됩니다.
설명: 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에서 가져오세요.
설명: 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 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.