Configurer les outils

Que signifie configurer les outils ?

Les capacités d’un agent REDA AI dépendent de ses outils. Trois décisions sont nécessaires :

• Quels outils intégrés rendre accessibles. Les 18 outils fournis par la plateforme sont présentés dans la Référence des outils intégrés. Limitez chaque agent à ceux dont il a besoin.
• Quels outils personnalisés créer. Pour un besoin non couvert, créez un outil Modèle SOQL, Classe Apex ou Mappage de fichiers.
• Comment définir leur périmètre. Chaque outil peut être limité à certains canaux, agents et objets de contexte pour apparaître au bon endroit.

Choisir les outils d’un agent

La disponibilité dépend de l’état actif, du périmètre de l’agent, du canal, des objets de contexte, des exclusions et du plafond d’outils. Les outils intégrés peuvent être chargés pour tous les agents sans affectation manuelle préalable ; vérifiez toujours la liste effective dans l’aperçu d’exécution.

Deux agents du même canal peuvent disposer de listes différentes grâce à leurs exclusions, plafonds et outils personnalisés réservés. La configuration d’un agent détermine sa liste effective.

Créer des outils personnalisés avec le générateur

Le générateur vous accompagne sur un seul écran pour les besoins non couverts. Vous commencez par choisir le type d’outil, puis le formulaire s’adapte à ce choix.

Étape 1 — Choisir un type d’outil

Trois cartes de type apparaissent en haut :

La carte sélectionnée détermine le type. Les autres sections se replient et se réorganisent pour ne présenter que les champs pertinents.

Étape 2 — Comprendre le verrouillage de catégorie

Chaque type possède une catégorie adaptée, que le générateur impose visiblement :

Lorsque la catégorie est verrouillée, un avis en explique la raison pour éviter de chercher à modifier une contrainte imposée par le type.

Étape 3 — Configurer les champs du type choisi

Chaque type ouvre ses propres blocs de configuration. Consultez les pages dédiées :

• Outils de modèle SOQL : requête, syntaxe des paramètres et schéma d’entrée généré.
• Outils de classe Apex : classe d’exécution, schéma d’entrée, format de retour et indicateur de traitement de fichiers.
• Outils de correspondance de fichiers : objet cible, opération, correspondances et clé de rapprochement.

Étape 4 — Utiliser le générateur IA

Pour chaque type, le générateur IA prépare la configuration à partir d’une courte description et des références fournies :

• Pour un modèle SOQL, collez la requête ou décrivez le besoin. Le générateur extrait les paramètres et rédige un schéma d’entrée avec des descriptions détaillées.
• Pour un outil Apex, décrivez l’opération et joignez éventuellement un exemple de fichier s’il traite des documents. Le générateur produit le schéma d’entrée et un exemple des données reçues par votre classe.
• Pour une correspondance de fichiers, joignez un exemple de CSV et une brève description. Le générateur propose l’objet, l’opération, les correspondances et la clé de rapprochement.

Vous gardez la possibilité de vérifier : le générateur remplit le formulaire, vous corrigez ce qui ne convient pas, puis vous enregistrez.

Étape 5 — Examiner le panneau d’impact

Pendant la configuration, le panneau d’impact présente ce que recevra l’agent :

• Le nom et la description de l’outil tels qu’ils apparaîtront au modèle
• Le schéma d’entrée dans la structure JSON exacte transmise à chaque requête
• La catégorie et les restrictions de canal ; l’ancien champ de niveau peut encore apparaître mais ne contrôle plus le chargement
• Pour les outils d’action, un aperçu de la carte de confirmation destinée à l’utilisateur
• Pour les outils Apex traitant des fichiers, un exemple de la structure des données extraites reçues par la classe

C’est le moyen le plus rapide de repérer un écart entre le résultat attendu et les informations transmises à l’agent, avant une première conversation réelle.

Étape 6 — Enregistrer et vérifier la disponibilité

