> For the complete documentation index, see [llms.txt](https://docs.diaflow.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.diaflow.io/teammates/introduction-to-diaflow-teammate/hiring-and-creating-a-teammate.md).

# Hiring & Creating a Teammate

Add AI coworkers to your workspace by describing your needs to AI, selecting pre-built specialists from the Talent Pool, or manually building a custom Teammate.

Diaflow provides three flexible ways to bring an AI Teammate into your organization:

1. **Generate with AI (Prompt or Template):** Describe the role in natural language or pick a template, and Diaflow will generate the candidate for you.
2. **Hire from the Talent Pool:** Onboard pre-configured specialists (e.g., Marketing, Security, Legal) with a single click.
3. **Build Your Own:** Manually create a Teammate with a custom name, job title, and avatar.

## Generate a Teammate with AI <a href="#user-content-1-generate-a-teammate-with-ai-recommended" id="user-content-1-generate-a-teammate-with-ai-recommended"></a>

**How to Generate:**

1. Click the **`+ Hire`** button on your main Teammates page.
2. In the top prompt bar, choose one of two options:
   * **Custom Prompt:** Type your specific requirements into the input field (e.g., *"A marketing teammate who handles analytics, content, competitor research, and posts to Slack"*).
   * **Use a Template:** Click the **`Template ▾`** button, select your department (e.g., *Marketing*), and choose a pre-configured template such as **Content Review Scheduler**, **Campaign Asset Organizer**, or **Social Content Assistant**. This will automatically fill the prompt bar for you.
3. Click the **Up Arrow icon `↑`** (or press `Enter`) to let Diaflow generate your new Teammate.
4. Complete the **Tool Connection Step** or click **Connect later**.

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FFH4lEx8bVI6osoaFkYtY%2Frounded-image%20(27).png?alt=media&amp;token=b40a8027-fe4e-4dbc-b2c2-922e988aa4d6" alt=""><figcaption></figcaption></figure>

## Hire from the Talent Pool <a href="#user-content-2-hire-from-the-talent-pool" id="user-content-2-hire-from-the-talent-pool"></a>

If you prefer pre-built specialists with verified skill sets, choose from the **Talent Pool** section below the prompt bar:

* **Browse Candidates:** Scroll through role cards (e.g., *Nora – Brand PR & Corporate Comms*, *Ethan – Cybersecurity & SecOps Analyst*, *Sophia – Solutions Architect*).
* **Review Integrations:** See which connected apps the Teammate is designed to use (Gmail, Slack, Jira, Notion).
* **Onboard:** Click **Onboard** to proceed directly to the tool connection step, or click **View profile** to inspect detailed capability notes.

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FY3s7DvsODOD9bdd0mQFu%2Frounded-image%20(28).png?alt=media&amp;token=b7d2a928-bae2-49b3-9afa-70e9fea95326" alt=""><figcaption></figcaption></figure>

#### 💡 Connecting Tools During Onboarding <a href="#user-content--connecting-tools-during-onboarding-optional" id="user-content--connecting-tools-during-onboarding-optional"></a>

Immediately after generating or onboarding a Teammate, an onboarding dialog will prompt you to connect their required tools:

* **Connect Tools:** Click **`+`** next to any service (e.g., *Slack, Notion, LinkedIn, Gmail*) to authenticate and review granular permissions (*Actions & Permissions*).
* **Connect Later:** You do not need to connect all tools right away. Click **Connect later** at the bottom to jump straight into chat. You can always connect tools anytime via **Teammate Settings → Connectors**.

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2Fx1LfrIcp0clUc9lHK3oh%2Frounded-image%20(30).png?alt=media&amp;token=91cd1832-8fd2-4101-ab98-14b50a55fe54" alt="" width="563"><figcaption></figcaption></figure>

## Build Your Own Teammate (Manual Setup) <a href="#user-content-3-build-your-own-teammate-manual-setup" id="user-content-3-build-your-own-teammate-manual-setup"></a>

If you want complete manual control over identity from the ground up:

**Step-by-Step Guide:**

1. In the hiring modal, click the dark **Build your own teammate →** button in the top-right corner.
2. In the dialog that appears:
   * **Name:** Enter a name for your AI coworker (e.g., *Kim*, *Alex*).
   * **Title:** Specify their role (e.g., *Financial Manager*, *QA Triage Lead*).
   * **Avatar:** Select an illustrated persona from the avatar gallery, or click the **Upload icon `↑`** to use a custom profile picture.
3. Click **Create**.

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FcIghbtTq3KMLfto1pp8g%2Frounded-image%20(29).png?alt=media&amp;token=18b44355-d3fc-4c63-9667-867dfe25bbbb" alt="" width="563"><figcaption></figcaption></figure>

Your new Teammate will be created immediately and added to your **Teammates** directory.

> **Note on Advanced Configuration:**\
> When building your own teammate, you only need to provide their basic identity details at this step. Advanced capabilities - such as installing **Skills**, connecting **App Connectors**, setting behavioral **Instructions**, and creating **Quick Tasks** - are configured afterwards inside the **Teammate Settings** modal.

### Next steps <a href="#user-content-next-steps" id="user-content-next-steps"></a>

Now that your Teammate is part of your workspace, learn how to collaborate with them:

* [**Chat & Daily Work**](/teammates/chat-and-daily-work.md): Learn how to assign tasks, use Quick Task shortcuts, and manage generated artifacts.
* [**Teammate Settings**](/teammates/teammate-settings.md): Fine-tune instructions, reasoning levels, and third-party app connections.