Skip to main content
Triage the frictions stopping the most runs, inspect the underlying trace evidence, ship the fix in your product or setup, and relaunch to verify improvement.

Prerequisites

  • Finished experiments with Insights enabled (run Run insights on older experiments if needed).
  • Access to edit your product, tool, custom agent, or task setup.

Steps

1

Open the friction list

Open Analyze → All frictions for project-wide issues, an experiment’s Frictions tab, or the Brief on Comparisons.
2

Filter by where to fix

Filter Family to Machine or Task quality (or Where to fix to Setup) and clear environment or rubric problems first so results stay reliable. Then filter Where to fix to Product, Custom agent, Setup, or Agent behavior (sorted by Unrecovered runs by default).
3

Read the top friction and trace evidence

Open the friction to inspect What goes wrong, Why it matters, and Suggested fix. Under Recent evidence, select a cited step link to open Traces right at the failure point.
4

Copy as Markdown

Select Copy as Markdown to copy the problem summary, suggested fix, concentration, three recent trace links, and frc_ ID into an issue or your AI assistant.
5

Apply the fix in the right layer

6

Launch again and verify

Select Launch again on the experiment (or After a fix, run the N tasks that differed again inside a Clear difference Brief). Because frictions keep stable frc_ IDs across experiments, check the new experiment’s Frictions tab to verify that affected runs decreased.

Interpret the results

From the CLI and the plugin

Example prompt for your AI assistant:

Other ways to run it

  • Track one tool: open any tool under Manage → Tools and inspect its Frictions tab across all experiments.
  • Investigate with Ask Oqo: ask Ask Oqo to cross-check a friction against a public GitHub repository.
  • Prevent regressions: put the experiment on a schedule after fixing.

Next steps

Frictions

Understand Where to fix, Family, and concentration rules.

Run details

Inspect timelines, transcripts, and changed files.

Track results over time

Keep fixed frictions from returning.

Install the Oqoqo Plugin

Fix frictions directly from your AI assistant.