Creating Projects

A Project is the top of the Testzilla hierarchy. It groups everything you test for one agent, product, or team into a single place, and it owns a shared prompt that the channels and tests beneath it can reuse.

The model is Project -> Channel -> Test -> Run -> Result. A project holds channels (connections to the agent under test), and each channel holds tests (the scenarios you run). Results roll back up: a test’s latest result scores its channel, and a channel’s scores roll up to the project, giving you one health number per project. See Reports for the roll-up view.

Create a project

1. Open Projects

   In the web app, open Projects from the left nav and click New Project. (Or skip the manual steps and let Tessie create the whole project from a plain-language description.)

2. Name it

   Give the project a clear name — usually the agent or product it covers, e.g. “Acme Support Line”. This is how you will find it later and how it appears in your Dashboard roll-ups.

3. Set a shared project prompt (optional)

   A project can carry a shared prompt — instructions, persona, or context you want every test under it to inherit. Channels and tests pull it in with the {{project_prompt}} token instead of copying it, so you maintain shared instructions in one place. See prompt layering for how project, channel, and test prompts combine.

4. Save

   The project appears in your Projects list, ready for its first channel.

Add channels and tests

A project is just a container until it has at least one channel. From the project page:

• Click + Channel to add a channel — the connection to your agent (phone, LLM Chat, Web Chat, or Web Voice). Pick the channel’s connection type for the surface your agent runs on.
• Add tests to each channel — the scenarios the AI tester runs against it.
• To benchmark one set of tests across several channels at once, add a Folder channel and use the suite runner.

Tip

Most IDs and field values on the project page have a Copy button next to them, so you can grab a project ID without retyping it.

Project reports

Open a project and click Report to generate a roll-up analysis across every active test in all of its channels — a summary, the records analysed, the issues found, and proposed fixes. See Reports for what each section contains and how scope (channel vs project) works.