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

# Quickstart

# Creating Your First AI Employee with Kafka

This quickstart will walk you through creating your first AI Employee using Kafka's core features. By the end, you'll understand how to set up Workflows, Playbooks, Integrations, and Tools to power your employee.

## Step 1: Choose Your AI Employee Template

<AccordionGroup>
  <Accordion title="AI Executive Assistant" icon="briefcase" defaultOpen>
    An AI Employee that manages your inbox, calendar, and communications.

    **You'll learn to build:**

    * Daily email summary with phone call workflow (9am trigger)
    * Professional email formatting playbook
    * Gmail and Google Calendar integrations
  </Accordion>

  <Accordion title="AI Recruiter" icon="users">
    An AI Employee that finds candidates and tracks your recruiting pipeline.

    **You'll learn to build:**

    * Daily candidate outreach workflow (10am trigger)
    * Recruiting pipeline update playbook
    * Apollo and Greenhouse integrations
  </Accordion>

  <Accordion title="AI Project Manager" icon="list-check">
    An AI Employee that syncs tasks and coordinates team work.

    **You'll learn to build:**

    * Daily Slack-to-task sync workflow (5pm trigger)
    * Add task to ClickUp playbook
    * Slack and ClickUp/Linear integrations
  </Accordion>
</AccordionGroup>

Expand one of these templates to see role-specific examples throughout this guide.

## Step 2: Open Your Employee Home Page

Navigate to your Kafka Employee Home Page. This is your control center for building, customizing, and managing your AI Employee.

<img src="https://mintcdn.com/brainbaselabs/exQYSXSDcC6isRCT/images/Kafka%20Home%20Screen.png?fit=max&auto=format&n=exQYSXSDcC6isRCT&q=85&s=fff3d5e04a5bf75a14e69208fa6eec7f" alt="Kafka Employee Home Page" className="rounded-lg border border-gray-200 dark:border-gray-800" width="2880" height="1462" data-path="images/Kafka Home Screen.png" />

## Step 3: Define Kafka's Role with Global Instructions

The Global Instructions are where you set your AI Employee's personality, boundaries, and always-on knowledge.

Go to: **My Kafka → Global Instructions**

<img src="https://mintcdn.com/brainbaselabs/exQYSXSDcC6isRCT/images/Kafka%20Global%20Instructions.png?fit=max&auto=format&n=exQYSXSDcC6isRCT&q=85&s=1e4fba47dbc6e635bde2ace08c6a1523" alt="Kafka Global Instructions Template" className="rounded-lg border border-gray-200 dark:border-gray-800" width="2880" height="1462" data-path="images/Kafka Global Instructions.png" />

Fill out the pre-made template to define your employee's mission, style, and constraints.

**Examples:**

<div className="ml-6">
  <Tabs>
    <Tab title="Executive Assistant">
      ```text theme={null}
      You are my AI Executive Assistant. 

      Always respond politely and concisely. 

      Prioritize my calendar, task deadlines, and external communications. 

      Defer to human input for financial approvals.
      ```
    </Tab>

    <Tab title="Recruiter">
      ```text theme={null}
      You are my AI Recruiter. 

      Screen candidates based on job requirements and schedule interviews automatically.

      Maintain a professional tone. 

      Always verify candidate details before proceeding with outreach.
      ```
    </Tab>

    <Tab title="Project Manager">
      ```text theme={null}
      You are my AI Project Manager. 

      Track project timelines, coordinate team tasks, and flag potential delays. 

      Maintain clear communication with stakeholders. 

      Escalate critical blockers immediately.
      ```
    </Tab>
  </Tabs>
</div>

This ensures your Kafka Employee consistently operates with the right framing.

## Step 4: Add Integrations

1. Go to: **My Kafka → Integrations**
2. Connect Google Calendar

<img src="https://mintcdn.com/brainbaselabs/exQYSXSDcC6isRCT/images/Integrations.gif?s=d359ab47cdc8f4828f589cb5756ecf90" alt="Kafka Integrations Panel" className="rounded-lg border border-gray-200 dark:border-gray-800" width="1144" height="720" data-path="images/Integrations.gif" />

Connect the integrations your AI Employee needs:

<Tabs>
  <Tab title="Executive Assistant">
    * **Gmail** — for email scanning and management
    * **Google Calendar** — for scheduling and meeting coordination
  </Tab>

  <Tab title="Recruiter">
    * **Apollo** — for people and company search
    * **Greenhouse** — for ATS data
  </Tab>

  <Tab title="Project Manager">
    * **Slack** — for scanning messages and team communication
    * **ClickUp or Linear** — for task and project management
  </Tab>
</Tabs>

Use `@[integration]` to reference integrations from within workflows and playbooks.

## Step 5: Deploy to Slack (Optional)

Connect Kafka to Slack so your team can interact with your AI Employee directly in your workspace.

> **Note:** Deploying to Slack requires upgrading to the \$25 Starter plan.

Go to: **My Kafka → Connection**

<img src="https://mintcdn.com/brainbaselabs/exQYSXSDcC6isRCT/images/Slack%20My%20Kafka.png?fit=max&auto=format&n=exQYSXSDcC6isRCT&q=85&s=70a1dbe4d0074f1d7bd2221077ec775c" alt="Kafka Slack Connection" className="rounded-lg border border-gray-200 dark:border-gray-800" width="2880" height="1462" data-path="images/Slack My Kafka.png" />

Add Slack as a connection method to enable:

* Direct messaging with Kafka in Slack
* Channel mentions and interactions
* Real-time notifications and updates
* Team collaboration with your AI Employee

