# Your first agent

Source: https://www.hyperagent.com/docs/get-started/your-first-agent

> For AI agents: the documentation index is at https://www.hyperagent.com/llms.txt and the complete documentation in one file at https://www.hyperagent.com/llms-full.txt. Any docs page is also served as Markdown by appending `.md` to its URL.

Turn a job worth repeating into a teammate.

You just ran a job in a thread and steered it right. An **agent** makes that the starting point instead of something you rebuild: a named teammate carrying the instructions, tools, and knowledge the job needs, into every future run.

The best first agent already exists: it's the thread where you just corrected
the work into shape. Hyperagent reads that conversation and drafts the agent
from it, so the briefing you refined becomes the agent's standing
instructions.

## Promote the thread [#promote-the-thread]

### Save the thread as an agent [#save-the-thread-as-an-agent]

In the thread where the work went well, open the **…** menu in the header and choose **Save as agent**. Hyperagent reads the conversation, analyzes the patterns, and generates a draft: name, description, and instructions, all taken from how the work actually went.

### Review what it wrote [#review-what-it-wrote]

The draft opens in the agent editor with everything pre-filled and everything editable. Read the instructions like a job description: is this what you'd tell a new hire doing this job?



### Create it, then run it once [#create-it-then-run-it-once]

Click **Create Agent**, then start a new thread with the agent and give it the same kind of job. It should land close to where your corrected thread ended up, without the corrections.

Starting from scratch works too: **New agent** from the Agents list gives you the same editor, blank. Reach for it when the job exists only in your head, not in a thread yet.

## What makes a good first agent [#what-makes-a-good-first-agent]

* **A job you did this week and will do again.** A weekly summary, a report format, a research routine. Recurrence is what pays for the setup.
* **One job, not a department.** "Writes renewal briefs" beats "handles customer stuff." You can always make a second agent.
* **Instructions that would brief a person.** The draft gives you a start; sharpen it with the two or three rules you found yourself repeating in the thread.

## What the agent carries, and what it doesn't [#what-the-agent-carries-and-what-it-doesnt]

The agent brings its identity, instructions, tools, and knowledge into every new thread. It doesn't bring the old thread's conversation: each run starts clean, which is what keeps run fifty as sharp as run one. What should persist between runs becomes a memory or a skill, and that's the [next lesson](https://www.hyperagent.com/docs/get-started/teach-it-something).

## FAQs [#faqs]

No. **Save as agent** is the strongest starting point when you've already shaped a real piece of work, because the draft comes from decisions you actually made. If the role only exists in your head, choose **New agent** from the Agents list and write the brief directly.

Check that it owns one clear responsibility, knows what a good result looks like, and has the judgment rules you found yourself repeating in the thread. Keep durable facts in memories and repeatable methods in skills rather than packing everything into the instructions. See [Agent configuration](https://www.hyperagent.com/docs/concepts/agents/configuration).

It uses the thread to draft its configuration, but it doesn't carry the conversation into future runs. Each new thread starts clean with the agent's instructions, tools, and knowledge. Save facts or preferences as memories and methods as skills when they should persist.

**Next:** teach it something it'll never forget. [Teach it something →](https://www.hyperagent.com/docs/get-started/teach-it-something)