Chargement des outils et coût
Fonctionnement du chargement des outils
À chaque appel du modèle, la plateforme constitue la liste d’outils de l’agent à partir des définitions d’outils actives et la joint à la requête. Un outil est inclus s’il satisfait à tous les critères suivants :
- Actif : la définition de l’outil est marquée comme active.
- Périmètre de l’agent : les outils intégrés sont accessibles à tous les agents ; un outil personnalisé peut être réservé à un agent grâce à son champ Agent.
- Canal : la sélection Chaînes de l’outil comprend le canal de la conversation.
- Contexte : si l’outil précise des Objets de contexte, l’objet de l’enregistrement courant doit correspondre.
- Absence d’exclusion : l’outil ne figure pas dans la liste d’exclusion de cet agent, définie via Modifier l'équipement dans l’aperçu d’exécution de l’agent.
- Respect du plafond Nombre maximal d'outils : le paramètre Nombre maximal d'outils de l’agent, compris entre 1 et 100 et fixé à 25 par défaut, limite le nombre d’outils proposés selon leur Ordre de tri.
La liste obtenue reste identique à chaque tour de conversation et, pour un même agent et un même canal, d’une conversation à l’autre. Cette stabilité est l’objectif recherché.
Pourquoi une liste stable réduit les coûts
Une liste stable d’outils autorisés facilite la réutilisation du prompt en cache lorsque l’API et le modèle le permettent. Les définitions comptent toujours dans les tokens. Cache et facturation varient selon le fournisseur et le modèle ; consultez les enregistrements d’utilisation et la console du fournisseur plutôt que de supposer une remise fixe.
IA incluse utilise des crédits REDA. Votre propre IA utilise le compte fournisseur de votre organisation, facturé directement par ce fournisseur. La licence définit un mode pour toute l’organisation. Dans les deux cas, REDA AI gouverne les outils et actions configurés dans Salesforce. Configurer la licence et les comptes IA.
Les paramètres qui influencent réellement le coût
| Levier | Emplacement | Effet |
|---|---|---|
| Limiter le nombre d’outils affectés | Nombre maximal d'outils dans la définition de l’agent ; exclusions Modifier l'équipement | Un outil absent de la liste de l’agent ne consomme aucun jeton. Limitez la liste aux outils réellement utilisés. |
| Mode Outils | Définition de l’agent | Pages d'enregistrement uniquement évite de charger les outils sur les pages d’accueil et de liste, où l’agent n’a aucun enregistrement sur lequel agir. |
| Des schémas concis | Définitions d’outils personnalisés | Un schéma d’entrée verbeux consomme des jetons à chaque tour et dégrade les appels d’outils. Privilégiez des descriptions précises et les seuls champs nécessaires. |
| Maintenir une liste stable | Gestion de la configuration | Toute modification de la liste d’outils d’un agent invalide le cache du fournisseur pour cet agent. Regroupez les modifications au lieu de les ajuster chaque jour. |
Consultez Optimiser la consommation de crédits pour découvrir les autres techniques : budgets de jetons et d’historique, niveaux de traitement et mise en cache.
L’ancien champ Niveau d'outil (obsolète)
Les définitions d’outils conservent un champ Niveau d'outil (obsolète). Il est obsolète : conservé pour permettre l’enregistrement des configurations existantes, il est ignoré lors de l’exécution dans toutes les versions actuelles. Modifier sa valeur n’a aucun effet. Si vos procédures internes décrivent le comportement Tier 1 / Tier 2, retirez ces indications : seul le modèle de chargement décrit ci-dessus s’applique désormais.
Bonnes pratiques
- Examinez les schémas volumineux. Si le schéma d’entrée d’un outil personnalisé est verbeux, vérifiez que ce niveau de détail est nécessaire. Un schéma plus concis réduit le coût de chaque tour et améliore les appels d’outils.
- Limitez les outils affectés. Les outils affectés consomment des jetons à chaque tour. La principale économie consiste à réduire leur nombre grâce à Nombre maximal d'outils et aux exclusions Modifier l'équipement.
- Vérifiez avec le débogueur de conversations. Le débogueur affiche la liste exacte des outils reçue par le modèle à chaque tour. Utilisez-le pour confirmer qu’elle correspond à vos attentes et reste identique à chaque tour.
Questions fréquentes
Une liste stable d’outils autorisés facilite la réutilisation du prompt en cache lorsque l’API et le modèle le permettent. Les définitions comptent toujours dans les tokens. Cache et facturation varient selon le fournisseur et le modèle ; consultez les enregistrements d’utilisation et la console du fournisseur plutôt que de supposer une remise fixe.
Non. Les valeurs Tier que vous avez définies sont simplement ignorées. Vous pouvez aujourd’hui agir sur les coûts avec Nombre maximal d'outils, les exclusions propres à chaque agent via Modifier l'équipement dans l’aperçu d’exécution, Mode Outils et des schémas d’outils personnalisés concis.
Réduisez la liste d’outils : baissez Nombre maximal d'outils ou excluez les outils jamais utilisés via Modifier l'équipement. Choisissez Pages d'enregistrement uniquement dans Mode Outils si l’agent travaille uniquement sur des enregistrements, simplifiez les schémas personnalisés trop détaillés et maintenez une liste stable : chaque modification invalide le cache du fournisseur pour cet agent.
Non. Le chargement des outils sert à économiser des jetons ; il ne constitue pas une limite de sécurité. Chaque outil applique les autorisations CRUD, la sécurité au niveau des champs et les règles de partage, sous réserve du contexte d’exécution de l’agent sur le canal API. Pour restreindre un outil à un canal ou à un agent, utilisez les champs Chaînes et Agent de sa définition.
Prochaines étapes
Consultez Optimiser la consommation de crédits pour découvrir toutes les techniques de réduction des coûts, ou la Référence des outils intégrés pour connaître les entrées et canaux de chaque outil.