Dépannage de l'orchestration multi-agents

Comment puis-je réduire la latence dans ma solution Orchestration multi-agents ?

• Commencez par implémenter les recommandations de la rubrique « Comment réduire la latence dans les solutions multi-agents » dans Orchestration multi-agents.
• Isolez les endroits où la latence et les expirations sont élevées dans votre solution Agentforce. Utilisez les outils de débogage décrits dans « Ressources de dépannage ». Par exemple :
  • Dans Agent Analytics, surveillez les métriques et les scores de « durée » de votre solution. Dans Surveillance sanitaire des agents, définissez des seuils d'alerte pour les métriques et les scores appropriés afin de déclencher des notifications lorsque la latence dépasse les seuils.
  • Examinez les traces et les journaux des erreurs d'expiration. Le délai d'expiration pour les agents orchestrateurs est de 120 secondes, ce qui inclut le temps passé par l'agent orchestrateur à effectuer des tâches générales, par exemple déléguer et (en mode superviseur) synthétiser les résultats. En mode superviseur, l'agent orchestrateur synthétise les erreurs d'expiration. La limite d'expiration pour les sous-agents connectés est de 30 secondes.
  Utilisez ces symptômes pour découvrir les causes profondes de la latence auxquelles vous pouvez remédier dans votre solution IA.

Comment puis-je résoudre les problèmes de transmission de variables ?

Notez les points suivants :

• Des variables personnalisées (mutables) peuvent être spécifiées pendant la session.
• Les variables de contexte (liées) sont immuables et ne peuvent pas être mises à jour une fois la session démarrée.

Consultez Référence du script de l'agent : Variables (personnalisées et liées) dans l'Agentforce Developer Guide.

Dans Orchestration multi-agents, vous pouvez transmettre des variables de deux façons :

• D'un agent orchestrateur à un sous-agent connecté. Pour des sous-agents connectés, les variables d'entrée peuvent être mappées. En mode transfert et superviseur, vous pouvez mapper ces variables d'entrée avec des variables de contexte ou personnalisées. Consultez « Modes de transfert et de superviseur » dans Orchestration multi-agents.
  

  Remarque Dans cette version, les variables sont transmises dans une seule direction : depuis l'agent orchestrateur vers le sous-agent connecté. Les variables ne sont pas transmises depuis un sous-agent connecté vers l'agent orchestrateur.
• Entre sous-agents connectés. En mode transfert, si un sous-agent connecté a une section Après la réponse, vous pouvez définir des variables avant la transition vers un autre sous-agent connecté. Comme le sous-agent connecté suivant reçoit ces valeurs uniquement via son bloc inputs, toutes les variables que vous définissez nécessitent un mappage dans le bloc d'entrées du sous-agent connecté cible. Le contexte ne circule pas automatiquement.

Voir Connexion d'un agent en tant que sous-agent dans l'Aide de Salesforce et Bloc de sous-agents connectés dans le Agentforce Developer Guide.

Comment puis-je résoudre les problèmes d'authentification ?

Votre approche de l'authentification varie selon le type d'agent et selon la combinaison de l'agent orchestrateur et du sous-agent connecté.

• Les sous-agents connectés Agentforce Agent de service (ASA) sont exécutés en tant qu'utilisateur de session de l'agent orchestrateur (l'utilisateur numérique), pas en tant que son propre utilisateur agent. ASA prend également en charge les utilisateurs invités non authentifiés.
• Les sous-agents connectés Agentforce Employee Agent (AEA) sont exécutés dans le contexte de l'utilisateur connecté. Attribuez à l'utilisateur connecté les autorisations requises pour toute opération demandée par le sous-agent connecté.

Consultez « Authentification au niveau de l'utilisateur dans les solutions multi-agents » dans Orchestration multi-agents.

Quelles limitations puis-je prendre en compte pour ma solution Orchestration multi-agents ?

• Examinez les fonctionnalités prises en charge et non prises en charge dans « Considérations et limitations » dans Orchestration multi-agents.
• L'orchestration multi-agents n'applique aucune limite au nombre de sous-agents connectés. Expérimentez différentes combinaisons pour trouver une conception optimale adaptée à votre cas d'utilisation et à votre environnement.
• Pour des recommandations de conception, consultez « Conseils de conception de votre solution agent à agent » dans Orchestration multi-agents.

Ressources de dépannage

Agentforce fournit des outils et des fonctionnalités qui facilitent l'identification des modèles, l'étude des causes profondes et la prise de mesures correctives.

• Dans Agent Builder, utilisez le traceur de plan dans le panneau d'aperçu de la conversation pour examiner les problèmes de votre solution multi-agents. Inspectez les décisions détaillées, étape par étape, et les actions que votre agent orchestrateur et les sous-agents connectés prennent pendant une conversation ou un test de workflow.
• Utilisez les journaux d'événements avancés pour fournir des détails précis sur les conversations des agents.
• Utilisez Agent Analytics pour surveiller les performances des agents et détecter les tendances des erreurs. Examinez les modèles et les causes profondes au niveau de la session (consultez Analyse des données avec l'optimisation des agents).
• Dans Surveillance de l'intégrité des agents, définissez des seuils d'alerte pour déclencher des notifications lorsque les performances des agents dépassent les seuils.