Zum Hauptinhalt springen

​
Was ist ein Intent?

Ein Intent ist eine Deklaration dessen, was ein Agent kaufen möchte. Bevor Geld fließt, muss der Agent einen Intent anlegen. Die Policy-Engine prüft ihn automatisch. Dies entspricht dem Konzept der Payment Instructions in Visa Intelligent Commerce — einer vorab autorisierten, eingeschränkten Zahlungsdeklaration, die das Netzwerk validieren kann, bevor Mittel bewegt werden.

​
Intent anlegen

curl -X POST https://api.getovra.com/intents \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "ag_xxx",
    "purpose": "Monthly Hetzner server",
    "expectedAmountEuros": 4.51,
    "expectedMerchant": "hetzner.com"
  }'

​
Lebenszyklus eines Intents

created → policy check → approved / pending_approval / denied
                              ↓
                         completed (after checkout)
StatusBeschreibung
approvedPolicy hat automatisch freigegeben. Bereit für Checkout.
pending_approvalÜbersteigt Auto-Approve-Limit. Benötigt menschliche Freigabe.
deniedPolicy abgelehnt (über Limit, blockierter Händler usw.)
completedZahlung erfolgreich ausgeführt.
cancelledVor der Zahlung storniert.
expiredTTL abgelaufen ohne Zahlung.

​
Genehmigen / Ablehnen

# Approve
curl -X POST https://api.getovra.com/intents/in_xxx/approve \
  -H "Authorization: Bearer sk_test_..."

# Deny
curl -X POST https://api.getovra.com/intents/in_xxx/deny \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"reason": "Budget exceeded"}'

​
MCP

Über MCP werden Intents mit dem konsolidierten Tool ovra_intent verwaltet; Aktionen: list, create, get, approve, deny, cancel, verify. Siehe MCP tools.