# Using the AI agent

> Start a chat with the agent on a working copy of your resume, review the changes it makes, and pick up earlier chats.

**Agent** is a full-page chat where the agent works on a resume with you. It can draft a resume from a few lines about you, rework your summary, rewrite weak bullets or tailor a resume to a job. Every chat works on its own copy of the resume, so your original stays as it was.

Open it from **Agent** in the dashboard sidebar.

<Info>
  The agent runs on Hiresweep AI, with nothing to set up. Starting a chat is free. Each message you send uses one AI
  action. See [Plans and usage](https://docs.hiresweep.com/guides/plans-and-usage).
</Info>

To work on the resume open in the builder instead, without a copy, use the [Agent card in the builder](https://docs.hiresweep.com/guides/using-ai-in-the-builder).

## Other ways to start a chat

- **Draft with the agent** on the Overview, on **Resumes** and in the command palette opens a new chat ready to draft a resume.
- **Plan with the agent** and **Ask the agent** on the Overview open a new chat about a resume or a job.
- **Open in Agent** in the builder's **Agent options** menu opens that resume's builder chat here.
- Press <kbd>⇧</kbd> <kbd>⌘</kbd> <kbd>O</kbd> on a Mac or <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>O</kbd> on Windows and Linux on any Agent page to start a new chat.

Opening a chat this way only fills in the start screen. Nothing is sent until you start the chat.

## Start a chat

<Steps>
  <Step title="Choose a resume">
    In **Resume**, pick the resume to work on, or **Create from scratch** for a blank one. The most recent resume you
    edited is picked for you.

    - From a resume, the chat works on a copy with " - AI Draft" added to its name, for example "Product Designer - AI Draft", and the same tags. Your original stays untouched.
    - From scratch, the chat starts a new blank resume named "AI Draft".
  </Step>

  <Step title="Say what you need (optional)">
    Type a request in **What should the agent do? (optional)**, or pick one of the suggestions under **Or start from**,
    such as "Find weak bullets and rewrite them with outcomes, numbers and sharper verbs." The suggestions change with
    the resume and job you picked.

    If you opened the page from a job, a **Job** chip shows which one. Remove the chip to leave the job out.
  </Step>

  <Step title="Select Start chat">
    Hiresweep creates the working copy and opens the chat.
  </Step>
</Steps>

## The chat

On a wide screen the chat page has three columns:

- **Chats** on the left: **New** and your **Recents**. Select **Hide chats** to fold the list away and **Show chats** to bring it back.
- The conversation in the middle.
- The working resume on the right, updated as the agent changes it.

On a phone, select **Resume** in the header to see the working resume.

### Ask for changes

Type in **Ask anything about this resume** and press <kbd>Enter</kbd>. Concrete requests work best:

- "Tailor this resume to the job description below, keeping the voice concise."
- "Find weak bullets and rewrite them with stronger outcomes."
- "Ask me before changing anything that looks uncertain."

Select **Stop generation** to stop a reply part-way.

### Attach files

Select **Attach files** to add a job description, notes or a screenshot. You can attach PDFs, text files, images and JSON files, up to 10 MB each and up to 10 files per message. A chat holds up to 100 MB of attachments.

### Answer the agent's questions

When the agent needs a decision, such as which role to aim for or whether to keep a section, it shows a question card with suggested answers. Select one to send it.

### Ask for options on one bullet

With a mouse, hover over a bullet in the working resume and select **Propose options**. The agent suggests other ways to write that bullet.

## Review the agent's changes

In the full-page Agent, the agent applies its changes to the working copy straight away. Each change shows in the chat as a card:

| Label                  | What it means                                              |
| ---------------------- | ---------------------------------------------------------- |
| **Applying changes…**  | The change is being written.                               |
| **Applied changes**    | The change is on the working copy, with how many edits it made. |
| **Patch failed**       | The change couldn't be applied. Nothing changed.           |
| **Change conflicted**  | The resume changed in the meantime, so the change wasn't applied. |
| **Change rolled back** | You restored the resume to before this change.             |

On a change card:

- **Details** shows the exact edits the agent made.
- **Open in builder** opens the working copy in the builder.
- **Restore** puts the resume back to how it was before this change. Restoring also rolls back every change the agent made after it. This can't be undone.

<Warning>
  AI-written changes can be inaccurate. Read the working copy before you export it, share it or send it to an employer.
</Warning>

## The working resume

The resume column is read-only. Its toolbar has:

- **Decrease zoom**, **Increase zoom** and **Fit to width**;
- **Download PDF** to download the working copy;
- **Open in builder** to edit the working copy yourself.

The working copy is an ordinary resume. You find it in **Resumes**, with the rest of your resumes.

## Manage chats

The chat list shows your most recent chats first. Open a chat's **Chat actions** menu, in the list or in the chat's header:

- **Copy** copies the conversation as text.
- **Archive** keeps the chat but stops new messages. An archived chat shows **Archived** in the list. Select **New chat** to keep going in a new one.
- **Delete** removes the chat's messages and the files you attached. The working resume stays in **Resumes** unless you also tick **Also delete that resume**. This can't be undone.

A chat also becomes read-only if its working resume is deleted.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Send is greyed out">
    Your plan has no AI actions left. A warning under the message box links to **See plans**. See
    [Plans and usage](https://docs.hiresweep.com/guides/plans-and-usage).
  </Accordion>
  <Accordion title="AI features aren't available on this server right now">
    Hiresweep AI isn't available at the moment. Try again later.
  </Accordion>
  <Accordion title="Working resume unavailable">
    The resume this chat worked on was deleted, so the chat is read-only. Start a new chat from another resume.
  </Accordion>
  <Accordion title="This agent chat could not be opened">
    The chat was deleted, or the link belongs to a different account. Select **Back to chats** to see yours.
  </Accordion>
</AccordionGroup>
