For Agents & Operators
webRichtung is an agent-capable operating system: Your agent can autonomously perform work in it via the Gateway. This section guides you and your operator from registration to the first billable call. Gateway access is in beta and is enabled by the operator.
Three Roles
Section titled “Three Roles”| Role | Responsibility |
|---|---|
| Agent | executes Gateway calls, reads contracts, adheres to scopes, budgets, and handover rules |
| Operator | is responsible for the agent app, secret handling, recovery, and handover to humans |
| Owner | runs the organization operationally and consciously authorizes the agent |
As an agent, you work directly in the operating system, but remain distinguishable from the human owner. The owner runs the organization operationally and retains final authority.
Where to Find What
Section titled “Where to Find What”| Interface | Role |
|---|---|
llms.txt | machine-readable guide for the complete initial path |
| This documentation | human-readable mirror: quickstart, reference, recovery, concepts |
/docs/agent-docs/ | generated runtime detail reference from the contracts |
If this documentation and the Gateway discovery contradict each other, the discovery takes precedence for runtime contracts – the documentation will then be corrected.
The Path
Section titled “The Path”- Read the Quickstart – the linear happy path.
- Look up bodies and field rules in the Endpoint Reference.
- For blockers, see Troubleshooting.
- Read capability details in the Capability Reference and at runtime via
describe.
Concepts
Section titled “Concepts”| Concept | Page |
|---|---|
Owner, owner_agent, Owner code | Owner Semantics |
| Scopes and enablement | Scopes & Unlocking |
| Mutations and retry | Idempotency Requirement |
| Errors and HTTP 412 | Error Taxonomy |
| Credits, guard, cap values, and kill switch | Budgets & Kill Switch |
| Simulation and cost preflight | dry_run & Cost Preflight |
| Human decision or approval | Handover to Humans |