Use o painel WebMCP no Chrome DevTools para inspecionar, depurar e testar as ferramentas de IA do lado do cliente que seu site expõe aos agentes de IA. O painel oferece visibilidade completa do ciclo de vida da ferramenta, incluindo registro, validação de esquema e histórico de invocações.
Abrir o painel do WebMCP
O painel WebMCP está localizado no painel Application. Para abrir, siga estas etapas:
- Abra o Chrome DevTools em uma página que usa ferramentas do WebMCP.
- Clique na guia Application.
- No nível superior da barra lateral, selecione o painel WebMCP.
Visão geral da interface
O painel WebMCP usa um layout de dois painéis para ajudar você a gerenciar e monitorar suas ferramentas:
- Invoked Tools:um registro cronológico de interações entre o agente de IA e a página.
- Available Tools:uma lista dinâmica de todas as ferramentas do WebMCP detectadas na guia ativa.
Ferramentas disponíveis
A seção Available tools mostra os nomes e descrições das ferramentas da maneira como aparecem para o agente de IA. Ela também inclui um contador de invocações para cada ferramenta, que mostra quantas vezes uma ferramenta foi chamada durante a sessão atual.
Ferramentas invocadas
O registro Invoked tools fornece um registro persistente de interações de ferramentas. Ao selecionar uma entrada no registro, você pode inspecionar os seguintes detalhes:
- Status:o resultado da invocação (concluída, cancelada, em andamento ou erro).
- Input:os parâmetros exatos que o agente previu e enviou para a ferramenta.
- Output:o valor de retorno ou a mensagem de erro fornecida pela ferramenta.
Filtrar o registro
Use a barra Filter para restringir a lista de ferramentas invocadas com base nos seguintes critérios:
- Name or description:insira o texto para encontrar ferramentas que correspondam a um nome ou finalidade específica.
- Status type: filtre as chamadas pelo estado atual, como Completed, Error, Cancelled ou In Progress.
- Tool type:selecione para filtrar ferramentas Declarative definidas em HTML e ferramentas Imperative definidas em JavaScript. Para ver todos os tipos de ferramentas, verifique se nenhum filtro está ativo.
Testar ferramentas manualmente
É possível ignorar a lógica de decisão do agente de IA para testar a confiabilidade da ferramenta de forma independente. Isso é útil para verificar a lógica da função sem aguardar um comando específico do agente.
- Na lista Available Tools, clique na ferramenta que você quer testar. Como alternativa, no registro Invoked Tools, passe o cursor sobre uma ferramenta para revelar o ícone Play (➜) e clique nele. A área de teste manual é aberta. Observação: se você selecionou a ferramenta na lista de ferramentas disponíveis, os parâmetros na área de teste manual estarão vazios. Caso contrário, se você selecionou uma ferramenta invocada, a área de teste manual será aberta com os parâmetros dessa sessão já preenchidos.
- Na área de teste manual, insira ou ajuste os parâmetros nos campos de entrada.
- Clique em Run tool.
Como solucionar problemas de integração
O painel WebMCP ajuda a diagnosticar falhas comuns de integração:
- Violações de esquema:o painel de saída mostra mensagens de erro se os parâmetros da ferramenta ou os valores de retorno não corresponderem ao esquema definido.
- Rejeição do agente:verifique o contador de invocações na lista Available Tools para saber se o agente já considerou sua ferramenta para um determinado comando.
Automação e agentes
O WebMCP foi projetado para a Web de agentes, em que os agentes de IA podem descobrir e interagir com as ferramentas do seu site. Para o desenvolvimento assistido por agentes, o Chrome DevTools for agents projeto oferece uma interface especializada que usa esse protocolo para ajudar os agentes de IA a testar e usar suas ferramentas do WebMCP.
Sinalizações de linha de comando
Algumas interfaces de agentes exigem que você ative a flag --categoryWebMCP explicitamente.
Recursos relacionados
Para saber mais sobre o WebMCP e a Web de agentes, consulte os seguintes recursos: