Salta ai contenuti

Riferimento per agenti IA (testo semplice)

atbridge.ai è costruito per gli agenti IA. Perciò la sua intera API è pubblicata come testo semplice — un agente (o un assistente di codice, o uno script) può assorbire l’intera superficie di comandi e tool in un solo fetch, senza HTML da analizzare.

I file

/llms-mcp.txt — ogni tool MCP che il server atbridge.ai espone: nome, descrizione, ogni parametro (tipo · obbligatorio · descrizione) e se è una scrittura (le scritture richiedono ATBRIDGE_ALLOW_WRITES=1). È esattamente ciò che un client MCP vede da tools/list.
/llms-cli.txt — ogni comando CLI e flag (le stesse operazioni di MCP). JSON in ingresso, JSON in uscita.
/llms-full.txt — una guida alle funzionalità dal compito al risultato (cosa fa atbridge.ai, formulata come Situazione → Compito → Azione → Risultato), per orientare un agente su quando ricorrere a quale operazione.
/llms.txt — la mappa del sito leggibile dagli LLM (riepilogo delle entità + i link canonici), nel formato llmstxt.org.

Perché il testo semplice

La documentazione renderizzata è pensata per le persone — navigazione, stile, script. Un agente che deve analizzare HTML spende token sul markup e può perdere contenuti. Il riferimento .txt è l’opposto: pura API, niente da rimuovere, economica da assimilare e facile da confrontare. Funge anche da contratto API pubblico.

Non si disallinea mai

/llms-cli.txt e /llms-mcp.txt sono generati dal prodotto live — il file CLI dall’albero reale dei comandi atbridge, il file MCP dal tools/list del server — tramite atbridge reference --kind cli|mcp, rigenerati a ogni build. Non possono disallinearsi da ciò che il binario effettivamente distribuisce.

Prima configura

Per chiamare davvero questi tool devi comunque collegare atbridge.ai al tuo agente una volta — vedi Collega Claude Desktop, Cursor, o qualsiasi client MCP/CLI. Poi consegna al tuo agente i file qui sopra.

Was this page helpful?