> 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

## Vue d’ensemble

Connectez vos agents IA ElevenLabs à Perplexity pour répondre aux questions à partir du web en direct pendant les conversations. Les agents peuvent poser une question et recevoir une réponse courte étayée par des sources citées, ou rechercher directement des pages et articles sur le web. Utilisez cette intégration pour fonder les réponses sur des informations plus récentes que les connaissances propres de l’agent.

## Configuration

Cette intégration utilise une **clé API Perplexity** pour l’authentification.

#### Créer un compte Perplexity

Inscrivez-vous sur [perplexity.ai](https://www.perplexity.ai) si vous n’avez pas encore de compte.

#### Ajouter un mode de paiement

Perplexity facture l’utilisation de l’API à l’usage. Ajoutez un mode de paiement dans la [console API](https://console.perplexity.ai) avant de générer une clé.

#### Générer une clé API

Accédez à [console.perplexity.ai/project/keys](https://console.perplexity.ai/project/keys) et créez une clé. Elle commence par `pplx-`.

#### Se connecter dans ElevenLabs

Dans la configuration de l’intégration ElevenLabs, collez votre clé API Perplexity dans le champ **API Key**.

## Outils

L’intégration propose deux outils. Le choix de l’agent dépend de si l’appelant souhaite une réponse ou une liste de sources.

| Outil    | Ce qu’il renvoie                                                  |
| -------- | ----------------------------------------------------------------- |
| `Ask`    | Une courte réponse en prose avec les URL dont elle est issue      |
| `Search` | Des pages web, chacune avec un titre, un lien et un court extrait |

### Ask

Ask envoie la question à l’API Agent de Perplexity, qui recherche sur le web et rédige une réponse. Les réponses sont limitées à environ trois phrases en prose simple, adaptées à une lecture à voix haute, et les sources sur lesquelles elles reposent sont renvoyées avec elles. Utilisez cet outil pour des questions comme « que s’est-il passé avec X cette semaine ? », lorsque l’appelant souhaite entendre la réponse.

### Search

Search interroge l’API Search de Perplexity et renvoie les pages elles-mêmes, chacune avec un titre, un lien et un court extrait. L’agent peut limiter les résultats à des domaines spécifiques ou à une période récente d’une heure, un jour, une semaine, un mois ou une année. Par défaut, il renvoie trois pages, suffisamment courtes pour être lues pendant un appel, et jusqu’à vingt lorsque l’appelant demande un nombre précis.

### Modes de recherche

Search interroge le web ouvert par défaut. Le paramètre `search_type` de l’outil Search sélectionne le mode, que vous modifiez lors de la configuration de l’outil :

| Mode     | Renvoie                                             |
| -------- | --------------------------------------------------- |
| `web`    | Des pages web. Le mode par défaut.                  |
| `fast`   | Des pages web, optimisées pour une latence réduite. |
| `people` | Des informations de profil sur des personnes.       |

Votre configuration fixe le mode pour chaque appel effectué par l’agent. Si vous sélectionnez `people`, modifiez le **Condition prompt** de l’outil Search pour indiquer qu’il recherche des personnes, afin que l’agent l’utilise pour les bonnes questions.

## Comment les réponses sont raccourcies

Les deux outils renvoient volontairement des résultats concis, adaptés à ce qu’un appelant peut assimiler au cours d’une conversation. L’intégration limite par défaut à trois le nombre de pages renvoyées, demande les extraits de pages les plus courts disponibles et invite le modèle de réponse à rester dans la limite de quelques phrases. Chacun de ces éléments est un paramètre de l’outil ; augmentez-les lors de la configuration si votre agent a besoin d’un contexte plus complet.

## Liens utiles

* [Documentation de l’API Perplexity](https://docs.perplexity.ai)
* [Console API Perplexity](https://console.perplexity.ai)
* [Référence de l’API Agent](https://docs.perplexity.ai/api-reference/agent-post)
* [Référence de l’API Search](https://docs.perplexity.ai/api-reference/search-post)