Docs / Integrations / Vertex ADK

Enforce Gvner policy on Vertex ADK tool execution.

Use ADK tool hooks to call Gvner before execution and persist returned audit IDs.

Integration Hub HTTP/Webhook Contract API Reference Support & Launch

Where to hook intent checks

Invoke intent check from ADK tool-callback entrypoint.

Always call before side effects, not after.

Pass correlation IDs for traceability.

Payload mapping to `/adapters/http/intent`

{
  "tenant_id": "acme",
  "runtime_id": "vertex-adk-01",
  "agent_id": "agent-01",
  "intent": "update_customer",
  "requested_scopes": ["update_customers"],
  "tool": "crm",
  "context": {"source": "vertex-adk", "workflow": "demo"},
  "requested_budget": 1.0,
  "work_type": "execution",
  "correlation_id": "req-123"
}

Fail-closed behavior

Required: if Gvner is unreachable, returns DENIED, or response is invalid, do not execute. Treat as blocked and log audit context.

Sample wrapper pattern

# in ADK tool hook
decision = guvna_evaluate(intent)
if decision["decision"] != "ALLOWED":
    raise RuntimeError(decision["reason"])
# execute tool and log decision["audit_id"]