Usare la documentazione con l’AI
Ogni pagina di questo sito è pubblicata anche in semplice Markdown, così un assistente AI può leggere la documentazione senza analizzare il sito web. Puoi passare all’assistente un URL o un file, oppure connetterlo a Babel Desktop, che cerca nella documentazione al suo posto.
File per gli assistenti AI
La build del sito pubblica questi file accanto alle pagine:
| URL | Contenuto |
|---|---|
https://docs.babelfor.net/llms.txt | Indice di tutte le pagine, raggruppate per sezione (Obfuscator, Licensing, Desktop, API Reference), con una descrizione di una riga e un link alla copia Markdown di ogni pagina |
https://docs.babelfor.net/llms-full.txt | Tutte le pagine in un unico file, nell’ordine di navigazione. Ogni pagina inizia con il titolo e una riga Source: con l’URL della pagina. Il file pesa alcuni megabyte |
https://docs.babelfor.net/md/<path>.md | Copia Markdown di una singola pagina. Il percorso è l’indirizzo della pagina, per esempio /md/desktop/stack-decoder.md per Decodificatore stack, oppure /md/desktop.md per la pagina della sezione Desktop |
https://docs.babelfor.net/docs-index.json | Indice di ricerca di tutte le sezioni, usato dagli strumenti per la documentazione di Babel Desktop |
Le copie Markdown hanno lo stesso contenuto delle pagine. Le procedure diventano elenchi numerati, le note diventano paragrafi di citazione, le schede diventano titoli di sottosezione, e i link e le immagini puntano a https://docs.babelfor.net, quindi continuano a funzionare quando il testo viene copiato altrove.
I file vengono rigenerati a ogni pubblicazione del sito e descrivono sempre il rilascio corrente.
Usare i file con Claude, ChatGPT e altri assistenti
Scegli il file adatto alla domanda. Per una domanda su una sola funzionalità basta una singola pagina, che lascia all’assistente più spazio per il tuo codice e i tuoi log. Per le domande ampie, forniscigli l’indice o il file completo.
Trova la pagina
Apri llms.txt e cerca le pagine che trattano la tua domanda, oppure sfoglia questo sito e aggiungi /md davanti al percorso e .md alla fine: https://docs.babelfor.net/licensing/licensing-modes diventa https://docs.babelfor.net/md/licensing/licensing-modes.md.
Passala all’assistente
Se l’assistente può aprire le pagine web, incolla l’URL nella conversazione. Altrimenti scarica il file e allegalo, oppure copiane il testo nel messaggio. I file grandi come llms-full.txt potrebbero non entrare in una sola conversazione; in tal caso, fornisci all’assistente llms.txt e lascia che chieda le pagine che gli servono.
Fai la domanda
Chiedi all’assistente di rispondere in base alla documentazione che gli hai fornito e di citare l’URL Source: o il link della pagina che ha usato, così puoi verificare la risposta sul sito.
Alcuni esempi di richieste:
Leggi https://docs.babelfor.net/llms.txt e dimmi quali pagine spiegano come eseguire Babel Obfuscator in una build di CI su Linux. Poi leggi quelle pagine ed elenca i passi.
Usando https://docs.babelfor.net/md/obfuscator/nuget-package/configuration.md , aggiungi a questo file di progetto la cifratura delle stringhe e l’offuscamento del flusso di controllo.
Ecco llms-full.txt. Qual è la differenza tra una licenza flottante e l’attivazione della licenza, e quale delle due è adatta a un’app desktop venduta per postazione?
Questi file sono pagine pubbliche e statiche. Aprirli o allegarli significa soltanto scaricarli da https://docs.babelfor.net; a babelfor.NET non viene inviato nulla che riguardi il tuo codice o i tuoi progetti. Ciò che incolli in un assistente, come codice sorgente, file di progetto o stack trace, è soggetto alle condizioni di quell’assistente.
Usare la documentazione da Babel Desktop
Se Babel Desktop è installato, connetti il tuo assistente al suo server MCP. È l’opzione consigliata. Il server comprende tre strumenti per la documentazione, docs_search, docs_read e docs_list, quindi la stessa connessione risponde alle domande su come fare qualcosa e poi applica la modifica nell’app: l’assistente cerca come funziona una funzionalità , cita la pagina e modifica le impostazioni del progetto o esegue l’offuscamento.
Abilita il server MCP
In Babel Desktop apri Impostazioni, scegli MCP e seleziona Abilita il server di automazione. È consigliabile richiedere un token di accesso. Vedi Abilitare il server.
Connetti l’assistente
Fai clic su Copia configurazione e aggiungila alla configurazione MCP del tuo client oppure, per Claude Code, fai clic su Copia comando Claude Code ed esegui il comando. La configurazione contiene l’indirizzo del server, http://127.0.0.1:8765/mcp con la porta predefinita, e l’intestazione X-Babel-Token quando è richiesto un token. Vedi Connettere un client.
Fai una domanda
Chiedi come si fa qualcosa in Babel. L’assistente cerca nella documentazione, legge la sezione corrispondente e risponde con i link alle pagine.
Gli strumenti per la documentazione non richiedono altre impostazioni. Sono disponibili ogni volta che il server è in esecuzione. Babel Desktop scarica le pagine da https://docs.babelfor.net e vi esegue la ricerca sul tuo computer, e ne conserva una copia nel tuo profilo utente, così gli strumenti rispondono anche quando sei offline. Vedi Strumenti per la documentazione di Babel per i dettagli.