ProjectBuild an Agentic Content Studio: the explanation · Module 17: Evaluating the agents · part 19 of 22
Part 19 · Module 17: Evaluating the agents

Module 17: Evaluating the agents

23 min read·
About 50 minutes · Needs: Module 8 (the LangGraph pipeline), Module 10 (the designer, JSON repair and the honesty guard), Module 11 (render, measure and repair) · Code: backend/evals/run.py, backend/evals/checks.py, backend/evals/fake.py, backend/evals/datasets/, backend/tests/test_evals.py

Where this fits

WHERE THIS FITS Slidesmith Studio this module BROWSER React FRONT DOOR AND API nginx, FastAPI BACKGROUND AGENTS LangGraph MODELS Ollama RENDERING Playwright DATA Postgres 17 OPERATIONS evals, Docker, Cloud Run Studio app React pages /render page same renderer nginx proxy, headers Auth sessions, CSRF Brand kit onboarding, uploads Projects deck spec, edits Job runner progress over SSE Research search, facts Strategist outline Designer slide JSON Check fit, else repair LangGraph pipeline state graph, JSON repair Ideas post ideas from pillars qwen3.8:27b Ollama, local GPU Web search Ollama API Chromium render, measure Exports PDF, PNG, ZIP, HTML PostgreSQL users, decks, jobs Uploads disk or GCS Evaluation suites, gate Insights usage, timings Containers Docker Compose Deploy Cloud Run, CI/CD
This module (blue) is the evaluation box: it drives the real designer, pipeline and check loop with prepared inputs and scores what the model (amber) produced.

Unit tests check that each function does what its author meant. Evaluations check that the agents, with a real model in the loop, write slides that are valid, honest and fit the page, on many realistic inputs. This module opens the evaluation box: the datasets, the five suites, every metric and the gate that can stop a release.

The rest of this project is yours to keep

This project is bought on its own, once, and stays readable afterwards, including the parts added to it later.

Or open everything with a plan