Outils de construction : problèmes connus

En bref

Certaines restrictions s'appliquent lorsqu'un outil nécessite une connexion configurée pour utiliser les identifiants d'un membre

Les restrictions suivantes s'appliquent lorsqu'un outil nécessite une connexion configurée pour utiliser les identifiants d'un membre :

Nœud « Outil » au sein du nœud « Activité utilisateur »

Lorsqu'un nœud d'activité utilisateur du flux de travail est attribué à un utilisateur et que celui-ci fournit ses identifiants de connexion, la discussion passe en mode chargement (icône tournante). Aucun message d'erreur ne s'affiche et l'action de l'utilisateur ne se termine pas; l'utilisateur a donc l'impression que le chat est bloqué.

Cause : les flux de travail qui incluent un nœud d'outil au sein d'un nœud d'activité utilisateur ne peuvent pas être attribués à d'autres utilisateurs que l'initiateur du flux lorsque l'outil utilise les identifiants d'un membre pour se connecter. Dans ce cas, il n'est pas possible d'attribuer le nœud d'activité de l'utilisateur à un autre utilisateur.

Nœud d'agent avec workflow

Bien que le nœud d'activité utilisateur soit configuré dans le flux de travail pour être attribué à un utilisateur spécifique, lors de l'exécution, l'activité est en réalité attribuée à l'initiateur du flux. Lorsque l'initiateur du flux fournit les identifiants de connexion requis, ceux-ci sont utilisés pour l'exécution de l'outil. En conséquence, l'activité de l'utilisateur ne suit pas l'affectation configurée et est entièrement gérée par l'initiateur du flux plutôt que par l'utilisateur auquel elle était initialement destinée.

Destinataire de l'activité de l'utilisateur en mode Aperçu

Lorsqu'aucun agent n'est affecté et que vous testez le flux de travail en mode Aperçu, un nœud d'activité utilisateur n'envoie pas de messages ni de formulaires aux utilisateurs ou destinataires assignés dans une discussion. À titre de solution de contournement, configurez le nœud d'activité utilisateur pour qu'il utilise l'option « Flow Initiator »; vous pourrez ainsi tester vous-même le flux de travail en mode Aperçu sans envoyer de messages à d'autres utilisateurs.

Prise en charge des outils asynchrones

À l'heure actuelle, watsonx Orchestrate ne prend pas en charge les outils d' Python s asynchrones de bout en bout. Lorsqu'un outil personnalisé est conçu pour fonctionner de manière asynchrone, par exemple en utilisant le threading ou asyncio pour gérer des tâches simultanées, le système n'attend pas correctement sa réponse.

L'exécution de l'outil échoue à invoquer l'outil

L'exécution de l'outil échoue lors de la première tentative d'appel de l'outil et réussit lors de la deuxième tentative sur le même thread.

Solution de contournement : si vous rencontrez une erreur après une période d'inactivité prolongée, réessayez l'exécution une fois.

Outils de téléchargement de plusieurs fichiers utilisant des agents de type « ReAct »

Les outils de téléchargement de plusieurs fichiers ne sont pas pris en charge avec les agents de type « ReAct ». Utilisez le style d'agent par défaut pour la fonctionnalité de téléchargement de plusieurs fichiers.

Impossible de faire défiler les champs extraits

Si vous ajoutez jusqu'à 25 champs dans l'extracteur de documents, la barre de défilement ne s'affiche pas, ce qui vous empêche de voir tous les champs extraits.

Prise en charge de modèles optionnels

Le modèle meta-llama/llama-3-2-11b-vision-instruct optionnel pour l'extracteur et le classificateur de documents n'est pas pris en charge dans certaines régions (Asie-Pacifique (AP) Sud et Tokyo).

Pour plus d'informations, consultez la section « Disponibilité régionale des modèles de base fournis ».

Entrées par défaut utilisées dans un workflow agentique imbriqué

