Microsoft 365 Copilot에서 개발자 모드를 사용하여 에이전트 테스트 및 디버그

테스트는 Microsoft 365 Copilot용 선언적 에이전트를 개발하는 프로세스의 중요한 부분입니다. Copilot Studio에서 개발자 모드를 사용하여 에이전트를 테스트하고 Copilot 오케스트레이터가 주어진 프롬프트에 대한 응답에 사용할 지식 원본을 선택하는지 여부와 방법을 확인할 수 있습니다.

Copilot에서 개발자 모드 사용

Copilot에서 개발자 모드를 사용하도록 설정하려면 다음을 입력합니다 -developer on. 개발자 모드를 사용하지 않도록 설정하려면 다음을 입력합니다 -developer off.

개발자 모드를 성공적으로 활성화하기 위해 사용자가 '-developer on'을 입력한 Microsoft 365 Copilot 세션의 스크린샷

개발자 모드가 활성화되어 있는 동안에는 오케스트레이터가 프롬프트에 응답하기 위해 에이전트 내 엔터프라이즈 지식(데이터), 기능 또는 기술(작업 또는 플러그인) 내에서 구체적으로 검색할 때마다 디버그 정보가 포함된 카드가 반환됩니다. 디버그 정보 카드에는 다음 필드가 포함되어 있습니다.

  • 에이전트 메타데이터: 에이전트 및 대화에 대한 식별자입니다.
  • 기능: 에이전트에 대해 구성된 기능 목록입니다.
  • 작업: 에이전트에 대해 구성된 작업 목록
    • 일치하는 함수: 런타임 앱 인덱스 조회에서 일치하는 함수의 상태
    • 실행을 위해 선택한 함수: 오케스트레이터 추론에 따라 호출을 위해 선택된 함수의 상태
  • 실행: 프롬프트에 대해 실행된 기능 및 작업의 목록
    • 실행된 기능: 실행된 기능에 대한 상태 및 응답 통계입니다.
    • 실행된 작업: 작업에 대한 요청 및 응답 실행 상태입니다.

에이전트 메타데이터 섹션

Copilot이 에이전트 메타데이터를 보여주는 디버깅 정보가 포함된 카드를 반환한 Microsoft 365 Copilot 세션의 스크린샷

에이전트 메타데이터는 다음을 포함하여 에이전트 및 현재 디버깅 세션에 대한 주요 세부 정보를 제공합니다.

  • 에이전트 ID - 타이틀 ID 및 매니페스트 ID를 포함하는 에이전트의 고유 식별자입니다.
  • 에이전트 버전 - 현재 사용 중인 에이전트의 버전 번호입니다.
  • 대화 ID - 활성 채팅 세션 또는 대화를 식별합니다.
  • 요청 ID - 대화 내에서 특정 프롬프트를 식별합니다.

참고

에이전트 ID의 접두사는 에이전트가 배포되는 방식을 나타냅니다.

  • U_ 사용자 범위(사이드로드) 에이전트를 나타냅니다.
  • T_ 테넌트 범위 에이전트(테넌트 저장소 또는 조직 카탈로그에 게시)를 나타냅니다.
  • P_ 공개적으로 사용 가능한 에이전트를 나타냅니다.

관련 퍼블리싱 지침은 다음을 참조하세요.

에이전트 기능

Copilot이 구성된 에이전트 기능을 보여 주는 디버깅 정보가 포함된 카드를 반환한 Microsoft 365 Copilot 세션의 스크린샷

에이전트 기능 섹션에는 에이전트에 대해 구성된 기능이 표시되어 액세스 가능한 지식 원본의 scope를 정의합니다.

중요

에이전트 기능 섹션에 WebSearch 가 활성화되었다고 표시되면 이는 에이전트가 해당 기능을 활성화했음을 의미할 뿐입니다. 관리자가 해당 organization에 대해 웹 검색을 사용하지 않도록 설정하는 데 사용할 수 있는 클라우드 정책 설정을 반영 Allow web search in Copilot 하지 않습니다. 자세한 내용은 Microsoft 365 관리 센터에서 Microsoft 365 Copilot 시나리오 관리를 참조하세요.

에이전트 작업

Copilot이 구성된 에이전트 작업을 보여 주는 디버깅 정보가 포함된 카드를 반환한 Microsoft 365 Copilot 세션의 스크린샷

에이전트 동작에는 동작 ID 및 버전 번호, 동작에 대해 구성된 함수, 일치 및 선택 상태가 표시됩니다.

사용하도록 설정된 작업이 없는 카드

사용하도록 설정된 작업이 없는 경우 작업 섹션에는 사용하도록 설정된 작업이 없다고 표시됩니다.

일치하는 함수가 없는 카드

지정된 프롬프트에 대해 일치하는 함수가 반환되지 않은 경우 프롬프트에서 작업 이름을 명시적으로 멘션하지 않았음을 나타낼 수 있습니다.

실행 세부 정보

실행된 세부 정보 섹션에는 프롬프트에 대해 실행되었는지 여부와 구성된 기능 또는 작업, 실행 세부 정보 및 상태가 표시됩니다.

기능 실행 세부 정보

Copilot이 실행된 기능을 보여주는 디버깅 정보가 있는 카드를 반환한 Microsoft 365 Copilot 세션의 스크린샷

기능 실행 세부 정보에는 실행된 기능과 해당 상태가 표시됩니다. 각 기능에는 사용된 검색 텍스트, 기능의 응답 및/또는 반환된 결과 수와 같은 실행 세부 정보가 다를 수 있습니다.

작업 실행 세부 정보

Copilot이 실행된 작업을 보여 주는 디버깅 정보가 포함된 카드를 반환한 Microsoft 365 Copilot 세션의 스크린샷

작업 실행 세부 정보에는 지연 시간, 요청 정보(요청 엔드포인트, HTTP 메서드, 요청 헤더) 및 응답과 함께 함수 및 해당 상태가 포함됩니다.

실행할 함수가 선택되지 않은 카드

프롬프트의 검색 의도와 일치하는 작업 함수가 없으면 디버그 정보 카드가 실행을 위해 선택된 함수가 없다고 보고합니다. 이는 매니페스트의 명령 설명이 지정된 프롬프트의 검색 의도와 의미상 관련이 없기 때문일 수 있습니다.

Copilot이 이전에 함수를 일치시키고 성공적으로 실행한 경우 이는 제한을 나타낼 수 있습니다.

비어 있거나 실패한 카드: 함수 실행 세부 정보 없음

메시지 확장 플러그 인이 아닌 경우 함수 실행 세부 정보가 실패했거나 없다면 에이전트가 플러그 인의 선택한 함수에 매개 변수를 할당하는 동안 실패했음을 나타냅니다. 오류가 계속 발생하면 불분명한 조치 또는 매개 변수 설명, 잘못된 호스트 URL 또는 Open API 정의의 기타 문제로 인한 것일 가능성이 큽니다.

메시지 확장 플러그 인의 경우 모범 사례는 9초 미만의 응답에 최적화하는 것입니다. 자세한 내용은 메시지 확장 플러그인에 대한 기술 요구 사항을 검토하세요.

현재 플러그 인 API의 Copilot 실행 제한 시간은 10초로 설정되어 있습니다.

오류 문제 해결

다음은 에이전트를 디버그할 때 발생할 수 있는 일반적인 오류와 오류의 가능한 원인입니다.

디버그 카드 없음

오케스트레이터가 프롬프트에 응답하기 위해 Microsoft 365 데이터 또는 기술이 필요하지 않은 경우 디버그 정보 카드가 반환되지 않습니다.

디버그 카드는 용량 스로틀링의 경우에도 반환되지 않으며, 일반적으로 나중에 다시 시도하라는 오류 메시지가 표시됩니다.

문제 보고

엄지손가락 위로 또는 엄지 손가락 아래로 단추를 사용하여 상담원에 대한 피드백이나 문제를 보고합니다. 보고서에 #extensibility 태그를 포함합니다.

Microsoft 365 Copilot 좋아요 또는 싫어요 피드백 옵션의 스크린샷

텍스트 상자에 #extensibility 태그를 포함하여 메시지를 입력합니다.

텍스트 상자의 Microsoft 365 Copilot 피드백 스크린샷