에이전트에 코드 인터프리터 기능 추가

팁

권장: 지원되는 프로 코드 선언적 에이전트 및 플러그인 시나리오에 대한 Work IQ Dev 도구 로 시작하십시오. WIQD 빠른 시작을 참조하세요. 도구 키트 기반 지침은 이를 필요로 하는 기존 프로젝트 및 워크플로에 계속 사용할 수 있습니다. 도구를 선택하기 전에 기능 및 대상 환경 지원을 확인하세요. WIQD는 사용자 지정 엔진 에이전트를 대상으로 하지 않습니다.

코드 인터프리터 기능을 추가하여 Microsoft 365 Copilot용 선언적 에이전트의 사용자 환경을 향상시킬 수 있습니다. 매니페스트 참조의 기능 요소 와 에이전트 작성기의 기능 섹션은 사용자의 기능을 잠금 해제할 수 있는 몇 가지 옵션을 제공합니다.

코드 인터프리터는 Python 코드를 통해 복잡한 작업을 해결하도록 설계된 고급 도구입니다. 추론 모델을 사용하여 코드를 작성하고 실행하므로 사용자는 복잡한 수학 문제를 해결하고, 데이터를 분석하고, 시각화를 생성하는 등의 작업을 수행할 수 있습니다. 코드가 실행되면 코드 인터프리터는 결과와 생성되는 관련 코드를 출력합니다. 또한 시나리오에 따라 다운로드 가능한 이미지나 파일을 생성할 수 있으며, 수정 및 분석을 위해 파일을 입력으로 허용합니다.

코드 인터프리터 기능은 Microsoft 365 Copilot 라이선스가 있는 사용자와 요금제 사용량이 활성화되지 않은 Copilot Chat 사용자가 사용할 수 있습니다.

참고

코드 인터프리터는 컨텍스트 내 에이전트에 대해 기본적으로 사용하도록 설정됩니다. 이 설정을 변경하려면 설정 아이콘을 선택하고 다음 스크린샷과 같이 필요에 따라 코드 인터프리터 설정을 업데이트합니다.

Microsoft 365 에이전트 도구 키트에서 코드 인터프리터 사용

에이전트 도구 키트 및 Visual Studio Code를 사용하여 에이전트를 만들고 코드 인터프리터를 활성화하려면 다음 예제와 같이 매니페스트 파일의 capabilities 속성에 값을 추가합니다CodeInterpreter.

참고

기능을 추가 CodeInterpreter 하려면 선언적 에이전트 매니페스트 스키마 버전 1.2 이상을 사용해야 합니다.

{
  "capabilities": [
    {
      "name": "CodeInterpreter"
    }
  ]
}

에이전트 작성기에서 코드 인터프리터 활성화

코드 인터프리터는 에이전트 작성기에서 항상 활성화되어 있습니다. 이 기능은 모든 에이전트에 대해 자동으로 포함됩니다.

코드 인터프리터 기능 예제

코드 인터프리터 기능은 추론 모델을 사용하여 선언적 에이전트가 샌드박스 환경에서 Python 코드를 작성하고 실행할 수 있도록 합니다. 이 기능을 통해 사용자는 복잡한 수학 문제를 해결하고, 데이터를 분석하고, 시각화를 생성하는 등의 작업을 수행할 수 있습니다. 코드가 실행되면 코드 인터프리터가 결과와 생성된 코드를 출력합니다. 또한 시나리오에 따라 다운로드 가능한 이미지 및 기타 파일을 생성할 수 있으며 수정 및 분석을 위해 파일을 입력으로 허용합니다.

코드 인터프리터는 다음과 같은 기능을 제공합니다.

Copilot은 이러한 작업을 실행할 때 생성되는 코드의 복사 및 다운로드 가능한 버전을 제공할 수도 있습니다.

그래프 및 차트 만들기

사용자는 코드 인터프리터가 활성화된 에이전트를 사용하여 그래프와 차트를 만들 수 있습니다. 예를 들어 Copilot은 피보나치 수열의 처음 20개 숫자를 그래프로 표시하라는 프롬프트에 대한 응답으로 다음과 같은 선 그래프를 생성합니다.

피보나치 수열의 처음 20개 숫자를 보여주는 선 그래프의 스크린샷

사용자가 단추를 </> Code 선택하면 에이전트가 해당 Python 코드를 제공합니다.

피보나치 수열의 처음 20개 숫자를 그래프로 나타낸 Python 코드의 스크린샷.

사용자는 데이터 파일을 업로드하여 그래프와 차트를 생성하여 데이터를 시각화할 수도 있습니다. 지원되는 파일 형식은 Word, Excel, PowerPoint, PDF, CSV/TSV 및 TXT/UTF8입니다. 예를 들어 사용자는 판매 데이터가 있는 Excel 파일을 업로드하고 프롬프트를 입력할 수 있습니다. 업로드 한 판매 데이터의 막대 차트와 선 그래프를 만듭니다. 에이전트는 다음 응답을 반환합니다.

