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

# Create your first Agent

> Create an Agent in the web app and open its chat.

An Agent is a persona with a mandate, such as a CTO or a QA lead. This guide creates one and opens its chat. It takes about a minute.

## Before you start

You need a Worksong account and a workspace. A new account with no Agents shows a **Create your first agent** button on **Home** and on **Agents**.

## Steps

1. Open **Agents** in the left rail. With no Agents yet, you see "No agents yet".
2. Select **Create your first agent**. Once you have an Agent, select the **+** button at the top of the list instead.
3. Fill in the form:
   * **Name** — what you call the Agent, for example `Ada`.
   * **Role** — a short title, for example `CTO`.
   * **Mandate** — what the Agent owns and how it should answer, for example `You are Ada, the CTO. Own architecture decisions and keep answers short.` The field holds up to 40,000 characters.
4. Pick a colour for the avatar, or type a hex value in **Colour**.
5. Select **Create**.

![The New agent form with Name Ada, Role CTO and a mandate](https://mintcdn.com/worksong/eq4k964yMBofksE3/images/guides/new-agent-form.png?fit=max\&auto=format\&n=eq4k964yMBofksE3\&q=85\&s=8586f3c6c8cde09215d204be9d5a3990)

The New agent form, filled in.

The chat with the new Agent opens. It says "Nothing said yet" until you write the first message.

![An empty chat with Ada and the message box at the bottom](https://mintcdn.com/worksong/eq4k964yMBofksE3/images/guides/new-agent-chat.png?fit=max\&auto=format\&n=eq4k964yMBofksE3\&q=85\&s=24d10e65b6849deb83f468b3d49afacf)

The new Agent's chat, before the first message.

## What the new Agent can do

A new Agent starts with **no tools** and **manual** autonomy. That means it can talk, and it asks you before any action. You grant tools later, on the Agent's own pages. See [Agents](/worksong/agents.md) and [Approvals](/worksong/approvals.md).

## Next

* [Send a message and read the reply](/guides/send-a-message.md)

<sub>Source: `worksong-ai/worksong:apps/mobile/src/features/bots/NewBotScreen.tsx@e5e65e9`, `worksong-ai/worksong:docs/API.md@e5e65e9`. Docs version: Worksong 2.0 with Work 1.2.</sub>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.