Vue d’ensemble
Les actions transforment vos agents IA d’assistants conversationnels en outils d’automatisation métier puissants. Au-delà de répondre aux questions, vos agents peuvent planifier des rendez-vous, transférer des appels, mettre à jour des systèmes et s’intégrer à vos flux de travail métier existants - tout en maintenant un flux de conversation naturel. Considérez les actions comme la boîte à outils de votre agent. Tout comme un employé humain utilise différents outils pour accomplir des tâches, votre agent IA exécute des actions pour effectuer un travail réel pendant les interactions client.Les actions s’exécutent automatiquement en fonction du contexte de conversation et des instructions que vous fournissez dans le prompt de votre agent. Vous définissez quand et comment les actions doivent être utilisées grâce à l’ingénierie de prompt.
Que sont les Actions ?
Les actions sont des outils préconfigurés que votre agent peut invoquer pendant les conversations pour accomplir des tâches spécifiques. Lorsqu’un client demande quelque chose qui nécessite une action - comme réserver un rendez-vous ou parler à un spécialiste - votre agent peut exécuter l’action appropriée de manière transparente.Comment fonctionnent les Actions
Pendant les conversations, votre agent décide de manière autonome s’il doit répondre directement ou exécuter une action : L’agent utilise les noms et descriptions d’actions pour comprendre ce que chaque action fait. Ceux-ci sont cruciaux pour aider le LLM à sélectionner le bon outil. Meilleures pratiques :- Donnez aux actions des noms clairs et descriptifs (par exemple, “book_appointment” et non “action1”)
- Écrivez des descriptions détaillées expliquant ce que fait l’action
- Ajoutez des instructions explicites dans vos instructions d’agent (prompt système) sur quand utiliser chaque action
Alors que les noms et descriptions d’actions indiquent à l’agent ce que fait une action, vos instructions d’agent (prompt système) doivent spécifier quand l’utiliser. Par exemple : “Lorsqu’un client demande à parler à un humain, utilisez l’action transfer_to_support.”
Catégories d’Actions
Les actions sont organisées en deux catégories dans le tableau de bord :Contrôle d’Appel
Transférer l'Appel
Transférer vers un autre agent IA, numéro de téléphone ou adresse SIP
Terminer la Conversation
Faire en sorte que l’agent termine la conversation avec un message personnalisé
Intégration
Action Personnalisée
Créer une action API personnalisée ou webhook
Réservation de Calendrier
Planifier des rendez-vous en utilisant l’intégration Cal.com
Quand les Actions s’Exécutent
Les actions s’exécutent pendant la conversation lorsqu’elles sont déclenchées par votre agent en fonction de ses instructions. Contrairement aux systèmes IVR traditionnels qui suivent des scripts rigides, les agents IA utilisent la compréhension contextuelle pour déterminer quand les actions sont appropriées.Mécanismes de Déclenchement
Déclencheurs Basés sur les Instructions :Configuration des Actions
Toute configuration d’action se fait dans l’éditeur d’agent sous l’onglet Abilities → Actions.Naviguer vers les Actions
Ouvrez votre agent dans l’éditeur et cliquez sur Abilities → onglet Actions
Choisir le Type d'Action
Parcourez les catégories Call Control et Integration et cliquez sur Add sur l’action que vous souhaitez configurer
Configurer l'Action
Remplissez le formulaire de configuration spécifique à l’action :
- Name : Donnez à votre action un nom clair et descriptif
- Description : Expliquez ce que fait cette action
- Paramètres spécifiques à l’action : Configurez les paramètres en fonction du type d’action
Indicateurs de Statut d’Action
Après avoir ajouté des actions, vous les verrez listées dans l’onglet Actions de votre agent avec des indicateurs de statut :Configurée
L’action est correctement configurée et prête à être utilisée
Incomplète
Configuration ou identifiants requis manquants
Erreur
Erreur de configuration ou échec d’authentification
Référencer les Actions dans les Instructions
Pour utiliser les actions, référencez-les par nom exact dans les instructions de votre agent :Référence Directe
Avec Conditions
Avec Paramètres
Les noms d’actions sont sensibles à la casse et doivent correspondre exactement à la configuration. Si vous renommez une action, mettez à jour toutes les références dans vos instructions.
Meilleures Pratiques de Configuration
Commencer Simple
Commencer Simple
Commencez par des actions de base avant d’ajouter des intégrations complexes. Ajoutez une action à la fois, testez minutieusement, puis ajoutez la suivante.Exemple de progression :
- Ajouter l’action End Conversation
- Ajouter l’action Transfer to Support
- Ajouter l’action Booking
- Ajouter les actions Custom API
Utiliser des Noms Clairs et Descriptifs
Utiliser des Noms Clairs et Descriptifs
Les noms d’actions sont critiques - le LLM les utilise pour comprendre ce que fait chaque outil. Utilisez des noms descriptifs, orientés action qui transmettent clairement le but de la fonction.Pourquoi c’est important : Le modèle s’appuie sur les noms et descriptions de fonctions pour détecter quand une fonction doit être appelée et choisir le bon outil pour la tâche.Bons noms :
- “Get Customer Account” - Verbe d’action clair + cible spécifique
- “Transfer to Billing Department” - Destination spécifique incluse
- “Book 30-Minute Consultation” - Inclut des détails pertinents
- “Action 1” - Aucun contexte sur ce qu’elle fait
- “Transfer” - Trop générique, peu clair où
- “API Call” - Ne décrit pas l’action
Écrire des Descriptions Détaillées
Écrire des Descriptions Détaillées
Les descriptions d’actions aident le LLM à comprendre ce que fait l’action. La description doit expliquer le but de l’action, ce qu’elle retourne et quels paramètres elle utilise.Meilleures pratiques d’OpenAI function calling :Note : Décrivez ce que fait l’action dans la description. Spécifiez quand l’utiliser dans vos instructions d’agent (prompt système).
- Décrire clairement ce que fait l’action et ce qu’elle retourne
- Expliquer quels paramètres ou données elle utilise
- Utiliser un langage précis qui guide la compréhension du modèle
- Rester concis mais complet
Tester Minutieusement
Tester Minutieusement
Testez chaque action dans l’interface de test d’agent avant de la mettre en production :
- Vérifier que l’action s’exécute correctement
- Tester les scénarios de succès
- Tester les scénarios d’échec
- Vérifier la gestion des erreurs
- Vérifier le flux de conversation
Gérer les Échecs avec Élégance
Gérer les Échecs avec Élégance
Configurez des comportements de secours pour quand les actions échouent. Instruisez votre agent sur quoi faire quand les actions ne fonctionnent pas.
Collecter d'Abord les Informations
Collecter d'Abord les Informations
Assurez-vous que les agents recueillent les données requises avant d’exécuter les actions. N’essayez pas de réserver des rendez-vous sans adresse email ou de transférer des appels sans expliquer pourquoi.
Sécuriser les Identifiants
Sécuriser les Identifiants
Utilisez une authentification appropriée pour toutes les actions personnalisées. Ne jamais exposer les clés API ou identifiants dans les URL ou champs non cryptés.
- Utiliser des tokens Bearer pour l’authentification API
- Utiliser Basic auth sur HTTPS uniquement
- Stocker les identifiants sensibles en toute sécurité
- Faire tourner les identifiants régulièrement
Tester les Actions
Avant de déployer des agents avec des actions, testez minutieusement dans l’interface de test du tableau de bord :Vérifier l'Exécution
Vérifiez que les actions s’exécutent correctement et traitent les réponses de manière appropriée
Tester les Cas d'Échec
Simulez des échecs pour vérifier que la gestion des erreurs fonctionne comme prévu
Ce qu’il faut Tester
Pour les Actions de Transfert :- Le transfert s’exécute vers la bonne destination
- La musique d’attente joue si configurée
- Le message de transfert est approprié
- Les modes de transfert froid vs chaud fonctionnent correctement
- La disponibilité est récupérée correctement
- La réservation se confirme avec succès
- Les notifications email/SMS sont envoyées correctement
- La gestion des fuseaux horaires est précise
- Les appels API réussissent
- L’authentification fonctionne
- Les données de réponse sont disponibles pour l’agent
- Les réponses d’erreur sont gérées avec élégance
- L’agent référence l’action par le bon nom
- L’agent collecte d’abord les informations requises
- Le flux de conversation reste naturel
- Les échecs ne cassent pas la conversation
Cas d’Usage Courants
Workflow de Support Client
Workflow de Réservation de Rendez-vous
Workflow de Qualification Commerciale
Dépannage des Problèmes Courants
L'Action ne se Déclenche Pas
L'Action ne se Déclenche Pas
Problème : L’agent n’utilise pas l’action alors qu’il devrait.Solutions :
- Vérifier que le nom de l’action dans les instructions correspond exactement (sensible à la casse)
- Vérifier que le statut de l’action est “Configured” et non “Incomplete” ou “Error”
- Rendre les instructions plus explicites sur quand utiliser l’action
- Tester en isolation en demandant explicitement à l’agent d’utiliser l’action
- Examiner la transcription de conversation pour voir le raisonnement de l’agent
L'Agent Dit qu'il Va Exécuter l'Action Mais ne le Fait Pas
L'Agent Dit qu'il Va Exécuter l'Action Mais ne le Fait Pas
Problème : L’agent confirme verbalement qu’il exécute une action (par exemple, “Je vous transfère maintenant”) mais l’action ne s’exécute que lors du prochain tour de conversation.Pourquoi cela se produit : L’agent génère une réponse et exécute l’action dans le même tour, mais un seul peut se produire par tour.Solution : Inciter l’agent à demander la confirmation de l’utilisateur avant d’exécuter les actions :Cela garantit que l’agent exécute l’action immédiatement après avoir reçu la confirmation, pas dans le même tour que l’annonce.
Échecs d'Authentification
Échecs d'Authentification
Problème : Les actions personnalisées échouent avec des erreurs 401/403.Solutions :
- Vérifier que les identifiants sont corrects et non expirés
- Vérifier que le type d’authentification correspond aux exigences de l’API
- S’assurer que les tokens Bearer incluent le préfixe “Bearer” si nécessaire
- Tester l’endpoint indépendamment avec Postman ou curl
- Examiner la documentation de l’API pour le format d’authentification
L'Action de Réservation Échoue
L'Action de Réservation Échoue
Problème : L’action de réservation Cal.com retourne des erreurs.Solutions :
- Vérifier que l’intégration Cal.com est connectée
- Vérifier que le type d’événement existe et est actif
- S’assurer que la plateforme de réunion est configurée dans Cal.com
- Vérifier que les fenêtres de planification autorisent les dates demandées
- Vérifier la configuration du fuseau horaire
- Tester la réservation manuellement dans Cal.com pour vérifier la disponibilité
Le Transfert ne se Connecte Pas
Le Transfert ne se Connecte Pas
Problème : L’action de transfert s’exécute mais ne se connecte pas.Solutions :
- Vérifier que la destination est au format E.164 correct (par exemple, +15551234567)
- S’assurer que le numéro de téléphone est joignable (pour les transferts téléphoniques)
- Vérifier que l’adresse SIP est correcte (pour les transferts SIP)
- Tester la destination indépendamment
Prochaines Étapes
Actions de Contrôle d'Appel
Configurer les actions Transfer, End Conversation et Inactivity Management
Détails des Transferts
Maîtriser les destinations de transfert, modes et paramètres avancés
Intégration de Réservation
Configurer la planification de rendez-vous Cal.com avec notifications email et SMS
Actions API Personnalisées
Connecter vos agents à des systèmes et API externes
Guide des Instructions
Apprendre à écrire des instructions d’agent efficaces
Ingénierie de Prompt
Maîtriser les techniques de prompting avancées pour un comportement d’agent fiable