Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Тестирование является важной частью процесса разработки декларативных агентов для Microsoft 365 Copilot Chat. Вы можете использовать режим разработчика при тестировании агента, чтобы проверить, выбирает ли оркестратор Copilot источники знаний для использования в ответ на заданные запросы.
Кроме того, вы можете использовать функцию предварительного просмотра приложения (F5) в наборе средств агентов Microsoft 365 для тестирования агентов в локальной среде разработки. Эта функция предоставляет интерактивный способ проверки поведения и устранения неполадок непосредственно из интерфейса разработки.
Использование режима разработчика в наборе средств Copilot Chat и агентов
Вы можете протестировать агент из набора средств агентов в Visual Studio Code, выбрав Предварительный просмотр приложения (F5) в области Набор средств агентов. При этом агент запускается в браузере Copilot Chat интерфейсе, что позволяет быстро проверить его поведение в ответ на запросы.
Выбрав агент в Microsoft 365 Copilot Chat, включите режим разработчика, введя -developer on. Чтобы отключить режим разработчика, введите -developer off.
Хотя режим разработчика включен, карта с отладочными данными возвращается каждый раз, когда оркестратор выполняет поиск в пределах корпоративных знаний (данных), возможностей или навыков (действий или подключаемых модулей) в агенте. В наборе средств агента эти сведения об отладке отображаются на панели Отладка и включают следующие поля:
- Метаданные агента: идентификаторы агента и беседы
- Возможности: список возможностей, настроенных для агента, а также их состояние выполнения и статистика ответов (при выполнении).
-
Действия: список действий, настроенных для агента.
- Совпадаемые функции: состояние функций, сопоставленных в подстановке индекса приложения среды выполнения.
- Выбранные функции для выполнения: состояние функций, выбранных для вызова на основе аргументации оркестратора
Раздел метаданных агента
Метаданные агента содержат основные сведения об агенте и текущем сеансе отладки, включая:
- Сводка . Общие сведения о настроенных источниках знаний и статистике их использования
- Идентификатор агента — уникальный идентификатор агента, включающий идентификатор заголовка и идентификатор манифеста.
- Версия агента — номер версии используемого в данный момент агента.
- Идентификатор беседы — идентификатор активного сеанса чата или беседы.
- Идентификатор запроса — идентификатор конкретного запроса в беседе
Возможности агента
В разделе возможности агента отображаются настроенные возможности агента, определяющие область его доступных источников знаний. Ниже приведены сведения о каждой возможности, используемой в запросе.
- Состояние выполнения — указывает, использовалась ли возможность во время оркестрации.
- Файл журнала диагностики — скачиваемый .txt файл, содержащий подробные результаты выполнения, включая сообщения об успешном или неудачном выполнении, которые могут помочь в устранении неполадок и проверке.
Действия агента
В разделе Действия агента содержатся подробные сведения о том, как обрабатываются действия агента (функции или подключаемые модули) во время оркестрации. Эта информация разбита на три ключевые области: метаданные действия, сопоставление и выбор функций, а также сведения о выполнении.
Метаданные действия
В этом разделе отображаются общие сведения о действиях, зарегистрированных для агента. Эти сведения включают идентификатор действия (уникальный идентификатор действия) и номер версии (версия используемого определения действия).
Сопоставление и выбор функций
В этой части показано, как оркестратор интерпретировал запрос пользователя и считались ли какие-либо функции релевантными для выполнения:
Совпадающие функции — функции, которые семантически соответствуют запросу пользователя во время поиска индекса приложения среды выполнения. Если для данного запроса не были возвращены соответствующие функции, скорее всего, запрос явно не упоминание имя действия.
Выбранные функции для выполнения — функции, выбранные для вызова на основе аргументации оркестратора и релевантности запроса. Если действия не включены, в разделе действий указано, что действия не включены.
Сведения о выполнении
Сведения о выполнении действия включают функцию и ее состояние, а также задержку, сведения о запросе (конечная точка запроса, метод HTTP, заголовки запросов) и ответ.
Устранение неполадок
Ниже приведены распространенные сбои, которые могут возникнуть при отладке агента, и возможные причины сбоев.
Нет сведений об отладке
После запуска агента проверка, что подключение к браузеру помечено как успешное на панели отладки. Если это не так, попробуйте запустить F5 еще раз в Visual Studio Code, чтобы начать новый сеанс.
Если подключение прошло успешно, но сведения об отладке не отображаются, возможно, оркестратору не требуются данные или навыки Microsoft 365 для реагирования. В этом случае сведения об отладке карта не возвращаются.
Сведения об отладке также не возвращаются в случаях регулирования емкости, когда обычно отображается сообщение об ошибке, чтобы повторить попытку позже.
Сведения об отладке с отсутствием функций, выбранных для выполнения
Если никакая функция действия не соответствовала намерению поиска в запросе, сведения об отладке карта сообщает об отсутствии выбранных для выполнения функций. Причина, скорее всего, в том, что описание команды в манифесте не семантически связано с намерением поиска в заданной строке.
Если Copilot ранее совпадал и успешно выполнял функции, запросы могут быть отрегулированы.
Сведения об отладке с пустыми или неудачными сведениями о выполнении функции
Если для подключаемых модулей API произошел сбой или нет сведений о выполнении функции, это указывает на сбой во время попытки агента назначить параметры выбранной функции подключаемого модуля. Если ошибка согласована, скорее всего, это связано с неясными описаниями действий или параметров, недопустимыми URL-адресами узла или другими проблемами с определением Открытого API.
Для подключаемых модулей расширения сообщений рекомендуется оптимизировать ответы до девяти секунд. Дополнительные сведения см. в технических требованиях к подключаемым модулям расширения сообщений.
В настоящее время ограничение времени ожидания для выполнения Api подключаемого модуля Copilot устанавливается в 10 секунд.
Сообщение о проблеме
Сообщите о любых отзывах или проблемах с агентом с помощью кнопки вверх или вниз.
#extensibility Включите тег в отчет.
