> ## 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.

# Create Your First AI Actor

> Step-by-step guide to creating your first AI Actor in Vocalis. Configure voice, write a Purpose, define insights, and set up reports — no code required.

An AI Actor is your AI-powered interviewer. This guide walks you through setting one up.

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/getting_started/create_your_first_actor.png?fit=max&auto=format&n=29PVoPfbm1UtpFr0&q=85&s=009c5fa48249628d32647c7b4ba46e16" width="1920" height="1440" data-path="images/getting_started/create_your_first_actor.png" />
</Frame>

The setup wizard has four steps:

<Steps>
  <Step title="Actor — name and voice">
    Give your AI Actor a name and choose how it sounds.

    * **Name** — A display name for your team (e.g., "Screen - Backend Engineer"). Candidates do not see this.
    * **Voice** — Pick a voice model. Each has a different tone and feel.
    * **Language, tone, and speed** — Set the conversational style.

    <Frame caption="Step 1: Give your AI Actor a name and choose its voice and style.">
      <img src="https://mintcdn.com/wittingai/29PVoPfbm1UtpFr0/images/getting_started/create_your_first_actor_step_1.png?fit=max&auto=format&n=29PVoPfbm1UtpFr0&q=85&s=7c43a5b1b735dabb003c74300e19354e" width="1920" height="1440" data-path="images/getting_started/create_your_first_actor_step_1.png" />
    </Frame>
  </Step>

  <Step title="Purpose — the instructions">
    Write the instructions that tell the AI what to do during the interview. A good Purpose includes the context, the questions to ask, behavior guidelines, and evaluation criteria.

    Here is a simple starting point:

    ```
    You are conducting a 15-minute screening call for a Software Engineer
    position at Acme Corp.

    Ask these questions in order:
    1. Tell me about your current role and responsibilities.
    2. What programming languages are you most experienced with?
    3. Why are you interested in this position?
    4. What are your salary expectations?
    5. When would you be available to start?

    Be friendly and conversational. If the candidate gives a short answer,
    ask a brief follow-up to get more detail.
    ```

    See [Actor Purpose](/vocalis/how-to/actor-purpose) for tips on writing better instructions.

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

  <Step title="Insights — what data to extract">
    Define the structured data points Vocalis should pull from each conversation. Click **Add Insight** and set a name, type, and description for each one.

    Example insights:

    | Insight name           | Type | What it captures                          |
    | ---------------------- | ---- | ----------------------------------------- |
    | Current role           | Text | Candidate's current job title and company |
    | Primary technologies   | Text | Main languages and frameworks             |
    | Salary expectations    | Text | Stated compensation range                 |
    | Overall recommendation | Text | Strong Yes / Yes / Maybe / No             |

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

  <Step title="Reports — how results are packaged">
    Configure how interview results are summarized. Review the settings and click **Save** to create your AI Actor.

    <Frame caption="Step 4: Configure reporting and save your AI Actor.">
      <img src="https://mintcdn.com/wittingai/29PVoPfbm1UtpFr0/images/getting_started/create_your_first_actor_step_4.png?fit=max&auto=format&n=29PVoPfbm1UtpFr0&q=85&s=9c1870738cc1ae431edede0ab5a4f6e9" width="1920" height="1440" data-path="images/getting_started/create_your_first_actor_step_4.png" />
    </Frame>
  </Step>
</Steps>

## Test before going live

Before using your AI Actor with real candidates:

1. Create a test meeting with yourself as the participant.
2. Go through the interview as if you were a candidate.
3. Review the transcript and insights — adjust as needed.

## Next steps

<Columns cols={2}>
  <Card title="Create a Meeting" icon="calendar" href="/vocalis/getting-started/schedule-meeting">
    Put your AI Actor to work.
  </Card>

  <Card title="Actor Purpose" icon="pen" href="/vocalis/how-to/actor-purpose">
    Write better instructions for your AI Actors.
  </Card>
</Columns>