Prompt et outils

Un outil n'est pas utilisé, des variables restent vides, des modifications n'ont pas d'effet ou l'outil API signale une erreur.

L'agent utilise de lui-même des outils comme le calendrier, la recherche web, le transfert d'appel, la base de connaissances ou ton CRM quand le prompt et la description de l'outil l'y invitent. Ce qu'il a utilisé et quand apparaît dans l'historique des appels sous Main Logs.

Un outil n'est pas utilisé

Cause possibleSolution
L'outil n'est pas activéDans l'onglet Outils, vérifie qu'il figure sous Outils. Un outil seulement mentionné dans le prompt n'existe pas pour l'agent
L'agent ne sait pas quand l'utiliserRemplis la description de l'outil : Contexte pour l'IA pour le transfert, Quand la recherche doit-elle être déclenchée ? pour la recherche web, Description (pour l'IA) pour l'outil CRM. Indique-le aussi dans le prompt
Il manque des informations dont l'outil a besoinAvec l'outil CRM, l'agent demande d'abord tous les paramètres obligatoires. Vérifie que l'appelant les a donnés
Transfert dans le test audioIl n'y a pas de ligne téléphonique dans le navigateur ; un transfert ne se teste qu'avec un vrai appel

Pour tester : dans le test, formule exactement la phrase qui doit déclencher l'outil, par exemple « Je voudrais un rendez-vous mardi ». Main Logs doit ensuite contenir une entrée pour l'outil.

Un outil est utilisé au mauvais moment

Cause possibleSolution
Deux outils ont des descriptions prochesDélimite-les clairement, par exemple « Transfère uniquement les urgences, note toutes les autres demandes comme rappel. »
La description est trop généraleIndique des déclencheurs concrets plutôt que « si besoin »

Des variables restent vides

Cause possibleSolution
Le nom dans l'espace réservé diffère{{Customer_name}} et {{customer_name}} sont deux variables différentes. Écris le nom exactement comme dans le webhook, dans context ou dans la colonne de la campagne
Espaces ou caractères spéciaux dans l'espace réservé{{ customer_name }} n'est jamais remplacé. Écris {{customer_name}}
L'Incoming Webhook n'a pas fourni la valeurVérifie dans Statistiques Webhook s'il a réussi, et définis une Valeur de secours
Pour les campagnes, la colonne manque dans le CSVÀ l'import, le tableau de bord indique quels espaces réservés n'ont pas de colonne

Un espace réservé sans valeur est supprimé avant la conversation. L'agent ne lit donc jamais le nom de la variable, la phrase paraît seulement incomplète.

Une modification n'a pas d'effet

Cause possibleSolution
Pas enregistréeEnregistre la modification. Le test audio enregistre automatiquement avant de démarrer
La conversation était déjà en coursLes modifications s'appliquent à partir de l'appel suivant
Tu as modifié un autre agentVérifie sous Numéro de téléphone quel agent est attribué au numéro
Un modèle a écrasé le promptÉcraser le prompt remplace le texte existant. Reporte ensuite tes modifications

L'outil CRM signale une erreur

Cause possibleSolution
Ton système ne répond pas avec un statut 2xxVérifie la sortie de l'outil dans Main Logs et la requête dans le journal de ton système
Délai dépasséTon système répond plus lentement que le délai d'expiration. Augmente-le sous Paramètres avancés ou accélère ton système
JSON invalide dans le corpsVérifie l'Aperçu du corps de requête dans l'outil. Les espaces réservés dans les chaînes vont entre guillemets : "name": "{{name}}"
En-tête erroné ou manquantVérifie la clé et l'orthographe dans la zone Headers

L'appelant entend un silence pendant qu'un outil tourne

Définis un Texte d'attente, par exemple « Un instant, je note cela. » L'agent le prononce pendant que l'outil travaille. Avec la recherche web, une recherche dure environ deux à cinq secondes.

Aide supplémentaire

Envoie-nous l'heure de l'appel, le nom de l'outil et une capture d'écran de Main Logs, voir Signaler un problème.