# Creating an Agent

> Step-by-step guide to creating an agent.

**URL:** https://inference.sh/docs/agents/creating
**Last updated:** 2026-10-11

---

Step-by-step guide to creating an agent.

---

## Open the Agent Creator

1. Go to [Agents](https://app.inference.sh/agents)
2. Click **New Agent**

---

## Name Your Agent

Give it a clear name:

- `image-creator`
- `content-assistant`
- `data-analyzer`

Names should be lowercase with hyphens.

---

## Choose an LLM

The AI model that powers reasoning:

| Model | Best for |
|-------|----------|
| GPT-4 | Complex reasoning, most capable |
| Claude | Long documents, detailed responses |
| GPT-3.5 | Fast, cost-effective |

You can change this later.

---

## Write a System Prompt

See [Writing System Prompts](/docs/agents/system-prompts).

---

## Add Tools

Go to the **Tools** tab to add:

| Tool Type | What it does |
|-----------|--------------|
| **App** | Call apps from the grid |
| **Agent** | Delegate to other agents |
| **Connector** | MCP server tools (Linear, Slack, etc.) |
| **Call** | Make HTTP API calls |
| **Hook** | Call external webhooks |

See [Adding Tools](/docs/agents/adding-tools) for details.

If your agent uses **call tools** with dynamic URLs (for example `{{context.project_id}}`), declare [context fields](/docs/agents/adding-tools#context) so each chat can target the right resource.

---

## Permissions (optional)

Open the **permissions** tab in the agent editor (shield icon in the sidebar) to set what **new chats** with this agent may do without asking.

| Setting | What it does |
|---------|--------------|
| **Allow every tool** | Each new chat starts with every tool call allowed, remote commands included, so unattended runs (webhooks, schedules, triggers) are not blocked on approvals. Users can turn it off per chat in [chat settings → Permissions](/docs/agents/chatting#permissions). Workspace and organization policy still applies. |

These defaults are saved on the agent **version** (`permissions.allow_all_tools`). They are copied into a chat once when the conversation is created; changing the template or redeploying does not alter chats that already exist.

→ [Agent template defaults](/docs/api/agent/approval#agent-template-defaults) · [REST `version.permissions`](/docs/api/rest/agents#agent-version-permissions)

---

## Save

Click **Save**. Your agent is ready.

Each save creates a new version, so you can always go back.

---

## Test It

1. Click **Chat with Agent**
2. Try a few messages
3. Watch how it uses tools
4. Refine the system prompt based on results

---

## Next

→ [Writing System Prompts](/docs/agents/system-prompts)  
→ [Publishing and embedding](/docs/agents/publishing) — share the agent on external sites