샘플 판매 데이터의 막대형 차트

샘플 판매 데이터의 선 그래프

QR 코드 및 데이터 시각화 만들기

코드 인터프리터를 활성화하면 사용자는 QR 코드 및 단어 구름과 같은 다양한 데이터 시각화를 만들 수 있습니다. 예를 들어, Microsoft 회사 웹 사이트에 대한 QR 코드를 만드라는 사용자 프롬프트에 대한 응답으로 에이전트는 해당 URL과 일치하는 QR 코드를 모두 표시합니다.

Copilot에서 생성한 Microsoft용 QR 코드

단어 구름의 경우 다음 예와 같이 상위 애완동물 이름의 단어 구름 만들기 프롬프트는 가장 일반적인 이름이 포함된 이미지를 생성합니다.

사용자 프롬프트에 대한 Word Cloud 응답

합성 데이터 만들기

사용자에게 작업할 샘플 데이터가 필요한 경우 코드 인터프리터를 통합하면 다양한 목적을 위한 합성 데이터를 생성할 수 있습니다. 에이전트는 요청된 샘플 데이터를 생성한 다음 Word, Excel, PowerPoint 또는 PDF 파일로 출력할 수 있습니다. 사용자는 에이전트의 응답에서 생성된 파일을 직접 다운로드할 수 있습니다. 다음은 프롬프트 및 응답의 예입니다.

프롬프트:날짜, 금액, 가맹점 및 범주를 포함한 10개의 가짜 금융 거래 테이블을 만듭니다.

종합 금융 거래 표.

프롬프트:청구 문제에 대한 20개의 합성 고객 지원 채팅 기록을 생성합니다.

종합 고객 지원 채팅의 표입니다.

복잡한 수학 문제 풀기

에이전트에 코드 인터프리터를 추가하면 다음 예제와 같이 에이전트에게 복잡한 수학 문제를 풀라는 메시지를 표시할 수 있습니다.

프롬프트:함수( f(x) = x^3 - 4x^2 + 6x - 2 )에 대한 곡선 아래 면적의 적분을 ( x = 0 )에서 ( x = 3 )로 제공합니다.

곡선 아래 면적에 대한 적분 계산입니다.

업로드된 이미지 수정

코드 인터프리터를 통합하면 사용자가 업로드된 이미지를 수정할 수도 있습니다. 이 기능이 있는 에이전트는 이미지에 배너와 캡션을 추가하고 흑백 버전의 컬러 이미지를 생성할 수 있습니다. (다음 이미지는 Copilot에서 생성했습니다.)

Copilot이 생성한 1934년형 Bentley 4 자동차 이미지.

해당 이미지를 수정하기 위해 사용자는 첨부된 이미지의 흑백 버전을 제공하세요 프롬프트를 입력할 수 있습니다. "1934 Bentley 4"라는 배너와 "Copilot에서 생성한 이미지"라는 캡션을 추가합니다. 에이전트는 다음 결과를 제공합니다.

Copilot에서 수정한 1934년형 Bentley 4 자동차의 흑백 이미지입니다.

다운로드 가능한 파일 생성

코드 인터프리터는 다운로드 가능한 파일을 생성하고 호스트할 수 있으므로 에이전트가 에이전트가 생성하는 파일을 사용자가 다운로드하도록 허용할 수 있습니다. 코드 인터프리터가 출력 파일(예: 이미지, 차트, 스프레드시트 또는 문서)을 생성하면 Copilot은 응답에 다운로드 링크를 자동으로 표시합니다. 사용자는 링크를 선택하여 파일을 로컬에 저장할 수 있습니다.

이 기능은 많은 시나리오에서 유용합니다. 예를 들면 다음과 같습니다.

  • 데이터 내보내기: 계산된 데이터 또는 분석 결과의 Excel 스프레드시트를 생성하고 다운로드로 제공합니다.
  • 보고서: 결과를 요약하여 서식을 갖고 있는 PDF 또는 Word 문서를 만들고 다운로드할 수 있도록 합니다.
  • 생성된 시각적 개체: 차트, QR 코드 또는 단어 구름을 다운로드 가능한 이미지 파일로 생성합니다.
  • 처리된 파일: 업로드된 이미지 또는 문서에 수정 사항을 적용하고 결과를 다운로드 가능한 파일로 반환합니다.

다음 예제 프롬프트는 파일 생성 및 자동 다운로드 링크 생성을 트리거합니다.

프롬프트:숫자 1부터 10까지의 구구단이 있는 스프레드시트를 만들고 Excel 파일을 제공합니다.

에이전트는 Excel 파일을 생성하고 응답에 다운로드 링크를 제공합니다.

참고

코드 인터프리터에서 생성된 Files 일시적으로 호스트되며 활성 세션 중에만 다운로드할 수 있습니다. 세션이 종료된 후 Files 유지되지 않습니다.