# Creating an agent manually

Create a blank agent, name its single responsibility, write instructions, select a model, add capabilities, and save a version you can test.

![Creating an agent manually in Foxora v5.0.3](/docs/images/v5.0.3/studio/new-agent.webp)

## Where this lives

Open **studio → Agents**.

An agent is a reusable specialist with its own name, role, instructions, model, skills, tools, and optional provider key. Agents can work directly in tasks or as members of a crew.

> **Safety:** Do not place secrets in agent instructions. Add provider keys through the agent model settings and keep tool access limited to the agent’s actual job.

## Steps

1. Open **studio → Agents**.
2. Create a blank agent.
3. Name its single responsibility.
4. Write instructions.
5. Select a model.
6. Add capabilities.
7. Save a version you can test.
8. **Confirm the result.** Run the same test in a fresh task and confirm the agent follows its role, uses the intended tools, requests the expected approvals, and produces a verifiable result.

## Choose the right path

- Create with AI when you can describe the outcome but not every field.
- Create manually when exact instructions and permissions matter.
- Use a crew when the objective needs several distinct specialists.


## Confirm it worked

- Run the same test in a fresh task and confirm the agent follows its role, uses the intended tools, requests the expected approvals, and produces a verifiable result.
- The screen, command, file, run, or destination named in this guide reflects the expected state.