Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Utilisez ce guide pour connecter Salesforce Agentforce à Microsoft Agent 365 et pour collecter l’activité de session Agentforce afin de permettre l’observabilité des assistants tiers.
Avant de commencer
- Confirmez que l’administrateur IA de l’Agent 365 peut créer des connexions dans le centre d’administration Microsoft 365 admin center.
- Demandez à un administrateur Salesforce de compléter les étapes Salesforce de cet article.
- Confirmez que l’IA générative Einstein et Agentforce sont activés dans l’organisation Salesforce.
- Pour collecter l’activité, confirmez que Data 360 (anciennement Data Cloud) est disponible dans l’organisation.
Créer une application client externe Salesforce
- Dans Salesforce, sélectionnez Configurer, puis cherchez App Manager.
- Ouvre External Client App Manager, puis sélectionne New External Client App.
- Saisissez un nom d’application et un adresse e-mail de contact.
- Sélectionnez Activer OAuth, et saisissez une URL de rappel, comme
https://login.salesforce.com/services/oauth2/success. - Sous Portées OAuth, ajoutez ces portées :
- Accéder aux services de chatbot (
chatbot_api) - Accéder à la plateforme d’API Salesforce (
sfap_api) - Gérer les données utilisateur via des API (
api) - Effectuer des requêtes à tout moment (
refresh_token,offline_access)
- Accéder aux services de chatbot (
- Dans la section Activation de flux, sélectionnez Activer le flux des identifiants client, puis sélectionnez Créer.
- Dans l’onglet Stratégies de l’application, sélectionnez Modifier. Dans la section Stratégies OAuth, activez Activer le flux d’informations d’identification du client.
- Définissez Exécuter en tant que sur un utilisateur actif disposant d’un accès à l’API, puis sélectionnez Enregistrer. Pour collecter de l’activité, cet utilisateur doit également être capable d’interroger l’espace de données de Data 360.
- Dans l’onglet Paramètres de l’application, dépliez Paramètres OAuth, sélectionnez Clé et Secret du consommateur, et enregistrez la clé du consommateur et le secret du consommateur. Ensuite, copiez l’URL actuelle de mon domaine depuis Configuration>Mon domaine.
Activez la traçabilité de session Agentforce
Agent 365 collecte l’activité Agentforce à partir des données de traçage de session Agentforce dans Data 360. Activez le traçage avant que les agents ne s’exécutent. Les sessions qui s’exécutent alors que le tracé est désactivé ne sont pas enregistrées et ne peuvent pas être récupérées plus tard.
- Si Data 360 n’est pas configuré, accédez à Configuration>Configuration Data 360 (Configuration des données cloud dans certaines organisations), et sélectionnez Démarrer. Le provisionnement peut prendre jusqu’à une heure.
- Dans Setup, recherchez Packages installés et confirmez que le modèle de données standard Salesforce est la version 1.130 ou ultérieure. Pour le mettre à niveau, consultez Configurer le traçage de session Agentforce.
- Dans Setup, cherchez Einstein Generative AI, puis sélectionnez Configuration d’Einstein Audit, Analytics et Monitoring.
- Activez Agentforce Session Tracing si ce n’est pas déjà activé. Si on vous demande un espace de données, sélectionnez default.
- Activez Traçage de la plateforme d’assistant et Audit et commentaires.
Créer la connexion
- Ouvrez le centre d’administration Microsoft 365.
- Sélectionner les agents>Tous les agents.
- Dans les plateformes connectées, sélectionnez Gérer.
- Sélectionnez + Connectez une plateforme et choisissez Salesforce Agentforce.
- Saisissez l’URL My Domain sans chemin, la clé consommateur et le secret consommateur.
- Validez les informations d’identification.
- Enregistrez la connexion.
- Sélectionnez Sync agents.
Les nouvelles connexions collectent par défaut des données d’observabilité. Si vous avez créé la connexion avant que l’observabilité ne soit disponible, modifiez-la et sélectionnez Collecter les données d’observabilité de l’agent.
Vérifiez la connexion et l’activité
- Ouvrez la connexion et confirmez que la synchronisation a réussi et que les agents attendus apparaissent.
- Engagez une conversation avec un agent actif. Par exemple, dans Agentforce Builder, utilisez le panneau Aperçu en mode Test en direct, et notez l’ID de la session.
- (Optionnel) Dans l’application Data 360, ouvrez Data Explorer et sélectionnez l’espace de données activé, Data Model Objects et AI Agent Session. Confirmez qu’une ligne existe pour l’identifiant de session.
- Dans le centre d’administration Microsoft 365, ouvrez la connexion et sélectionnez Synchroniser les assistants. L’Agent 365 collecte de nouvelles sessions à chaque synchronisation de la connexion.
- Dans Agents>Tous les agents, ouvrez l’agent, sélectionnez Activité, et confirmez que Sessions est au moins égal à 1.
Les premières sessions après avoir activé le traçage peuvent prendre jusqu’à deux heures à apparaître dans Data 360. Si Sessions est toujours à 0, attendez quelques minutes et synchronisez à nouveau. Utilisateurs actifs s'affiche N/A car les sessions Agentforce n'incluent pas les identités Microsoft Entra.
Note
Dans certains cas, Data 360 ne rafraîchit pas les flux de données selon un calendrier. Dans l’application Data 360, ouvrez Data Streams, ouvrez chaque flux de traçage de session Agentforce, puis sélectionnez Actualiser maintenant.
Troubleshoot
| Symptôme | Cause la plus probable | Résolution |
|---|---|---|
| Échec de la validation des identifiants | Le flux d’informations d’identification du client n’est pas activé, ni dans les paramètres de l’application, ni dans les stratégies OAuth, Exécuter en tant que n’est pas défini, ou l’URL n’est pas l’URL Mon domaine | Corrigez l’application et l’URL. Une nouvelle application peut mettre quelques minutes à accepter le flux. |
| Un agent semble ne pas apparaître après la synchronisation | L’agent n’est pas actif, ou l’utilisateur Run As ne peut pas y accéder | Activez l’assistant dans Agentforce Builder, vérifiez les autorisations de l’utilisateur Exécuter en tant que, puis synchronisez à nouveau. |
| Le traçage de session Agentforce n’est pas disponible | Data 360 n’est pas provisionné, Agentforce est désactivé, ou le modèle standard de données Salesforce est antérieur à 1.130 | Terminez Activer le traçage de session Agentforce. |
| Aucune session n’apparaît dans Data 360 | Le suivi était désactivé pendant la conversation, ou le flux de données ne s’est pas rafraîchi | Lancer une nouvelle conversation une fois le traçage activé. Dans les organisations Developer Edition, sélectionnez Rafraîchir maintenant sur les flux de données. |
| Une session apparaît dans Data 360, mais l’Activité est vide | La collecte est désactivée, la connexion n’a pas été synchronisée depuis la conversation, la traçabilité utilise un autre espace de données, ou l’utilisateur Exécuter en tant que ne peut pas interroger Data 360 | Sélectionnez Collecter les données d’observabilité de l’agent, synchronisez à nouveau et accordez à l’utilisateur Run As l’accès correspondant, par exemple avec l’ensemble de permissions Data Cloud Architect (anciennement Data Cloud Admin). |
Révoquer l’accès
Révoquez l’accès en désactivant ou en supprimant l’application client externe Salesforce, en renouvelant le secret client, ou en supprimant l’accès à l’API de l’utilisateur Run As.
Pour les problèmes de connexion qui ne sont pas spécifiques à Salesforce Agentforce, voir Dépannage des plateformes connectées.