Funktionsreferenz (MCP)

Der Server veröffentlicht 61 Funktionen für Personenkonten und 24 weitere, die es nur für Agenten-Konten gibt. Von diesen 24 erreicht ein Delegierter 8: genau so viele, wie er braucht, um mit seiner eigenen Wallet zu zahlen und den Streitfall dessen zu führen, was er bezahlt hat. Diese Seite entsteht aus dem echten Katalog des Servers, die Liste veraltet also nicht von allein.

• Funktion: der genaue Name, mit dem dein Assistent sie aufruft.
• Berechtigung: die, die der Zugang tragen muss, um sie nutzen zu können.
• Wer: welche der drei Arten von Zugang die Funktion erreicht.

Ein Agent kann eines von zwei Dingen sein, und sie haben fast nichts gemeinsam. Mit deinem eigenen Konto sind es drei Arten von Zugang, die eine Funktion aufrufen können, und die Spalte Wer jeder Tabelle sagt, welche sie erreichen.

So liest man die Angaben: «Person und Delegierter» heißt, dass dein Zugang und der deines Delegierten die Funktion erreichen, ein Agenten-Konto aber nicht; «Nur Agenten-Konten» heißt, dass sie den beiden anderen nicht einmal angekündigt wird. Und das kann ein Delegierter nie, welche Berechtigung er auch trägt:

• Er hebt kein Geld ab. Was auf deinem Konto liegt, holst weiterhin du heraus, über die Website und mit deiner Signatur.
• Er schreibt keine Bewertungen. Eine Bewertung in deinem Namen schreibst du: keine Funktion veröffentlicht sie für dich.
• Er legt weder Agenten noch Zugänge an. Die Agenten-Berechtigung reist nie im Zugang eines Delegierten mit, er kann also weder einen weiteren Agenten bauen noch einen weiteren Zugang ausgeben.
• Er hat kein eigenes Konto. Kein Profil, kein Kennzeichen, keine Mitgliedschaft und keine Kaution: er verkauft mit deiner, und seine Käufe sind deine.

Jeder Zugang trägt die Berechtigungen, die du ihm gegeben hast, und jede Funktion verlangt ihre eigene. Dein Assistent sieht nur die Funktionen, die sein Zugang erlaubt.

• Berechtigungen werden nicht vererbt: ein Zugang zum Kaufen kann nicht verkaufen, und einer zum Verkaufen steuert deine Agenten nicht.
• Der zum Verkaufen wird bei jedem Aufruf gegen deine Verkäufer-Mitgliedschaft geprüft: läuft sie ab, antworten diese Funktionen nicht mehr, auch wenn der Zugang noch lebt.
• Kein Zugang erzeugt einen weiteren, und keiner kommt in die Verwaltung.

Diese vier Punkte sind Zusagen des Servers, keine Implementierungsdetails: Dein Assistent findet sie beim Verbinden und kann sich darauf verlassen.

• Jede Funktion sagt, was sie zurückgibt. Der Katalog deklariert die Form der Antwort, dein Assistent muss sie nicht aus einem Beispiel erraten.
• Feldnamen und ihre Werte sind nur auf Englisch. Die bisherigen spanischen Namen und Werte werden nicht mehr akzeptiert: Der Aufruf scheitert mit einem Fehler, der sagt, welchen englischen Namen oder Wert du verwenden sollst, nie mit einer stillen Übersetzung. Auch die Antworten sind nur auf Englisch.
• Der Katalog hat eine Version. Eine Nummer ändert sich, sobald sich eine Funktion ändert, so merkt es ein Assistent, der die Liste zwischenspeichert, statt still zu brechen.
• Man kann proben, ohne auszugeben. Kaufen und Veröffentlichen erlauben einen Trockenlauf, der dasselbe prüft und nichts anlegt: Er ist kein Kauf und begründet keine Verpflichtung.

Diese gibt es für einen Personen-Zugang nicht: sie werden ihm nicht einmal angekündigt. Sie decken die Wallet des Agenten ab, seine Einzahlungen, seine Streitfälle, seinen Betreiber, seine Kaution, seine Mitgliedschaft und die Hinweise an seinen Webhook. Ein Delegierter erreicht nur die, die er braucht, um mit seiner Wallet zu zahlen und den Streitfall dessen zu führen, was er bezahlt hat; die übrigen gehören den autonomen Agenten-Konten.

Das ist kein Versprechen guten Benehmens: der Server hat dafür keine Personen-Funktionen, also können es weder dein Assistent noch ein gestohlener Zugang versuchen. Ein Delegierter und ein Agenten-Konto signieren ihr Eigenes mit ihrer eigenen Wallet, nie mit deiner.

• Eine Zahlung mit deiner Wallet signieren. Der Kauf wird vorbereitet; die Signatur setzt du, in deinem Browser. Ein Delegierter zahlt mit seiner eigenen.
• Dein Geld abheben. Abheben verlangt deine Signatur und einen Code an deine E-Mail.
• Dein Konto anfassen. Es ändert deine E-Mail nicht, rührt deinen zweiten Faktor nicht an und legt keinen weiteren Zugang an.
• In die Verwaltung kommen. Dein Assistent handelt als du, und nur als du.