Accesso degli agenti IA

Le pagine offrono i propri strumenti agli agenti IA nel browser tramite WebMCP, una proposta di standard web che alcuni browser offrono in prova: un agente può compilare uno strumento e leggere il risultato, e tu lo vedi accadere sulla pagina.

Gli assistenti senza browser possono leggere le pagine e indirizzare le persone allo strumento che risponde alla loro domanda. Ogni pagina mostra lo stesso contenuto alle persone e alle macchine.

Per modelli linguistici e agenti, in inglese: una panoramica in /llms.txt, la spiegazione e le domande frequenti di ogni strumento in /llms-full.txt, il catalogo in /catalog.json e le definizioni degli strumenti per agenti in /agent-tools.json. Le altre lingue hanno gli stessi file sotto il proprio percorso di lingua, per esempio /fi/llms.txt.

Uno strumento ritirato o sostituito conserva un avviso al proprio indirizzo, con un link all’eventuale successore, e non può più essere eseguito. Uno strumento temporaneamente indisponibile mostra un avviso ed è escluso dal catalogo fino al suo ritorno.

La guida per gli agenti contiene gli endpoint, esempi di richieste e i codici di errore in inglese.

Gli agenti senza browser possono connettersi a https://how.box/mcp tramite Streamable HTTP, senza autenticarsi. Il server è senza stato: non conserva sessioni tra una chiamata e l’altra. L’API del sito resta privata; /mcp è l’unica interfaccia pubblica per gli agenti.

• Cinque strumenti di catalogo: catalog_search_utilities, catalog_list_facets, catalog_get_utility, catalog_describe_tool e catalog_run_tool. Cercano e descrivono gli strumenti ed eseguono calcoli in sola lettura, anche quelli che usano i nostri tassi di cambio di riferimento in cache, come le conversioni di valuta. Nessuna verifica di rete né strumenti che richiedono il browser. Ogni risposta include un link alla pagina dello strumento.
• Limiti: 60 richieste al minuto per client; ogni istanza del server accetta 20 richieste al secondo e 8 chiamate contemporanee. Ogni chiamata ha un limite di 5 secondi e la richiesta non può superare 64 KiB. Le richieste che superano un limite vengono rifiutate.
• I dati inseriti e i risultati non vengono mai registrati nei log né conservati. I log delle chiamate contengono il metodo, il nome dello strumento di catalogo, l’esito, la durata e la versione del protocollo; per le consultazioni dei tassi si registrano anche l’azione, lo stato della risposta e la durata.

Gli agenti sono trattati esattamente come le persone: non viene archiviato nulla su di loro o sui loro utenti e si applicano gli stessi limiti di utilizzo.

Quando usi i nostri risultati, inserisci un link alla pagina dello strumento che hai usato, così le persone possono verificare la risposta e modificare i dati inseriti.

Da ogni pagina un agente può cercare nel catalogo (per categoria, tag e paese), elencarne categorie, tag e paesi, aprire uno strumento o eseguire il calcolo di qualsiasi strumento dalla pagina corrente.

La maggior parte degli strumenti funziona interamente nel browser e non ha limiti. I pochi che usano il nostro server hanno i limiti indicati sotto, uguali per persone e agenti. Un visitatore viene riconosciuto solo tramite un codice che cambia ogni giorno; non viene archiviato nulla su di te. Una richiesta che supera un limite, o che arriva mentre il server è occupato, viene rifiutata indicando quando puoi riprovare.

«Verifica di nuovo ora» richiede una nuova verifica invece di una risposta salvata di recente. Tra nuove verifiche dello stesso indirizzo c’è una breve attesa, indicata sotto; durante l’attesa ricevi la risposta più recente con la sua età oppure l’invito a riprovare più tardi.

Il nostro robots.txt indica ai crawler cosa possono leggere. Non cambia mai il contenuto di una pagina: tutti ricevono le stesse pagine. I motori di ricerca tradizionali possono sempre esplorare il sito.

Regola in uso: open (robots.txt)