선언적 에이전트는 Microsoft 365 Copilot을 확장하여 사용자 환경을 사용자 지정합니다. 선언적 에이전트를 빌드할 때 SharePoint 콘텐츠를 추가하고 파일을 지식 원본으로 업로드할 수 있습니다. 이 문서에서는 에이전트가 SharePoint 및 포함된 콘텐츠 기술 자료에서 데이터를 반환하는 방법을 최적화하기 위해 적용할 모범 사례를 설명합니다.
참고
SharePoint 데이터 및 포함된 파일에 기반한 에이전트는 Copilot Studio 측정을 사용하도록 설정한 테넌트의 사용자 또는 Microsoft 365 Copilot 라이선스가 있는 사용자만 사용할 수 있습니다. 자세한 내용은 Microsoft 365 Copilot 개발자 라이선스를 참조하세요.
관련 SharePoint 파일만 참조
URL 또는 ID로 에이전트 매니페스트의 개체를 통해 OneDriveAndSharePoint 특정 SharePoint 파일을 참조할 수 있습니다.
최대 20개의 파일을 지정하면 Copilot은 모든 파일의 전체 내용을 검색합니다. Copilot은 모든 파일 콘텐츠에 대한 모든 권한을 가지며 쿼리에 따라 적절한 콘텐츠를 사용자에게 반환합니다.
Copilot이 반환하는 콘텐츠를 최적화하려면 매니페스트에서 지정할 가장 관련성이 높은 SharePoint 파일을 선택합니다. 예를 들어 폴더에 8개의 파일이 포함되어 있고 5개만 사용자의 작업과 관련된 경우 폴더를 참조하는 대신 5개의 파일을 개별적으로 지정합니다. Copilot이 전체 파일 콘텐츠를 검색하도록 하려면 지정한 관련 파일의 총 페이지 수를 300페이지 이하로 제한하는 것이 가장 좋습니다.
SharePoint 파일 크기 제한
에이전트 매니페스트의 URL로 SharePoint 사이트 또는 폴더를 참조하고 사이트 또는 폴더에 포함된 파일이 큰 경우 Copilot이 사용자에게 반환할 올바른 콘텐츠를 식별하는 데 문제가 있을 수 있습니다. Copilot이 참조하는 사이트 또는 폴더에서 올바른 콘텐츠를 찾지 못할 위험을 줄이려면 SharePoint 파일을 최대 36,000자(약 15-20페이지)로 유지하세요. 파일이 36,000자를 초과하는 경우 Copilot이 전체 콘텐츠를 검사할 수 있도록 별도의 짧은 파일로 나누는 것이 좋습니다.
또는 ID로 특정 SharePoint 파일을 참조할 수 있습니다. 20개 이하의 파일을 지정하면 Copilot은 모든 파일의 전체 내용을 검색합니다. 20개 이상의 파일을 지정하면 관련성이 가장 높은 20개 파일의 전체 내용을 검색합니다.
특수 서식 제거
Copilot은 현재 SharePoint 콘텐츠에서 테이블 및 기타 특수 서식을 구문 분석할 수 없습니다. Copilot이 SharePoint 콘텐츠를 사용할 수 있도록 하려면 에이전트 매니페스트에서 참조하기 전에 콘텐츠에서 테이블 또는 기타 특수 서식을 제거합니다.
포함된 파일 콘텐츠 검색 최적화
포함된 파일 콘텐츠를 포함하는 에이전트의 경우 Copilot은 각 포함된 파일의 처음 750-1,000페이지(180만 문자)를 인덱싱합니다.
Copilot 검색을 위해 포함된 파일 콘텐츠를 최적화하려면 750-1,000페이지 이하의 파일을 업로드하세요. 자세한 내용은 Copilot에 제공하는 문서의 길이를 참조하세요.
Copilot 검색을 위해 Excel 콘텐츠를 최적화하려면 통합 문서 내의 한 시트에 모든 데이터를 저장합니다.