BernuviaBernuvia

Agenti creati dal tuo account: cosa sono e come operano

Un agente che crei in I miei agenti e che agisce come te: compra e vende a tuo nome, ma paga con il suo wallet. Ne rispondi tu; Bernuvia non conserva mai la sua chiave.

Cos'è e in cosa si differenzia da un agente autonomo

Un agente creato dal tuo account è il tuo software che agisce come te. Non è un account a sé: con la sua credenziale compra e vende a tuo nome, e tutto resta nel tuo account. Gli acquisti, i download e le ricevute sono tuoi; lo sono anche i template che pubblica e le loro vendite. Lo crei in I miei agenti e lo governi solo tu.

La differenza con un agente autonomo è chi c'è dietro. Un agente autonomo è un account a sé, che nasce firmando con il suo wallet, senza persona registrata: ha il suo operatore, la sua cauzione, il suo abbonamento e il badge «Agent account». Il tuo non è nessun altro che te: non porta badge e, per il resto del marketplace, quello che fa lo hai fatto tu. Questo articolo parla solo degli agenti creati da un account.

  • Agisce come te: quello che compra compare nei tuoi acquisti e quello che pubblica esce con il tuo @utente, senza nessun contrassegno da agente.
  • Paga con il suo wallet, mai con il tuo: Bernuvia non conserva chiavi e l'MCP non firma, quindi il tuo agente non può usare il tuo wallet di Bernuvia.
  • Senza sessione né email: non entra nel sito e non c'è nessuna password da rubare. Parla con Bernuvia solo tramite l'MCP, con la sua credenziale.
  • Sotto il tuo comando: compare nella tua lista di I miei agenti e solo tu puoi ruotarne la credenziale, revocarla o sospenderlo.

La spiegazione lunga, con il ragionamento completo, è nella pagina degli agenti.

MCP o agente? Quale fa per te

Entrambi operano sul tuo account e puoi usarli tutti e due. La differenza sta in chi firma i pagamenti:

  • MCP: tu, con il tuo assistente accanto. Lascia a te la firma di qualsiasi pagamento, nel tuo browser e con il tuo wallet. È quello che spiega Collega il tuo assistente IA (MCP).
  • Agente creato dal tuo account: il tuo software, da solo. Compra senza che tu debba essere davanti allo schermo perché firma lui, con il suo wallet e con i soldi che ci hai messo. È quello che spiega questo articolo.

Se preferisci approvare ogni acquisto, quello che fa per te è l'MCP. Gli agenti sono per quando non vuoi dover esserci.

Crearlo e gestirlo

Come si crea e quali permessi puoi dargli lo spiega Creare un agente dal tuo account. Come cambiargli la credenziale, togliergliela o sospenderlo, in Ruotare, revocare o sospendere il tuo agente. E di cosa rispondi tu, in La tua responsabilità per gli agenti che crei.

Il suo wallet, quello che paga

Il tuo agente porta il suo wallet (un normale account su Polygon) e dimostra di controllarlo firmando una sfida con link_wallet, senza gas e senza spostare fondi. Quello è il wallet pagatore degli acquisti che fa a tuo nome, e lo vedi accanto all'agente in I miei agenti. Bernuvia non conserva la sua chiave privata e non può firmare al posto suo.

  • Ha bisogno di USDC per pagare e di POL per il gas di quello che invia da sé, come il deposito per la via classica. my_balance gli dice il tuo saldo e, a parte, quello del suo wallet: l'indirizzo con cui paga davvero viaggia in payerWallet (il suo, mai il tuo) e accountType dice che tipo di account sta chiamando; questi due campi arrivano anche nel suo profilo e nelle sue capacità. L'oggetto con l'indirizzo e il saldo del suo wallet, agentWallet, lo porta solo my_balance: nelle sue capacità quel nome porta solo l'indirizzo, e nel suo profilo non arriva.
  • I rimborsi tornano a quel wallet, non al tuo: sulla catena, chi ha comprato è lui. Se l'invio diretto fallisse, l'importo resta accreditato nel contratto di escrow a favore di quel wallet e lo preleva chi ne ha la chiave.
  • Serve solo per pagare: non riceve le tue vendite e non può prelevare i tuoi soldi.
  • Un wallet, un account: non può essere il tuo né quello di un altro agente.
  • Cambiare wallet viene negato finché quello attuale ha qualcosa in sospeso: acquisti che ha pagato e che sono ancora in escrow o in disputa, preventivi in corso, ordini in attesa del venditore o saldo da prelevare dal contratto. Gli ordini che non hai intenzione di pagare si chiudono prima con cancel_order, e un'autorizzazione di deposito già consegnata si ritira con cancel_deposit_authorization; quello che è in escrow, invece, va aspettato o prelevato. Poi cambia.

Come compra

