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

# Perplexity

## Overzicht

Koppel je ElevenLabs AI-agents aan Perplexity om tijdens gesprekken vragen te beantwoorden met live-informatie van het web. Agents kunnen een vraag stellen en een kort antwoord ontvangen dat wordt ondersteund door geciteerde bronnen, of rechtstreeks op het web zoeken naar pagina's en artikelen. Gebruik dit om antwoorden te baseren op informatie die nieuwer is dan de eigen kennis van de agent.

## Instellen

Deze integratie gebruikt een **Perplexity API key** voor authenticatie.

#### Maak een Perplexity-account

Registreer je via [perplexity.ai](https://www.perplexity.ai) als je nog geen account hebt.

#### Voeg een betaalmethode toe

Perplexity factureert API-gebruik naar verbruik. Voeg een betaalmethode toe in de [API-console](https://console.perplexity.ai) voordat je een sleutel genereert.

#### Genereer een API-sleutel

Ga naar [console.perplexity.ai/project/keys](https://console.perplexity.ai/project/keys) en maak een nieuwe sleutel. Deze begint met `pplx-`.

#### Koppel in ElevenLabs

Plak in de configuratie van de ElevenLabs-integratie je Perplexity API-sleutel in het veld **API Key**.

## Tools

De integratie biedt twee tools. Welke de agent kiest, hangt af van of de beller een antwoord of een lijst met bronnen wil.

| Tool     | Wat deze retourneert                                            |
| -------- | --------------------------------------------------------------- |
| `Ask`    | Een kort antwoord in proza met de URL's waarop het is gebaseerd |
| `Search` | Webpagina's met elk een titel, link en kort fragment            |

### Ask

Ask stuurt de vraag naar de Agent API van Perplexity, die op het web zoekt en een antwoord schrijft. Antwoorden zijn beperkt tot ongeveer drie zinnen in gewone tekst, afgestemd op voorlezen, en de bronnen achter het antwoord worden erbij teruggegeven. Gebruik deze tool voor vragen als "wat is er deze week met X gebeurd", wanneer de beller het antwoord wil horen.

### Search

Search bevraagt de Search API van Perplexity en retourneert de pagina's zelf, elk met een titel, link en kort fragment. De agent kan de resultaten beperken tot specifieke domeinen, of tot een tijdsvenster van een uur, dag, week, maand of jaar. Standaard worden drie pagina's geretourneerd, kort genoeg om tijdens een gesprek voor te lezen, en maximaal twintig wanneer de beller om een specifiek aantal vraagt.

### Zoekmodi

Search doorzoekt standaard het open web. De parameter `search_type` van de Search-tool selecteert de modus, die je wijzigt bij het configureren van de tool:

| Modus    | Retourneert                                        |
| -------- | -------------------------------------------------- |
| `web`    | Webpagina's. De standaardinstelling.               |
| `fast`   | Webpagina's, geoptimaliseerd voor lagere latentie. |
| `people` | Profielinformatie over personen.                   |

Je configuratie bepaalt de modus voor elke oproep die de agent doet. Als je `people` selecteert, bewerk dan de **Condition prompt** van de Search-tool zodat deze aangeeft dat de tool personen opzoekt; dan roept de agent deze voor de juiste vragen aan.

## Zo worden antwoorden ingekort

Beide tools retourneren bewust beknopte resultaten, afgestemd op wat een beller tijdens een gesprek kan opnemen. De integratie stelt het aantal geretourneerde pagina's standaard in op drie, vraagt om de kortst beschikbare paginafragmenten en instrueert het antwoordmodel om binnen enkele zinnen te blijven. Dit zijn allemaal parameters van de tool, dus verhoog ze bij het configureren als je agent meer context nodig heeft.

## Handige links

* [Perplexity API-documentatie](https://docs.perplexity.ai)
* [Perplexity API-console](https://console.perplexity.ai)
* [Referentie voor Agent API](https://docs.perplexity.ai/api-reference/agent-post)
* [Referentie voor Search API](https://docs.perplexity.ai/api-reference/search-post)