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

Совет

Рекомендуется: Начните с Work IQ Dev Tools для поддерживаемых сценариев декларативного агента и плагинов для кода. См. краткое руководство по WIQD. Инструкции на основе набора средств остаются доступными для существующих проектов и рабочих процессов, для которых они требуются. Перед выбором инструмента проверьте поддержку возможностей и целевого интерфейса : WIQD не нацелен на агентов пользовательской подсистемы.

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

Кроме того, вы можете использовать функцию предварительного просмотра приложения (F5) в наборе средств агентов Microsoft 365 для тестирования агентов в локальной среде разработки. Эта функция предоставляет интерактивный способ проверки поведения и устранения проблем непосредственно из интерфейса разработки.

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

Вы можете протестировать агент из набора средств агентов в Visual Studio Code, выбрав "Предварительный просмотр приложения" (F5) в области набора средств агентов. При этом агент откроется в браузере Copilot Chat, что позволит быстро проверить, как он работает в ответ на запросы.

Снимок экрана: Visual Studio Code с функцией

Выбрав агент в Microsoft 365 Copilot Chat, включите режим разработчика, введя -developer on. Чтобы отключить режим разработчика, введите -developer off.

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

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

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

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

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

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

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

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

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

  • Состояние выполнения — указывает, использовалась ли возможность во время оркестрации.
  • Файл журнала диагностики — загружаемый файл .txt, содержащий подробные результаты выполнения, включая сообщения об успехе или сбое, который может помочь в устранении неполадок и проверке

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

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

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

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

Метаданные действия

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

Сопоставление и выделение функций

В этой части показано, как оркестратор интерпретировал запрос пользователя и были ли какие-либо функции сочтены релевантными для выполнения:

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

  • Выбранные функции для выполнения — функции, выбранные для вызова на основе рассуждений оркестратора и релевантности запросу. Если действия не включены, в разделе действий указано, что они не включены.

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

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

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

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

Нет сведений об отладке

После запуска агента проверка, что подключение к браузеру отмечено как успешное на панели отладки. Если это не так, попробуйте снова запустить клавишу F5 в Visual Studio Code, чтобы начать новый сеанс.

Снимок экрана: сеанс набора средств агента, в котором успешно выполнено подключение к веб-браузеру

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

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

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

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

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

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

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

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

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

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

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

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