Инструменты отладки WebMCP

Используйте панель WebMCP в инструментах разработчика Chrome для проверки, отладки и тестирования клиентских инструментов ИИ, которые ваш веб-сайт предоставляет агентам ИИ. Панель обеспечивает полную прозрачность жизненного цикла инструмента, включая регистрацию, проверку схемы и историю вызовов.

Откройте панель WebMCP.

Панель WebMCP находится в панели «Приложения» . Чтобы открыть её, выполните следующие действия:

  1. Откройте инструменты разработчика Chrome на странице, использующей инструменты WebMCP.
  2. Нажмите вкладку «Приложение» .
  3. В верхней части боковой панели выберите панель WebMCP .
Панель инструментов разработчика с выбранной панелью WebMCP на боковой панели приложений.
Панель инструментов разработчика с выбранной панелью WebMCP на боковой панели приложений.

Обзор интерфейса

Панель WebMCP использует двухпанельную компоновку, чтобы помочь вам управлять и отслеживать ваши инструменты:

  • Используемые инструменты: хронологический журнал взаимодействий между агентом ИИ и страницей.
  • Доступные инструменты: Список всех инструментов WebMCP, обнаруженных на активной вкладке, в режиме реального времени.

Доступные инструменты

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

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

Вызванные инструменты

Журнал запущенных инструментов представляет собой постоянную запись взаимодействий инструментов. При выборе записи в журнале можно просмотреть следующие сведения:

  • Статус: Результат выполнения вызова (Завершено, Отменено, В процессе или Ошибка).
  • Входные данные: Точные параметры, которые агент спрогнозировал и передал инструменту.
  • Вывод: Возвращаемое значение или сообщение об ошибке, предоставленное инструментом.

Отфильтруйте журнал

Используйте панель фильтров , чтобы сузить список вызываемых инструментов на основе следующих критериев:

  • Название или описание: Введите текст, чтобы найти инструменты, соответствующие определенному названию или назначению.
  • Тип статуса: Фильтрация вызовов по их текущему состоянию, например, «Завершено» , «Ошибка» , «Отменено» или «В процессе» .
  • Тип инструмента: выберите этот параметр для фильтрации декларативных инструментов, определенных в HTML, и императивных инструментов, определенных в JavaScript. Чтобы отобразить все типы инструментов, убедитесь, что ни один из фильтров не активен.

Тестирование инструментов вручную

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

  1. В списке доступных инструментов щелкните инструмент, который хотите протестировать. В качестве альтернативы, в журнале запущенных инструментов наведите курсор на инструмент, чтобы отобразилась иконка воспроизведения (➜), и щелкните по ней. Откроется область ручного тестирования. Примечание: Если вы выбрали инструмент из списка доступных инструментов, параметры в области ручного тестирования будут пустыми. В противном случае, если вы выбрали запущенный инструмент, откроется область ручного тестирования с уже заполненными параметрами из этой сессии.
  2. В области ручного тестирования введите или отрегулируйте параметры в полях ввода.
  3. Нажмите « Запустить инструмент» .
Наведите курсор на элемент в списке вызываемых инструментов, чтобы отобразить значок воспроизведения и открыть предварительно заполненную область ручного тестирования.
Наведите курсор на элемент в списке вызываемых инструментов, чтобы отобразить значок воспроизведения и открыть предварительно заполненную область ручного тестирования.

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

Панель WebMCP помогает диагностировать распространенные ошибки интеграции:

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

Автоматизация и агенты

WebMCP разработан для агентного веба, где агенты искусственного интеллекта могут обнаруживать инструменты вашего сайта и взаимодействовать с ними. Для разработки с помощью агентов проект Chrome DevTools for agents предоставляет специализированный интерфейс, использующий этот протокол, чтобы помочь агентам ИИ тестировать и использовать ваши инструменты WebMCP.

Флаги командной строки

Для некоторых интерфейсов агентов требуется явное включение флага --categoryWebMCP .

Связанные ресурсы

Чтобы узнать больше о WebMCP и агентной сети, ознакомьтесь со следующими ресурсами: