Connetti agenti AI ai tuoi siti di documentazione
Lascia che Claude Code, Codex, ChatGPT o i tuoi script redigano, organizzino e pubblichino pagine di siti di documentazione. Piani (Pro e superiori), autorizzazioni dei siti di documentazione, ambito del sito e regole di pubblicazione, con link alle guide complete su agenti AI e API.
Agenti AI come Claude Code, Codex, Cursor, Claude o ChatGPT possono leggere e scrivere sui tuoi siti di documentazione al posto tuo: redigere articoli, correggere pagine con valutazioni basse da parte dei lettori, colmare lacune nei contenuti, tradurre o pubblicare. Questo articolo tratta ciò che è specifico per i siti di documentazione. Token, connettori, spese ed errori sono spiegati in Agenti AI e API.
Prima di iniziare
- Agenti AI e API è disponibile nei piani Pro, Business e Personalizzato, inclusi i connettori per Claude e ChatGPT. I piani Free e Starter non lo includono; i token e le app smettono di funzionare se un'area di lavoro passa a uno di questi.
- Un agente agisce come la persona che ha creato il suo token o lo ha connesso, all'interno del ruolo di quella persona. Non può mai fare di più su un sito di quanto potrebbe fare l'utente stesso.
- Le chiamate API non costano crediti. La traduzione di pagine e la generazione di pagine del sito con l'AI costano crediti, e solo con un token che può spenderli.
Connetti un agente
Apri il menu dell'area di lavoro e scegli Agenti AI e API, oppure scegli Agenti AI e API nel menu Impostazioni di un sito di documentazione (apre l'attività per quel sito).
- Token API per Claude Code, Codex, Cursor o uno script: Token → Nuovo token, quindi una procedura guidata in quattro passaggi (Scopo, Autorizzazioni, Limiti, Revisiona). Scegli un preset per siti di documentazione come Scrittore o Editore, seleziona i siti in Limiti → Siti di documentazione e copia il token, che viene mostrato una sola volta. Vedi Crea un token API.
- Connettore per Claude.ai o ChatGPT: incolla l'URL del connettore da App connesse nell'app, accedi e scegli i Siti e l'Accesso. Vedi Connetti app e agenti AI.
Preset per siti di documentazione
| Preset | Descrizione sullo schermo | Per |
|---|---|---|
| Scrittore | "Gli agenti redigono; una persona revisiona e pubblica." | Redazione di articoli e voci del changelog, caricamento immagini |
| Editore | "Automazione affidabile che può modificare ciò che vedono i lettori." | Tutto per i siti di documentazione, inclusi pubblicazione, impostazioni e creazione di siti |
| Assistente al supporto | "Risposte da documenti pubblicati. Nient'altro." | Un bot di assistenza che cerca solo in pagine pubbliche pubblicate |
| Sola lettura | "Ricerca, audit e controlli di traduzione." | Lettura di contenuti |
| Analista | "Legge contenuti e segnali dei lettori per suggerire correzioni." | Lettura di contenuti e approfondimenti |
Produttore e Agente dell'area di lavoro aggiungono video e crediti di spesa. Ogni autorizzazione e chi può concederla: Autorizzazioni agente.
Autorizzazioni dei siti di documentazione
| Autorizzazione | Consente |
|---|---|
content:read |
Leggere siti, pagine, articoli (anche bozze), revisioni, changelog e pagine del sito |
articles:write |
Creare bozze di articoli e modificare articoli non ancora pubblicati |
structure:write |
Creare e modificare sezioni; spostare, nascondere e rinominare pagine |
site-pages:write |
Modificare pagine del sito come home, contatti e legale |
changelog:write |
Creare e modificare voci del changelog come bozze |
media:write |
Caricare immagini |
site:publish |
Pubblicare: cambiare ciò che vedono i lettori, modificare contenuti live, contrassegnare pagine come pronte |
insights:read |
Leggere lacune di ricerca, domande senza risposta e feedback sulle pagine |
site:configure |
Modificare impostazioni del sito, aspetto e navigazione |
sites:create |
Creare nuovi siti di documentazione |
help:read |
Cercare solo in pagine pubbliche pubblicate (per un assistente al supporto) |
La lettura è aperta a qualsiasi membro. Scrittura e organizzazione: proprietario, amministratori, editori e creatori di contenuti. Pubblicazione e impostazioni del sito: proprietario, amministratori ed editori ("Solo proprietari, amministratori ed editori possono concedere la pubblicazione."). Creazione di siti: proprietario e amministratori.
Quali siti copre un token
In Limiti → Siti di documentazione, scegli Tutti i siti ("Ogni sito di documentazione in questa area di lavoro, inclusi quelli nuovi.") o Siti scelti. Un token o un'app connessa vede e modifica solo i siti che copre. Se un articolo appare anche su un sito al di fuori del suo ambito, la modifica viene rifiutata: "Questo articolo è mostrato anche su un sito che questo token non può modificare."
I contenuti live richiedono diritti di pubblicazione
Senza site:publish, un agente non può cambiare ciò che vedono i lettori. La modifica di un articolo live viene rifiutata ("Questo contenuto è live su un sito pubblicato, quindi modificarlo richiede l'abilità site:publish"), e l'agente può invece inviare la sua bozza per la revisione. Riceverai una notifica, "agente ha richiesto la revisione di pagina su sito": "Non è stato pubblicato nulla. Leggi l'articolo e pubblicalo quando è pronto."
Ogni modifica apportata da un agente viene mostrata nella cronologia della pagina come "Agente nome (token)". Le pubblicazioni sono limitate a 10 all'ora per token. Un sito in pausa è in sola lettura per gli agenti: "Questo sito è in pausa o offline ed è in sola lettura."
Cosa possono fare gli agenti su un sito
Elencare siti e leggere l'albero delle pagine, cercare e leggere pagine, visualizzare l'anteprima Markdown, creare e aggiornare articoli, inviarli per la revisione, organizzare sezioni e pagine, modificare pagine del sito e il changelog, caricare immagini, leggere approfondimenti e contrassegnare lacune come coperte, modificare impostazioni, aspetto, navigazione e reindirizzamenti, creare siti, tradurre pagine, generare pagine del sito, pubblicare e ripristinare. Ognuna richiede l'autorizzazione corrispondente.