[이 문서는 시험판 문서이며 변경될 수 있습니다.]
Copilot Studio 에이전트는 코드 인터프리터를 사용하여 사용자 프롬프트에 응답해야 할 때 Python 코드를 생성하고 실행할 수 있습니다. 코드 인터프리터는 통계 분석, 테이블 조인, 예측 및 차트 생성과 같은 작업을 지원합니다. 이 작업들은 CSV, 엑셀 같은 구조화된 파일로 작동합니다.
중요합니다
이 문서에는 Microsoft Copilot Studio 미리 보기 설명서가 포함되어 있으며 변경될 수 있습니다.
미리 보기 기능은 프로덕션용이 아니며 기능이 제한되었을 수 있습니다. 이러한 기능은 공식 릴리스 이전에 제공되므로 사용자가 조기에 액세스하고 피드백을 제공할 수 있습니다.
프로덕션 준비 에이전트를 빌드하는 경우 Microsoft Copilot Studio 개요 참조하세요.
코드 인터프리터를 사용하여 구조화된 데이터 파일을 분석하는 가치 제안은 다음과 같습니다.
- 결정적이고 재현 가능한 계산을 사용하면 대용량 언어 모델의 고유 수학 및 유추 기능을 사용하여 분석 질문에 대답하는 대신 에이전트 내에서 신뢰할 수 있는 분석의 잠금을 해제할 수 있습니다.
- 사용자가 자연어로 분석 질문을 할 수 있도록 하여 고급 분석의 기술 장벽을 낮춥니다.
- 사용자가 보고 다운로드하며 재사용할 수 있는 결과의 표와 시각화를 프로그래밍적으로 생성하세요.
Copilot Studio 에이전트는 코드 인터프리터를 사용하여 다음 두 가지 방법으로 에이전트에 제공되는 구조적 파일을 분석할 수 있습니다.
- 최종 사용자로서 에이전트와 채팅하는 동안 구조화된 파일을 업로드할 때입니다.
- 제작자는 SharePoint 문서 라이브러리를 지식 소스로 추가할 때, 이는 구조화된 파일을 포함하고 있습니다.
요구 사항
라이선스: Microsoft Copilot Studio 청구 및 라이선스. 코드 생성 및 실행은 텍스트 및 생성형 AI 도구(프리미엄) 기능으로 계산됩니다.
지원되는 지역: 모든 퍼블릭 클라우드에 사용할 수 있습니다. 소버린 클라우드는 현재 지원되지 않습니다.
광범위하게 테스트된 시나리오
Microsoft는 높은 수준의 신뢰도로 다음 시나리오를 광범위하게 테스트했습니다.
비고
- 시나리오가 테이블에 나열된 시나리오에 속하지 않는 경우 여전히 작동할 수 있습니다. 아래 표에 나열된 시나리오는 예상 고객 사용에 따라 Microsoft에서 광범위하게 테스트한 시나리오 그룹을 반영합니다.
- 파일 형식에 관계없이 코드 인터프리터가 분석할 수 있는 각 파일의 크기 제한은 16MB입니다. 최대 10 파일을 업로드할 수 있습니다.
Excel(.xlsx) 파일에 대한 시나리오
| 카테고리 | 시나리오 설명 | 예제 1 | 예제 2 | 예제 3 |
|---|---|---|---|---|
| 조회 - 단일 시트 | Excel 파일의 단일 시트에서 특정 값, 레이블 또는 레코드를 검색합니다. 행 간 계산이 필요하지 않습니다. 정답은 직접 셀/행 조회로 존재합니다. 숫자 값, 텍스트 특성(이름, 역할, 범주) 및 타임스탬프를 다룹니다. | 최소 3골 이상의 측면 네트가 설치되어 있는 경기장은 무엇입니까? | 2024년 4분기 자유 현금 흐름은 얼마였나요? | 도매 연료는 2024년 1분기부터 어떤 세그먼트에 속합니까? |
.csv 파일에 대한 시나리오
| 카테고리 | 시나리오 설명 | 예제 1 | 예제 2 | 예제 3 |
|---|---|---|---|---|
| 조회 - 단일 파일 | 단일 CSV 파일에서 특정 값, 특성 또는 레코드를 검색합니다. 엔터티 조회(연락처, 공항, 풍력 프로젝트), 지정 시간 값 검색 및 작은 테이블 조회를 다룹니다. 행 간 집계가 필요하지 않습니다. | 선라이즈 윈드 프로젝트의 개발자는 누구인가요? | 1970년에 테네시에 등록된 오토바이는 몇 대인가요? | 누가 키네스 버그, CO에서 호스 슈 랜딩 공항을 소유? |
| 집계 - 단일 파일 | 단일 CSV 파일 내에서 합계, 개수, 차이, 그룹별 요약 또는 순위 조회를 계산합니다. 재무 집계, 조건부 수, 순위가 지정된 검색(최대/분) 및 숫자, 텍스트 또는 테이블로 반환된 그룹 수준 요약을 다룹니다. | 2019년 육상 석유 판매의 총 로열티 가치는 무엇이었습니까? | 2020년에 캘리포니아에 등록된 트럭은 2010년보다 몇 대 더 많았나요? | 2025년 1월 각 지역에서 창출된 총 판매 수익은 무엇인가요? |
| 조회 - 여러 파일 | 여러 CSV 파일을 조인하거나 상호 참조하여 특정 값 또는 목록을 검색합니다(예: 부품 목록, 인벤토리 및 가격표에서 부품 이름을 일치시켜 인벤토리를 조회하거나 섹터 이름을 주 배출 파일에 조인하여 배출 데이터를 쿼리). | 동부 창고에서 사용할 수 있는 워터 제트 커터는 몇 개입니까? | 10x24 선반의 교육 가격은 무엇인가요? | 동부 창고에 재고가 있는 3/8" 드릴 비트는 몇 개입니까? |
| 집계 - 여러 파일 | 여러 CSV 파일에 분산된 데이터를 집계하거나 비교합니다(예: 분기별 총액에 대한 월별 CSV의 직원 시간 합계, 연간 CSV 수출에 대한 거래 계산 또는 조인된 파일의 배출량별 섹터 순위 지정). | 3분기에 기록된 총 작업 시간은 몇 개인가요? | 크리스가 7월에 가장 일찍 출근한 시간은 언제였습니까? | 2020년에 가장 많은 CO2를 생산한 부문은 무엇입니까? |
사용자가 업로드한 구조화 데이터 파일 분석에는 코드 인터프리터를 사용하세요
Copilot Studio에서 Settings>Generative AI 선택합니다. 파일 처리 기능에서 파일 업로드 토글을 켭니다.
파일 처리 기능 항목에서 코드 인터프리터 토글을 켜세요.
저장을 선택합니다.
테스트 창에서 에이전트가 구조화된 데이터 파일의 데이터를 사용하여 계산을 수행해야 하는 쿼리를 작성합니다. 프롬프트에 데이터 파일을 첨부합니다.
코드 인터프리터를 사용하여 구조화된 데이터 파일을 SharePoint 지식 원본으로 분석
에이전트에 SharePoint 구조화된 데이터 파일이 기술 원본으로 아직 없는 경우 이 SharePoint 파일을 지식 원본으로 추가합니다.
Copilot Studio에서 Settings>Generative AI 선택합니다. 파일 처리 기능 항목에서 코드 인터프리터 토글을 켜세요.
검색 아래에서 의미 검색을 사용하는 테넌트 그래프 접지 토글을 켜세요.
저장을 선택합니다.
첫 번째 단계의 지침에 따라 SharePoint 파일을 추가한 경우 에이전트를 게시합니다.
에이전트가 대답하기 위해 계산을 수행해야 하는 쿼리를 제공하여 에이전트를 테스트합니다.