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 integral de extremo a extremo en el ciclo de vida de la herramienta, incluido el registro, la validación de esquemas y el historial de invocaciones.

Abre el panel de WebMCP

El panel WebMCP se encuentra en el 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 Application.
  3. En el nivel superior de la barra lateral, selecciona el panel WebMCP.
El panel Application de las Herramientas para desarrolladores con el panel WebMCP seleccionado en la barra lateral Application.

Descripción general de la interfaz

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

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

Herramientas disponibles

En la sección Available tools , 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 Available Tools muestra el contador de invocaciones con íconos de estado en los que se puede hacer clic para filtrar.

Herramientas invocadas

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

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

Filtra el registro

Usa la barra Filter para delimitar la lista de herramientas invocadas según los siguientes criterios:

  • Name or description: Ingresa texto para encontrar herramientas que coincidan con un nombre o propósito específico.
  • Status type: Filtra las llamadas por su estado actual, como Completed, Error, Cancelled o In Progress.
  • Tool type: Selecciona para filtrar las herramientas Declarative definidas en HTML y las herramientas Imperative 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 solicitud de agente específica.

  1. En la lista Available Tools, haz clic en la herramienta que quieres probar. De manera alternativa, en el registro Invoked Tools, coloca el cursor sobre una herramienta para revelar el ícono Play (➜) 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 Run tool.

Coloca el cursor sobre un elemento de la lista Invoked Tools para revelar el ícono Play y abrir el área de prueba manual completada previamente.

Soluciona problemas de integración

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

  • Violaciones de esquema: El panel de resultados muestra mensajes de error si los parámetros de la herramienta o los valores de retorno no coinciden con el esquema definido.
  • Rechazo del agente: Consulta el contador de invocaciones en la lista Available Tools para ver si el agente alguna vez consideró tu herramienta para una solicitud determinada.

Automatización y agentes

WebMCP está diseñado para la Web de agentes, en la que los agentes de IA pueden descubrir e interactuar con las herramientas de tu sitio. Para el desarrollo asistido por agentes, el Chrome DevTools for agents proyecto 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 de agentes, debes habilitar la marca --categoryWebMCP de forma explícita.

Recursos relacionados

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