Esegui il debug degli strumenti WebMCP con gli agenti AI

WebMCP è uno standard web proposto per consentire ai siti web di esporre la propria funzionalità come strumenti strutturati richiamati dagli agenti AI. Chrome DevTools per agenti consente al tuo agente di codifica di interagire direttamente con questi strumenti, aiutandoti ad analizzare e fornire suggerimenti su come preparare il tuo sito web per WebMCP.

Utilizzando DevTools per gli agenti, puoi verificare che la tua applicazione esponga correttamente gli strumenti WebMCP, testarne l'esecuzione e identificare le aree in cui gli agenti AI traggono vantaggio da funzionalità aggiuntive esposte sul tuo sito. WebMCP può essere implementato sul tuo sito web con l'aiuto delle competenze agentiche incluse in Modern Web Guidance.

Quando lavori con WebMCP, tieni presente quanto segue:

  • Flag sperimentale: la categoria WebMCP non è attiva per impostazione predefinita. Utilizza il flag --categoryExperimentalWebmcp. Per saperne di più sulla partecipazione, consulta la prova dell'origine WebMCP.
  • Requisiti del browser: questa funzionalità richiede Chrome 149 o versioni successive con le funzionalità WebMCP attive. Ciò significa che il sito web che stai testando è registrato nella prova dell'origine WebMCP oppure hai attivato manualmente il flag WebMCP corrispondente nel browser Chrome locale.
  • Distinzione del pubblico di destinazione: mentre il server MCP di DevTools è una funzionalità di debug destinata agli sviluppatori, gli strumenti WebMCP possono essere chiamati da qualsiasi persona che utilizza un agente browser per interagire con i siti web. Gli strumenti di sviluppo per gli agenti ti aiutano a creare e testare gli strumenti WebMCP rivolti agli utenti.

Casi d'uso per testare ed eseguire il debug degli strumenti WebMCP

Esistono diversi modi per utilizzare WebMCP. Ogni sito web è diverso, così come ogni insieme di strumenti WebMCP. Segui il nostro framework su come definire e creare strumenti utili per il tuo sito web o la tua applicazione web.

Ad esempio, se hai un sito web di un'agenzia di viaggi con strumenti per aiutare l'agente di un utente a completare le azioni pertinenti, ecco alcuni prompt di esempio che puoi utilizzare con DevTools per gli agenti per verificare che i tuoi strumenti funzionino come previsto.

Chiedi all'agente di elencare ed eseguire gli strumenti WebMCP per semplificare i test e lo sviluppo.

Nota:i passaggi di esecuzione dell'agente sono esempi di potenziale comportamento. Poiché esistono molti tipi diversi di agenti e gli agenti non sono deterministici, puoi visualizzare risultati diversi.

Verificare l'esposizione dello strumento WebMCP

Quando aggiungi il supporto di WebMCP al tuo sito, puoi chiedere al tuo agente di codifica di verificare che i tuoi strumenti siano esposti correttamente al browser e che i loro schemi di input siano ben definiti.

Prompt di esempio:

Implement a 'book_flight' WebMCP tool to this page to help agents book flights. Verify that it's correctly registered and ready for AI agents to use.

Esecuzione dell'agente di esempio:il tuo agente rileva la necessità di ispezionare gli strumenti esposti e richiama autonomamente lo strumento list_webmcp_tools. Analizza l'output, conferma se lo strumento è stato registrato correttamente e verifica che lo schema sia ben formato.

Eseguire il debug dell'esecuzione dello strumento WebMCP

Verifica che la logica interna dello strumento WebMCP funzioni come previsto quando viene chiamato da un'AI con input specifici. Puoi chiedere all'agente di eseguire lo strumento e monitorare la risposta dell'applicazione.

Prompt di esempio:

Try using the 'add_to_cart' tool on this page to add product 12345. Let me know if it succeeds or if the application throws any errors.

Esecuzione dell'agente di esempio:l'agente riconosce l'intenzione di testare un'azione specifica. Determina autonomamente lo schema di input corretto, utilizza execute_webmcp_tool per l'esecuzione e monitora la risposta dell'applicazione (incluso il controllo dei log della console) per comunicare lo stato di riuscita o eseguire il debug di eventuali errori.

Risolvere i problemi relativi alla chiarezza dello schema

Quando un agente AI non riesce ripetutamente a chiamare correttamente uno strumento WebMCP, spesso il problema è dovuto a uno schema JSON ambiguo. Puoi chiedere all'agente di esaminare lo schema dal punto di vista di un LLM e suggerire miglioramenti.

Prompt di esempio:

My 'schedule_meeting' tool is failing to parse the various date formats sent by different AI agents. Can you review the tool's schema and suggest how I can improve the descriptions or constraints so agents know exactly which format is required?

Esecuzione dell'agente di esempio: l'agente recupera gli strumenti WebMCP esposti e analizza inputSchema per "schedule_meeting". Rileva che il parametro data non ha una descrizione chiara o un vincolo di formato e suggerisce uno schema JSON corretto (ad esempio, aggiungendo una descrizione come "Date in YYYY-MM-DD format") da implementare nel codice.