Использование режима разработчика в Microsoft 365 Copilot для тестирования и отладки агентов

Тестирование является важной частью процесса разработки декларативных агентов для Microsoft 365 Copilot. Вы можете использовать режим разработчика в Copilot Studio, чтобы проверить свой агент и проверить, выбирает ли оркестратор Copilot источники знаний для использования в ответ на заданные запросы, и если да, то каким образом.

Использование режима разработчика в Copilot

Чтобы включить режим разработчика в Copilot, введите -developer on. Чтобы отключить режим разработчика, введите -developer off.

Снимок экрана: сеанс Microsoft 365 Copilot, где пользователь вводит

Когда режим разработчика включен, карта с отладочной информацией возвращается всякий раз, когда оркестратор выполняет поиск конкретно в рамках ваших корпоративных знаний (данные), возможностей или навыков (действия или плагины) в вашем агенте для ответа на запрос. Карта сведений об отладке включает следующие поля.

  • Метаданные агента: идентификаторы агента и беседы.
  • Возможности: список возможностей, настроенных для агента.
  • Действия: список действий, настроенных для агента
    • Сопоставленные функции: состояние функций, сопоставленных при поиске индекса приложения среды выполнения
    • Выбранные функции для выполнения: статус функций, выбранных для вызова на основе рассуждений оркестратора
  • Выполнение: список выполненных возможностей и действий для запроса
    • Выполненные возможности: состояние и статистика отклика для выполненных возможностей.
    • Выполненные действия: состояние выполнения запроса и отклика для действий.

Раздел метаданных агента

Снимок экрана: сеанс Microsoft 365 Copilot, в котором Copilot вернул карт с отладочной информацией, показывающей метаданные агента

Метаданные агента содержат основные сведения об агенте и текущем сеансе отладки, в том числе:

  • Идентификатор агента — уникальный идентификатор агента, который включает идентификатор названия и идентификатор манифеста.
  • Версия агента — номер версии агента, используемого в данный момент.
  • ИД беседы — определяет активный сеанс чата или беседу.
  • Идентификатор запроса — определяет конкретный запрос в беседе.

Примечание

Префикс в идентификаторе агента указывает способ распространения агента:

  • U_ Указывает на агент области пользователя (неопубликованный).
  • T_ Указывает на агент области клиента (опубликован в магазине клиента или каталоге организации).
  • P_ Указывает на общедоступный агент.

Рекомендации по публикации см. в соответствующих статьях:

Возможности агента

Снимок экрана: сеанс Microsoft 365 Copilot, где Copilot вернул карт с отладочной информацией, показывающей возможности настроенного агента

В разделе «Возможности агента» отображаются настроенные возможности агента, определяющие области его доступных источников знаний.

Важно

Если в разделе "Возможности агента" указано, что веб-поиск включен, это означает только то, что агент включил эту возможность. Он не отражает Allow web search in Copilot параметр облачной политики, который администраторы могут использовать для отключения веб-поиска для своей организации. Подробнее см. в статье Управление сценариями Microsoft 365 Copilot в Центре администрирования Microsoft 365.

Действия агента

Снимок экрана: сеанс Microsoft 365 Copilot, в котором Copilot вернул карт с отладочной информацией, показывающей настроенные действия агента

Действия агента отображают идентификатор действия и номер версии, настроенные функции для действия, а также статус их сопоставления и выбора.

Карточка без включенных действий

Если действия не включены, в разделе действий указано, что они не включены.

Карточка без сопоставленных функций

Если для указанного запроса не были возвращены соответствующие функции, это, скорее всего, указывает на то, что в запросе явно не было упоминание имя действия.

Сведения о выполнении

Разделы сведений о выполнении показывают, были ли выполнены настроенные возможности или действия для запроса, и если да, то какие именно, а также сведения о выполнении и состояние.

Сведения о выполнении возможности

Снимок экрана: сеанс Microsoft 365 Copilot, в котором Copilot вернул карт с отладочной информацией, показывающей выполненные возможности

Сведения о выполнении возможности отображают выполненную возможность и ее состояние. У каждой возможности могут быть разные сведения о выполнении, например использованный текст поиска, отклик возможности и/или количество возвращенных результатов.

Сведения о выполнении действия

Снимок экрана: сеанс Microsoft 365 Copilot, где Copilot вернул карт с отладочной информацией, показывающей выполненные действия

Сведения о выполнении действия включают функцию и ее состояние, а также задержку, сведения о запросе (конечная точка запроса, метод HTTP, заголовки запроса) и отклик.

Карточка без выбранных функций для выполнения

Если ни одна из функций действия не соответствует поиску в запросе, на карте отладочной информации сообщается о том, что функции, выбранные для выполнения, отсутствуют. Скорее всего, это вызвано тем, что описание команды в манифесте семантически не связано с поисковым намерением данного запроса.

Если Copilot ранее сопоставлял и успешно выполнял ваши функции, это может быть признаком регулирования.

Карточка с пустым значением или сбоем Нет сведений о выполнении функции

Для плагинов расширений без сообщений при сбое или отсутствии сведений о выполнении функции это указывает на ошибку во время попытки агента назначить параметры выбранной функции плагина. Если сбой последовательный, скорее всего, это связано с неясными описаниями действий или параметров, неверными URL-адресами узлов или другими проблемами с определением Open API.

Для плагинов расширения сообщений рекомендуется оптимизировать ответы продолжительностью менее девяти секунд. Дополнительные сведения см. в технических требованиях для подключаемых модулей расширения сообщений.

В настоящее время максимальное время ожидания выполнения API плагина Copilot составляет 10 секунд.

Устранение неполадок

Ниже приведены распространенные сбои, которые могут возникать при отладке агента, и возможные причины этих сбоев.

Отсутствует отладочная карта

Если оркестратору не требуются ваши данные или навыки Microsoft 365 для ответа на запрос, карта сведений об отладке не возвращается.

Карты отладки также не возвращаются в случаях регулирования емкости, где обычно отображается сообщение об ошибке, чтобы повторить попытку позже.

Сообщение о проблеме

Сообщайте о любых отзывах или проблемах с вашим агентом, используя кнопку "Большой палец вверх" или "Большой палец вниз". Включите в отчет #extensibility тег.

Снимок экрана: параметры обратной связи с Microsoft 365 Copilot с большим пальцем вверх или большим пальцем вниз

Введите в текстовое поле сообщение, в том числе тег #extensibility.

Снимок экрана: отзывы о Microsoft 365 Copilot в текстовом поле