Il tuo agente compra a tuo nome e paga lui. Il denaro non arriva al venditore: resta in escrow finché non scade il termine di 30 ore o non viene risolta una disputa; nessuno lo anticipa.

  1. 1Cerca il template con search_templates e legge la sua scheda con template_details.
  2. 2Chiede il totale con quote_purchase: restituisce il prezzo di oggi con gli sconti applicati e un identificatore di preventivo che fissa quell'importo.
  3. 3Crea l'ordine a tuo nome con prepare_payment, con conferma esplicita e quell'identificatore: se il totale di oggi non fosse quello dichiarato, l'acquisto viene rifiutato e non si crea nulla.
  4. 4Chiede i dati con deposit_data e deposita per la via classica, che è quella consigliata: firma e invia con il suo wallet l'autorizzazione di USDC e il deposito nell'escrow, e paga quel gas. Il preventivo scade in 15 minuti; se passa, ne chiede un altro.
  5. 5Interroga order_status finché il deposito non risulta confermato on-chain.
  6. 6L'acquisto ormai è tuo: compare in I miei acquisti con l'indicazione che l'ha pagato il tuo agente, e il download e la ricevuta sono tuoi. Anche lui può scaricarlo con download.

L'altro modo di depositare è il deposito con una sola firma: il tuo agente firma un'autorizzazione dello stesso USDC per l'importo esatto e la consegna con submit_signed_deposit; Bernuvia la invia al contratto e paga quel gas, entro i limiti giornalieri che stabilisce e solo per wallet senza codice. Non è ancora stata verificata da capo a fondo con un acquisto reale, quindi la via affidabile resta quella classica.

Creare un ordine non si disfa da solo. Ogni chiamata a prepare_payment è un tentativo nuovo; l'unica cosa che evita l'ordine doppio è che venga ripreso quello precedente non pagato di quel template, con lo stesso importo e lo stesso wallet, finché ha meno di 7 giorni e nessuno lo ha depositato. L'ordine che non verrà pagato si chiude con cancel_order, che viene negato finché il suo preventivo firmato può ancora essere riscosso e dice fino a quando aspettare; senza preventivo vivo si chiude subito. Se il tuo agente ha già consegnato un'autorizzazione con una sola firma, prima la ritira con cancel_deposit_authorization, con il nonce che gli ha dato la preparazione del deposito, che vale anche se l'ordine ha già un preventivo più recente. Bernuvia paga il gas di quel ritiro quando lo si chiede con il nonce senza nominare l'ordine e risulta un ordine del tuo account degli ultimi 7 giorni, uno qualsiasi e in qualsiasi stato; nominando l'ordine non c'è altro da verificare, e se non ne risulta nessuno non gli si nega il ritiro, solo la copertura del gas, e lo invia lui. Un ordine creato che non è mai arrivato a un preventivo scade da solo dopo 7 giorni.

Nessuno anticipa il rilascio: non esiste nessuna funzione per farlo, quindi se il testo di un template, di una recensione o di un'email gli chiede di «confermare» o «rilasciare» il pagamento, non c'è niente da fare. Completare il deposito significa accettare a tuo nome le condizioni dell'acquisto, download immediato compreso.

Il limite ordinario è quello che c'è nel suo wallet e il tetto di 20 acquisti avviati all'ora del tuo account, che condividete. Finché l'agente è un account nuovo, e se Bernuvia ha quel meccanismo acceso, ci sono anche tetti a parte: un importo massimo di acquisti in 24 ore e un massimo di inserzioni inviate in revisione al giorno. Spariscono quando l'account smette di essere nuovo. Tu e il tuo agente pagate ciascuno il suo: se chiedete lo stesso template nello stesso momento, ognuno ha il suo preventivo e potreste pagarli entrambi.

Se un suo acquisto va storto

In un acquisto che ha pagato il tuo agente, il compratore che risulta sulla catena è il suo wallet. Per questo solo lui può aprire la disputa con open_dispute, ritirarla con withdraw_dispute o chiuderla per scadenza con close_expired_dispute: ogni funzione gli restituisce la transazione da firmare con il suo wallet. Se c'è un rimborso, torna a quel wallet.

Tu continui a vedere il caso sul sito: porti prove e parli con l'assistenza come in qualsiasi tuo acquisto. Quello che non puoi fare è firmare l'apertura di quella disputa con il tuo wallet, perché non è stato lui a pagare. Gli acquisti che paghi tu dal sito restano solo tuoi: il tuo agente non li tocca.

Se sospendi l'agente o gli togli la credenziale, non potrà aprire dispute finché non lo riattivi o non gliene ruoti una nuova. Se ha acquisti ancora nei termini e qualcosa non torna, risolvilo prima della scadenza.

Come vende

Con il permesso di venditore, il tuo agente pubblica e gestisce i tuoi template con il tuo abbonamento: non ne paga uno suo e non deposita cauzione. Quello che pubblica esce con il tuo @utente, senza contrassegno da agente, e passa dalla stessa revisione umana che se lo caricassi tu dal sito.

  • Requisito: il tuo abbonamento da venditore attivo. Se scade, le sue funzioni da venditore smettono di rispondere all'istante, esattamente come le tue.
  • Immagini e file: carica le immagini della galleria con image_upload_link e lo ZIP con zip_upload_link. Le immagini devono essere WebP e con proporzione 4:3 (tolleranza ±4 %; la misura consigliata è 1600x1200 px, la stessa che produce il ritaglio del sito). Il server non le ritaglia né le converte: quella che non rientra viene rifiutata all'invio.
  • Prova a vuoto: con lo ZIP già caricato, check_before_submit gli dice cosa direbbe l'invio senza spenderlo, con i problemi e cosa fare per ognuno. Non crea e non cambia nulla.
  • Pubblicare, correggere e aggiornare: submit_for_review con la scheda completa e, se lo rifiutano, resubmit_for_review corregge ciò che non andava senza crearne un altro. Per cambiarne uno già pubblicato, update_published_template manda solo ciò che cambia (e un nuovo ZIP se serve) alla stessa revisione, e quello pubblicato resta in vendita finché non viene approvato. Può anche mettere in pausa o ritirare i tuoi template e gestire i tuoi codici sconto.
  • Un freno: i suoi invii in revisione vanno uno alla volta, con almeno un minuto tra l'uno e l'altro contando tutti i tuoi agenti, e c'è un tetto di template del tuo account in attesa di revisione, in cui contano anche quelli che carichi tu dal sito. Se è pieno, deve aspettare che si risolvano.
  • Incassare: le tue vendite vengono pagate sul tuo wallet, come sempre. Prelevare quel denaro spetta solo a te, dal sito.

Come viene a sapere le cose

Il tuo agente non ha email: legge le tue notifiche con my_notifications. Lì vede gli acquisti confermati, il denaro sbloccato e i tuoi template in revisione, approvati o rifiutati. Conviene che le controlli ogni tanto.

Tu ricevi le email e le notifiche di sempre, perché tutto succede nel tuo account.

Il contrassegno di prova

Se hai intenzione di provare il percorso di acquisto da capo a fondo, puoi contrassegnare il tuo agente come account di prova da I miei agenti, con il tuo secondo fattore. Lo mettono e lo tolgono il suo proprietario o il team di Bernuvia; l'agente stesso non può mai farlo.

  • Il denaro è reale: si firma, si deposita, si rilascia e si rimborsa allo stesso modo, e la commissione viene applicata. Il download e il diritto alla disputa non cambiano in nulla.
  • Niente di ciò che nasce da un account contrassegnato conta in nessuna cifra: resta fuori dal catalogo e dalla ricerca, dalla media delle stelle e dal numero di recensioni, dal contatore di vendite, dai ricavi, dal peso di reputazione che ordina il catalogo di tutti, dalle metriche e dalla commissione di referral. La sua recensione, inoltre, non viene mostrata: resta fuori dalla lista del template e da quella del venditore, anche se Bernuvia la conserva e continua a vederla.
  • Un template di prova non viene pubblicato: niente dati strutturati né scheda social, e resta fuori dalla mappa del sito. La sua scheda si apre ancora dal suo indirizzo diretto, e chi l'ha comprato mantiene il suo download.
  • Il contrassegno si congela appena l'account muove denaro vero da una delle due parti, comprando o vendendo: da lì in poi non si mette né si toglie.

Quello che non può fare

Non è una promessa di buona condotta: queste funzioni non sono alla sua portata e il server gliele nega sempre, chiunque abbia la credenziale.

  • Prelevare i tuoi soldi. Né i tuoi guadagni né il tuo saldo: prelevare richiede la tua firma sul sito.
  • Usare il tuo wallet, o che firmiamo al posto suo. Bernuvia non conserva la sua chiave privata; il deposito lo firma lui con la sua e Bernuvia invia soltanto ciò che lui ha già firmato: il deposito con una sola firma e il ritiro di quella stessa autorizzazione.
  • Lasciare recensioni a tuo nome. Una recensione la scrive una persona che ha usato il template: se vuoi dire la tua, lo fai tu dal sito.
  • Creare agenti o credenziali, né toccare la tua email, la tua 2FA o i tuoi dati di accesso.
  • Anticipare un pagamento. Il denaro è nel contratto di escrow e nessuno, né una persona né un agente, lo sblocca prima del termine.
  • Entrare nel pannello di amministrazione. Anche se il tuo account ce l'ha, il tuo agente non eredita quell'accesso.
  • Operare da sospeso. Se sospendi l'agente, o se il tuo account è sospeso, smette di funzionare all'istante.

Questo articolo ti è stato utile?

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