> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qxlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an agent

An agent is defined by its identity, model, instructions, capabilities, apps, knowledge, and channels. Go to **Agents** → **New Agent** to open the agent editor, then work through the sections below.

<Steps>
  <Step title="Identity, model, and instructions">
    Give the agent an avatar, a **Name** (e.g. "Marketing assistant"), and a short **Description** shown in the agent picker. Choose its model from the quick picks - **Recommended**, **Smartest**, or **Fast & Cheap** - or any permitted model. Then write the system prompt: the agent's personality, task, rules, and output format. See [Models and instructions](/agents/models-and-instructions).

    <Frame>
      <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/create-an-agent/identity-model-instructions-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=d56d315b8b611badc2ecb78ea922f11a" alt="Agent editor showing avatar, name, description, model, and instructions fields" width="767" height="553" data-path="images/agents/create-an-agent/identity-model-instructions-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/create-an-agent/identity-model-instructions-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=24889b7c32ce80c6cdd06132fa96d94b" alt="Agent editor showing avatar, name, description, model, and instructions fields" width="767" height="553" data-path="images/agents/create-an-agent/identity-model-instructions-dark.png" />
    </Frame>
  </Step>

  <Step title="Capabilities, apps, and knowledge">
    Toggle the agent's built-in [capabilities](/agents/capabilities), like web search and plenty more, plus [**Workspace Access**](/agents/persistent-workspace). Pick the [connected apps](/agents/apps-and-knowledge) it can use, down to individual tools. Attach the knowledge vaults it can search and cite.

    <Frame>
      <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/create-an-agent/capabilities-apps-knowledge-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=e04af2d2d35d492839fb4edab89671fe" alt="Agent editor showing capability toggles, connected apps, and knowledge vaults" width="798" height="858" data-path="images/agents/create-an-agent/capabilities-apps-knowledge-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/create-an-agent/capabilities-apps-knowledge-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=b86b3bfc52c49171a3054df4542c14ab" alt="Agent editor showing capability toggles, connected apps, and knowledge vaults" width="798" height="858" data-path="images/agents/create-an-agent/capabilities-apps-knowledge-dark.png" />
    </Frame>
  </Step>

  <Step title="Communication">
    Optionally enable email, WhatsApp, or a Slack bot for the agent. See [Agent communications](/agents/communication-channels).

    <Frame>
      <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/create-an-agent/communication-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=dbdb6007c0db0da345181698d7ffe6f1" alt="Agent editor communication section with email, WhatsApp, and Slack bot options" width="762" height="405" data-path="images/agents/create-an-agent/communication-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/create-an-agent/communication-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=e756514a304b3a2a170f864346b60e70" alt="Agent editor communication section with email, WhatsApp, and Slack bot options" width="762" height="405" data-path="images/agents/create-an-agent/communication-dark.png" />
    </Frame>
  </Step>
</Steps>

Click **Create agent**, then **Start chat** to try it immediately.

## Editing and deleting

Reopen any agent from the Agents list to edit it. **Save changes** applies immediately to future conversations. **Delete agent** removes it permanently.

## Tips for effective agents

* Keep instructions specific: who the agent is, what a good answer looks like, what it should never do.
* Only attach the apps and vaults the agent actually needs - smaller toolsets make agents faster and more predictable.
* Test in chat as you iterate; you can edit the agent and start a fresh chat side by side.