# AI agent tools

> The tools the agent uses in the Agent workspace and in the builder, and how they affect your resume.

While it chats with you, the agent uses a small set of tools to read your resume, read files, ask you questions and change the resume. You don't call these tools yourself: the agent picks them when your request needs them.

The agent has a different set of tools in each place:

- In the full-page [Agent workspace](https://docs.hiresweep.com/guides/using-ai-agent), it changes a working copy of your resume straight away, and you can restore it.
- In the [builder's Agent card](https://docs.hiresweep.com/guides/using-ai-in-the-builder), it can only suggest edits. Your resume changes only when you accept them.

## Tools in the Agent workspace

| Tool                 | What it does                                                                                       | Example request                                       |
| -------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| `read_resume`        | Reads the working copy of your resume.                                                             | "What are the weakest parts of this resume?"          |
| `read_attachment`    | Reads a file you attached. Text, Markdown and JSON files are read as text; images and PDFs go to the model directly. | "Use the attached notes to update the keywords." |
| `ask_user_question`  | Shows a question card with suggested answers when the agent needs your decision.                   | "Ask me before changing the career narrative."        |
| `apply_resume_patch` | Applies one batch of edits to the working copy and keeps a snapshot from before it, so you can restore it. | "Change the name on my resume to Jane Doe."    |

## Tools in the builder

| Tool                   | What it does                                                                                                    |
| ---------------------- | --------------------------------------------------------------------------------------------------------------- |
| `read_resume`          | Reads the resume open in the builder, including when it was last saved.                                         |
| `read_job_post`        | Reads the job post attached to the Agent card: title, company, requirements, keywords and the keywords the last score found missing. |
| `propose_resume_edits` | Stages suggested edits as cards you accept, skip or ask to rewrite. Each card is one change with a short label, a one-line reason and, with a job post, its estimated gain in match points. |
| `ask_user_question`    | Shows a question card with suggested answers, for example when a missing fact would make an edit much stronger. |
| `read_attachment`      | Reads a file attached to the chat.                                                                              |

In the builder, the agent is told not to invent facts. Suggestions that add employers, titles, schools, skills, numbers or dates your resume and messages don't already state are refused. It also leaves the design alone: templates, colors, fonts and layout stay in the Design panel.

## Web search

When the model Hiresweep AI is using supports it, the agent can also use a `web_search` tool to look up a company, a role or a public page you link to. It isn't always available. When it isn't, the agent tells you it can't browse and asks you to paste or attach the content instead. Pasting the job description or attaching it as a file always works.

## How changes are applied in the Agent workspace

Edits are JSON Patch operations rooted at the resume data. For example, the name at the top of the resume is at `/basics/name`. The agent groups related edits into one change.

When the agent applies a change:

- the working copy updates and the resume column refreshes;
- the chat shows a card labelled **Applied changes**, with how many edits it made;
- **Details** on the card shows the exact operations;
- a snapshot is kept so you can select **Restore** to put the resume back to how it was before that change.

Restoring an older change also rolls back every change made after it. If the resume changed after the agent read it, the change can fail with **Change conflicted**. Ask the agent to try again from the latest version.

## Good prompts for tool use

Tell the agent what to use and how careful to be:

- "Read the attached job description and ask me before changing anything outside the summary."
- "Identify the most important keywords in the job post below and make only conservative changes."
- "Change the name on my resume, then show me what changed."

## When tools aren't available

- An archived chat can't receive new messages.
- A chat whose working resume was deleted is read-only.
- Web search is available only when the model supports it.