# Creating and Managing Agents

Agents are the personal Aubrey workspaces you create for different needs.

## Jump to

* [Create another agent](#create-another-agent)
* [Open or switch agents](#open-or-switch-agents)
* [Review agent instructions](#review-agent-instructions)
* [Use the workspace tabs](#use-the-workspace-tabs)

## Create another agent

You can create more agents from the Agents page or from an existing agent workspace.

From the Agents page:

1. Open **Agents**.
2. Choose **New agent**.
3. Complete the setup flow.

From an agent workspace:

1. Open the agent workspace.
2. Use the new agent button near the agent switcher.
3. Complete the setup flow.

Your plan may limit how many agents you can create. You can check your current limit in **Settings** -> **Billing**.

## Open or switch agents

If you have existing agents, the Agents page shows them as cards. Select a card to open that agent.

Inside an agent workspace, use **Switch agent** to move between agents, or choose **All agents** to return to the full list.

If you have no agents yet, Aubrey sends you to onboarding so you can create the first one.

## Review agent instructions

The workspace header includes **Agent instructions**. Open it to review the instructions Aubrey is using for that agent.

These instructions come from the setup preview and help shape how Aubrey responds in that workspace.

## Use the workspace tabs

Each agent has a workspace panel with tabs:

* **Recipes**: turn on suggested workflows when Aubrey recommends them.
* **Tools**: review hosted skills, connected accounts, and selected Google Workspace files.
* **Channels**: pair Telegram or WhatsApp so you can chat outside the web app.
* **Share**: invite collaborators to use the agent.
* **Email**: copy the agent email address and handle email setup prompts.
* **Calendar**: copy, regenerate, or disable the Aubrey calendar feed.
* **Conversations**: open recent web, email, Telegram, or WhatsApp conversations.

## FAQ

### Can I rename or edit an agent here?

This guide only covers controls shown in the current workspace. If you do not see an edit control for a specific field, use chat to tell Aubrey what you want changed or create a new agent with updated setup details.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://aubrey-agent.gitbook.io/aubrey-docs/documentation/getting-started/creating-and-managing-agents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.