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

# Référence des paramètres des agents vocaux

> Explication de chaque paramètre des agents vocaux ThunderPhone : niveaux, voix, langues, acquiescements verbaux, outils, ordre de prise de parole, messagerie vocale, annonces de consentement, gestion du silence, tests et déploiement.

Ouvrez **Agents vocaux**, sélectionnez un agent, puis utilisez son onglet **Configuration** pour contrôler sa voix, son raisonnement, le lancement des appels, l’utilisation des outils, la gestion des silences et de la messagerie vocale, ainsi que la manière dont il contacte les appelants. Les modifications sont enregistrées automatiquement dans un brouillon ; le trafic de production ne change pas tant que vous ne sélectionnez pas **Déployer**.

Cette page constitue la référence complète du tableau de bord. Pour les noms de champs et des exemples de requêtes, consultez la [référence de l’API Agents](/api-reference/agents).

## Prompt et identité

Le nom de l’agent l’identifie dans tout le tableau de bord, les rapports, l’historique des appels et les portails clients. Le prompt est le script opérationnel de l’agent : personnalité, informations sur l’entreprise, questions obligatoires, politique d’escalade et actions d’appel.

L’éditeur de prompt indique une estimation du nombre de tokens et signale les problèmes courants, comme un prompt vide, des espaces réservés de modèle non résolus, un chemin d’escalade manquant ou un prompt très long. Les **5 000 premiers tokens estimés** sont inclus ; les prompts plus longs utilisent une [tarification avec supplément par blocs](/fr/guides/pricing).

<Tip>
  Les transferts, les pressions sur le clavier, le comportement en attente et les décisions de raccrochage peuvent être écrits directement dans le prompt. Ajoutez des outils API, d’application, MCP ou de connaissances lorsque l’agent a besoin de données ou d’actions externes.
</Tip>

## Niveau de modèle

| Niveau    | Prix de base | Cas d’usage idéal                                            |
| --------- | -----------: | ------------------------------------------------------------ |
| **Spark** |      2 ¢/min | Appels simples et sensibles aux coûts.                       |
| **Bolt**  |      5 ¢/min | Réponses rapides et workflows quotidiens équilibrés.         |
| **Storm** |      9 ¢/min | Instructions complexes, compréhension audio et raisonnement. |

Storm propose deux contrôles facultatifs :

* **Acquiescement** — **Aucun** reste silencieux pendant la préparation de la réponse complète ; **Bip** émet un léger son d’attente ; **Verbal** prononce un bref acquiescement verbal et ajoute **2 ¢/min**. Le texte verbal peut être généré à partir du prompt principal ou fourni manuellement via l’API.
* **Intelligence supplémentaire** — ajoute un raisonnement plus approfondi pour les appels complexes et **3 ¢/min**.

Le générateur affiche en continu le **coût total par minute** de l’agent, y compris le niveau, le parcours voix/langue, la longueur du prompt, l’acquiescement verbal, l’intelligence supplémentaire et la supervision.

## Voix, arrière-plan et langues

Sélectionnez une voix et écoutez son échantillon avant le déploiement. Le sélecteur ne propose que les voix compatibles avec toutes les langues sélectionnées et indique les combinaisons premium avec leur supplément. Vos voix personnalisées apparaissent dans le même sélecteur une fois prêtes. Consultez la [bibliothèque de voix et les voix personnalisées](/fr/guides/voice-library).

La **piste d’arrière-plan** peut être :

* **Aucune** — aucun son ambiant.
* **Centre d’appels** — une ambiance de centre d’appels, avec un aperçu dans le tableau de bord.

Définissez une **langue principale**, puis autant de **langues supplémentaires** que nécessaire. L’agent détecte automatiquement lorsqu’un appelant passe à une langue sélectionnée et répond dans cette langue. Certaines combinaisons voix/langue ajoutent **3 ¢/min** ; consultez le catalogue généré des [langues prises en charge](/fr/guides/supported-languages).

## Capacités connectées

L’onglet Configuration comprend quatre sections de capacités pouvant être ajoutées indépendamment :

| Section                     | Utilisation                                                                                       |
| --------------------------- | ------------------------------------------------------------------------------------------------- |
| **Applications connectées** | Opérations autorisées dans Google Calendar, Google Sheets, Slack, HubSpot, Salesforce ou Cal.com. |
| **Connexions API**          | Vos propres points de terminaison HTTP, décrits comme des fonctions appelables.                   |
| **Connaissances**           | Fichiers ou contenu web que l’agent peut rechercher pendant un appel.                             |
| **Serveurs MCP**            | Outils mis en cache découverts à partir de serveurs distants Model Context Protocol.              |

Un ajout fait partie du brouillon et devient disponible pour les appels de production après le déploiement. Configurez d’abord les ressources sous **Connexions** ou **Connaissances**, puis ajoutez-les à l’agent.

## Points de terminaison téléphoniques et web

Sous **Numéros de téléphone**, ajoutez un numéro existant, provisionnez un numéro de démonstration ou importez un numéro via une connexion VoIP. Un numéro peut utiliser différents agents pour les directions entrantes et sortantes.

Sous **Widgets web**, ajoutez un widget afin que les visiteurs puissent parler à l’agent depuis un site. La disponibilité des widgets peut également être activée ou désactivée dans la configuration de l’agent.

## Comportement avancé des appels

Développez **Avancé** en bas de Configuration pour accéder aux contrôles suivants.

### Supervision

Lorsqu'elle est activée, une seconde IA de supervision vérifie chaque tour de parole de l'agent par rapport aux instructions et peut intervenir silencieusement. La supervision ajoute **8¢/min** et n'est pas disponible sur Bolt.

