Evals
Organize evaluation projects
Use projects to group evaluation runs, traces, judge definitions and review work inside your organization. The project selector determines the context for the Evals page you are viewing. Published datasets are shared across the organization’s projects.
Before you start
Section titled “Before you start”Use an organization with ready Evals setup in the current beta console. Any customer role can browse authorized projects. Creating or archiving a project requires owner or admin access. A project is an evaluation grouping, not another organization or a permission grant to a different tenant.
To verify run history in the new project, have an approved agent and a small published dataset ready. Complete the setup in your first evaluation if these are missing.
1. Select a project
Section titled “1. Select a project”- Open Evals and locate the organization/project toolbar above the page title.
- Check the organization name and your role.
- Open Project and choose Default or a named ready project.
- Move between Runs, Traces and other Evals sections. The selected project remains part of that navigation.

Runs and trace views are project scoped. Datasets remain available across projects in the same organization. Selecting another project does not copy datasets or give you access to another organization.
2. Create a project
Section titled “2. Create a project”- As an owner/admin, click New project.
- In New evaluation project, enter a Name and optional Description that describe the evaluation work.
- Click Create project once.
- Wait for the new project to appear selected in the toolbar. Open Runs to begin work in it.

Creating a project establishes its evaluation context; it does not call an agent or run a model judge. If setup returns an unresolved response, use Retry project setup to inspect the saved setup request rather than creating an identically named replacement.
3. Verify retained scope
Section titled “3. Verify retained scope”- Refresh the page and confirm the named project is still selected.
- If the project is empty, click Run eval and follow Configure the run, keeping your new project selected instead of Default. Use the approved agent and small published dataset prepared above, then wait for the admitted run to finish.
- Open that run and confirm its run code and dataset identity.
- Change to Default and check that the project-specific run list changes.
- Return to the named project and confirm its saved work remains available.
An empty project list can reflect unavailable Evals setup, not an absence of permission to the whole console. Use Refresh setup after the underlying issue has been resolved. A URL naming an unavailable project is not sufficient to grant access.
4. Archive a finished project
Section titled “4. Archive a finished project”Archiving is an administrative terminal state in the current console: there is no restore interface. Use it only when the team is finished admitting new work to that project.
- Select a custom ready project. The Default context does not expose the same archive action.
- Wait for its active target evaluation or scoring work to finish.
- Choose the toolbar’s Archive project action.
- Read Archive project? and confirm Archive project.
- Verify the archived-project warning and refresh. Historical runs and traces remain readable, while new evaluation work is disabled for that project.

Failures and limits
Section titled “Failures and limits”- A project whose state is not ready cannot admit new evaluation work.
- Active target or scoring jobs can prevent archiving. Let them finish or use their documented cooperative stop controls before retrying.
- Archiving does not delete historical evidence or revoke an agent connection. Manage connections through Agents.
- Organization-wide concurrency still applies across projects: creating projects does not create extra target-run capacity.
Next, run an evaluation or inspect traces and sessions.