Comprendere gli agenti AI e l'API
Cosa possono fare nel tuo workspace Clevera gli agenti AI come Claude, ChatGPT, Claude Code, Codex e Cursor, i modi per connetterli, i piani (Pro e superiori), i limiti, i ruoli, i costi e la sicurezza.
AI agents & API consente ad app AI come Claude, ChatGPT, Claude Code, Codex e Cursor, e ai tuoi script, di lavorare nel tuo workspace Clevera: trovare registrazioni, richiedere video, clip social e articoli, esportare video e lavorare sui siti di documentazione. Decidi esattamente cosa può fare ogni agente, quanti crediti può spendere e quando una persona deve approvare.
Cosa possono fare gli agenti
| Area | Cosa può fare un agente |
|---|---|
| Video | Elencare e leggere le tue registrazioni, video, articoli e trascrizioni; richiedere video tutorial, demo di prodotto, video ripuliti e stilizzati da una registrazione, clip social, articoli da una registrazione e traduzioni video; esportare MP4 fino a 4K; aggiungere immagini, video e PDF ai tuoi caricamenti. |
| Siti di documentazione | Leggere, bozzare, organizzare, tradurre e pubblicare pagine di siti di documentazione e il changelog, rispondere ai lettori dalle pagine pubblicate, leggere gli approfondimenti dei lettori e modificare le impostazioni del sito o creare siti. |
Gli agenti non possono ancora eseguire ricerche su siti web o walkthrough registrati.
L'agente effettua la richiesta; l'AI di Clevera crea il video o l'articolo, nello stesso modo in cui lo avvii nell'app. Un agente non vede mai più di quanto il suo proprietario potrebbe vedere: le registrazioni in una raccolta privata rimangono nascoste a meno che il proprietario del token non abbia accesso.
Modi per connettersi
| Modo | Per | Configura in |
|---|---|---|
| Token API | Claude Code, Codex CLI, Cursor, qualsiasi client MCP e i tuoi script tramite l'API REST | Token → Nuovo token. Vedi Creare un Token API. |
| App connesse | Claude (claude.ai) e ChatGPT come connettore personalizzato; nessun token, accedi tu | L'app, con l'URL del connettore da App connesse. Vedi Connettere app e agenti AI. |
| API REST | Script e servizi backend | Un Token API. Vedi Usare l'API REST. |
Il server MCP è https://app.clevera.ai/mcp e l'API REST è sotto https://app.clevera.ai/api/v1.
Trovare la pagina
Apri il menu del workspace e scegli AI agents & API. Sui siti di documentazione, si trova anche nella home page dei Documenti e nel menu Impostazioni di un sito. La pagina ("Lascia che Claude, Codex, ChatGPT e i tuoi script lavorino in questo workspace.") ha cinque schede, ognuna con il proprio conteggio:
| Scheda | Cosa c'è |
|---|---|
| Token | I tuoi Token API; i proprietari e gli amministratori vedono ogni token. Gestire i Token API |
| App connesse | L'URL del connettore e le app connesse dalle persone. Connettere app e agenti AI |
| Richieste dell'agente | Lavoro a pagamento in attesa di approvazione da parte di una persona, con un badge di conteggio e la cronologia. Controllare la spesa e le approvazioni dell'agente |
| Webhook | Notifiche firmate ai tuoi sistemi. Configurare i webhook |
| Attività | Cosa hanno fatto gli agenti. Leggere l'attività dell'agente |
Piani
AI agents & API è disponibile nei piani Pro, Azienda e Personalizzato. Ciò include Token API, connettori per Claude e ChatGPT e webhook.
Nei piani Free e Starter, la pagina mostra "AI agents & API sono inclusi in Pro": "Passa a Pro per consentire a Claude, ChatGPT e ai tuoi script di lavorare in questo workspace. I token e le app esistenti smetteranno di funzionare fino ad allora; puoi comunque revocarli qui." Clicca su Passa a Pro. I controlli bloccati dicono "L'accesso all'API e all'agente è disponibile nei piani Pro e superiori.", "I connettori Claude.ai e ChatGPT sono disponibili nei piani Pro e superiori." o "I webhook sono disponibili nei piani Pro e superiori."
| Limite | Pro, Azienda, Personalizzato |
|---|---|
| Token API attivi per workspace | 50 |
| App connesse per persona | 20 |
| Webhook per workspace | 10 |
| Approva automaticamente sotto al massimo | Pro e Azienda: 500 crediti. Personalizzato: 1.000 crediti. |
Se il workspace lascia il piano Pro
Non viene eliminato nulla, ma tutto si mette in pausa finché non esegui nuovamente l'upgrade:
| Dopo il passaggio a Starter o Free | |
|---|---|
| Token API | Rimangono elencati e possono essere revocati. Ogni chiamata viene rifiutata: "L'API dell'agente non è nel piano di questo workspace. È disponibile nei piani Pro e superiori." Non possono essere rigenerati (Rigenera segreto apre la finestra di dialogo per l'upgrade). |
| App connesse | Rimangono elencate e possono essere disconnesse. Le loro chiamate falliscono; Claude o ChatGPT potrebbero solo dire che non è stato possibile connettersi. |
| Webhook | Rimangono elencati, ma non viene inviato nulla. Invia evento di test e Riconsegna dicono "I webhook non sono nel tuo piano." |
| Richieste dell'agente | Approva dice "L'accesso all'API e all'agente non è nel tuo piano." Nega funziona ancora. |
| Nuovi token | "L'accesso all'API e all'agente non è nel tuo piano." |
L'upgrade a Pro fa funzionare di nuovo token, app e webhook. I token scadono comunque nelle loro date originali.
Chi può fare cosa
Un agente agisce come la persona che ha creato il suo token o lo ha connesso, entro i limiti consentiti dal ruolo di quella persona. Non può mai fare più di quanto quella persona potrebbe fare nell'app, e il ruolo viene controllato a ogni chiamata, quindi un cambio di ruolo ha effetto immediato.
| Attività | Proprietario | Amministratore | Editor | Content Creator |
|---|---|---|---|---|
| Creare token e connettere app per te stesso | Sì | Sì | Sì | Sì |
| Vedere e revocare ogni token e app nel workspace | Sì | Sì | Solo i propri | Solo i propri |
| Dare a un agente il permesso di richiedere video e spendere crediti | Sì | Sì | No | Sì |
| Dare a un agente il permesso di pubblicare siti di documentazione | Sì | Sì | Sì | No |
| Approvare il lavoro a pagamento richiesto dagli agenti | Sì | Sì | No | No |
| Gestire i webhook | Sì | Sì | No | No |
L'elenco completo è in Permessi dell'agente.
Quanto costa
- Le chiamate API e MCP sono gratuite: leggere, cercare, citare e controllare un lavoro non costano crediti. Lo stesso vale per le esportazioni video.
- Il lavoro che utilizza l'AI costa crediti, come quando lo avvii nell'app: video, clip social, articoli da registrazioni, traduzioni e pagine del sito generate dall'AI.
- Un agente può iniziare un lavoro a pagamento solo con un token che ha
credits:spend. Ogni avvio viene prima quotato e controllato rispetto ai limiti di spesa del token, e una persona lo approva a meno che non sia inferiore alla riga Approva automaticamente sotto del token. Vedi Controllare la spesa e le approvazioni dell'agente.
Come Clevera mantiene sicuri gli agenti
- I token scadono sempre: dopo 7 giorni, 30 giorni, 90 giorni o 1 anno. Non esiste "mai".
- I segreti vengono mostrati una volta sola. Clevera memorizza solo un'impronta digitale e mostra gli ultimi quattro caratteri.
- Accesso minimo. Ogni token ha solo i permessi, i siti di documentazione e gli indirizzi IP che scegli.
- Le persone approvano il denaro. Un agente non può approvare la propria spesa; solo il proprietario del workspace o un amministratore può farlo.
- I token trapelati vengono revocati. Un token Clevera trovato in un repository GitHub pubblico viene revocato automaticamente.
- L'attività insolita viene interrotta. Raffiche di chiamate rifiutate revocano il token; raffiche di modifiche o spese lo mettono in pausa e il proprietario viene avvisato.
- Tutto viene registrato in attività, conservato per 13 mesi. Le modifiche al sito di documentazione di un agente appaiono anche nella cronologia della pagina come "Agente nome (token)".