Auto-Remediation
Auto-Remediation shows what has gone wrong with an agent and suggests fixes. You can preview a suggested change to the agent's instructions, apply it, apply it to a copy of the agent, or undo it.
Open Auto-Remediation
- On the Agents screen, select the agent's name to open its details.
- Open the Actions menu.
- Select Auto-Remediation.
A panel opens with the agent's name at the top. Select Close, or press Escape, to close it.
Tabs
The count on each tab shows how many items it holds.
| Tab | What it shows |
|---|---|
| Incidents | Problems recorded for this agent, with each one's Source, Root cause, Severity, Confidence, AI² impact, Evidence and Time. |
| Lessons | Recurring behaviours and failures, with Times seen, Worst severity, Mean confidence, Fixes and Last seen. |
| Suggestions | Suggested fixes, with each one's Source, Category, Suggested Fix, AI² Impact and Status. |
| Signals | Risk signals and good signals found in the agent's runs. |
| Trend | How the agent's score has changed over time. This tab appears once the agent has enough scored runs. |
| Governance | The governance scorecard for the agent's runs. |
Apply a suggested fix
Some suggestions can be applied straight to the agent's instructions. These rows have a Show details control.
- Open the Suggestions tab.
- Select Show details on the suggestion.
- Review Current Instruction, Suggested Addition and Proposed Instruction.
- Optional: edit the text in Proposed Instruction.
- Choose what to do:
- Select Apply to change this agent's instructions.
- Select Clone & Apply to make a copy of the agent with the change, and leave this agent as it is.
- Select Cancel to close the preview without changing anything.
A suggestion with the status manual can't be applied from here. Read the suggested fix and make the change yourself in the agent editor. See Edit an agent.
What happens next
- After Apply, the message Suggestion applied. appears.
- After Clone & Apply, a message such as Cloned and applied successfully. appears. Select Open clone on the suggestion to open the copy.
Undo an applied fix
- On the Suggestions tab, find the applied suggestion.
- Select Revert.
- Confirm when you're asked Revert this suggestion?
The message Suggestion reverted. appears.
Troubleshooting
- No incidents recorded for this agent yet — no governance deductions and no runtime failures. nothing has gone wrong. This is expected for a new agent.
- No remediation suggestions yet — run a test chat to populate. chat with the agent to give it runs to learn from. See Test an agent.
- No recurring behaviours or failures to learn from yet. check again after the agent has had more runs.
- A message starting Apply failed, Preview failed or Revert failed means the change wasn't made. Close the panel, open it again and retry.