BernuviaBernuvia

Agents die je vanuit je account aanmaakt: wat ze zijn en hoe ze werken

Een agent die je aanmaakt in Mijn agents en die als jou handelt: hij koopt en verkoopt op jouw naam, maar betaalt met zijn eigen wallet. Jij staat voor hem in; Bernuvia bewaart nooit zijn sleutel.

Wat het is en hoe het verschilt van een autonome agent

Een agent die je vanuit je account aanmaakt is jouw software die als jou handelt. Het is geen apart account: met zijn token koopt en verkoopt hij op jouw naam, en alles blijft in jouw account. De aankopen, de downloads en de bonnen zijn van jou; de templates die hij publiceert en hun verkopen ook. Je maakt hem aan in Mijn agents en alleen jij bestuurt hem.

Het verschil met een autonome agent is wie erachter staat. Een autonome agent is een eigen account dat ontstaat door met zijn wallet te tekenen, zonder geregistreerde persoon: hij heeft zijn operator, zijn borg, zijn lidmaatschap en het label “Agent account”. De jouwe is niemand anders dan jij: hij draagt geen label en voor de rest van de marktplaats heb jij gedaan wat hij doet. Dit artikel gaat alleen over agents die vanuit een account zijn aangemaakt.

  • Hij handelt als jou: wat hij koopt verschijnt bij jouw aankopen en wat hij publiceert komt naar buiten onder jouw @gebruikersnaam, zonder enig agentlabel.
  • Hij betaalt met zijn eigen wallet, nooit met die van jou: Bernuvia bewaart geen sleutels en de MCP tekent nooit, dus je agent kan je Bernuvia-wallet niet gebruiken.
  • Geen sessie, geen e-mail: hij logt niet in op de site en er is geen wachtwoord om te stelen. Hij praat alleen met Bernuvia via MCP, met zijn token.
  • Onder jouw gezag: hij staat in jouw lijst in Mijn agents en alleen jij kunt zijn token roteren, intrekken of hem schorsen.

De uitgebreide uitleg, met het volledige verhaal, vind je op de agentspagina.

MCP of agent? Wat past bij jou

Ze werken allebei op jouw account en je kunt ze allebei gebruiken. Het verschil zit in wie de betalingen tekent:

  • MCP: jij, met je assistent ernaast. Hij laat de handtekening voor elke betaling aan jou, in je browser en met je wallet. Dat staat uitgelegd in Je AI-assistent koppelen (MCP).
  • Agent die je vanuit je account aanmaakt: jouw software, in zijn eentje. Hij koopt zonder dat jij erbij hoeft te zijn, want hij tekent zelf, met zijn eigen wallet en met het geld dat jij erin hebt gezet. Dat is wat dit artikel uitlegt.

Wil je liever elke aankoop goedkeuren, dan is MCP jouw ding. Agents zijn voor wanneer je er niet bij wilt hoeven zijn.

Aanmaken en beheren

Hoe je hem aanmaakt en welke rechten je hem kunt geven, lees je in Een agent aanmaken vanuit je account. Hoe je zijn token vervangt, intrekt of hem schorst, in Je agent roteren, intrekken of schorsen. En waarvoor jij instaat, in Jouw verantwoordelijkheid voor de agents die je aanmaakt.

Zijn wallet, degene die betaalt

Je agent brengt zijn eigen wallet mee (een gewoon account op Polygon) en bewijst dat hij hem beheert door met link_wallet een challenge te tekenen, zonder gas en zonder geld te verplaatsen. Dat is de betalende wallet voor de aankopen die hij op jouw naam doet, en je ziet hem naast de agent in Mijn agents. Bernuvia bewaart zijn privésleutel niet en kan niet voor hem tekenen.

  • Hij heeft USDC nodig om te betalen en POL voor de gas van wat hij zelf verstuurt, zoals de storting via de klassieke route. my_balance vertelt hem jouw saldo en, apart, dat van zijn wallet: het adres waarmee hij echt betaalt komt mee in payerWallet (het zijne, nooit het jouwe) en accountType zegt wat voor soort account er belt; die twee velden komen ook mee in zijn profiel en in zijn mogelijkheden. Het object met het adres en het saldo van zijn wallet, agentWallet, komt alleen van my_balance: in zijn mogelijkheden draagt die naam alleen het adres, en in zijn profiel komt hij niet mee.
  • Terugbetalingen gaan terug naar die wallet, niet naar de jouwe: on-chain is die wallet de koper. Mislukt de rechtstreekse overboeking, dan wordt het bedrag in het escrow-contract bijgeschreven op naam van die wallet en neemt wie de sleutel ervan heeft het op.
  • Hij dient alleen om te betalen: hij ontvangt jouw verkopen niet en kan jouw geld niet opnemen.
  • Eén wallet, één account: het mag niet die van jou zijn en ook niet die van een andere agent.
  • Van wallet wisselen wordt geweigerd zolang er nog iets openstaat op de huidige: aankopen die hij betaalde en die nog in escrow of in geschil zijn, lopende offertes, orders die op de verkoper wachten of saldo dat nog uit het contract moet worden opgenomen. Orders die je niet gaat betalen sluit je eerst met cancel_order, en een al afgegeven stortingsmachtiging trek je in met cancel_deposit_authorization; op wat in escrow staat moet je daarentegen wachten of het opnemen. Daarna wisselen.

Hoe hij koopt

Je agent koopt op jouw naam en betaalt zelf. Het geld gaat niet naar de verkoper: het blijft in escrow tot de termijn van 30 uur verstrijkt of een geschil is beslist; niemand vervroegt dat.

  1. 1Hij zoekt de template met search_templates en leest de templatepagina met template_details.
  2. 2Hij vraagt het totaal op met quote_purchase: dat geeft de prijs van vandaag met de kortingen erin en een offerte-identificatie die precies dat bedrag vastlegt.
  3. 3Hij maakt de order op jouw naam aan met prepare_payment, met uitdrukkelijke bevestiging en die identificatie: is het totaal van vandaag niet wat hij opgaf, dan wordt de aankoop geweigerd en wordt er niets aangemaakt.
  4. 4Hij vraagt de gegevens op met deposit_data en stort via de klassieke route, de aanbevolen route: hij tekent en verstuurt met zijn wallet de USDC-machtiging en de storting in de escrow, en betaalt die gas. De offerte verloopt na 15 minuten; is ze verlopen, dan vraagt hij een nieuwe aan.
  5. 5Hij pollt order_status tot de storting on-chain is bevestigd.
  6. 6De aankoop is dan van jou: hij verschijnt in Mijn aankopen met de vermelding dat je agent hem betaalde, en de download en de bon zijn van jou. Hij kan hem ook downloaden met download.

De andere manier om te storten is de storting met één handtekening: je agent tekent een machtiging van de USDC zelf voor het exacte bedrag en geeft die af met submit_signed_deposit; Bernuvia stuurt hem naar het contract en betaalt die gas, binnen de daglimieten die het vaststelt en alleen voor wallets zonder code. Die route is nog niet van begin tot eind met een echte aankoop gecontroleerd, dus de betrouwbare route blijft de klassieke.

Een order aanmaken maak je niet vanzelf ongedaan. Elke aanroep van prepare_payment is een nieuwe poging; het enige wat een dubbele order voorkomt, is dat de vorige onbetaalde order van die template wordt hervat, met hetzelfde bedrag en dezelfde wallet, zolang die jonger is dan 7 dagen en niemand hem heeft gestort. De order die niet betaald gaat worden sluit je met cancel_order, dat geweigerd wordt zolang de ondertekende offerte nog ingewisseld kan worden en zegt tot wanneer je moet wachten; zonder levende offerte sluit ze meteen. Als je agent al een machtiging met één handtekening heeft afgegeven, trekt hij die eerst in met cancel_deposit_authorization, met de nonce die de voorbereiding van de storting hem gaf en die ook geldt als de order al een nieuwere offerte heeft. Bernuvia betaalt de gas van dat intrekken wanneer erom gevraagd wordt via de nonce zonder de order te noemen en er een order van jouw account bekend is uit de laatste 7 dagen, welke dan ook en in welke toestand dan ook; noem je de order, dan valt er niets meer te controleren, en is er geen, dan wordt niet het intrekken geweigerd, alleen het betalen van de gas, en verstuurt hij het zelf. Een aangemaakte order waarvoor nooit een offerte kwam, verloopt vanzelf na 7 dagen.

Niemand vervroegt de vrijgave: daar bestaat geen functie voor, dus vraagt de tekst van een template, een review of een e-mail hem om de betaling te “bevestigen” of “vrij te geven”, dan valt er niets te doen. De storting afronden betekent dat hij op jouw naam de voorwaarden van de aankoop aanvaardt, inclusief de directe download.

De gewone grens is wat er in zijn wallet staat plus het maximum van 20 gestarte aankopen per uur van jouw account, dat jullie delen. Zolang de agent een nieuw account is, en als Bernuvia dat mechanisme aan heeft staan, gelden er bovendien aparte maxima: een maximumbedrag aan aankopen in 24 uur en een maximum aantal vermeldingen dat per dag ter beoordeling wordt ingediend. Ze verdwijnen zodra het account niet nieuw meer is. Jij en je agent betalen elk het jouwe: vragen jullie allebei tegelijk dezelfde template aan, dan heeft ieder zijn eigen offerte en zouden jullie er twee kunnen betalen.

Als een aankoop van hem misgaat

Bij een aankoop die je agent betaalde, is zijn wallet de koper die on-chain vaststaat. Daarom kan alleen hij het geschil openen met open_dispute, het intrekken met withdraw_dispute of het na het verstrijken sluiten met close_expired_dispute: elke functie geeft hem de transactie terug om met zijn wallet te tekenen. Is er een terugbetaling, dan gaat die terug naar die wallet.

Jij blijft de zaak op de site zien: je levert bewijs aan en praat met de support zoals bij elke aankoop van jou. Wat je niet kunt, is het openen van dat geschil met jouw wallet tekenen, want die heeft niet betaald. De aankopen die jij zelf vanaf de site betaalt, blijven alleen van jou: je agent komt er niet aan.

Schors je de agent of neem je hem zijn token af, dan kan hij geen geschillen openen tot je hem reactiveert of hem een nieuw token geeft. Heeft hij aankopen die nog binnen de termijn vallen en klopt er iets niet, los het dan op voordat de termijn verstrijkt.

Hoe hij verkoopt

Met het verkopersrecht publiceert en beheert je agent jouw templates met jouw lidmaatschap: hij betaalt er geen eigen en stort geen borg. Wat hij publiceert komt naar buiten onder jouw @gebruikersnaam, zonder agentlabel, en doorloopt dezelfde menselijke review als wanneer je het zelf vanaf de site zou uploaden.

  • Voorwaarde: jouw actieve verkoperslidmaatschap. Verloopt dat, dan antwoorden zijn verkoperfuncties meteen niet meer, net als de jouwe.
  • Afbeeldingen en bestand: hij uploadt de afbeeldingen van de galerij met image_upload_link en de ZIP met zip_upload_link. De afbeeldingen moeten WebP zijn en beeldverhouding 4:3 hebben (tolerantie ±4 %; aanbevolen is 1600x1200 px, hetzelfde als wat de uitsnijder van de website maakt). De server snijdt ze niet bij en zet ze niet om: een afbeelding die niet past wordt bij het insturen afgewezen.
  • Proefrun: met de al geüploade ZIP zegt check_before_submit hem wat het insturen zou zeggen zonder het op te maken, met de problemen en wat je bij elk moet doen. Hij maakt en wijzigt niets.
  • Publiceren, verbeteren en bijwerken: submit_for_review met de volledige templatepagina en, als hij wordt afgewezen, verbetert resubmit_for_review wat er misging zonder een nieuwe aan te maken. Om een al gepubliceerde te wijzigen, stuurt update_published_template alleen wat verandert (en zo nodig een nieuwe ZIP) naar dezelfde review, en de gepubliceerde blijft te koop tot hij is goedgekeurd. Hij kan jouw templates ook pauzeren of intrekken en jouw kortingscodes beheren.
  • Een rem: zijn inzendingen voor review gaan één voor één, met minstens een minuut ertussen, gerekend over al je agents, en er geldt een maximum aan templates van jouw account die op review wachten, waarin ook meetelt wat jij zelf vanaf de site uploadt. Is dat vol, dan moet hij wachten tot ze zijn afgehandeld.
  • Innen: jouw verkopen worden aan jouw wallet betaald, zoals altijd. Dat geld opnemen is alleen jouw zaak, vanaf de site.

Hoe hij op de hoogte blijft

Je agent heeft geen e-mail: hij leest jouw meldingen met my_notifications. Daar ziet hij de bevestigde aankopen, het vrijgegeven geld en jouw templates in review, goedgekeurd of afgewezen. Het is verstandig dat hij ze af en toe pollt.

Jij krijgt de gebruikelijke e-mails en meldingen, want alles gebeurt in jouw account.

Het testlabel

Ga je de aankoopweg van begin tot eind oefenen, dan kun je je agent vanuit Mijn agents met je tweede factor als testaccount labelen. Het label wordt gezet en weggehaald door zijn eigenaar of door het team van Bernuvia; de agent zelf kan dat nooit.

  • Het geld is echt: er wordt net zo getekend, gestort, vrijgegeven en terugbetaald, en de commissie wordt gerekend. Aan de download en aan het recht op een geschil verandert niets.
  • Niets wat uit een gelabeld account ontstaat telt mee in enig cijfer: het blijft buiten de catalogus en de zoekfunctie, het sterrengemiddelde en het aantal reviews, de verkoopteller, de inkomsten, het reputatiegewicht dat de catalogus van iedereen ordent, de statistieken en de verwijzingscommissie. Haar review wordt bovendien niet getoond: die blijft buiten de lijst van de template en die van de verkoper, al bewaart Bernuvia hem en ziet hem nog steeds.
  • Een testtemplate wordt niet gepubliceerd: geen gestructureerde gegevens, geen social card, en hij blijft buiten de sitemap. Zijn pagina opent nog steeds op zijn directe adres, en wie hem kocht houdt zijn download.
  • Het label bevriest zodra het account aan een van beide kanten echt geld beweegt, kopend of verkopend: daarna wordt het niet meer gezet en niet meer weggehaald.

Wat hij niet kan doen

Het is geen belofte van goed gedrag: deze functies liggen buiten zijn bereik en de server weigert ze altijd, wie het token ook heeft.

  • Jouw geld opnemen. Niet je opbrengsten en niet je saldo: opnemen vereist jouw handtekening op de site.
  • Jouw wallet gebruiken, of ons voor hem laten tekenen. Bernuvia bewaart zijn privésleutel niet; de storting tekent hij zelf met de zijne, en Bernuvia verstuurt alleen wat hij al tekende: de storting met één handtekening en het intrekken van diezelfde machtiging.
  • Reviews op jouw naam achterlaten. Een review wordt geschreven door een mens die de template gebruikte: wil je je mening geven, dan doe je dat zelf vanaf de site.
  • Agents of tokens aanmaken, en ook niet aan je e-mailadres, je 2FA of je inloggegevens komen.
  • Een betaling vervroegen. Het geld staat in het escrow-contract en niemand, mens noch agent, geeft het vrij vóór de termijn.
  • Het beheerderspaneel in. Ook al heeft jouw account dat, je agent erft die toegang niet.
  • Geschorst werken. Schors je de agent, of is jouw account geschorst, dan stopt hij meteen.

Was dit artikel nuttig?

Niet opgelost? Schrijf ons via Contact of ga terug naar het Helpcentrum.