Cookbook
Task-oriented recipes that compose DVARA's governance features into scenario-level workflows. Each recipe answers "how do I accomplish X" — not "what is X" (see Core Concepts), not "how do I call an OpenAI SDK" (see Integrations), not "what does feature Y do" (see Features or Governance & Safety).
Recipes are deliberately short: problem statement, prerequisites, the few steps that actually compose features together, verification, and links out to the feature pages for depth. The dvarahq/dvara-examples repository is the canonical source for full runnable code — recipes on this page link into it where relevant.
When to use the Cookbook
| You want to … | Read this |
|---|---|
| Understand the platform | Core Concepts |
Run a single curl against a provider | Provider Setup |
| Wire an SDK at the client side | Integrations |
| Understand what feature Y does in detail | Features or Governance & Safety |
| Solve a specific cross-feature problem | This cookbook |
Available recipes
Onboarding
- Add DVARA to an existing OpenAI-SDK app — retrofit governance onto an existing codebase without rewriting client code
Rollouts
- Canary a new model version and roll back on error rate — test a new model on a small traffic slice, monitor, promote or revert
FinOps
- Attribute cost per tenant for chargeback — set up per-tenant API keys, tag usage, and generate a monthly chargeback report
Coming soon
These recipes are on the roadmap — track progress in dvara-web#126:
- Debug a slow request using trace-id correlation
- Blue/green provider migration with weighted routing
- Redact PII before vendor egress and audit the redactions
- Replay a billing-challenged request from the audit log
- Enforce spend caps on an agent loop (budget + priority admission)
- Mock an LLM in CI using file-backed scenarios
If a recipe you need isn't here, open an issue — we'd rather write the recipe you actually have than the one we guessed at.