Search APIs with shared caching
If ordinary traffic shares a CDN response, usecacheMode: "request". A feedback-aware caller sends
Agent-Feedback-Request: 1; public callers keep the public cache policy.
Run the search example
Async APIs
UseshouldInstrument to expose feedback only when the body reaches a terminal status. This avoids asking
the agent to evaluate a job it has not used yet.
Run the crawl example
Stateful MCP without micro-feedback
UseincludeTools for the complete trace and feedbackTools for the final boundary. A result-aware
sessionRef extractor groups the session-creation result with later calls.
Run the browser example
Authenticated, sensitive operations
DerivecustomerRef from verified API or OAuth context, never an email address or a tool argument. Epode
rejects feedback containing likely personal data, secrets, prompts, transcripts, or raw product content.
The agent may retry the same handle with a safe abstract summary.
Run the authenticated operations example