Le comportement attendu est que le moteur invite l'utilisateur à fournir des données à l'outil si celles-ci ne peuvent être calculées. Cependant, au lieu d'une invite, une valeur par défaut est utilisée.

Si le workflow parent ne contient aucune entrée pouvant être automatiquement mappée aux entrées des outils, ou s'il n'existe aucun nœud d'activité utilisateur collectant les entrées pertinentes pour l'outil, le workflow appelle l'outil à l'aide du mappage automatique et génère des entrées par défaut pour l'outil.

Solution de contournement : pour transmettre des valeurs spécifiques ou des valeurs nulles pour ces entrées, elles doivent être explicitement modifiées dans le mappage des données.

L'agent ne parvient pas à se déployer

Un agent ne parvient pas à se déployer s'il inclut un workflow qui a été créé précédemment dans la préversion technologique.

Solution de contournement : ouvrez le workflow dans le générateur de workflow agentique, modifiez le nom ou la description, puis enregistrez-le. L'enregistrement du flux de travail met à jour la configuration du flux de travail afin qu'il fonctionne avec la version généralement disponible.

Format de date de saisie du flux de travail agentique

Pour les champs de saisie de date, vous devez saisir les dates au format ISO uniquement (aaaa-mm-jj).

Solution de contournement : si l'entrée n'est pas au format ISO, le flux de travail renvoie une erreur. Assurez-vous que toutes les dates saisies respectent le format ISO.

Observabilité

Le système n'inclut actuellement pas les événements d'exécution du workflow agentique dans les traces d'observabilité lorsque le workflow n'est pas associé à un agent. Cela se produit, par exemple, lorsque vous lancez un workflow agentique via les API Flow.

Pour plus d'informations sur l'observabilité, consultez la section Agents de surveillance.

Dans les environnements d' IBM Cloud, il peut arriver que les utilisateurs n'apparaissent pas dans le champ « Utilisateur » d'un formulaire dans le chat.

Ce problème survient car les API de la plateforme nécessaires pour répertorier les utilisateurs doivent être explicitement autorisées sur IBM Cloud.

Solution de contournement : pour activer la liste des utilisateurs, l'administrateur du tenant Orchestrate d' Watson doit créer soit un identifiant de service, soit un utilisateur disposant des autorisations appropriées pour la plateforme IBM Cloud.

Autorisations IAM requis

Attribuez les rôles suivants :

• Rôle d'administrateur : attribué à l'identifiant de service. La portée est définie sur l'environnement cible Watson, avec le tenant Orchestrate comme ressource.

• Rôle de l'utilisateur : attribué pour tous les services de gestion des comptes IAM.

L'administrateur doit enregistrer la clé API associée à l'identifiant du service ou à l'utilisateur en tant que connexion à l'aide de l'identifiant d'application WXO_PLATFORM_USER_API prédéfini. Reportez-vous aux commandes suivantes :

$ orchestrate env activate
$ orchestrate connections add -a WXO_PLATFORM_USER_API

$ orchestrate connections configure -a WXO_PLATFORM_USER_API --env draft -t team -k api_key
$ orchestrate connections configure -a WXO_PLATFORM_USER_API --env live -t team -k api_key

$ orchestrate connections set-credentials -a WXO_PLATFORM_USER_API --env draft --api-key
$ orchestrate connections set-credentials -a WXO_PLATFORM_USER_API --env live --api-key
 

Une fois ces étapes terminées, les API de la plateforme peuvent récupérer correctement les utilisateurs, qui apparaissent alors dans le champ « Utilisateur » d'une conversation.

Le mappage des champs déclenché par l'utilisateur ne fonctionne pas pour la sélection progressive

Lorsque vous mappez des entrées à l'aide de champs de déclenchement utilisateur, la sélection progressive ne fonctionne pas dans les formulaires dynamiques.

Solution de contournement : utilisez le mappage automatique, qui est le paramètre par défaut, plutôt que le mappage à partir des champs de déclencheurs utilisateur.

Rubriques connexes

• Outils de construction

• Création de flux de travail autonomes

• Notes sur l'édition