### Tonalité de connexion

Jouez une courte tonalité immédiatement après la connexion de l'appel et avant que l'une ou l'autre des parties ne parle.

### Son de l'outil

Choisissez le son produit par l'outil audio appelable depuis le prompt :

* **Aucun** — l'outil n'est pas proposé.
* **Carillon**, **Ding** ou **Bip** — chacun peut être prévisualisé dans le builder.

### Qui parle en premier

Configurez séparément les appels entrants et sortants :

* **Entrant :** l'agent parle en premier, ou l'appelant parle en premier.
* **Sortant :** l'agent parle en premier, ou l'appelé parle en premier.

Ce paramètre est utile pour les composeurs sortants qui doivent attendre une personne ou un menu téléphonique avant de commencer le script.

### Gestion de la messagerie vocale

Choisissez ce qui se passe lorsqu'un appel sortant atteint une messagerie vocale :

| Option                                  | Comportement                                                                            |
| --------------------------------------- | --------------------------------------------------------------------------------------- |
| **Laisser l'agent décider**             | Le prompt et le contexte de la conversation déterminent s'il faut parler ou raccrocher. |
| **Raccrocher silencieusement**          | Terminez sans laisser de message.                                                       |
| **Laisser un message, puis raccrocher** | Prononcez le message configuré et terminez l'appel.                                     |

Les messages de messagerie vocale peuvent contenir jusqu'à **2 000 caractères** et prennent en charge
`{agent_name}` et `{org_name}`. Consultez la page
[Tarification](/fr/guides/pricing) pour savoir comment la durée des appels est facturée.

### Annonce de consentement

Par défaut, une courte annonce au début de chaque appel indique à l'appelant qu'il parle avec un assistant IA et que l'appel est enregistré. Vous pouvez modifier le texte de l'annonce, jusqu'à **2 000 caractères** ; il est lu tel quel dans la langue de l'agent.

La désactivation de l'annonce sur un agent admissible exige qu'un administrateur de l'organisation confirme que l'organisation fournira tout avis légalement requis et obtiendra tout consentement légalement requis. La réactiver puis la désactiver ultérieurement exige une nouvelle confirmation. Consultez le
[guide des lois sur le consentement à l'enregistrement](/fr/guides/recording-consent-laws) avant de modifier ce paramètre.

### Vérifications en cas de silence

Lorsqu'elles sont activées, l'agent vérifie si l'appelant est toujours présent après une période de silence, répète jusqu'à la limite définie, puis raccroche :

* **Secondes avant vérification :** 10–120 secondes.
* **Nombre maximal de vérifications :** 1–10.

Les valeurs par défaut sont de 15 secondes et 3 vérifications.

## Onglets du builder et cycle de vie

| Onglet ou action       | Objectif                                                                                                             |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **En direct / Parler** | Parlez avec le brouillon actuel dans votre navigateur et inspectez la transcription ainsi que l'activité des outils. |
| **Appels**             | Consultez les appels traités par cet agent.                                                                          |
| **A/B**                | Créez des variantes de prompt ou de configuration et comparez les résultats en direct.                               |
| **Simuler**            | Exécutez des scénarios d'appelants IA enregistrés ou ad hoc sur le brouillon.                                        |
| **Validation**         | Rejouez des tours de parole figés d'appels réels sur le brouillon avant le déploiement.                              |
| **Historique**         | Comparez les révisions déployées et restaurez-en une dans le brouillon.                                              |
| **Abandonner**         | Rétablissez chaque paramètre de brouillon en attente à la version déployée.                                          |
| **Déployer**           | Promouvez atomiquement le brouillon complet et créez une révision.                                                   |

Si un autre éditeur enregistre le même agent après que vous l'avez chargé, ThunderPhone bloque l'enregistrement ou le déploiement en conflit et vous demande d'actualiser plutôt que d'écraser ses modifications.

## Gérer les agents depuis la liste

La page **Agents vocaux** prend également en charge les actions de cycle de vie au niveau de l'organisation :

* **Dupliquer** un agent comme nouveau point de départ dans la même organisation.
* **Transférer** un agent vers une autre organisation à laquelle vous appartenez. **Copier** conserve la source ; **Déplacer** la supprime de l'organisation actuelle et nécessite un accès administrateur.
* Sélectionnez un ou plusieurs agents et exportez leur configuration affichée au format **CSV** ou **JSON**.
* Supprimez un agent, ou supprimez en masse les agents sélectionnés, après confirmation.

La copie ou le déplacement d'un agent entre organisations n'accorde pas automatiquement à l'organisation de destination l'accès aux connexions disponibles uniquement dans l'organisation source. Vérifiez les associations d'application, d'API, de base de connaissances, de MCP, de numéro de téléphone et de widget de l'agent copié avant de le déployer dans cette organisation.

## Pages associées

<CardGroup cols={2}>
  <Card title="Créer votre premier agent" icon="robot" href="/fr/guides/build-an-agent">
    Un guide concis de bout en bout pour créer un agent.
  </Card>

  <Card title="Tarification" icon="coins" href="/fr/guides/pricing">
    Niveaux de base, modules complémentaires, facturation des appels, numéros et frais ponctuels.
  </Card>

  <Card title="Jeux de validation" icon="list-check" href="/fr/guides/validation-sets">
    Figez des tours de véritables appels et rejouez-les avant le déploiement.
  </Card>

  <Card title="API des agents" icon="code" href="/api-reference/agents">
    Champs de requête, brouillons, déploiements, versions et exemples.
  </Card>
</CardGroup>
