Depura herramientas de WebMCP

Usa el panel WebMCP en las Herramientas para desarrolladores de Chrome para inspeccionar, depurar y probar las herramientas de IA del cliente que tu sitio web expone a los agentes de IA. El panel proporciona visibilidad completa de extremo a extremo del ciclo de vida de la herramienta, incluido el registro, la validación del esquema y el historial de invocaciones.

Abre el panel WebMCP

El panel WebMCP se encuentra dentro del panel Application. Para abrirlo, sigue estos pasos:

  1. Abre las Herramientas para desarrolladores de Chrome en una página que use herramientas de WebMCP.
  2. Haz clic en la pestaña Aplicación.
  3. En el nivel superior de la barra lateral, selecciona el panel WebMCP.
El panel Aplicación de DevTools con el panel WebMCP seleccionado en la barra lateral de la aplicación.

Descripción general de la interfaz

El panel WebMCP usa un diseño de doble panel para ayudarte a administrar y supervisar tus herramientas:

  • Herramientas invocadas: Es un registro cronológico de las interacciones entre el agente de IA y la página.
  • Herramientas disponibles: Una lista en vivo de todas las herramientas de WebMCP detectadas en la pestaña activa.

Herramientas disponibles

En la sección Herramientas disponibles, se muestran los nombres y las descripciones de las herramientas tal como aparecen para el agente de IA. También incluye un contador de invocaciones para cada herramienta, que muestra cuántas veces se llamó a una herramienta durante la sesión actual.

La lista de herramientas disponibles muestra el contador de invocaciones con íconos de estado en los que se puede hacer clic para filtrar.

Herramientas invocadas

El registro Herramientas invocadas proporciona un registro persistente de las interacciones con las herramientas. Cuando seleccionas una entrada en el registro, puedes inspeccionar los siguientes detalles:

  • Estado: Es el resultado de la invocación (Completado, Cancelado, En curso o Error).
  • Entrada: Son los parámetros exactos que predijo el agente y que envió a la herramienta.
  • Salida: Es el valor de devolución o el mensaje de error que proporciona la herramienta.

Filtra el registro

Usa la barra de filtros para reducir la lista de herramientas invocadas según los siguientes criterios:

  • Nombre o descripción: Ingresa texto para encontrar herramientas que coincidan con un nombre o propósito específicos.
  • Tipo de estado: Filtra las llamadas por su estado actual, como Completada, Error, Cancelada o En curso.
  • Tipo de herramienta: Selecciona para filtrar las herramientas Declarativas definidas en HTML y las herramientas Imperativas definidas en JavaScript. Para ver todos los tipos de herramientas, asegúrate de que ninguno de los filtros esté activo.

Prueba las herramientas de forma manual

Puedes omitir la lógica de decisión del agente de IA para probar la confiabilidad de tu herramienta de forma independiente. Esto es útil para verificar la lógica de la función sin esperar una instrucción específica del agente.

  1. En la lista Available Tools, haz clic en la herramienta que deseas probar. Como alternativa, en el registro de Herramientas invocadas, coloca el cursor sobre una herramienta para que aparezca el ícono de Reproducir (➜) y haz clic en él. Se abrirá el área de prueba manual.

  2. En el área de prueba manual, ingresa o ajusta los parámetros en los campos de entrada.

  3. Haz clic en Ejecutar herramienta.

Coloca el cursor sobre un elemento de la lista Herramientas invocadas para mostrar el ícono de Play y abrir el área de prueba manual completada previamente.

Soluciona problemas de integración

El panel de WebMCP te ayuda a diagnosticar errores comunes de integración:

  • Infracciones del esquema: El panel de salida muestra mensajes de error si los parámetros o los valores de devolución de la herramienta no coinciden con el esquema definido.
  • Rechazo del agente: Consulta el contador de invocaciones en la lista de Herramientas disponibles para ver si el agente alguna vez consideró tu herramienta para una instrucción determinada.

Automatización y agentes

WebMCP está diseñado para la Web de agentes, en la que los agentes de IA pueden descubrir las herramientas de tu sitio y, luego, interactuar con ellas. Para el desarrollo asistido por agentes, el proyecto Chrome DevTools for agents proporciona una interfaz especializada que usa este protocolo para ayudar a los agentes de IA a probar y usar tus herramientas de WebMCP.

Marcas de línea de comandos

Para interactuar con ciertas interfaces basadas en agentes, debes habilitar la marca --categoryWebMCP de forma explícita.

Recursos relacionados

Para obtener más información sobre WebMCP y la Web agentiva, consulta los siguientes recursos: