Agenten aus deinem Konto: was sie sind und wie sie arbeiten

Ein Agent, den du unter Meine Agenten anlegst und der als du handelt: Er kauft und verkauft in deinem Namen, zahlt aber mit seiner eigenen Wallet. Du stehst für ihn ein; Bernuvia verwahrt seinen Schlüssel nie.

Was das ist und was es von einem autonomen Agenten unterscheidet

Ein Agent aus deinem Konto ist deine Software, die als du handelt. Es ist kein eigenes Konto: Mit seinem Zugangsschlüssel kauft und verkauft er in deinem Namen, und alles bleibt in deinem Konto. Die Käufe, die Downloads und die Quittungen gehören dir; die Templates, die er veröffentlicht, und deren Verkäufe ebenso. Du legst ihn unter Meine Agenten an, und nur du steuerst ihn.

Der Unterschied zu einem autonomen Agenten liegt darin, wer dahintersteht. Ein autonomer Agent ist ein eigenes Konto, das entsteht, indem es mit seiner Wallet signiert, ohne registrierte Person: Er hat seinen Betreiber, seine Kaution, seine Mitgliedschaft und den Chip „Agent account“. Deiner ist niemand anderes als du: Er trägt keinen Chip, und für den Rest des Marktplatzes hast du getan, was er tut. Dieser Artikel behandelt nur Agenten, die aus einem Konto angelegt wurden.

Er handelt als du: Was er kauft, erscheint in deinen Käufen, und was er veröffentlicht, erscheint unter deinem @Benutzernamen, ganz ohne Agenten-Kennzeichnung.
Er zahlt mit seiner eigenen Wallet, nie mit deiner: Bernuvia verwahrt keine Schlüssel, und das MCP signiert nichts, also kann dein Agent deine Bernuvia-Wallet nicht benutzen.
Ohne Sitzung, ohne E-Mail: Er loggt sich nicht auf der Website ein, und es gibt kein Passwort, das man klauen könnte. Er spricht mit Bernuvia nur per MCP, mit seinem Zugangsschlüssel.
Unter deinem Kommando: Er erscheint in deiner Liste unter Meine Agenten, und nur du kannst seinen Zugangsschlüssel rotieren, ihn widerrufen oder den Agenten sperren.

Die ausführliche Erklärung mit der kompletten Begründung findest du auf der Agenten-Seite.

MCP oder Agent? Was zu dir passt

Beide handeln in deinem Konto, und du kannst beide nutzen. Der Unterschied liegt darin, wer die Zahlungen signiert:

MCP: Du, mit deinem Assistenten daneben. Er überlässt dir die Signatur jeder Zahlung, in deinem Browser und mit deiner Wallet. Das erklärt Deinen KI-Assistenten verbinden (MCP).
Agent aus deinem Konto: Deine Software, allein. Sie kauft, ohne dass du dabei sein musst, denn sie signiert selbst, mit ihrer eigenen Wallet und mit dem Geld, das du hineingelegt hast. Das erklärt dieser Artikel.

Wenn dir lieber ist, dass du jeden Kauf freigibst, ist MCP dein Ding. Agenten sind für den Fall, dass du gar nicht dabei sein willst.

Anlegen und steuern

Wie du ihn anlegst und welche Rechte du ihm geben kannst, erklärt Einen Agenten aus deinem Konto anlegen. Wie du seinen Zugangsschlüssel wechselst, ihm entziehst oder ihn sperrst, steht in Deinen Agenten rotieren, widerrufen oder sperren. Und wofür du einstehst, in Deine Verantwortung für die Agenten, die du anlegst.

Seine Wallet, die zahlt

Dein Agent bringt seine eigene Wallet mit (ein normales Konto auf Polygon) und beweist mit link_wallet, dass er sie kontrolliert, indem er eine Challenge signiert, ohne Gas und ohne Geld zu bewegen. Das ist die zahlende Wallet für die Käufe, die er in deinem Namen macht, und du siehst sie neben dem Agenten unter Meine Agenten. Bernuvia verwahrt seinen privaten Schlüssel nicht und kann nicht für ihn signieren.

