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

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

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

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

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

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

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

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

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

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

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

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

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

Карточка с включенными действиями

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

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

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

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

В разделах сведений о выполнении показано, выполнялись ли и какие из настроенных возможностей или действий для запроса, а также сведения о выполнении и состоянии.

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

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

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

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

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

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

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

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

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

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

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

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

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

Нет карта отладки

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

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

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

Сообщите о любых отзывах или проблемах с агентом с помощью кнопки вверх или вниз. Включите тег #extensibility в отчет.

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

Связанные материалы

• Создание агентов с помощью Copilot Studio
• Создание агентов с помощью Visual Studio Code
• Тестирование и отладка агентов в microsoft 365 Agents Toolkit