Un agente che risponde a una domanda su API può aver bisogno di una guida all'autenticazione e di un riferimento a un endpoint. Caricare un intero sito web porta con sé anche materiale non pertinente a quell'attività.
La proposta llms.txt offre ai publisher un punto in cui descrivere i propri contenuti e collegare pagine Markdown utili.
Cosa contiene il file?
Il file contiene un nome di progetto e può includere un riepilogo, indicazioni e link raggruppati verso ulteriori informazioni.
La proposta usa Markdown affinché persone e programmi possano elaborare lo stesso file. Le sue liste di link puntano a contenuti che l'agente può recuperare al bisogno.
Un indice di documentazione potrebbe raggruppare autenticazione, invio di messaggi ed eventi di consegna sotto intestazioni separate. Brevi descrizioni aiutano l'agente a distinguere quelle destinazioni prima di scaricarle.
La proposta consente anche indici al di sotto della radice del sito. Un indice sotto un percorso di documentazione copre il contenuto sottostante.
È la stessa cosa di robots.txt o di una sitemap?
Questi file hanno scopi diversi: regole di accesso, scoperta di URL e un percorso curato verso i contenuti.
| File | Scopo |
|---|---|
robots.txt | Fornisce ai client automatizzati regole di crawling |
| Sitemap | Elenca URL da far scoprire ai motori di ricerca |
llms.txt | Descrive i contenuti e linka dettagli utili per gli agenti |
Il confronto della proposta con gli standard esistenti descrive llms.txt come complementare agli altri file. Pubblicarlo non concede accesso a contenuti protetti.
Non espone nemmeno un'azione eseguibile. L'agente ha bisogno di un API separato o di una connessione MCP per eseguire operazioni sullo spazio di lavoro.
Pubblicarlo dimostra che gli agenti lo usano?
Pubblicare un indice leggibile ne stabilisce la disponibilità. La prova dell'utilizzo richiede l'osservazione di un client che recupera e usa quel contenuto.
L'audit Lighthouse di Chrome verifica la presenza di errori del server durante il recupero del file. Un file mancante riceve un risultato non applicabile perché il file è facoltativo. Superare quel controllo non misura la qualità delle risposte dell'agente.
Per la tua valutazione, registra l'attività e i documenti recuperati dal client. Verifica se l'agente ha raggiunto la risposta corretta o completato l'azione prevista. Confronta esecuzioni equivalenti per valutare se l'indice è stato d'aiuto.
Una richiesta in un log di accesso dimostra un recupero. Non dimostra, di per sé, che il client abbia usato il contenuto nella sua risposta. Una citazione costituisce un'osservazione ancora diversa. Mantieni separati questi esiti quando riporti i risultati.
Quale documentazione di Bird dovrei fornire a un agente?
Puoi fornire l'indice llms.txt di Bird quando un agente deve scoprire la documentazione e recuperare le pagine pertinenti.
La guida alla documentazione leggibile dalle macchine descrive l'indice, le singole pagine Markdown e il corpus completo. L'indice fornisce link; le singole pagine permettono al client di recuperare una risposta mirata.
llms-full.txt concatena la documentazione con gli URL sorgente. Questa forma più ampia è adatta a un flusso di lavoro che necessita esplicitamente del corpus, nei limiti di contesto del client.
Per eseguire un'attività di messaggistica dopo aver recuperato le istruzioni, connettiti al server MCP di Bird. La documentazione fornisce informazioni; la connessione autenticata fornisce accesso alle operazioni dello spazio di lavoro.