Skip to main content
Une fois l’appel terminé, un juge LLM lit la transcription et l’évalue selon la configuration d’analyse de l’assistant. Il peut évaluer le sentiment de l’appelant, déterminer si l’appel remplit un critère de réussite, et extraire des champs structurés (un numéro de rappel, un identifiant de commande, une réponse oui/non). Le résultat est enregistré sur l’appel et disponible dans les filtres de l’historique, l’API publique et MCP.

​
Ce que produit l’analyse

Pour chaque appel analysé, le juge rédige un résultat comprenant :
  • Sentiment — positive, neutral ou negative (sentiment général de l’appelant).
  • Réussite — true / false (ou null si l’évaluation de la réussite est désactivée), accompagné d’une courte raison expliquant le verdict.
  • Données — une table associant chaque champ structuré défini à sa valeur, indexée par nom de champ.
  • Modèle et analyzed_at — quel modèle juge a été utilisé, et à quel moment.
Le sentiment et la réussite sont également stockés sous forme de colonnes dénormalisées sur l’appel, ce qui permet de filtrer rapidement de longues listes d’appels (dans la vue Historique et via GET /calls?sentiment=&success=).
L’analyse s’exécute après l’appel et n’a aucun impact sur la conversation en direct. Si le juge échoue ou renvoie un résultat inexploitable, l’appel reste intact : un événement d’appel analysis_failed est enregistré et rien n’est écrit dans l’analyse de l’appel.

​
Configurer un assistant

Ouvrez la carte Analyse de l’assistant et activez les éléments dont vous avez besoin. Tout est facultatif : une configuration vide signifie qu’aucune analyse n’est exécutée.
1

Sentiment

Activé par défaut. Désactivez-le si vous n’avez pas besoin du sentiment par appel.
2

Critère de réussite

Activez Réussite et décrivez, en langage simple, à quoi ressemble un appel réussi — par exemple « L’appelant a pris rendez-vous » ou « L’appelant a confirmé son adresse de livraison ». Le juge renvoie un booléen accompagné d’une raison.
3

Champs structurés

Ajoutez les champs à extraire. Chaque champ comprend un name (snake_case, unique), un type (string, number, boolean ou enum), une description indiquant au juge quoi extraire (500 caractères max.), un indicateur required facultatif et, pour enum, une liste de choices.

​
Exemple de configuration

Voici à quoi ressemble le calls.analysis obtenu :

​
Exploiter les résultats

  • Filtres de l’historique — filtrez la liste des appels par sentiment et réussite pour retrouver, par exemple, tous les appels négatifs qui n’ont pas abouti.
  • API publique — chaque appel renvoyé par GET /calls et GET /calls/{id} inclut analysis, sentiment et success. Filtrez la liste avec ?sentiment=negative et ?success=false.
  • MCP — ces mêmes champs d’appel sont exposés via les outils MCP list_calls / get_call.

​
Configuration via l’API

analysis_config est un champ modifiable de l’assistant : vous pouvez donc le gérer par programmation :
Consultez la référence API (PATCH /assistants/{id} et le schéma AnalysisConfig) pour le contrat de champs complet.