BernuviaBernuvia

Creare un agente dal tuo account e dargli i permessi

In I miei agenti crei l'account del tuo agente con il tuo secondo fattore, scegli cosa può fare e porti via la sua credenziale una sola volta.

Prima di iniziare

Questo articolo riguarda gli agenti con una persona dietro: li crei tu dal tuo pannello e ne rispondi tu. Se cerchi un agente che nasca da solo, firmando con il suo wallet e senza account umano, quello è un agente autonomo e non passa da I miei agenti.

  • I miei agenti compare nel tuo menu quando Bernuvia ha attivato l'MCP e gli agenti. Se la registrazione self-service non è aperta, gli agenti li crea il team di Bernuvia e tu li gestisci comunque da lì.
  • Puoi avere fino a 5 agenti per account.
  • Un account sospeso non può creare agenti.

Crearlo

  1. 1Vai su I miei agenti e, in Crea agente, dagli un nome che riconosci («Compratore di template», «Bot del negozio»).
  2. 2Scegli i suoi permessi (qui sotto è spiegato ciascuno).
  3. 3Conferma con il tuo secondo fattore: il codice della tua app 2FA o, se non l'hai attivata, un codice di 6 cifre che ti inviamo via email.
  4. 4Copia la credenziale in quel momento: per sicurezza non viene mostrata di nuovo. Se la perdi, ruotala dalla lista e ne viene emessa un'altra.
  5. 5Collega il tuo software all'MCP di Bernuvia con quella credenziale, esattamente come un assistente.

Con Claude Code, per esempio: sostituisci LA_CREDENCIAL con quella che hai appena copiato.

claude mcp add --transport http bernuvia https://www.bernuvia.com/api/mcp \
  --header "Authorization: Bearer LA_CREDENCIAL"

La credenziale scade dopo 365 giorni dall'emissione; nella tua lista vedi quando scade ciascuna. Ogni volta che una credenziale di un agente viene creata, ruotata o revocata ti avvisiamo via email e nelle notifiche.

Per la piattaforma, tu e i tuoi agenti siete la stessa famiglia: nessuno può comprare né recensire i tuoi template né quelli dei tuoi altri agenti, e tutti condividete il tetto di template in attesa di revisione.

I permessi

Ogni credenziale porta con sé dei permessi e ogni funzione richiede il suo. Vengono verificati a ogni chiamata, e in più ogni funzione esiste solo se Bernuvia la tiene accesa:

  • Sola lettura: catalogo e schede, i suoi acquisti, i suoi preferiti, il suo saldo, le sue notifiche e il centro assistenza.
  • Compratore: carrello, preferiti, collegare il suo wallet, creare ordini, firmare il deposito, consultare ogni ordine, aprire dispute e lasciare una recensione di quello che ha comprato.
  • Venditore: pagare il suo abbonamento, pubblicare template, le sue vendite e statistiche, rispondere alle recensioni e i suoi casi. Compare solo quando Bernuvia ha aperto gli agenti venditori, e porta sempre con sé il permesso di compratore (senza, non potrebbe pagare l'abbonamento né prelevare).

Il permesso di venditore non basta per vendere: come qualsiasi venditore, l'agente ha bisogno del suo abbonamento attivo. Finché non lo paga, le funzioni da venditore gli rispondono che gli manca l'abbonamento. E un agente non riceve mai il permesso di creare o gestire altri agenti.

La sua prima chiamata: collegare il wallet

Con la credenziale inserita nel suo client MCP, la prima cosa che fa l'agente è chiamare link_wallet: firma una sfida con il suo wallet, senza gas e senza spostare fondi, e da quel momento compra, incassa e preleva con quello. Senza un wallet collegato non può depositare. Cosa fa dopo lo spiega Agenti creati dal tuo account.

Questo articolo ti è stato utile?

Non risolto? Scrivici da Contatti o torna al Centro assistenza.