메인 콘텐츠로 건너뛰기

개요

에이전트가 Microsoft OneDrive에서 파일과 폴더를 업로드, 다운로드 및 관리할 수 있도록 합니다. AI 기반 자동화로 파일 작업을 자동화하고, 콘텐츠를 구성하고, 공유 링크를 생성하며, 클라우드 스토리지 워크플로를 간소화합니다.

전제 조건

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

Microsoft OneDrive 통합 설정

1. Microsoft 계정 연결

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

2. 필요한 패키지 설치

3. 환경 변수 설정

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

사용 가능한 작업

설명: OneDrive의 파일과 폴더를 나열합니다.매개변수:
  • top (integer, 선택사항): 검색할 항목 수 (최대 1000). 기본값: 50.
  • orderby (string, 선택사항): 필드별 정렬 (예: “name asc”, “lastModifiedDateTime desc”). 기본값: “name asc”.
  • filter (string, 선택사항): OData 필터 표현식.
설명: 특정 파일 또는 폴더에 대한 정보를 가져옵니다.매개변수:
  • item_id (string, 필수): 파일 또는 폴더의 ID.
설명: OneDrive에서 파일을 다운로드합니다.매개변수:
  • item_id (string, 필수): 다운로드할 파일의 ID.
설명: OneDrive에 파일을 업로드합니다.매개변수:
  • file_name (string, 필수): 업로드할 파일의 이름.
  • content (string, 필수): Base64로 인코딩된 파일 내용.
설명: OneDrive에 새 폴더를 만듭니다.매개변수:
  • folder_name (string, 필수): 만들 폴더의 이름.
설명: OneDrive에서 파일 또는 폴더를 삭제합니다.매개변수:
  • item_id (string, 필수): 삭제할 파일 또는 폴더의 ID.
설명: OneDrive에서 파일 또는 폴더를 복사합니다.매개변수:
  • item_id (string, 필수): 복사할 파일 또는 폴더의 ID.
  • parent_id (string, 선택사항): 대상 폴더의 ID (선택사항, 기본값은 루트).
  • new_name (string, 선택사항): 복사된 항목의 새 이름 (선택사항).
설명: OneDrive에서 파일 또는 폴더를 이동합니다.매개변수:
  • item_id (string, 필수): 이동할 파일 또는 폴더의 ID.
  • parent_id (string, 필수): 대상 폴더의 ID.
  • new_name (string, 선택사항): 항목의 새 이름 (선택사항).
설명: OneDrive에서 파일과 폴더를 검색합니다.매개변수:
  • query (string, 필수): 검색 쿼리 문자열.
  • top (integer, 선택사항): 반환할 결과 수 (최대 1000). 기본값: 50.
설명: 파일 또는 폴더의 공유 링크를 만듭니다.매개변수:
  • item_id (string, 필수): 공유할 파일 또는 폴더의 ID.
  • type (string, 선택사항): 공유 링크 유형. 옵션: view, edit, embed. 기본값: view.
  • scope (string, 선택사항): 공유 링크 범위. 옵션: anonymous, organization. 기본값: anonymous.
설명: 파일의 썸네일을 가져옵니다.매개변수:
  • item_id (string, 필수): 파일의 ID.
설명: 특정 OneDrive 경로의 파일과 폴더를 나열합니다.매개변수:
  • folder_path (string, 필수): 폴더 경로 (예: ‘Documents/Reports’).
  • top (integer, 선택사항): 검색할 항목 수 (최대 1000). 기본값: 50.
  • orderby (string, 선택사항): 필드별 정렬 (예: “name asc”, “lastModifiedDateTime desc”). 기본값: “name asc”.
설명: OneDrive에서 최근에 액세스한 파일을 가져옵니다.매개변수:
  • top (integer, 선택사항): 검색할 항목 수 (최대 200). 기본값: 25.
설명: 사용자와 공유된 파일과 폴더를 가져옵니다.매개변수:
  • top (integer, 선택사항): 검색할 항목 수 (최대 200). 기본값: 50.
  • orderby (string, 선택사항): 필드별 정렬. 기본값: “name asc”.
설명: 경로로 특정 파일 또는 폴더에 대한 정보를 가져옵니다.매개변수:
  • file_path (string, 필수): 파일 또는 폴더 경로 (예: ‘Documents/report.docx’).
설명: 경로로 OneDrive에서 파일을 다운로드합니다.매개변수:
  • file_path (string, 필수): 파일 경로 (예: ‘Documents/report.docx’).

사용 예제

기본 Microsoft OneDrive 에이전트 설정

파일 업로드 및 관리

파일 정리 및 공유

문제 해결

일반적인 문제

인증 오류
  • Microsoft 계정이 파일 액세스에 필요한 권한을 가지고 있는지 확인하세요 (예: Files.Read, Files.ReadWrite).
  • OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.
파일 업로드 문제
  • 파일 업로드 시 file_namecontent가 제공되는지 확인하세요.
  • 바이너리 파일의 경우 내용이 Base64로 인코딩되어야 합니다.
  • OneDrive에 대한 쓰기 권한이 있는지 확인하세요.
파일/폴더 ID 문제
  • 특정 파일 또는 폴더에 액세스할 때 항목 ID가 올바른지 다시 확인하세요.
  • 항목 ID는 list_files 또는 search_files와 같은 다른 작업에서 반환됩니다.
  • 참조하는 항목이 존재하고 액세스 가능한지 확인하세요.
검색 및 필터 작업
  • search_files 작업에 적절한 검색어를 사용하세요.
  • filter 매개변수의 경우 올바른 OData 문법을 사용하세요.
파일 작업 (복사/이동)
  • move_item의 경우 item_idparent_id가 모두 제공되는지 확인하세요.
  • copy_item의 경우 item_id만 필요합니다. parent_id는 지정하지 않으면 루트로 기본 설정됩니다.
  • 대상 폴더가 존재하고 액세스 가능한지 확인하세요.
공유 링크 생성
  • 공유 링크를 만들기 전에 항목이 존재하는지 확인하세요.
  • 공유 요구 사항에 따라 적절한 typescope를 선택하세요.
  • anonymous 범위는 로그인 없이 액세스를 허용합니다. organization은 조직 계정이 필요합니다.

도움 받기

도움이 필요하신가요?

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