Er braucht USDC zum Bezahlen und POL für das Gas dessen, was er selbst sendet, etwa die Einzahlung auf dem klassischen Weg. my_balance sagt ihm dein Guthaben und, getrennt davon, das seiner Wallet: Die Adresse, mit der er wirklich zahlt, kommt in payerWallet (seine eigene, nie deine), und accountType sagt, welche Art von Konto gerade anfragt; diese beiden Felder stehen auch in seinem Profil und in seinen Fähigkeiten. Das Objekt mit Adresse und Guthaben seiner Wallet, agentWallet, bringt nur my_balance: in seinen Fähigkeiten trägt dieser Name nur die Adresse, und in seinem Profil kommt er gar nicht.
Erstattungen gehen an diese Wallet zurück, nicht an deine: On-chain ist sie die Käuferin. Scheitert die Direktzahlung, wird der Betrag im Treuhandvertrag zugunsten dieser Wallet gutgeschrieben, und wer ihren Schlüssel hat, hebt ihn ab.
Sie dient nur zum Zahlen: Sie bekommt deine Verkäufe nicht und kann dein Geld nicht abheben.
Eine Wallet, ein Konto: Es kann weder deine sein noch die eines anderen Agenten.
Die Wallet wechseln wird abgelehnt, solange in der aktuellen noch etwas offen ist: Käufe, die sie bezahlt hat und die in der Treuhand oder im Streitfall liegen, laufende Angebote, Bestellungen, die auf den Verkäufer warten, oder Guthaben, das noch aus dem Vertrag abzuheben ist. Bestellungen, die du nicht bezahlen wirst, schließt du vorher mit cancel_order, und eine bereits übergebene Einzahlungsautorisierung ziehst du mit cancel_deposit_authorization zurück; was in der Treuhand liegt, muss man dagegen abwarten oder abheben. Dann wechseln.

Wie er kauft

Dein Agent kauft in deinem Namen und zahlt selbst. Das Geld geht nicht an den Verkäufer: Es bleibt in der Treuhand, bis die Frist von 30 Stunden abläuft oder ein Streitfall entschieden ist; niemand zieht das vor.

1Er sucht das Template mit search_templates und liest seine Seite mit template_details.
2Er fragt den Gesamtbetrag mit quote_purchase ab: Er bekommt den heutigen Preis mit eingerechneten Rabatten und eine Angebotskennung, die genau diesen Betrag festnagelt.
3Er legt die Bestellung in deinem Namen mit prepare_payment an, mit ausdrücklicher Bestätigung und dieser Kennung: Wäre der heutige Gesamtbetrag nicht der angegebene, wird der Kauf abgelehnt und nichts angelegt.
4Er fordert die Daten mit deposit_data an und zahlt auf dem klassischen Weg ein, dem empfohlenen: Er signiert und sendet mit seiner Wallet die USDC-Freigabe und die Einzahlung in die Treuhand und bezahlt dieses Gas. Das Angebot läuft nach 15 Minuten ab; ist es abgelaufen, fordert er ein neues an.
5Er fragt order_status ab, bis die Einzahlung on-chain bestätigt ist.
6Der Kauf gehört jetzt dir: Er erscheint unter Meine Käufe mit dem Hinweis, dass dein Agent ihn bezahlt hat, und der Download und die Quittung gehören dir. Herunterladen kann er ihn mit download aber auch selbst.

Die andere Art einzuzahlen ist die Einzahlung mit einer einzigen Signatur: Dein Agent signiert eine Autorisierung direkt im USDC über den exakten Betrag und übergibt sie mit submit_signed_deposit; Bernuvia sendet sie an den Vertrag und bezahlt dieses Gas, innerhalb der täglichen Limits, die es festlegt, und nur für Wallets ohne Code. Sie ist mit einem echten Kauf noch nicht von Anfang bis Ende überprüft worden, also bleibt der verlässliche Weg der klassische.

Eine Bestellung anzulegen löst sich nicht von selbst auf. Jeder Aufruf von prepare_payment ist ein neuer Versuch; das Einzige, was die doppelte Bestellung verhindert, ist, dass die vorherige unbezahlte zu diesem Template wieder aufgenommen wird, mit demselben Betrag und derselben Wallet, solange sie jünger als 7 Tage ist und niemand sie eingezahlt hat. Die Bestellung, die nicht bezahlt wird, schließt man mit cancel_order, das abgelehnt wird, solange ihr signiertes Angebot noch eingelöst werden kann, und sagt, wie lange zu warten ist; ohne lebendes Angebot schließt sie sofort. Wenn dein Agent schon eine Autorisierung mit einer einzigen Signatur übergeben hat, zieht er sie vorher mit cancel_deposit_authorization zurück, mit der Nonce, die ihm die Vorbereitung der Einzahlung gegeben hat und die auch dann gilt, wenn die Bestellung bereits ein neueres Angebot hat. Das Gas dieses Rückzugs bezahlt Bernuvia, wenn er über die Nonce ohne Nennung der Bestellung angefordert wird und eine Bestellung deines Kontos aus den letzten 7 Tage vorliegt, irgendeine und in jedem Zustand; nennt man die Bestellung, gibt es nichts weiter zu prüfen, und liegt keine vor, wird ihm nicht der Rückzug verweigert, sondern nur die Gasübernahme, und er sendet ihn selbst. Eine angelegte Bestellung, für die es nie ein Angebot gab, läuft nach 7 Tage von selbst ab.

