apps/opik-documentation/documentation/fern/docs-v2/ollie.mdx
With Ollie and opik connect, Opik becomes the place you actually fix it. Opik is no longer just a place to watch what your agent did. Ask a question about any trace, let Ollie read your code, have it edit the file, rerun your agent, and verify the fix with a test suite — all without leaving the browser.
Ollie is a conversational AI assistant built into Opik. It lives next to every trace, dataset, experiment, and prompt you've logged — and when you pair your local project with opik connect, Ollie can also read your source files, run your agent, and propose code changes. One assistant, full context: your data on one side, your code on the other.
The real workflow — and the reason Ollie exists — is the full loop from "something looks wrong" to "it's fixed and it won't regress." Here's what that looks like in Opik:
<Steps>Start where every debugging session starts: a trace that looks wrong. Filter by error status, low feedback score, or latency spike.
Open Ollie from the trace view. Describe what looks off — "the model ignored the retrieved context", "the tool call returned empty" — and Ollie walks the span tree to find the cause.
<Frame> </Frame>Once Ollie identifies where the bug lives, it asks to read the relevant source file. With opik connect running on your machine, it has secure access to the files in your project — and shows you exactly what it's looking at.
Ollie proposes a change. You see the diff, approve it, and the file is updated on your machine. Nothing happens without your click.
<Frame> </Frame>With the fix applied locally, Ollie reruns your agent through opik connect using the same inputs from the original failing trace. The new trace streams back into Opik in real time.
Ask Ollie to add the original trace to a test suite as a regression case, then run the suite against the updated agent. You get a pass/fail summary — and a test that will catch the bug if it ever comes back.
<Frame> </Frame> </Steps>opik connect in your agent folderFrom the root of your agent project, run:
opik connect --project <project-name>
That's it. opik connect pairs your local project with Opik, and Ollie takes care of the rest — discovering your entrypoints, running your agent, and proposing code changes.
Open Ollie from anywhere in the Opik UI and start asking. Traces, code, reruns, evaluations — it's all one conversation from here.
</Steps> <Tip> `opik connect` is opt-in and scoped to the session it's launched in. Ollie can only read and edit files in the project you connect, and every write operation requires your explicit approval. </Tip>