Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.getovra.com/llms.txt

Use this file to discover all available pages before exploring further.

Ein Agent ist eine Stripe-shaped Resource: er besitzt Karten, Tokens, Transaktionen und genau eine Policy zur Zeit. Agents sind für AI-Use typisiert — sie tragen einen purpose, optionales framework (openai-assistants, anthropic-sdk, langgraph, crewai) und optionale Capabilities damit Dashboard und Audit-Trail beschreiben können wofür sie da sind.

​
Das Agent-Modell

FeldBeschreibung
idag_*
nameDisplay-Name
policyIdGenau eine Policy, mutable aber immer present
profile.purposeRequired. Freitext — beschreibt was der Agent tut.
profile.frameworkOptional — z.B. langgraph
profile.capabilitiesOptionales string[] — was der Agent kann
profile.descriptionOptional längere Beschreibung
profile.departmentOptionales Cost-Center-Tag
profile.ownerContactOptionaler Eskalations-Kontakt
statusactive · suspended · archived

​
Minimal-Create

Der Dashboard-Create-Drawer (und der dokumentierte Happy-Path) ist name + purpose + policyId. Andere Profile-Felder sind optional, hinter einem „Advanced”-Toggle versteckt. 
curl -X POST https://api.getovra.com/agents \
  -H "Authorization: Bearer $OVRA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "name": "procurement-bot",
    "policyId": "po_default_...",
    "profile": { "purpose": "Bürobedarf unter EUR 100 kaufen" }
  }'

​
Lebenszyklus

EndpointZweck
POST /agentsErstellen (idempotent)
GET /agents/:idLesen
PATCH /agents/:idUpdate name / profile / status
DELETE /agents/:idArchivieren (kaskadiert über Karten + Tokens)
POST /agents/:id/freeze / /unfreezePausieren / Resumieren
POST /agents/:id/tokensAgent-scoped Token (at_*) ausstellen

​
Agent-Tokens

Agents können eigene scoped Tokens (at_*) halten. Ein Token ist an einen Agent gebunden, trägt typisierte Permissions und kann optional einen Spend-Cap haben (via Delegation). 
curl -X POST https://api.getovra.com/agents/ag_.../tokens \
  -H "Authorization: Bearer $OVRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "production-runtime",
    "scopes": ["intents.write", "checkout.write"],
    "expiresInDays": 90
  }'
at_*-Tokens in deiner Runtime statt deinen org-level sk_*-Key teilen. Cross-Agent-Reads mit at_*-Token returnen 403 E_AGENT_ISOLATION — Strict Isolation ist eine der Sacred Invariants.

​
Signing-Keys (Phase-8-Prep)

Pro Agent wird async ein Ed25519-Keypair provisioniert. Die Public-JWK wird exposed an: 
GET /.well-known/agent-jwks/{agent_id}
Das ist Wiring für Visa Trusted Agent Protocol (RFC-9421 HTTP Message Signatures). Kein Outbound-Signing aktiv in v1.2 — Code landet sobald der erste TAP-aware Merchant es verlangt.

​
Webhooks

  • agent.created
  • agent.frozen
  • agent.unfrozen

​
Plan-Tier-Limits

PlanAgents
Free1
Starter5
Business10
EnterpriseUnbegrenzt

​
Surfaces

SurfaceCapability
REST/agents, /agents/:id/tokens
SDKovra.agents.*
MCPovra_agent (admin-side)
Dashboard/dashboard/agents

​
Weiter

Karten

Karten an einen Agent binden.

Policies

Definieren was ein Agent ausgeben darf.

Intents

Die Approval-Primitive mit der jede Belastung beginnt.

Bezahlung

Wie ein Agent tatsächlich zahlt.