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

# AI Actor

> How to create an AI Actor in Vocalis. Walk through the three-step setup wizard — Actor, Purpose, and Insights — to build your AI interviewer.

An AI Actor is your AI-powered interviewer. You create one by walking through a three-step wizard in the Vocalis dashboard.

## Open the setup wizard

1. Log in to [vocalis.witting.ai](https://vocalis.witting.ai).
2. Click **AI Actors** in the left sidebar.
3. Click **Create Actor**.

<Frame caption="Your AI Actors page — click Create Actor to get started.">
  <img src="https://mintcdn.com/wittingai/29PVoPfbm1UtpFr0/images/how_to/ai_actor.png?fit=max&auto=format&n=29PVoPfbm1UtpFr0&q=85&s=60a06ccc5fc45921dfbc135dac23a1f8" width="1920" height="1440" data-path="images/how_to/ai_actor.png" />
</Frame>

## Step 1: Actor

Define your AI Actor's identity, how it behaves in meetings, and how it sounds.

### Actor's Identity

| Setting         | What it controls                                            |
| --------------- | ----------------------------------------------------------- |
| **Icon**        | A visual icon for the Actor card.                           |
| **Actor Name**  | A display name for your team (e.g., "UI/UX Interviewer").   |
| **Use Case**    | The type of conversation — Interview, Sales Discovery, etc. |
| **Description** | A short summary shown on the Actor card.                    |
| **Tags**        | Labels to organize and filter your Actors.                  |

A live **Preview Card** on the right shows how the Actor will appear in your dashboard.

### Meeting Led By

Choose who drives the conversation:

* **Actor-led** — The AI Actor leads with dynamic questions and follow-ups.
* **User-led** — The AI supports your lead, responding and assisting as needed.

### Tool Access

Choose what your Actor can use during meetings.

| Tool                | What it does                                      | Status      |
| ------------------- | ------------------------------------------------- | ----------- |
| **Screen Share**    | View and analyze the participant's shared screen. | Available   |
| **Web Sources**     | Look up real-time information from the web.       | Coming soon |
| **Knowledge Files** | Access your uploaded company docs and files.      | Coming soon |
| **Tools / MCP**     | Connect with external apps or APIs.               | Coming soon |

### Conversation Style

| Setting      | What it controls                                      |
| ------------ | ----------------------------------------------------- |
| **Language** | What language the AI speaks in (e.g., English).       |
| **Voice**    | The voice model — each has a different tone and feel. |
| **Speed**    | How quickly the AI talks (Slow, Normal, Fast).        |
| **Tone**     | Professional, Friendly, Warm, etc.                    |

### Conversation Behaviors

Toggle switches that control the Actor's flexibility during conversations.

| Behavior                          | What it does                                      |
| --------------------------------- | ------------------------------------------------- |
| **Allow Small Talk**              | Build rapport with greetings and casual comments. |
| **Mirror Participant's Language** | Respond in the user's language.                   |
| **Use Humor**                     | Introduce light humor when appropriate.           |

<Frame caption="Step 1: Define your Actor's identity, tools, and conversation style.">
  <img src="https://mintcdn.com/wittingai/29PVoPfbm1UtpFr0/images/how_to/ai_actor_step_1.png?fit=max&auto=format&n=29PVoPfbm1UtpFr0&q=85&s=8afdb689514e1b2e06871cd8e540fc3f" width="1920" height="1440" data-path="images/how_to/ai_actor_step_1.png" />
</Frame>

## Step 2: Purpose

Write the instructions that tell the AI what to do during the conversation. The Purpose Builder has four fields:

| Field          | What to write                                                |
| -------------- | ------------------------------------------------------------ |
| **Role**       | Who the AI Actor is — name, title, personality.              |
| **Goals**      | What the conversation should accomplish and how to evaluate. |
| **Flow**       | How the conversation progresses from intro to wrap-up.       |
| **Guardrails** | Boundaries, edge cases, and time management.                 |

See [Actor Purpose](/vocalis/how-to/actor-purpose) for detailed guidance and examples.

<Frame caption="Step 2: Write the Purpose — your AI Actor's instructions for the conversation.">
  <img src="https://mintcdn.com/wittingai/29PVoPfbm1UtpFr0/images/how_to/actor_purpose.png?fit=max&auto=format&n=29PVoPfbm1UtpFr0&q=85&s=2713a3558e6e373227fed3823e8bfec5" width="1920" height="1440" data-path="images/how_to/actor_purpose.png" />
</Frame>

## Step 3: Insights

Define the structured data points Vocalis should extract from each conversation. See [Actor Insights](/vocalis/how-to/actor-insights) for details on configuring insights.

<Frame caption="Step 3: Define what insights to extract from each conversation.">
  <img src="https://mintcdn.com/wittingai/29PVoPfbm1UtpFr0/images/how_to/actor_insights.png?fit=max&auto=format&n=29PVoPfbm1UtpFr0&q=85&s=9654d719a494e2300083f551babb2583" width="1920" height="1440" data-path="images/how_to/actor_insights.png" />
</Frame>

## Next steps

<Columns cols={2}>
  <Card title="Actor Purpose" icon="pen" href="/vocalis/how-to/actor-purpose">
    Write effective instructions for your AI Actor.
  </Card>

  <Card title="Test Actor" icon="flask" href="/vocalis/how-to/test-actor">
    Test your AI Actor before going live.
  </Card>
</Columns>