Building the AI Operating Partner with Context Engineering + Evaluation Systems
Most “agentic AI” demos fail for the same reason early automation often failed: not because the machine cannot work, but because people do not trust it to work predictably, safely, and accountably.
This post is a production-first blueprint for building an AI Operating Partner: a system that can reliably execute multi-step workflows across tools while remaining auditable and steerable.
2026 framing
The language has tightened since this blueprint was first written. “AI Operating Partner” is still a useful product metaphor, but the engineering object is a governed decision runtime. Its core promise is concrete: every consequential run compiles from a pinned Context Pack, executes through a bounded Decision loop, causes side effects only through the Tool Gateway, and emits a replayable Decision Record.
That is the standard the rest of this article should be read against. Trust is not a brand attribute. It is a set of runtime contracts that survive model upgrades, prompt edits, policy changes, and audits.
Quick takeaways
- Trust is an engineering artifact, not a UX afterthought.
- Reliability comes from the five planes — Intelligence, Context, Decision, Action, Trust — operating under one canonical execution contract.
- Context is a supply chain with contracts, provenance, and refresh cadence.
- Determinism levers beat prompt tweaks. Approval-mode tiers beat ad-hoc gates.
- A production rollout is not complete until replay, scorecards, and rollback are wired into the same release path.
Production bar
| Bar | What must exist before production |
|---|---|
| Versioned context | ContextPack ids, hashes, source priorities, bucket budgets, and compiler version in lineage |
| Bounded authority | Tool manifests, approval-mode tiers, argument constraints, and deterministic policy at execute time |
| Evidence | evidence_refs for claims, approvals, exceptions, and committed writes |
| Evaluation | Policy, utility, latency, safety, and cost scorecards on golden sets and live samples |
| Replay | A trace_id can rebuild the Decision Record from pinned inputs and recorded transcripts |
| Improvement | Operator corrections become typed proposals, replay verdicts, and released StrategyRules |
Index map
Section links:
- The operator’s dilemma
- Trust contract
- Prompt era
- Pilots vs rollouts
- AI operating partner
- Reference architecture
- Context supply chain
- Smart packing
- Determinism levers
- Agent patterns
- Trust plane
- Evaluation pyramid
- Release gates
- AgentOps
- Adoption playbook
- Example workflow
- Context pack contract
- Human role
- Closing
The operator’s dilemma: why adoption stalls
Automation adoption is rarely blocked by technology. It is blocked by trust.
In many systems, humans exist as “operators” not because machines cannot operate, but because humans provide:
- Confidence: someone is watching and can intervene
- Control: there is a steering wheel, brakes, and a stop button
- Accountability: there is a named owner of decisions
When operators disappear, adoption happens only if the system engineers a new trust contract.
The Trust Contract: predictability, control, evidence
If you want people to delegate to an AI system, you need to ship a trust contract that holds under pressure.
Trust contract diagram
Predictability
- Same intent -> consistent behavior
- Bounded variability: format, tone, and decision logic do not drift
- Stable outputs under small phrasing changes
Control
- Ability to steer, pause, override, and escalate
- Dynamic approvals for high-risk actions (money, PII/PCI, irreversible writes)
- Clear degrade modes (draft-only, ask-for-info, escalate)
Evidence
- Visible rationale and provenance for decisions
- Tool transcripts and citations for numeric claims
- An audit trail that can reproduce “what happened and why”
If any one is missing, users revert to manual operation.
Why the “prompt era” is a manual lever
Prompting is a transitional user interface. We have powerful reasoning engines, but we still drive them manually.
That creates a fragile operating model:
- Outcomes depend on the skill of individuals (“magic words”)
- Behavior is non-deterministic and hard to audit
- Repeatability breaks when the context shifts slightly
Thesis: the future is architectures that remove the need for manual driving.
Why pilots succeed but rollouts stall
Most deployments behave like a vending machine:
Insert prompt -> get response -> retry if wrong.
It breaks at enterprise scale due to:
- Fragility: small prompt changes -> big output variance
- Amnesia: no persistent state; repeated context stuffing
- Isolation: cannot reliably act in tools and systems
This is why pilots succeed, but production programs stall.
The target state: the AI Operating Partner
Definition
An AI Operating Partner is a system that:
- Maintains business context (policies, catalogs, tone, constraints)
- Executes multi-step workflows across tools
- Self-checks outputs using evaluation + trust benchmarks
- Produces auditable, steerable outcomes (not just text)
Litmus test
Repeated trials are a useful smoke check, not an enterprise acceptance threshold. Evaluate useful allowed work and required denials, faults and recovery in the actual workflow, release and environment. Ten clean trials cannot establish rare-event safety or independent runtime controls.
Reference architecture: five planes + a closed loop
The production architecture for an AI Operating Partner is best understood as five planes plus one continuous improvement loop. The canonical decomposition is described in the Foundations.
The five planes
- Intelligence — substrate of meaning: ontology, knowledge graph, identity, promotion-aware memory.
- Context — per-request compilation into a typed, budgeted Context Pack; tooling surfaced from
Registry ∩ Permissions − Prohibitions. - Decision — bounded Planner / Critic.verify / Executor / Critic.score / Consolidate loop, returning a DecisionRecord.
- Action — the Adapter Mesh: the only path through which decisions cause side effects, mediated by the Tool Gateway.
- Trust — policy outside agent code, approval-mode tiers, redaction, sandboxing, hash-chained audit.
One canonical execution contract
invokeAgent(request_envelope, run_context)
→ compile(packs, request, run_context) → CompiledContext
→ loop {
planner(CompiledContext) → Plan
critic.verify(Plan) → ok | replan | reject
executor(Plan, ToolGateway) → step_results, evidence
critic.score(step_results) → accept | retry | replan | escalate
consolidate(effects, evidence) → memory_proposals
}
→ DecisionRecord(evidence_refs, approvals, controls_active, trace_id)This is the five-plane processing spine. The compatible execution contract adds exact profile admission, current authority/approval, actual execution/data boundaries, durable ownership and aggregate accounting. Compilation and a Decision Record do not establish that a deployed runtime enforced them. Provider-hosted tools, generated subprocesses and browser/computer actions need an admitted effect path or must be disabled.
Closed loop
Continuous improvement: evaluators → typed failure clusters → Insight Synthesizer → Strategy Compiler proposals → release-gated rollout. If you are not closing this loop, you will hit a trust ceiling.
Context engineering is a supply chain
Context is not a paragraph you paste into a chat window. It is a supply chain.
Context supply chain diagram
Production artifacts
- Context contracts: schema, owner, refresh cadence, TTL
- Versioned policy bundles: what rules were in effect for this run
- Provenance tags: every chunk and tool result has a source + timestamp
- Context diff: what changed since last run (drift-aware behavior)
Context defects are one important failure class alongside authority, containment, state ownership, provider recovery and data-lifecycle failures. This article does not establish their relative incidence.
Smart packing as an engine (not advice)
The context window is a bounded budget. “Just increase tokens” is not a strategy.
Query decomposition
Split the task into retrievable sub-questions:
- eligibility
- policy applicability
- latest facts (price, stock, delivery SLA, return window)
- tool availability
- required user inputs
Hierarchical retrieval
Retrieve in layers:
- summary -> sections -> evidence
- pull raw evidence only for claims that require it
Conflict resolution
- source priority tiers (system-of-record beats wiki beats chat)
- recency rules and effective-dates for policy
Budget allocator
Allocate tokens by bucket:
- canonical
business,policy,tool,evidence,memoryandsessionbuckets - justify the allocation
Cache + invalidation
- TTL for stable context
- event-based invalidation (policy change, price update, inventory update, fraud flag)
Outcome: lower cost, lower latency, higher groundedness.
Determinism levers: remove “magic words”
Reliability comes from constraining the system, not pleading with prompts.
Structured outputs
- JSON schema or typed forms for critical fields
- strict parsers that reject invalid IDs, money formats, address fields, dates
Constrained decoding
- enforce allowed enums and formats
- validate money, address, identity fields
Tool results as truth
- verify actual source provenance, freshness, integrity and current eligibility; tool output can be hostile or stale
- never confirm an action without tool success + state proof
State machines
- explicit stages, transitions, abort conditions
- canonical error classes and recovery paths
Idempotent actions
- preserve stable operation identity and provider-specific recovery guarantees
- a timeout is unknown until reconciled; a key alone cannot guarantee duplicate-free execution
Fallback strategies
- use a permitted draft-only path only when its own authority/data/containment requirements pass
- ask for missing inputs
- escalate with a structured handoff
Agent patterns: choose with a rubric
ReAct (Reason -> Act -> Observe)
Use when:
- uncertainty is high
- tools can fail
- you need correction loops
Optimizes for safety and self-repair.
Plan-then-Execute (ReWOO-like)
Use when:
- tool reliability is high
- latency matters
- tasks can parallelize
Optimizes for speed and throughput.
Multi-agent orchestration
Use when:
- context is large
- risk zones differ (research vs final execution)
- specialization reduces hallucination and improves auditability
Selection axes: uncertainty, tool reliability, time budget, blast radius, audit requirements.
The Trust plane: governance that actually ships
This is where most “agentic AI” demos collapse in production.
Minimum viable Trust plane
- Fine-grained permissions per tool, per argument, per data-class, per tenant.
- Native risk and compatibility binding on capabilities: preserve the five v1 modes, evaluate every
ActionRiskdimension and retain all independent prohibitions/approval obligations even if a compatibility projection is lower. - Prompt-injection structural defense — tool surface narrowed at compile time; deterministic policy outside the model; arg constraints; default deny.
- Secrets isolation so secrets never enter context; brokered execution only via the Tool Gateway with STS-style per-call credential exchange.
- Active execution boundaries for code, files and browsing: exact configuration/image pins, current filesystem/process/egress/resource and brokered-credential observations. A signature is profile-dependent provenance, not proof of active enforcement.
- Exact required approvals binding proposal/request, complete nested action, actor, evidence and pins to a current entitled distinct quorum; atomic redemption cannot authorize a second effect.
- Data-lifecycle enforcement at collection, inference, tool input/output, telemetry, cache, memory, export and delegation. Bind actual recipients/processors, purpose, labels and transformations; track governed candidate storage and copy-specific retention/deletion receipts.
- Governed audit with correlated Decision Records, W3C trace propagation and pinned replay inputs. Protect access and retention; hashes do not authenticate their origin or require indefinite raw personal-data storage. Protected atomic state stores remain separate. See Security and Compliance.
The evaluation pyramid: how serious teams ship
Evaluation is not one score. It is layered.
Evaluation pyramid diagram
Unit evaluation
- retrieval quality
- grounding checks
- schema validity
- policy checks
Integration evaluation
- correct tool choice
- correct arguments
- correct state transitions
- recovery behavior
Adversarial evaluation
- jailbreaks
- injections
- ambiguity traps
- data exfil attempts
- social engineering
Online evaluation
- shadow mode
- canaries
- drift detection
- human review sampling
- regression alerts
If you do not evaluate across these layers, you will ship regressions silently.
Benchmark-based release gates
You do not launch agents, you graduate workflows.
Example release gates
- evidence-backed output rate >= benchmark for N days
- policy compliance >= benchmark
- tool success + recovery >= benchmark
- incident rate
<=threshold - override rate stable or improving
- rollback tested in game days
Maturity ladder
- HITL: human approves actions (high stakes)
- HOTL: AI acts with monitoring + veto (scale tasks)
These are candidate release signals. Exact control profiles and conformance evidence require current independently verified mandatory controls plus useful work and denials for the actual deployment. Aggregate scores, synthetic tests and reference passes cannot cover a missing required control; monitoring/veto cannot replace a currently required pre-action approval.
AgentOps: observability you can operate
Trust requires operational visibility.
Per-run trace
Capture:
- context pack version
- retrieved evidence IDs
- tool calls + results
- decisions, approvals, outputs
Dashboards
Track:
- success rate, evidence rate, compliance rate, override rate, incidents
- p95 latency, cost per completed task
- drift signals (policy changes, tool changes, model updates)
Runbooks
If you cannot operate it, you cannot trust it:
- disable tool
- revert to draft-only
- switch to HITL
- rollback versions
- incident response
Adoption playbook (enterprise-real)
A pragmatic rollout sequence:
- Phase 0: Shadow read-only; evidence-only; no external actions
- Phase 1: Assist drafts + recommendations; HITL approvals
- Phase 2: Delegate HOTL for low-blast workflows; automated execution with controls
- Phase 3: Autonomy with audit selective autonomy; continuous eval; periodic red-team; benchmark governance
Goal: not autonomy everywhere – safe delegation where it matters.
Example: eCommerce order change workflow
To ground this in something concrete, consider a common eCommerce request:
“Change my delivery address for order ODR-918273 and switch size from M to L.”
This is deceptively risky:
- address changes have fraud implications
- size change affects inventory and price
- approvals may be needed for high-value orders or COD orders
- confirmations must reflect actual tool state, not model confidence
Proof obligations mindset
In a trust architecture, the system cannot claim:
- “Your address has been updated”
- “The size change is confirmed” unless it has:
- tool success
- updated order state proof
- and an audit record
Workflow as a controlled state machine
- Identity verification (account ownership / OTP / session trust)
- Order lookup (status, payment method, fulfillment state)
- Policy lookup (address-change window, item-change rules, fraud rules)
- Eligibility decision (allowed? requires approval? disallowed?)
- Inventory + repricing (size availability, delta amount, promos impact)
- Approval gate (if required: user confirmation + risk checks)
- Execute changes (address update, item modification)
- Verify + compose response (evidence-backed confirmation)
- Evaluate run (trust benchmarks + governed logging)
Bind the exact new address, item variant, currency/minor-unit price delta and current order state to required approvals. Address and item updates are separate effects unless the actual provider supports an atomic operation: partial success must remain partial. Resume under current fenced ownership with current owner/ancestor grant, approval, boundary/data permissions and external preconditions. Keep original shared spent/reserved capacity across child/retry/reviewer work. Unknown supplier results require reconciliation; a stop request or pack rollback cannot prove reversal.
What the user sees
- “Checked order status: Packed (not shipped yet)”
- “Size L available in your warehouse”
- “Price difference: +Rs 149 (requires payment confirmation)”
- “Proceed to confirm?”
This is “glass box” behavior: enough visibility to trust, without dumping raw logs.
A local eCommerce configuration sketch
The JSON below is a historical application configuration sketch, not the canonical ContextPack schema or an input accepted by the reference compiler. Its user/env/knowledge/tools buckets and inline policy layout are local concepts. Map them to the published Context Pack, canonical buckets, manifests and execution controls before implementation. A real versioned bundle should declare:
- what context is allowed and refreshed
- what tools can be called and with what constraints
- what policies apply
- what evaluation gates must pass
{
"context_pack_id": "ctxpack://ecom/order_change/v1",
"owner": "ai-platform",
"tenant": "default",
"effective_at": "2025-12-01T00:00:00Z",
"buckets": {
"user": { "max_tokens": 900, "sources": ["profile_store"], "ttl_sec": 86400 },
"env": { "max_tokens": 250, "sources": ["runtime_env"], "ttl_sec": 3600 },
"knowledge": { "max_tokens": 2400, "sources": ["policy_kb", "kg"], "ttl_sec": 3600 },
"tools": { "max_tokens": 700, "sources": ["tool_registry"], "ttl_sec": 3600 },
"session": { "max_tokens": 1200, "sources": ["conversation_state"], "ttl_sec": 7200 }
},
"policy_bundles": [
{
"id": "POLICY_ORDER_CHANGES_V6",
"type": "policy-as-code",
"invariants": [
"INV_NO_EXEC_WITHOUT_IDV",
"INV_NO_NUMERIC_WITHOUT_EVIDENCE",
"INV_NO_PII_ECHO"
],
"approval_gates": [
"GATE_ADDRESS_CHANGE",
"GATE_PAYMENT_DELTA"
]
}
],
"tools": [
{
"name": "identity_verify",
"permissions": { "requires_strong_auth": true },
"rate_limit_qps": 5
},
{
"name": "order_lookup",
"permissions": {
"allowed_fields": ["status", "items", "shipment_state", "payment_method", "totals"],
"pii_redaction": true
},
"rate_limit_qps": 20
},
{
"name": "policy_lookup",
"permissions": { "allowed_domains": ["order_change", "returns", "fraud"] },
"rate_limit_qps": 50
},
{
"name": "inventory_check",
"permissions": { "allowed_fields": ["sku", "warehouse", "available_qty"] },
"rate_limit_qps": 30
},
{
"name": "reprice_change",
"permissions": { "allowed_fields": ["delta_amount", "currency", "promo_impact"] },
"rate_limit_qps": 10
},
{
"name": "update_address",
"permissions": { "requires_approval_gate": "GATE_ADDRESS_CHANGE" },
"rate_limit_qps": 3
},
{
"name": "update_item_variant",
"permissions": { "requires_approval_gate": "GATE_PAYMENT_DELTA" },
"rate_limit_qps": 3
}
],
"evaluation": {
"trust_benchmarks": {
"evidence_backed_output_rate": { "min": 0.98 },
"policy_compliance_rate": { "min": 0.995 },
"tool_success_recovery_rate": { "min": 0.97 }
},
"golden_sets": ["goldenset://ecom/order_change/v1"]
}
}The sketch communicates domain requirements; its presence and illustrative score thresholds do not demonstrate enterprise enforcement. Validate actual source contracts and current deployment evidence rather than copying its local field names into the base schema.
The human role: compass to the telescope
AI expands sensing, recall, and execution.
Humans remain accountable for:
- goals, ethics, tradeoffs, risk appetite
- escalation decisions under uncertainty
- meaning-making and responsibility
If Context is the stage, and Agents are the workforce, then:
- Evaluation is the quality engine
- Steerability is the safety net
Stop optimizing prompts. Start engineering trust.
Closing
The future of AI is not about better prompts. It is about better architecture.
If you are building agents in an enterprise and hitting a trust ceiling, the fix is not more prompt tuning. It is five planes + canonical execution contract + evaluator-gated improvement loop, engineered into the system.
The prompt is dead. Long live the context.
