Manuale degli agenti
Collega Claude, ChatGPT, Cursor, VS Code o qualsiasi client MCP al tuo spazio di lavoro, scegli cosa può fare ciascuno e mantieni il controllo.
Cosa fanno gli agenti
Gli agenti fanno lavorare l’app di IA che usi già nel tuo spazio SimuLive. Chiedi con parole tue e l’agente consulta o modifica con gli strumenti che consenti.
SimuLive non fornisce l’IA. Porti la tua app e il tuo account, e SimuLive le dà un accesso sicuro.
- Consultare serie, runbook, libreria, statistiche e fatturazione.
- Creare e aggiornare serie, gestire richieste e file.
- Guidare le dirette: pausa, salto e slide.
Collegare un agente
Nello spazio di lavoro apri Agenti e seleziona Connetti. Scegli l’app che usi e segui i tre brevi passaggi.
L’app apre SimuLive nel browser. Controlla il nome dell’app e dove ritorna, scegli l’accesso e seleziona Approva. Torni subito all’app, con l’accesso fatto.
Non c’è nessuna chiave da copiare. Se ti viene chiesto di accedere prima, accedi e la richiesta prosegue.
App supportate
Ogni app si collega in modo un po’ diverso. La finestra Connetti mostra i passaggi esatti per quella scelta.
- Claude sul web e su desktop: aggiungi un connettore personalizzato e incolla l’URL del server.
- ChatGPT: attiva la modalità sviluppatore, crea un connettore e incolla l’URL del server.
- Cursor: un clic installa il server, poi seleziona Connetti.
- VS Code: un clic installa il server, poi avvialo dall’elenco MCP.
- Claude Code: esegui il comando mostrato e digita /mcp.
- Altri agenti: aggiungi l’URL del server o usa una chiave agente.
Scegliere l’accesso per area
L’accesso si imposta per ogni area, come Membri, Serie, Controlli dal vivo, Libreria o Fatturazione. Impostazione rapida applica lo stesso livello ovunque, poi puoi cambiare ogni area.
Le aree senza accesso sono del tutto nascoste all’agente. Il tuo ruolo resta valido, quindi un agente non fa mai più di te.
- Nessun accesso: l’agente non vede quest’area.
- Leggere: solo consultare.
- Modificare: anche creare e aggiornare, ogni modifica richiede il tuo ok.
- Completo: anche rimuovere, eliminare e riavviare le dirette.
Inizia con Solo lettura e amplia quando serve.
Chiavi agente per altri strumenti
Gli strumenti che non possono accedere, come un bot Slack o uno script, usano una chiave agente. Seleziona Crea chiave agente, dai un nome, scegli le aree e copia la chiave. Viene mostrata una sola volta.
Invia la chiave come token Bearer all’URL del server. Le chiavi ruotabili possono ricevere un nuovo segreto senza cambiare nome o accesso.
- Conserva le chiavi in un gestore di segreti, mai in file condivisi.
- Revoca una chiave appena non serve più.
Controlli dal vivo per agenti
Con l’accesso ai Controlli dal vivo, un agente elenca le dirette in corso e vede cosa riproduce ciascuna.
Con Modificare può anche mettere in pausa, riprendere, saltare e spostare le slide. Riavviare e ricaricare richiedono l’accesso Completo perché i partecipanti lo vedono.
- list_live_runs e get_live_state leggono soltanto.
- control_series_run mette in pausa, salta e sposta le slide.
- change_series_run_content riavvia o ricarica i contenuti.
- Il proprietario e i responsabili ricevono un avviso nella campanella quando un agente agisce.
Sicurezza integrata
Ogni agente lavora con gli stessi limiti.
- Ogni modifica ti chiede prima conferma in chat.
- Le modifiche hanno un limite e i controlli dal vivo attendono qualche secondo tra un’azione e l’altra.
- Ogni modifica viene registrata nel registro di controllo.
- Gli agenti trattano il testo di file e ticket come dati, non come istruzioni.
- Pagamenti, posti, pacchetti di spazio, disdetta e chiavi restano sul sito.
Vedere e revocare le connessioni
Ogni connessione compare in Chiavi agente, segnata come App connessa, con accesso e ultimo utilizzo.
Seleziona Revoca per interromperla. L’accesso si ferma subito e l’app dovrà ricollegarsi. Gli amministratori vedono e possono revocare ogni connessione.
Se qualcuno lascia lo spazio di lavoro o viene messo in pausa, anche le sue connessioni smettono di funzionare.
Se qualcosa non funziona
Questi sono i casi più comuni.
- La richiesta di connessione è scaduta: ricollegati dall’app.
- Lo strumento non è disponibile: dai più accesso a quell’area o controlla il tuo ruolo.
- Attendi qualche secondo e riprova: i controlli dal vivo sono stati usati da poco.
- Disconnesso nell’app: ricollegati e approva.
Serve aiuto?
Apri il centro assistenza nella dashboard, scrivi in chat al nostro team o inviaci un'email.
Scrivi a support@simulive.us