> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vijil.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Harnesses

> Create targeted Diamond Evaluations with custom Harnesses, Personas, and Policies.

While Vijil has a variety of pre-configured [Harnesses](https://docs.vijil.ai/concepts/evaluation-components/harness.md) that you can select from, you can also create your own Harnesses to obtain a [Trust Score](https://docs.vijil.ai/concepts/trust-score/introduction.md) specific to your organization and agent.

## View Custom Harnesses

You can view previously created custom Harnesses by navigating to **Harnesses** in the left sidebar.

To view the prompts, [Personas](https://docs.vijil.ai/owner-guide/simulate-environment/personas.md) and [Policies](https://docs.vijil.ai/owner-guide/simulate-environment/policies.md) in a custom Harness, click on its row in the **Harnesses** table.

## Create a Custom Harness

1. In the left sidebar, navigate to **Harnesses** and press **+ Create Harness**.
2. Enter a Harness name and a description.
3. Select an [Agent](https://docs.vijil.ai/owner-guide/register-agents/what-is-an-agent.md).
4. Optional Select one or more [Persona(s)](https://docs.vijil.ai/owner-guide/simulate-environment/personas.md).
5. Optional Select one or more [Policies](https://docs.vijil.ai/owner-guide/simulate-environment/policies.md).

> [!NOTE]
>
> To structure the Harness around policy rules, select approved rules from those Policies for Harness generation. You can use up to 50 rules in one Harness.

Vijil automatically structures the Harness around your selected rules, with one dimension per rule, and generates test cases for each rule. Before using this option, [extract and approve rules](https://docs.vijil.ai/owner-guide/simulate-environment/policies.md#extract-rules-from-a-policy) from an uploaded policy document or manually entered policy text in **Policies**.

## Create a Custom Harness via MCP

### Create a Harness

With the [Vijil MCP server](https://docs.vijil.ai/developer-guide/agentic/quickstart.md) configured, ask Claude Code in natural language:

Create a custom Harness called 'Customer Support Harness' for agent a1b2c3d4-… with the GDPR policy

Create a custom Harness called 'Customer Support Harness' for agent a1b2c3d4-… with the GDPR policy

Claude creates the Harness and returns the ID.

> [!NOTE]
>
> Custom Harnesses are immutable once created. To change the configuration, delete the Harness and create a new one.

### Check Generation Status

Harness generation is asynchronous. Ask Claude to check until `status` is `active`.

What is the status of custom Harness h1a2b3c4-…?

What is the status of custom Harness h1a2b3c4-…?

| `status` value | Meaning |
| - | - |
| `draft` (no workflow) | Not yet started |
| `draft` (workflow `running`) | Generation in progress |
| `draft` (workflow `failed`) | Generation failed |
| `active` | Ready to use in an Evaluation |
| `failed` | Harness creation failed permanently |

### Get Harness Prompts

Retrieve the generated Probes for a completed Harness.

Show me the prompts for custom Harness h1a2b3c4-…

Show me the prompts for custom Harness h1a2b3c4-…

Returns an empty list if the Harness is still in `draft` status.

### List Custom Harnesses

List my custom Harnesses

List my custom Harnesses

List my custom Harnesses for agent a1b2c3d4-… with status active

List my custom Harnesses for agent a1b2c3d4-… with status active

Both support filtering by agent and status.

### Cancel Generation

Stop a Harness that is still generating.

Cancel the custom Harness h1a2b3c4-… that is still generating

Cancel the custom Harness h1a2b3c4-… that is still generating

### Delete a Harness

Delete custom Harness h1a2b3c4-…

Delete custom Harness h1a2b3c4-…

## Next Steps

> [card] [Run Evaluations](https://docs.vijil.ai/owner-guide/run-evaluations/running-evaluations.md)
>
> Execute custom Harness evaluations

> [card] [Understand Results](https://docs.vijil.ai/owner-guide/run-evaluations/understanding-results.md)
>
> Analyze custom Harness results

> [card] [Personas](https://docs.vijil.ai/owner-guide/simulate-environment/personas.md)
>
> Learn more about Personas

> [card] [Policies](https://docs.vijil.ai/owner-guide/simulate-environment/policies.md)
>
> Learn more about Policies


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.