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

# Reviewed Runs in Agents

Marking a run as a reference sets the standard for how your agent should behave, allowing the system to learn from its most successful outputs. When an agent execution meets your quality requirements, you can validate it to ensure consistency over time and prevent performance regressions. These historical examples provide the agent with a proven foundation to build on, replicating SQL patterns and formatting styles that already work.

This guide explains how to mark runs as reviewed, how the context injection works, and the benefits for your automated workflows.

## How it works

The process for using reviewed runs as a reference follows three main stages to ensure your agents maintain high standards over time.

<Steps>
  <Step title="Mark as Reviewed" icon="check">
    After an agent completes a successful run, navigate to the **Previous Runs** list. Click the **Mark as reviewed** button on the specific execution that produced the desired result.
  </Step>

  <Step title="Context Storage" icon="database">
    WisdomAI stores the full context of that validated run, including the specific steps taken, the generated SQL, and the exact output formatting used.
  </Step>

  <Step title="Reference Injection" icon="rotate-right">
    On future executions, WisdomAI automatically retrieves up to 3 of the most recently reviewed runs. These are injected as historical reference examples before the agent begins its new task, guiding it to follow the established logic and style.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/wisdomai/rKBpT-TQ-2FvMIwv/images/reviewed-run-agent.png?fit=max&auto=format&n=rKBpT-TQ-2FvMIwv&q=85&s=21ce0701d148c8630a7c81ce28dfaaf4" alt="Reviewed Run Agent" width="1615" height="800" data-path="images/reviewed-run-agent.png" />
</Frame>

<Note>
  This feature acts as a regression guard, ensuring that once you have perfected an agent's behavior, that quality is preserved across future updates and similar queries.
</Note>

## Key capabilities

Reviewed runs provide the following technical advantages for maintaining agent performance:

* **Manual Validation:** Choose exactly which success-status runs to promote as references via the **Mark as reviewed** button.
* **Contextual Injection:** Automatically utilize up to 3 recently reviewed runs per execution for historical guidance.
* **Logic Consistency:** Improve the reliability of SQL patterns and tool call sequencing by providing a "gold standard" for the agent to follow.
* **Formatting Control:** Ensure the agent maintains a consistent output structure, which is critical for teams running recurring weekly or monthly reports.
* **Reversibility:** Remove the reviewed status at any time to update your reference library and ensure only the best examples are used.

<Frame>
  <img src="https://mintcdn.com/wisdomai/rKBpT-TQ-2FvMIwv/images/reviewed-run-agent-remove.png?fit=max&auto=format&n=rKBpT-TQ-2FvMIwv&q=85&s=5fd7ee3b76e4fd336a2aba4c5f2cd766" alt="Reviewed Run Agent Remove" width="1731" height="465" data-path="images/reviewed-run-agent-remove.png" />
</Frame>

## Target users

The reviewed runs feature is specifically designed for:

* **Agent owners & builders** who want to lock in high-quality performance once an agent run meets their exact requirements.
* **Data teams** that generate recurring weekly or monthly reports and need the output structure to remain identical across every execution.

## FAQs

<AccordionGroup>
  <Accordion title="Which runs can be marked as reviewed?">
    Only runs with a **Completed** status and an associated conversation can be marked as reviewed.
  </Accordion>

  <Accordion title="Can I unmark a run?">
    Yes. You can remove the reviewed status at any time. Once unmarked, that specific run will no longer be used as a reference for future agent tasks.
  </Accordion>

  <Accordion title="How many references are used at once?">
    WisdomAI uses up to the 3 most recent reviewed runs to provide context for a new execution.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Create an Agent" icon="robot" href="/advanced-features/agents/tutorial-create-agent">
    Learn the basics of setting up a new AI agent for your data.
  </Card>

  <Card title="Manage Your Agents" icon="list-check" href="/advanced-features/agents/manage-agents">
    Explore how to monitor performance and view the Previous Runs list.
  </Card>
</CardGroup>
