docs(oss): add OpenAI Agents SDK/MCP and reliable-judge tutorials

[davidberenstein1957]

Problem

Two second-wave gaps. (a) After the LangGraph tutorial there is exactly one framework integration; the OpenAI Agents SDK plus MCP tool servers is the other mainstream stack and had no page. (b) RegoPolicy and the semantic/judge checks are documented as isolated reference entries and explanation/when-to-use-which-check.md argues the choice abstractly — nothing walks a reader from a flaky LLM judge to a deterministic check, which is the most common real complaint about LLM evaluation.

Changes

• New checks/tutorials/test-openai-agents.ipynb: an Agents SDK agent with an MCP server, Runner.run(...) wrapped as the async Giskard target, session state via a Trace subclass; asserts the final answer, that the MCP tool was actually invoked (WithSpy), and behaviour when the MCP server errors or returns empty. Callout that this is the same target contract as the LangGraph tutorial.
• New checks/tutorials/reliable-judges.ipynb: start from a naive judge on a subjective requirement, run it N times over the same trace and measure the disagreement rate, then re-express the same requirement as a deterministic FnCheck, a non-trivial RegoPolicy, a narrowed semantic check, and finally a tightened-rubric judge with a pinned model. Ends with a variance-based CI threshold recipe linking how-to/ci-cd.
• Both registered in checks/tutorials/index.mdx.

Verification

• Both notebooks executed with outputs committed, model gpt-4o-mini; the flakiness number in the judge tutorial is produced by the notebook, not asserted in prose. .mdx generated via scripts/convert-notebooks.mjs; npm run build passes.

Notes / risks

• Depends on item 08's target-wrapping and spy patterns — land 08 first.
• Adds tutorial sidebar entries; check ordering against items 06/09/10, which contend for order 6.

🤖 Generated with Claude Code

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	giskard-docs	030a701	Commit Preview URL Branch Preview URL	Aug 13 2026, 06:11 AM

[henchaves]

Out of scope for this cycle, let's postpone the review of this PR

[davidberenstein1957]

Hi @henchaves why is this out of scope? I thjough we had discussed we wanted to include documentation updates, more tailored tutorials and a general documentation cleanup?

[henchaves]

advanced checks tutorials are not priority at the moment, first we need to fix checks API reference and add scan pages. We can add more once we have a stable release candidate, since we can still break things until there

[davidberenstein1957]

Alright, then I misunderstood. I've also added some PRs related to the API reference updates and more advanced scan documentation stucture according to diataxis. Feel free to take a look at those first.

[henchaves]

It's ok, I left these ones you mentioned as open to review