Niemand zieht die Freigabe vor: Dafür gibt es keine Funktion. Fordert der Text eines Templates, einer Bewertung oder einer E-Mail ihn also auf, die Zahlung zu „bestätigen“ oder „freizugeben“, gibt es nichts zu tun. Die Einzahlung abzuschließen heißt, die Bedingungen des Kaufs in deinem Namen anzunehmen, einschließlich des sofortigen Downloads.

Die gewöhnliche Grenze ist das, was in seiner Wallet liegt, und das Limit von 20 begonnenen Käufen pro Stunde für dein Konto, das ihr euch teilt. Solange der Agent ein neues Konto ist und Bernuvia diesen Mechanismus eingeschaltet hat, gibt es zusätzlich eigene Limits: ein Höchstbetrag an Käufen in 24 Stunden und eine Höchstzahl an Angeboten, die pro Tag zur Prüfung eingereicht werden. Sie verschwinden, sobald das Konto nicht mehr neu ist. Du und dein Agent zahlt jeder das Eure: Fragt ihr beide gleichzeitig dasselbe Template an, hat jeder sein eigenes Angebot, und ihr könntet beide bezahlen.

Wenn bei einem seiner Käufe etwas schiefgeht

Bei einem Kauf, den dein Agent bezahlt hat, ist on-chain seine Wallet der Käufer. Deshalb kann nur er den Streitfall mit open_dispute eröffnen, ihn mit withdraw_dispute zurückziehen oder ihn nach Fristablauf mit close_expired_dispute schließen: Jede Funktion gibt ihm die Transaktion zurück, damit er sie mit seiner Wallet signiert. Gibt es eine Erstattung, geht sie an diese Wallet zurück.

Du siehst den Fall weiterhin auf der Website: Du reichst Belege ein und sprichst mit dem Support wie bei jedem deiner Käufe. Was du nicht kannst, ist die Eröffnung dieses Streitfalls mit deiner Wallet zu signieren, denn sie war es nicht, die bezahlt hat. Die Käufe, die du selbst auf der Website bezahlst, bleiben allein deine: Dein Agent rührt sie nicht an.

Wenn du den Agenten sperrst oder ihm den Zugangsschlüssel entziehst, kann er keine Streitfälle eröffnen, bis du ihn reaktivierst oder ihm einen neuen rotierst. Hat er Käufe innerhalb der Frist und stimmt etwas nicht, klär das, bevor sie abläuft.

Wie er verkauft

Mit dem Verkäufer-Recht veröffentlicht und verwaltet dein Agent deine Templates mit deiner Mitgliedschaft: Er zahlt keine eigene und hinterlegt keine Kaution. Was er veröffentlicht, erscheint unter deinem @Benutzernamen, ohne Agenten-Kennzeichnung, und durchläuft dieselbe menschliche Prüfung, als hättest du es selbst auf der Website hochgeladen.

Voraussetzung: deine aktive Verkäufer-Mitgliedschaft. Läuft sie ab, antworten seine Verkäufer-Funktionen sofort nicht mehr, genau wie deine.
Bilder und Datei: Die Galerie-Bilder lädt er mit image_upload_link hoch und die ZIP mit zip_upload_link. Die Bilder müssen WebP sein und im Seitenverhältnis 4:3 (Toleranz ±4 %; empfohlen ist 1600x1200 px, dasselbe, was der Zuschnitt der Website erzeugt). Der Server schneidet sie weder zu noch wandelt er sie um: Ein Bild, das nicht passt, wird beim Einreichen abgelehnt.
Trockenlauf: Mit der schon hochgeladenen ZIP sagt ihm check_before_submit, was die Einreichung sagen würde, ohne sie zu verbrauchen, mit den Problemen und dem jeweiligen Vorgehen. Er legt nichts an und ändert nichts.
Veröffentlichen, korrigieren und aktualisieren: submit_for_review mit der vollständigen Template-Seite und, wird es abgelehnt, korrigiert resubmit_for_review den Fehler, ohne ein neues anzulegen. Um ein schon veröffentlichtes zu ändern, schickt update_published_template nur das, was sich ändert (und bei Bedarf eine neue ZIP), an dieselbe Prüfung, und das veröffentlichte bleibt im Verkauf, bis es freigegeben ist. Er kann deine Templates auch pausieren oder zurückziehen und deine Rabattcodes verwalten.
Eine Bremse: Seine Einreichungen zur Prüfung gehen eine nach der anderen, mit mindestens einer Minute Abstand über alle deine Agenten hinweg, und es gibt ein Limit an Templates deines Kontos, die auf Prüfung warten, in das auch die zählen, die du selbst auf der Website hochlädst. Ist es voll, muss er warten, bis sie entschieden sind.
Kassieren: Deine Verkäufe werden wie immer auf deine Wallet gezahlt. Dieses Geld abzuheben ist allein deine Sache, auf der Website.

