docs/guides/using-ai-agent.mdx
The AI Agent workspace is a dedicated place to work with an AI assistant on a resume draft. It keeps the conversation, tool activity, and read-only resume preview in one full-screen view.
<Info> Agent threads edit an AI draft copy of your resume. Your original resume is not changed when you start from an existing resume. </Info>You need at least one AI provider that is tested and enabled in Dashboard -> Settings -> Integrations. For setup, see Using Artificial Intelligence.
If you self-host Reactive Resume, the agent workspace also requires the server-side agent configuration described in Self-hosting with Docker.
From the dashboard sidebar, click Agents.
The agent page always shows your thread sidebar. Use it to continue an existing thread, or click New thread to start another one.
You can also open the agent from the builder dock. When you do this, the current resume is preselected in the new thread setup screen.
<Frame caption="Starting an AI Agent thread">
</Frame>
The desktop workspace is split into three panes:
On smaller screens, the workspace uses tabs/sheets so you can switch between threads, chat, and preview without losing the active conversation.
The agent works best with concrete instructions:
https://example.com/job"You can attach files or images from the composer. The agent can read uploaded attachments when they are relevant to your request.
<Note> Text input is supported. Voice input is not supported in the agent workspace yet. </Note>When the agent edits the resume, the patch is applied immediately to the AI draft. The chat shows a small Patch applied line.
Open the line to inspect the raw JSON Patch and use Revert if you want to undo that patch.
<Warning> AI-generated changes can still be inaccurate. Review the draft in the preview or builder before exporting or sharing it. </Warning>If the agent needs a decision, it may show a question card with recommended answers. Click the answer you want to send it back to the agent.
This is useful when the agent finds ambiguous instructions, missing job context, or a change that depends on your preference.
The resume pane is read-only. Use the toolbar to:
Zoom settings are remembered across refreshes.
Threads are ordered by the newest message. Use the thread menu to archive or delete a thread.
Threads can also become read-only if the working resume is deleted, the selected provider is deleted, or the thread is archived. If a provider is disabled or no longer tested, re-enable and test it before sending new messages.