L’enregistrement déploie l’outil via l’API Metadata. Le générateur suit le déploiement et vous indique lorsque l’outil est disponible. Configurez ensuite son périmètre et les exclusions de l’agent, puis vérifiez la liste effective dans l’aperçu d’exécution. Un outil actif sans restriction d’agent peut être accessible à plusieurs agents selon les autres critères de chargement.

Définir le périmètre d’un outil

Chaque définition possède des champs qui contrôlent où et quand l’outil apparaît :

Maintenir une liste d’outils concise

Chaque outil disponible consomme des jetons à chaque requête : le modèle reçoit son nom, sa description et son schéma même s’il ne l’utilise pas. Trois habitudes réduisent ce coût :

Choisissez selon le besoin. N’ajoutez pas des outils uniquement au cas où. Rendez-les accessibles quand une conversation réelle le nécessite et excluez ceux inutilisés depuis plusieurs semaines.

Simplifiez les schémas verbeux. Leur définition est transmise à chaque tour. Gardez des descriptions précises et les champs nécessaires, puis vérifiez dans le débogueur ce que le modèle reçoit. Consultez Chargement des outils et coût.

Utilisez des prompts pour les connaissances stables. Si l’agent pose toujours les mêmes questions sur la liste de sélection d’un champ, décrire les valeurs dans son prompt coûte moins cher qu’appeler get_picklist_values à chaque conversation. Consultez Prompts personnalisés par agent.

Fixez des plafonds par agent. Les trois pratiques précédentes reposent sur votre jugement ; deux paramètres imposent des limites. Nombre maximal d'outils plafonne le nombre d’outils proposés par tour entre 1 et 100, avec 25 si le champ est vide. Il limite directement le coût de la liste. Nombre maximal d'itérations d'outils plafonne les étapes d’enchaînement d’outils d’un même tour entre 3 et 25, avec 6 si le champ est vide, afin d’éviter les boucles sur une tâche impossible à terminer. Ils figurent dans Contrôles des performances et des coûts sur la définition de l’agent. Consultez Paramètres de performance et de coût.

Erreurs d’autorisation à l’exécution

Les outils s’exécutent avec les autorisations de l’utilisateur, sous réserve de l’exception de contexte système sur API. En cas de refus d’accès :

• L’outil renvoie une erreur structurée plutôt qu’une trace technique.
• L’agent lit l’erreur et l’explique dans la conversation.
• La conversation se poursuit : une erreur d’autorisation ne bloque pas à elle seule l’agent.

La plateforme reprend ainsi les contrôles d’accès Salesforce et permet à l’agent d’aider l’utilisateur à comprendre un refus. L’exception explicitement configurée Contexte d'exécution = Système sur un agent API élève l’accès aux objets et champs, mais n’élargit jamais le partage des enregistrements.

Bonnes pratiques

Concevez l’outil autour d’une tâche. « Envoyer un devis de renouvellement », qui appelle une méthode Apex ciblée, est plus fiable qu’un outil générique « Modifier les enregistrements » dont l’agent doit déduire l’usage. Des outils délimités rendent les conversations prévisibles.

Soignez les descriptions. La décision d’appeler un outil dépend largement de sa description. Expliquez ce qu’il fait, quand l’utiliser et ses limites.

Fixez ce qui ne doit pas changer. Utilisez les modèles SOQL et la correspondance de fichiers pour un contrat stable ; choisissez Apex pour davantage de souplesse. N’accordez que la liberté nécessaire au besoin.

Utilisez le panneau d’impact. Examinez les informations vues par l’agent et vérifiez qu’elles correspondent à vos attentes : c’est une première étape de débogage très rapide.

Améliorez avec le débogueur de conversations. Une fois l’outil disponible, il affiche chaque appel, ses paramètres et son résultat. La plupart des problèmes deviennent visibles à cet endroit.

Questions fréquentes

Prochaines étapes

Consultez Confirmation des actions pour l’expérience utilisateur, ou approfondissez un type : Modèle SOQL, Classe Apex ou Mappage de fichiers.