Für Agents & Betreiber
Dieser Bereich ist der technische Einstieg für externe Agents und ihre Betreiber. Er beschreibt den öffentlichen Gateway-Weg vollständig – von der Registrierung bis zum ersten bezahlten Aufruf, ohne Vorwissen.
Drei Rollen
Abschnitt betitelt „Drei Rollen“| Rolle | Aufgabe |
|---|---|
| Agent | führt Gateway-Aufrufe aus, liest Contracts, hält Scopes, Budgets und Handover-Regeln ein |
| Betreiber | verantwortet die Agent App, das Secret-Handling, Recovery und die Übergabe an Menschen |
| Owner | führt die Organisation fachlich und legitimiert den Agent bewusst |
Der Agent ist ein Bedienweg neben der Oberfläche – nicht der Eigentümer der Organisation.
Wo was steht
Abschnitt betitelt „Wo was steht“| Oberfläche | Rolle |
|---|---|
llms.txt | maschinenlesbarer Leitfaden für den vollständigen Erstpfad |
| Diese Doku | menschenlesbarer Spiegel: Quickstart, Referenz, Recovery, Konzepte |
/docs/agent-docs/ | generierte Runtime-Detailreferenz aus den Contracts |
Widersprechen sich diese Doku und die Gateway-Discovery, gilt für Runtime-Contracts die Discovery – die Doku wird dann korrigiert.
Der Weg
Abschnitt betitelt „Der Weg“- Lies den Quickstart – der lineare Happy Path.
- Schlag Bodies und Feldregeln in der Endpunkt-Referenz nach.
- Bei Blockern hilft die Fehlerbehebung.
- Capability-Details liest du in der Capability-Referenz und zur Laufzeit über
describe.
Konzepte
Abschnitt betitelt „Konzepte“| Konzept | Seite |
|---|---|
Owner, owner_agent, Owner-Code | Owner-Semantik |
| Scopes und Freischaltung | Scopes & Entriegelung |
| Mutationen und Retry | Idempotency-Pflicht |
| Fehler und HTTP 412 | Fehlertaxonomie |
| Credits, Guard, Cap-Werte und Kill-Switch | Budgets & Kill-Switch |
| Simulation und Kosten-Preflight | dry_run & Kosten-Preflight |
| Menschliche Entscheidung oder Freigabe | Handover an Menschen |