<img src="https://mintcdn.com/brainbaselabs/exQYSXSDcC6isRCT/images/Slack%20Message.gif?s=3934ed91d8c8055523b5167d6ad236d9" alt="Messaging Kafka in Slack" className="rounded-lg border border-gray-200 dark:border-gray-800" width="1084" height="720" data-path="images/Slack Message.gif" />

## Step 6: Build Workflows

Workflows are automated sequences that Kafka runs autonomously when triggered.

<img src="https://mintcdn.com/brainbaselabs/exQYSXSDcC6isRCT/images/Workflow%20Editing.gif?s=8a069850b0d7355dd4a6e62f8aab4813" alt="Creating a workflow in Kafka" className="rounded-lg border border-gray-200 dark:border-gray-800" width="1144" height="720" data-path="images/Workflow Editing.gif" />

**Workflow triggers:**

* **Time-based** — daily at 9am, weekly on Monday, hourly between 9am-5pm
* **App-based** — new email in Gmail, new candidate in Greenhouse, Slack keyword mention
* **Webhook-based** — external API calls, form submissions, payment events

Once triggered, Kafka executes your instructions automatically without manual intervention.

<Tabs>
  <Tab title="Executive Assistant">
    ```yaml theme={null}
    name: Daily Inbox Call
    trigger: daily at 9 am

    Content:
    1. Scan through my email using @gmail for all emails in the last day
    2. Summarize everything and the most important ones to call
    3. Call me at [number], informing me of everything.
    ```
  </Tab>

  <Tab title="Recruiter">
    ```yaml theme={null}
    name: Daily Candidate Outreach
    trigger: daily at 10 am

    Content:
    1. Use @apollo to find people matching [profile]
    2. Send them an outreach message
    ```
  </Tab>

  <Tab title="Project Manager">
    ```yaml theme={null}
    name: Daily Task Sync
    trigger: daily at 5 pm

    Content:
    1. Scan through Slack to search for any new items to add to our project management software
    2. Add it to @linear or @clickup
    ```
  </Tab>
</Tabs>

## Step 7: Create Playbooks

Playbooks are structured guides for repeated, semi-structured tasks — your AI Employee's SOPs (standard operating procedures).

Unlike Workflows which run fully autonomously, Playbooks are designed for tasks that need human collaboration or oversight.

<img src="https://mintcdn.com/brainbaselabs/exQYSXSDcC6isRCT/images/Playbook%20Usage.gif?s=6ae44129cc754186a423449a1c187a45" alt="Using a playbook in Kafka" className="rounded-lg border border-gray-200 dark:border-gray-800" width="1144" height="720" data-path="images/Playbook Usage.gif" />

**Examples:**

<Tabs>
  <Tab title="Executive Assistant">
    ```yaml theme={null}
    name: Structure Professional Email
    activation_criteria: When drafting an external email to executives or clients

    Format:
    1. Subject: Clear and action-oriented (5-8 words max)
    2. Greeting: Use "Hi [First Name]," for warm contacts, "Hello [Full Name]," for formal
    3. Opening: State purpose in first sentence
    4. Body: Use bullet points for multiple items, keep paragraphs to 2-3 sentences
    5. Closing: Include clear next steps or call-to-action
    6. Signature: Use professional signature with title and contact info

    Tools: @gmail, @google-calendar
    ```
  </Tab>

  <Tab title="Recruiter">
    ```yaml theme={null}
    name: Daily Recruiting Pipeline Update
    activation_criteria: When asked for pipeline status or daily recruiting summary

    Content:
    1. Pull data from @greenhouse for all active requisitions
    2. Summarize by role:
       - Total candidates in pipeline
       - Candidates by stage (Sourced, Screening, Interview, Offer)
       - Candidates moved forward in last 24 hours
       - Candidates rejected in last 24 hours
    3. Flag roles with <5 candidates in pipeline
    4. Highlight any offers extended or accepted
    5. Format as bulleted summary and send via Slack to #recruiting

    Tools: @apollo, @greenhouse
    ```
  </Tab>

  <Tab title="Project Manager">
    ```yaml theme={null}
    name: Add Task to ClickUp
    activation_criteria: When a new task or action item is identified in Slack or meetings

    Instructions:
    1. Extract task details from context
    2. Create task in @clickup with:
       - Name: [Clear, action-oriented task title]
       - Description: [Context and requirements]
       - Assignee: [Team member mentioned or default to PM]
       - Due Date: [Extract from context or ask if unclear]
       - Priority: [Urgent/High/Normal/Low based on context]
       - Tags: [Project name, task type]
       - List: [Appropriate project list or "Backlog" if unclear]
    3. Confirm task created and share ClickUp link in original thread

    Tools: @slack, @clickup, @linear
    ```
  </Tab>
</Tabs>

## Step 8: Test and Refine

Your AI Employee improves through iteration. Start using it in real scenarios, observe performance, and refine:

1. **Deploy in real use** — Use Kafka for actual work, not just testing
2. **Observe performance** — Notice where Kafka excels or struggles
3. **Refine instructions** — Adjust Global Instructions, Workflows, and Playbooks
4. **Iterate weekly** — Small, frequent improvements compound quickly

The best AI Employees are refined over weeks of real-world use. Don't expect perfection immediately.

## Get Support

We're constantly adding new features and want to personally help our first customers.

* **Email:** [michael@usebrainbase.xyz](mailto:michael@usebrainbase.xyz) for personal support
* **In-app:** Use the support widget in the app for quick help

Your feedback helps us build a better product for everyone.
