Chiavi agente per script e automazioni
Crea una chiave agente, scegli cosa può fare, vedila una volta sola, rinnovala prima che scada e revocala.
In questa pagina
Una chiave agente permette a uno script, a un'automazione o a un job di CI di parlare con Verimly senza una schermata di accesso. La chiave agisce come la persona che l'ha creata, con al massimo i suoi stessi diritti. Tutto ciò che usa la chiave smette di funzionare nel momento in cui la revochi.
Se usi un'app come Claude o ChatGPT, non ti serve una chiave: collegala come descritto in Collegare il tuo agente IA a Verimly.
Prima di iniziare
- Consenti agenti deve essere attivo in Impostazioni › IA e agenti. Lo controlla un titolare. Se è disattivato, le chiavi smettono di funzionare.
- Una chiave agisce come te, quindi non può mai vedere o cambiare più di quanto consente il tuo ruolo. Un cassiere che spunta Modificare il menu non ottiene nulla in più, perché il ruolo non può modificare il menu.
- Se Sola lettura per tutti è attivo, ogni nuova chiave è in sola lettura qualunque cosa scelga.
- Tratta una chiave come una password: chiunque la possieda può agire come te entro i suoi ambiti.
Creare una chiave
- Apri Impostazioni › IA e agenti, trova Chiavi agente e scegli Crea chiave.
- Inserisci un Nome che dica a cosa serve, come Script del report settimanale.
- In Cosa può fare, lascia attiva Sola lettura, oppure disattivala per consentire le modifiche e spunta gli ambiti che ti servono (vedi sotto). Vedere la tua attività è sempre incluso.
- In Sedi scegli Tutte le sedi, oppure Solo queste sedi e selezionane almeno una.
- Scegli la Scadenza: dopo 30, 90 o 365 giorni. Ogni chiave scade; non esiste una chiave che dura per sempre.
- Scegli Crea chiave.
- Copia ora la tua chiave. Inizia con
vk_live_e viene mostrata una sola volta. Conservala in un gestore di password o nei segreti della tua CI, poi scegli L’ho copiata.
Invia la chiave nell'intestazione Authorization come token bearer: Authorization: Bearer vk_live_…. Una chiave funziona sia sull'indirizzo del server completo sia su quello di Sola lettura mostrati nella stessa pagina. Le chiavi non possono chiedere a una persona di approvare altri accessi, quindi non possono andare oltre gli ambiti che hai dato loro.
Ambiti
| Ambito | Cosa consente |
|---|---|
| Vedere la tua attività | Vendite, menu, scorte, turni del personale, prenotazioni e report: ciò che puoi vedere tu stesso |
| Modificare il menu | Prodotti, prezzi, categorie e cosa è esaurito |
| Gestire le prenotazioni | Creare, spostare e annullare prenotazioni |
| Gestire personale e turni | Profili del personale, inviti e turni |
| Gestire gli ordini online | Accettare gli ordini online e aggiornarne stato e note. Mai rimborsi né annullamenti. Nessuna azione degli agenti usa ancora questo ambito. |
Gli agenti non possono mai spostare denaro: niente rimborsi, annullamenti, bonifici né impostazioni di pagamento.
Vedere e gestire le chiavi
L'elenco mostra ogni chiave con il suo nome, i primi caratteri della chiave, chi Agisce come, Ultimo uso (oppure Non ancora usata), e Scadenza oppure Scaduta con la data. I titolari vedono tutte le chiavi dell'attività; gli altri vedono le proprie.
Rinnovare una chiave prima che scada
Scegli Rinnova sulla chiave. Ottieni un nuovo segreto con le stesse impostazioni, e il vecchio smette di funzionare subito. La nuova chiave mantiene i giorni rimanenti. Aggiorna subito il tuo script. Un titolare che rinnova la chiave di qualcun altro la prende in carico: la nuova chiave agisce come il titolare.
Revocare una chiave
Scegli Revoca e conferma. Tutto ciò che usa la chiave smette di funzionare subito. Fallo se la chiave è stata incollata dove non doveva, se un collega se ne va o se lo script viene dismesso.
Quando una persona viene rimossa dall'attività, vengono revocate anche le sue chiavi e le sue app collegate.
Limiti
- Le chiamate sono contate al mese per l'attività: Starter 3.000, Pro 10.000 e Business 30.000 per sede, in comune. La pagina mostra … di … chiamate degli agenti e quando si azzera.
- Ogni chiave può fare 60 chiamate al minuto su Starter e Pro, 120 su Business. Oltre il limite la chiamata viene rifiutata con un messaggio di attendere.
Domande frequenti
Ho perso la chiave
Non si può mostrare di nuovo. Crea una nuova chiave (oppure rinnova quella vecchia) e revoca quella persa.
La chiave funzionava ieri e ora restituisce un errore
Potrebbe essere revocata (AGENT_KEY_REVOKED), scaduta, oppure Consenti agenti potrebbe essere disattivato (MCP_DISABLED). Controlla la chiave nell'elenco e l'interruttore nella pagina.
Perché la chiave può leggere ma non cambiare nulla?
Sola lettura è attivo per la chiave, oppure Sola lettura per tutti è attivo per l'attività, oppure l'ambito non è stato selezionato. Vedi AGENT_READ_ONLY in Cosa possono e non possono fare gli agenti.
Se qualcosa va storto
Guarda Attività nella stessa pagina: elenca ogni azione degli agenti, con risultato e ora. Per una chiave trapelata, revocala per prima cosa e poi controlla nel registro Controllare chi ha cambiato cosa cosa ha fatto. Usa Contattare l'assistenza se ti serve aiuto.