> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Snelstart

In deze handleiding leer je hoe je je eerste conversationele agent maakt. Dit vormt de basis voor conversationele workflows die zijn afgestemd op je zakelijke use cases.

> **Tip**
>
> Gebruik de [ElevenLabs agents skill](https://github.com/elevenlabs/skills/tree/main/agents) om voice agents te bouwen en beheren vanuit je AI-codingassistent:
>
> ```bash
> npx skills add elevenlabs/skills --skill agents
> ```
>
> Je kunt ook de [gehoste MCP-server](/docs/nl/eleven-agents/operate/hosted-mcp) verbinden met Claude of een andere MCP-client om agents met natuurlijke taal te maken en beheren.

## Aan de slag

ElevenLabs Agents worden beheerd via het [ElevenAgents-dashboard](https://elevenlabs.io/app/agents), de [ElevenLabs API](/docs/nl/api-reference/introduction), de [Agents CLI](/docs/nl/eleven-agents/operate/cli) of de [gehoste MCP-server](/docs/nl/eleven-agents/operate/hosted-mcp).

![ElevenLabs Agents](/docs/_fern-img/62ad20de44cee44a439b138d56764c801c4eb939cf3b0f167f594d5c6a6895fb.webp)

## Je eerste agent maken

In deze quickstart maken we eerst een agent via de API of het webdashboard. Daarna testen we de agent, door deze in je website in te sluiten of via het ElevenLabs-dashboard.

#### Een agent bouwen via het webdashboard

In deze handleiding maken we een conversationele supportassistent die vragen over je product, documentatie of service kan beantwoorden. Je kunt deze assistent in je website of app insluiten om je klanten realtime ondersteuning te bieden.

![ElevenLabs Agents](/docs/_fern-img/62ad20de44cee44a439b138d56764c801c4eb939cf3b0f167f594d5c6a6895fb.webp)

#### Inloggen bij ElevenLabs

Ga naar [elevenlabs.io](https://elevenlabs.io/app/sign-up) en log in of maak een account.

#### Een nieuwe assistent maken

Maak in het **ElevenLabs-dashboard** een nieuwe assistent door een naam in te voeren en de optie `Blank template` te selecteren.

![Dashboard](/docs/_fern-files/elevenlabs.docs.buildwithfern.com/61b0e1df291ea587a8ff3e116579a47f66d48c74b24f44cfcd4804a568eb0a9d/assets/images/conversational-ai/assistant-create-flow.gif)

#### Het gedrag van de assistent configureren

Ga naar het tabblad **Agent** om het gedrag van de assistent te configureren. Stel het volgende in:

#### Eerste bericht

Dit is het eerste bericht dat de assistent hardop uitspreekt wanneer een gebruiker een gesprek start.

**`Eerste bericht`**

```plaintext Eerste bericht
Hi, this is Alexis from <company name> support. How can I help you today?
```

#### Systeemprompt

Deze prompt stuurt het gedrag, de taken en de persoonlijkheid van de assistent.

Pas het volgende voorbeeld aan met de gegevens van je bedrijf:

**`Systeemprompt`**

```plaintext Systeemprompt
You are a friendly and efficient virtual assistant for [Your Company Name]. Your role is to assist customers by answering questions about the company's products, services, and documentation. You should use the provided knowledge base to offer accurate and helpful responses.

Tasks:
- Answer Questions: Provide clear and concise answers based on the available information.
- Clarify Unclear Requests: Politely ask for more details if the customer's question is not clear.

Guidelines:
- Maintain a friendly and professional tone throughout the conversation.
- Be patient and attentive to the customer's needs.
- If unsure about any information, politely ask the customer to repeat or clarify.
- Avoid discussing topics unrelated to the company's products or services.
- Aim to provide concise answers. Limit responses to a couple of sentences and let the user guide you on where to provide more detail.
```

#### Een kennisbank toevoegen

Ga naar het gedeelte **Knowledge Base** om je assistent context over je bedrijf te geven.

Hier kun je relevante documenten en links naar externe bronnen uploaden:

* Voeg documentatie, veelgestelde vragen en andere bronnen toe om de assistent te helpen reageren op vragen van klanten.
* Houd de kennisbank up-to-date, zodat de assistent nauwkeurige en actuele informatie geeft.

Vervolgens configureren we de stem voor je assistent.

#### Een stem selecteren

Kies op het tabblad **Voice** een stem uit de [stembibliotheek](https://elevenlabs.io/voice-library) die het beste bij je assistent past:

![Steminstellingen](/docs/_fern-img/14aad328f468daafa9ec95d3b7a55489a8cb1a34869368020e05b207c9b0360a.webp)

> **Note**
>
> Stemmen, modellen en LLM's van hogere kwaliteit kunnen de reactietijd verhogen. Zorg voor een optimale klantervaring door kwaliteit en latentie af te stemmen op de verwachte use case van je assistent.

#### Je assistent testen

Klik op de knop **Test AI agent** en probeer een gesprek met je assistent te voeren.

Configureer evaluatiecriteria en gegevensverzameling om gesprekken te analyseren en de prestaties van je assistent te verbeteren.

#### Evaluatiecriteria configureren

Ga naar het tabblad **Analysis** in de instellingen van je assistent om aangepaste criteria voor het evalueren van gesprekken te definiëren.

![Analyse-instellingen](/docs/_fern-img/fee8bc444d5436c71eae3829b9ec8d5cdb6a57c4d4efe6483d7bfed2b066e438.webp)

Elk gesprekstranscript wordt naar de LLM gestuurd om te controleren of specifieke doelen zijn behaald. De resultaten zijn `success`, `failure` of `unknown`, met een toelichting op het gekozen resultaat.

Laten we een evaluatiecriterium toevoegen met de naam `solved_user_inquiry`:

**`Prompt`**

```plaintext Prompt
The assistant was able to answer all of the queries or redirect them to a relevant support channel.

Success Criteria:
- All user queries were answered satisfactorily.
- The user was redirected to a relevant support channel if needed.
```

#### Gegevensverzameling configureren

Configureer in het gedeelte **Data collection** de gegevens die uit elk gesprek moeten worden geëxtraheerd.

Klik op **Add item** en configureer het volgende:

1. **Gegevenstype:** Selecteer "string"
2. **Identifier:** Voer een unieke identifier voor dit gegevenspunt in: `user_question`
3. **Beschrijving:** Geef de LLM gedetailleerde instructies over hoe de specifieke gegevens uit het transcript moeten worden geëxtraheerd:

**`Prompt`**

```plaintext Prompt
Extract the user's questions & inquiries from the conversation.
```

> **Tip**
>
> Test je assistent door je voor te doen als klant. Stel vragen, evalueer de antwoorden en pas de prompts aan totdat je tevreden bent met de prestaties.

#### Gespreksgeschiedenis bekijken

Bekijk de evaluatieresultaten en verzamelde gegevens voor elk gesprek op het tabblad **Call history**.

![Gespreksgeschiedenis](/docs/_fern-img/fd517a080ba2c0d678c1ce34ea79afbd0dad764a19da43ca045a1c29b693ee48.webp)

> **Tip**
>
> Bekijk de gespreksgeschiedenis regelmatig om veelvoorkomende problemen en patronen te herkennen.

De nieuw gemaakte agent kan op verschillende manieren worden getest, maar de snelste manier is via het [ElevenLabs-dashboard](https://elevenlabs.io/app/agents).

> **Info**
>
> Het webdashboard gebruikt onder de motorkap onze [React SDK](/docs/nl/eleven-agents/libraries/react) om realtime gesprekken af te handelen.

Wil je de agent liever snel op je eigen website testen, dan kun je de Agent-widget gebruiken. Plak eenvoudig het volgende HTML-fragment in je website en vervang `agent-id` door de ID van je agent.

```html
<elevenlabs-convai agent-id="agent-id"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async type="text/javascript"></script>
```

#### Een agent bouwen via de CLI

#### De CLI installeren

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> Werk je met een AI-code-assistent? Voer `elevenlabs generate-skills` uit in je project om voor elke
> commandogroep een `SKILL.md` naar `skills/` te schrijven, zodat je assistent alle mogelijkheden van de CLI kent
> zonder dat je documentatie hoeft te plakken. Gebruik `--output-dir` om ze ergens anders te plaatsen. Dit leest de eigen
> ingebouwde API-definitie van de CLI, dus er is geen API-sleutel nodig en het werkt offline — en het blijft afgestemd op
> de versie van de CLI die je hebt geïnstalleerd.

#### Een nieuw project initialiseren

```bash
elevenlabs agents init
```

Hiermee maak je de projectstructuur met configuratiemappen en registrybestanden.

#### Verifiëren bij ElevenLabs

[Maak hier een API-sleutel in het dashboard](https://elevenlabs.io/app/settings/api-keys), die je gebruikt om de CLI veilig [te gebruiken](/docs/nl/api-reference/authentication).

Voer vervolgens de volgende opdracht uit om je bij ElevenLabs te verifiëren:

```bash
elevenlabs auth login
```

Hiermee wordt een browservenster geopend om je via OAuth te verifiëren. De CLI controleert de inloggegevens en slaat ze veilig op.

#### De agent maken

Maak je eerste agent met de assistentsjabloon:

```bash
elevenlabs agents add "My Assistant" --template assistant
```

#### Naar het ElevenLabs-platform pushen

```bash
elevenlabs agents push
```

Hiermee upload je de lokale configuratie van je agent naar het ElevenLabs-platform.

#### De agent testen

De nieuw gemaakte agent kan op verschillende manieren worden getest, maar de snelste manier is via het [ElevenLabs-dashboard](https://elevenlabs.io/app/agents). Selecteer in het dashboard je agent en klik op de knop **Test AI agent**.

> **Info**
>
> Het webdashboard gebruikt onder de motorkap onze [React SDK](/docs/nl/eleven-agents/libraries/react) om realtime gesprekken af te handelen.

Wil je de agent liever snel op je eigen website testen, dan kun je de Agent-widget gebruiken. Gebruik de CLI om het HTML-fragment te genereren:

```bash
elevenlabs agents widget embed <agent_id>
```

De agent-ID wordt bij het pushen vastgelegd in `agents.json` en `elevenlabs agents status` toont deze. Hiermee wordt het HTML-fragment uitgevoerd dat je vervolgens rechtstreeks in je website kunt plakken.

#### Een agent bouwen via de API

#### Een API-sleutel maken

[Maak hier een API-sleutel in het dashboard](https://elevenlabs.io/app/settings/api-keys), die je gebruikt voor veilige [toegang tot de API](/docs/nl/api-reference/authentication).

Sla de sleutel op als beheerd geheim en geef deze aan de SDK's door als omgevingsvariabele via een `.env`-bestand, of rechtstreeks in de configuratie van je app, afhankelijk van je voorkeur.

**`.env`**

```js title=".env"
ELEVENLABS_API_KEY=<your_api_key_here>
```

#### De SDK installeren

#### SDK

We gebruiken ook de `dotenv`-bibliotheek om onze API-sleutel uit een omgevingsvariabele te laden.

```python
pip install elevenlabs
pip install python-dotenv
```

```typescript
npm install @elevenlabs/elevenlabs-js
npm install dotenv
```

#### CLI

Installeer de ElevenLabs CLI. Homebrew (macOS) en Scoop (Windows) worden aanbevolen.

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> Werk je met een AI-code-assistent? Voer `elevenlabs generate-skills` uit in je project om voor elke
> commandogroep een `SKILL.md` naar `skills/` te schrijven, zodat je assistent alle mogelijkheden van de CLI kent
> zonder dat je documentatie hoeft te plakken. Gebruik `--output-dir` om ze ergens anders te plaatsen. Dit leest de eigen
> ingebouwde API-definitie van de CLI, dus er is geen API-sleutel nodig en het werkt offline — en het blijft afgestemd op
> de versie van de CLI die je hebt geïnstalleerd.

Verifieer je daarna — hiermee wordt je browser geopend om de CLI te autoriseren:

```bash
elevenlabs auth login
```

#### De agent maken

Maak een nieuw bestand met de naam `create_agent.py` of `createAgent.mts`, afhankelijk van de programmeertaal die je kiest, en voeg de volgende code toe:

```python maxLines=0
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
import os
load_dotenv()

elevenlabs = ElevenLabs(
    api_key=os.getenv("ELEVENLABS_API_KEY"),
)

prompt = """
You are a friendly and efficient virtual assistant for [Your Company Name].
Your role is to assist customers by answering questions about the company's products, services,
and documentation. You should use the provided knowledge base to offer accurate and helpful responses.

Tasks:
- Answer Questions: Provide clear and concise answers based on the available information.
- Clarify Unclear Requests: Politely ask for more details if the customer's question is not clear.

Guidelines:
- Maintain a friendly and professional tone throughout the conversation.
- Be patient and attentive to the customer's needs.
- If unsure about any information, politely ask the customer to repeat or clarify.
- Avoid discussing topics unrelated to the company's products or services.
- Aim to provide concise answers. Limit responses to a couple of sentences and let the user guide you on where to provide more detail.
"""

response = elevenlabs.conversational_ai.agents.create(
    name="My voice agent",
    tags=["test"], # List of tags to help classify and filter the agent
    conversation_config={
        "tts": {
            "voice_id": "aMSt68OGf4xUZAnLpTU8",
            "model_id": "eleven_flash_v2"
        },
        "agent": {
            "first_message": "Hi, this is Rachel from [Your Company Name] support. How can I help you today?",
            "prompt": {
                "prompt": prompt,
            }
        }
    }
)

print("Agent created with ID:", response.agent_id)
```

```typescript maxLines=0
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";

const elevenlabs = new ElevenLabsClient();

const prompt = `
    You are a friendly and efficient virtual assistant for [Your Company Name].
    Your role is to assist customers by answering questions about the company's products, services,
    and documentation. You should use the provided knowledge base to offer accurate and helpful responses.

    Tasks:
    - Answer Questions: Provide clear and concise answers based on the available information.
    - Clarify Unclear Requests: Politely ask for more details if the customer's question is not clear.

    Guidelines:
    - Maintain a friendly and professional tone throughout the conversation.
    - Be patient and attentive to the customer's needs.
    - If unsure about any information, politely ask the customer to repeat or clarify.
    - Avoid discussing topics unrelated to the company's products or services.
    - Aim to provide concise answers. Limit responses to a couple of sentences and let the user guide you on where to provide more detail.
`;

const agent = await elevenlabs.conversationalAi.agents.create({
    name: "My voice agent",
    tags: ["test"], // List of tags to help classify and filter the agent
    conversationConfig: {
        tts: {
            voiceId: "aMSt68OGf4xUZAnLpTU8",
            modelId: "eleven_flash_v2",
        },
        agent: {
            firstMessage: "Hi, this is Rachel from [Your Company Name] support. How can I help you today?",
            prompt: {
                prompt,
            }
        },
    },
});

console.log(`Agent created with ID: ${agent.agentId}`);
```

> **Note**
>
> De hierboven gemaakte agent krijgt een tag `"test"`. Dit helpt om de agent te classificeren en filteren, bijvoorbeeld om testagents van productieagents te onderscheiden.

#### De code uitvoeren

```python
python create_agent.py
```

```typescript
npx tsx createAgent.mts
```

Hiermee maak je een agent met enkele basisinstellingen en wordt de ID van de agent naar de console afgedrukt. In een volgende stap passen we de agent aan.

#### De agent testen

De nieuw gemaakte agent kan op verschillende manieren worden getest, maar de snelste manier is via het [ElevenLabs-dashboard](https://elevenlabs.io/app/agents). Selecteer in het dashboard je agent en klik op de knop **Test AI agent**.

> **Info**
>
> Het webdashboard gebruikt onder de motorkap onze [React SDK](/docs/nl/eleven-agents/libraries/react) om realtime gesprekken af te handelen.

Wil je de agent liever snel op je eigen website testen, dan kun je de Agent-widget gebruiken. Plak eenvoudig het volgende HTML-fragment in je website en vervang `agent-id` door de ID van je agent.

```html
<elevenlabs-convai agent-id="agent-id"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async type="text/javascript"></script>
```

Bekijk het tabblad SDK's om te leren hoe je de agent met de beschikbare SDK's in je website of app insluit.

## Volgende stappen

Na deze quickstart kun je je agent effectiever maken door het volgende te integreren:

* [Kennisbanken](/docs/nl/eleven-agents/customization/knowledge-base) om de agent uit te rusten met domeinspecifieke informatie.
* [Tools](/docs/nl/eleven-agents/customization/tools) zodat de agent namens jou taken kan uitvoeren.
* [Verificatie](/docs/nl/eleven-agents/customization/authentication) om toegang tot bepaalde gesprekken te beperken.
* [Succesbeoordeling](/docs/nl/eleven-agents/customization/agent-analysis/success-evaluation) om gesprekken te analyseren en de prestaties te verbeteren.
* [Gegevensverzameling](/docs/nl/eleven-agents/customization/agent-analysis/data-collection) om gegevens over gesprekken te verzamelen en de prestaties te verbeteren.
* [Gespreksbewaring](/docs/nl/eleven-agents/customization/privacy/retention) om de gespreksgeschiedenis te bekijken en de prestaties te verbeteren.