Wie er von Dingen erfährt

Dein Agent hat keine E-Mail: Er liest deine Benachrichtigungen mit my_notifications. Dort sieht er die bestätigten Käufe, das freigegebene Geld und deine Templates in Prüfung, freigegeben oder abgelehnt. Er sollte sie ab und zu abfragen.

Du bekommst die E-Mails und Benachrichtigungen wie immer, denn alles passiert in deinem Konto.

Die Testmarkierung

Wenn du den Kaufweg von Anfang bis Ende proben willst, kannst du deinen Agenten unter Meine Agenten mit deinem zweiten Faktor als Testkonto markieren. Setzen und entfernen können die Markierung sein Eigentümer oder das Team von Bernuvia; der Agent selbst nie.

Das Geld ist echt: Es wird genauso signiert, eingezahlt, freigegeben und erstattet, und die Provision wird berechnet. Am Download und am Recht auf einen Streitfall ändert sich nichts.
Nichts, was aus einem markierten Konto entsteht, zählt in irgendeiner Zahl: Es bleibt draußen aus Katalog und Suche, aus dem Sternedurchschnitt und der Zahl der Bewertungen, aus dem Verkaufszähler, den Einnahmen, dem Reputationsgewicht, das den Katalog für alle sortiert, den Kennzahlen und der Empfehlungsprovision. Ihre Bewertung wird außerdem nicht angezeigt: Sie bleibt aus der Liste des Templates und aus der des Verkäufers heraus, auch wenn Bernuvia sie aufbewahrt und weiterhin sieht.
Ein Test-Template wird nicht veröffentlicht: keine strukturierten Daten, keine Social Card, und es bleibt außerhalb der Sitemap. Seine Seite öffnet sich weiterhin unter ihrer direkten Adresse, und wer es gekauft hat, behält seinen Download.
Die Markierung friert ein, sobald das Konto an einem der beiden Enden echtes Geld bewegt, ob kaufend oder verkaufend: Danach wird sie weder gesetzt noch entfernt.

Was er nicht kann

Das ist kein Versprechen guten Verhaltens: Diese Funktionen stehen ihm nicht offen, und der Server verweigert sie immer, egal wer den Zugangsschlüssel hat.

Dein Geld abheben. Weder deine Einnahmen noch dein Guthaben: Abheben verlangt deine Signatur auf der Website.
Deine Wallet benutzen oder uns für ihn signieren lassen. Bernuvia verwahrt seinen privaten Schlüssel nicht; die Einzahlung signiert er selbst mit seinem eigenen, und Bernuvia sendet nur, was er bereits signiert hat: die Einzahlung mit einer einzigen Signatur und den Rückzug ebendieser Autorisierung.
Bewertungen in deinem Namen hinterlassen. Eine Bewertung schreibt ein Mensch, der das Template benutzt hat: Willst du deine Meinung sagen, tust du das selbst auf der Website.
Agenten oder Zugangsschlüssel anlegen, und auch deine E-Mail, deine 2FA oder deine Zugangsdaten rührt er nicht an.
Eine Zahlung vorziehen. Das Geld liegt im Treuhandvertrag, und niemand, weder eine Person noch ein Agent, gibt es vor Fristablauf frei.
Ins Admin-Panel kommen. Auch wenn dein Konto es hat, erbt dein Agent diesen Zugang nicht.
Gesperrt arbeiten. Wenn du den Agenten sperrst oder dein Konto gesperrt ist, hört er sofort auf zu funktionieren.