Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Тестирование является важной частью процесса разработки декларативных агентов для Microsoft 365 Copilot. Вы можете использовать режим разработчика в Copilot Studio, чтобы проверить свой агент и проверить, выбирает ли оркестратор Copilot источники знаний для использования в ответ на заданные запросы, и если да, то каким образом.
Использование режима разработчика в Copilot
Чтобы включить режим разработчика в Copilot, введите -developer on. Чтобы отключить режим разработчика, введите -developer off.
Когда режим разработчика включен, карта с отладочной информацией возвращается всякий раз, когда оркестратор выполняет поиск конкретно в рамках ваших корпоративных знаний (данные), возможностей или навыков (действия или плагины) в вашем агенте для ответа на запрос. Карта сведений об отладке включает следующие поля.
- Метаданные агента: идентификаторы агента и беседы.
- Возможности: список возможностей, настроенных для агента.
-
Действия: список действий, настроенных для агента
- Сопоставленные функции: состояние функций, сопоставленных при поиске индекса приложения среды выполнения
- Выбранные функции для выполнения: статус функций, выбранных для вызова на основе рассуждений оркестратора
-
Выполнение: список выполненных возможностей и действий для запроса
- Выполненные возможности: состояние и статистика отклика для выполненных возможностей.
- Выполненные действия: состояние выполнения запроса и отклика для действий.
Раздел метаданных агента
Метаданные агента содержат основные сведения об агенте и текущем сеансе отладки, в том числе:
- Идентификатор агента — уникальный идентификатор агента, который включает идентификатор названия и идентификатор манифеста.
- Версия агента — номер версии агента, используемого в данный момент.
- ИД беседы — определяет активный сеанс чата или беседу.
- Идентификатор запроса — определяет конкретный запрос в беседе.
Примечание
Префикс в идентификаторе агента указывает способ распространения агента:
-
U_Указывает на агент области пользователя (неопубликованный). -
T_Указывает на агент области клиента (опубликован в магазине клиента или каталоге организации). -
P_Указывает на общедоступный агент.
Рекомендации по публикации см. в соответствующих статьях:
Возможности агента
В разделе «Возможности агента» отображаются настроенные возможности агента, определяющие области его доступных источников знаний.
Важно
Если в разделе "Возможности агента" указано, что веб-поиск включен, это означает только то, что агент включил эту возможность. Он не отражает Allow web search in Copilot параметр облачной политики, который администраторы могут использовать для отключения веб-поиска для своей организации. Подробнее см. в статье Управление сценариями Microsoft 365 Copilot в Центре администрирования Microsoft 365.
Действия агента
Действия агента отображают идентификатор действия и номер версии, настроенные функции для действия, а также статус их сопоставления и выбора.
Карточка без включенных действий
Если действия не включены, в разделе действий указано, что они не включены.
Карточка без сопоставленных функций
Если для указанного запроса не были возвращены соответствующие функции, это, скорее всего, указывает на то, что в запросе явно не было упоминание имя действия.
Сведения о выполнении
Разделы сведений о выполнении показывают, были ли выполнены настроенные возможности или действия для запроса, и если да, то какие именно, а также сведения о выполнении и состояние.
Сведения о выполнении возможности
Сведения о выполнении возможности отображают выполненную возможность и ее состояние. У каждой возможности могут быть разные сведения о выполнении, например использованный текст поиска, отклик возможности и/или количество возвращенных результатов.
Сведения о выполнении действия
Сведения о выполнении действия включают функцию и ее состояние, а также задержку, сведения о запросе (конечная точка запроса, метод HTTP, заголовки запроса) и отклик.
Карточка без выбранных функций для выполнения
Если ни одна из функций действия не соответствует поиску в запросе, на карте отладочной информации сообщается о том, что функции, выбранные для выполнения, отсутствуют. Скорее всего, это вызвано тем, что описание команды в манифесте семантически не связано с поисковым намерением данного запроса.
Если Copilot ранее сопоставлял и успешно выполнял ваши функции, это может быть признаком регулирования.
Карточка с пустым значением или сбоем Нет сведений о выполнении функции
Для плагинов расширений без сообщений при сбое или отсутствии сведений о выполнении функции это указывает на ошибку во время попытки агента назначить параметры выбранной функции плагина. Если сбой последовательный, скорее всего, это связано с неясными описаниями действий или параметров, неверными URL-адресами узлов или другими проблемами с определением Open API.
Для плагинов расширения сообщений рекомендуется оптимизировать ответы продолжительностью менее девяти секунд. Дополнительные сведения см. в технических требованиях для подключаемых модулей расширения сообщений.
В настоящее время максимальное время ожидания выполнения API плагина Copilot составляет 10 секунд.
Устранение неполадок
Ниже приведены распространенные сбои, которые могут возникать при отладке агента, и возможные причины этих сбоев.
Отсутствует отладочная карта
Если оркестратору не требуются ваши данные или навыки Microsoft 365 для ответа на запрос, карта сведений об отладке не возвращается.
Карты отладки также не возвращаются в случаях регулирования емкости, где обычно отображается сообщение об ошибке, чтобы повторить попытку позже.
Сообщение о проблеме
Сообщайте о любых отзывах или проблемах с вашим агентом, используя кнопку "Большой палец вверх" или "Большой палец вниз". Включите в отчет #extensibility тег.
Введите в текстовое поле сообщение, в том числе тег #extensibility.