Vous ĂȘtes ici :
Buteurs et buteurs personnalisĂ©s (bĂȘta)
Les Scoreers (bĂȘta) sont des composants d'Ă©valuation dans Agentforce Studio qui analysent les sessions des agents et produisent des scores, des dimensions et des mesures pour Agentforce Optimization et Analytics. Associez des scores standard Salesforce Ă des Ă©valuations personnalisĂ©es pour vos indicateurs de performance clĂ©s, crĂ©ez des scores personnalisĂ©s en utilisant les tests Next Gen, appliquez-les Ă des sessions et utilisez les sorties dans Optimisation et Analytics pour prioriser les amĂ©liorations des agents.
Ăditions requises
| Disponible avec : les éditions Enterprise, Performance et Unlimited avec un complément Einstein pour Sales, Einstein pour Platform, Einstein pour Service, Einstein 1 Service ou Einstein GPT Service. Pour acheter des compléments, contactez votre chargé de compte Salesforce. |
Les scoreurs sont un service bĂȘta soumis aux Conditions des services bĂȘta dans Accords - Salesforce.com ou un document Ă©crit Unified Pilot Agreement si exĂ©cutĂ© par le Client, et aux conditions applicables Ă©noncĂ©es dans le RĂ©pertoire des conditions du produit. L'utilisation de ce service bĂȘta est Ă la seule discrĂ©tion du Client.
Affichage des scores dans Optimisation et Analytics
- Test Next Gen : créez des scores personnalisés dans le cadre d'une série de tests nouvelle ou existante, affinez-la et publiez-la.
- Scorer Hub (Agentforce Studio) â emplacement central pour afficher, activer et gĂ©rer les scoreurs.
- Tableau Sessions et intentions : les sessions affichent les résultats du scoreur, filtrent et analysent par dimensions de scoreur personnalisées.
- Page Session : les sessions affichent les étiquettes et les scores des buteurs associés.
- Tableaux de bord Analytics : les mesures de score personnalisées sont affichées sous forme de métriques pour les rapports.
Considerations and Limitations
- Disponible dans Lightning Experience avec les Ă©ditions Enterprise, Performance et Unlimited avec Salesforce Foundations ou Agentforce 1 Edition oĂč l'Optimisation des agents et Analytics sont activĂ©s.
- Les Scoreers personnalisĂ©s sont en version bĂȘta et ne nĂ©cessitent aucune licence supplĂ©mentaire en dehors d'Agentforce.
- Pendant la version bĂȘta, seuls les scoreurs au niveau de la session sont pris en charge.
- Les scoreurs personnalisés ne sont pas pris en charge pour les types d'agent Agentforce Employee Agent (AEA).
- Le type d'agent SDR est affiché dans la plate-forme de score, mais pas dans la liste déroulante de l'agent de l'interface utilisateur d'optimisation.
- Des scores standard (A&D, Score de qualité) sont créés lors du provisionnement de STDM. S'ils sont manquants, vérifiez s'il y a un problÚme de provisionnement.
- Vous devez cloner un scoreur standard avant de le modifier. La modification directe n'est pas prise en charge pendant la version bĂȘta.
- Les scoreurs basés sur l'expression nécessitent un type de sortie booléen.
- Les scores numériques sur une échelle de 0 à 1 ne sont pas recommandés, car les grands modÚles de langage sont peu performants sur des plages numériques trÚs étroites.
- Les sessions du Centre de test ne sont pas notées par des scoreurs personnalisés. Les sessions du Centre de test ne reçoivent pas d'horodatage de fin. Par conséquent, l'action de données qui déclenche l'évaluation personnalisée du scoreur n'est jamais déclenchée.
Vue dâensemble
Les scoreurs évaluent les sessions des agents et génÚrent des scores, des dimensions (valeurs de texte) et des mesures (valeurs numériques). Ils font partie de l'Optimisation et de l'observabilité Agentforce. Ils sont exécutés automatiquement contre un pourcentage configurable de sessions et exposent les résultats dans Optimisation et Analytics. Les administrateurs et les développeurs peuvent ainsi améliorer en permanence les performances des agents.
Il existe deux types de scoreurs :
- Les scoreurs standard sont fournis par Salesforce prĂȘts Ă l'emploi.
- Les scorers personnalisés sont définis par votre organisation pour évaluer des critÚres spécifiques à votre activité.
Scoreurs standard
Les scores standard sont des évaluations prédéfinies qui sont automatiquement créées avec le provisionnement STDM. Ils sont exécutés sur des sessions d'agent sans configuration client supplémentaire.
Scoreurs standard actuels
- Score d'abandon : indique si le client a terminé la session prématurément avant que l'agent ait résolu son problÚme.
- Score de déviation : indique si l'agent a dévié avec succÚs une interaction pour ne pas nécessiter une escalade humaine.
- Score de qualité : mesure la qualité globale de la session sur la base de critÚres Salesforce prédéfinis.
Les scoreurs standard utilisent un emplacement réservé dans l'interface utilisateur et sont séparés de la liste des scoreurs personnalisée.
Vous ne pouvez pas modifier directement un score standard. Clonez-le pour créer une version personnalisée avec une logique modifiée.
Scoreurs personnalisés
Les scoreurs personnalisés permettent de définir une logique d'évaluation et de l'appliquer à des sessions. Ils utilisent une approche LLM en tant que juge (évaluation basée sur l'invite) ou une logique basée sur l'expression pour étiqueter, noter ou classer les sessions par rapport à vos critÚres.
Vous crĂ©ez des scores personnalisĂ©s dans Test Next Gen (NGT) dans Agentforce Studio. Voir Configuration et exĂ©cution de tests dans Agentforce Studio (bĂȘta). Pour plus d'informations, consultez Tests de nouvelle gĂ©nĂ©ration sur Slack.
Les scoreurs personnalisés sont exécutés par rapport aux sessions, et exposent les scores personnalisés et les dimensions dans Observabilité.
Fonctionnement des scoreurs personnalisés
Un scoreur personnalisé est soutenu par un modÚle d'invite qui est automatiquement exécuté en tant que tùche par lot à la fin de la session. Lorsqu'un scoreur est exécuté sur une session, la session est associée à ce scoreur, et les étiquettes et les scores sont affichés dans Optimisation et Analytics.
- Un scorer est un modÚle d'invite exécuté sur un pourcentage configurable de sessions (exemple de taux).
- Les scores sont appliqués à la fin de la session, pas pendant la conversation en direct. Les sessions doivent recevoir un horodatage de fin pour que l'action de données de score se déclenche.
- Les résultats sont affichés dans Observabilité sous forme de mesures personnalisées.
- Vous pouvez également déclencher des marqueurs manuellement en utilisant l'action invocable
executeAgentforceScoresJob. - Les scoreurs n'affectent pas la latence ou les performances de l'agent pendant les conversations en direct, car le score est exécuté aprÚs la fin de la session.
Configuration du scoreur
Champs clés
| Champ | Description |
|---|---|
scorerApiName |
Nom d'API unique du scoreur. |
status |
Statut du cycle de vie du scoreur (par exemple, Brouillon ou Disponible). |
isDraft |
Booléen. Indique si cette définition du scoreur est brouillon. |
versionNumber |
Version entiÚre de la définition du scoreur. |
engine |
Moteur d'évaluation : Basé sur LLM ou basé sur l'expression. |
inputScope |
GranularitĂ© : niveau session (par dĂ©faut pour la version bĂȘta et la disponibilitĂ© gĂ©nĂ©rale) ou niveau interaction (planifiĂ©). |
dataType |
Type de sortie du scoreur (par exemple, Texte ou Numérique). |
scorerValues / valuesSpecification |
En fournir un seul. Définit les étiquettes de sortie ou la plage numérique du scoreur. |
promptTemplateRef |
RĂ©fĂ©rence au modĂšle d'invite pour l'Ă©valuation basĂ©e sur le LLM. Le modĂšle doit ĂȘtre actif. |
agentApiName |
Facultatif. Associe le scoreur à un agent spécifique. Un seul nom d'API d'agent est autorisé. |
samplingRate |
Pourcentage de sessions sur lesquelles le scoreur se heurte. |
RĂšgles de validation
- La
scorerApiNamene doit pas déjà exister. - Les
promptTemplateRefdoivent exister et ĂȘtre actifs. - Pour le type de donnĂ©es Texte : Les valeurs de score doivent exister ; une valeur exacte doit avoir
isFallback: true; une valeur exacte doit avoirisSystemFallback: true(uniquement lorsqueisFallbackest Ă©galement vrai). - Pour Type de donnĂ©es numĂ©rique : aucune valeur de repli ; les valeurs doivent ĂȘtre analysĂ©es en tant que doubles valides. Si vous utilisez
valuesSpecification: Lastepdoit ĂȘtre supĂ©rieure Ă 0; lamindoit ĂȘtre infĂ©rieure Ămax; lathresholdest facultative mais doit ĂȘtre comprise entreminetmax. - Nombre maximal de valeurs de score : 101.
Types de sortie
- Texte (étiquettes) : le scoreur attribue l'une des étiquettes de chaßne prédéfinies à chaque session (par exemple, Résolu, Abandonné ou Escaladé). Utiliser pour la classification par catégorie.
- Numérique : le scoreur renvoie un chiffre dans une plage définie (par exemple 0 à 5). Adapté aux évaluations de qualité et aux scores continus. Les LLM sont généralement plus performants sur des échelles discrÚtes (telles que 0 à 5) que sur des plages étroites de 0 à 1.
- Booléen (étirable ou futur) : renvoie true ou false. Pris en charge pour les scoreurs basés sur l'expression.
Exécution de scoreurs en production
Activation depuis l'onglet Buteur
AprÚs avoir créé et testé un scoreur personnalisé, activez-le depuis la plate-forme de score dans Agentforce Optimization. L'activation permet d'exécuter le scoreur sur des sessions live au taux d'échantillonnage configuré.
| Accéder à et afficher Agentforce Optimization | Attribuer les ensembles d'autorisations Access Agentforce Optimization et Data Cloud User |
| Utiliser l'onglet Scoreer (bĂȘta) | Attribuer l'ensemble d'autorisations Agentforce Scorer Beta (aucune licence supplĂ©mentaire au-delĂ d'Agentforce n'est requise) |
| Créer un score | Attribuer l'ensemble d'autorisations d'accÚs Tests de nouvelle génération (NGT) |
| Activer un score | Attribuer lâensemble dâautorisations AgentforceScorerActivation (inclus par dĂ©faut dans le profil administrateur) |
Exécuter depuis Salesforce Flow
Nous fournissons une nouvelle action invocable, TriggerAgentBulkScoring, qui permet d'exécuter des scorers personnalisés de façon asynchrone sur des sessions historiques. Cette action accepte plusieurs sessions et scores et est accessible via :
- Flux Salesforce
- API REST
- Apex
Nom de l'action : TriggerAgentBulkScoring
| ParamÚtre d'entrée | Type | Description |
|---|---|---|
InputIds |
List<String> | Liste contenant jusqu'Ă 500 ID de session uniques. |
InputScope |
ĂnumĂ©ration | Ătendue du score : Session, Moment ou Interaction. |
ScoresApiNames |
List<String> | Jusqu'à 10 noms de développeur pour les scoreurs à exécuter. |
Notes importantes
- Tous les ID et
scorerApiNamesde session doivent appartenir au mĂȘme agent. - Assurez-vous que la version du scoreur est Disponible avant l'exĂ©cution.
API REST
Envoyez une requĂȘte POST au point de terminaison REST de l'action standard.
/services/data/v66.0/actions/standard/triggerAgentBulkScoring
Exemple de charge utile :
{
"inputs": [
{
"inputIds": ["019c9442-b760-7d62-837c-8ab80ecc0fc2"],
"inputScope": "Session",
"scorerApiNames": ["language_classifier"]
}
]
}Utilisez l'action invocable executeAgentforceScoresJob dans Flux. L'action accepte une liste d'ID de session et de scoreurs, et soumet une tùche au pipeline d'évaluation. Les utilisations courantes comprennent :
- Scores d'exécution sur les sessions historiques
- Analyse par lot et rapports personnalisés
- Intégration à Agentforce Grid
API de métadonnées
Créez et gérez des scorers personnalisés avec l'API de métadonnées Salesforce afin de déployer des scorers dans des workflows pro-code et DevOps, y compris des pipelines CI/CD.
Cas d'utilisation
| Cas d'utilisation | Objectif utilisateur | Aide des buteurs |
|---|---|---|
| Surveiller la qualité des agents | Comprendre comment l'agent résout les problÚmes des clients | Les scoreurs standard (Score de qualité, A&D) sont automatiquement exécutés et exposent les résultats dans Analytics sans configuration |
| Ăvaluer les rĂ©sultats spĂ©cifiques Ă l'entreprise | Mesurer des indicateurs de performance clĂ©s personnalisĂ©s (par exemple, classification des rubriques ou conformitĂ©) | Les scoreurs personnalisĂ©s appliquent vos invites LLM Ă des sessions et exposent les rĂ©sultats sous forme de dimensions personnalisĂ©es |
| Itérer et améliorer les agents | Rechercher des modÚles dans les sessions faibles et affiner les instructions | L'observabilité affiche les résultats du score par session pour explorer les interactions marquées |
| Test des scores avant production | Confirmer le comportement d'un nouveau score avant l'activation | Le Centre de test d'Agentforce Studio prend en charge la création, l'exécution et l'affinage des scores par rapport aux cas de test. |
| ExĂ©cuter les scoreurs Ă l'Ă©chelle | Ăvaluer des lots importants de sessions historiques | executeAgentforceScoresJob prend en charge le traitement par lot et les rapports personnalisĂ©s |
| Gérer les scoreurs sous forme de code | Déploiement de scoreurs via CI/CD | La prise en charge de l'API de métadonnées active la création et la gestion de pro-code |
| Personnaliser les critĂšres d'Ă©valuation | Ajuster ou Ă©tendre le score prĂȘt Ă l'emploi | Cloner un scoreur standard pour crĂ©er une version personnalisĂ©e avec une logique d'invite modifiĂ©e |

