Appeler un agent

Catalogue des nœuds Intelligence artificielle

Sur cette page

Délègue une tâche à un agent IA d’un workflow publié

Utilisation et spécificités

Sélectionnez un agent accessible et construisez son entrée. Les permissions, outils et limites de l’agent cible restent applicables. Une approbation d’outil ne peut pas suspendre un agent imbriqué.

Type technique : call_agent. Runtime : nodulz.

Identifiants et prérequis

Aucun identifiant externe dédié n’est défini par ce nœud. Les sources distantes ou la cible d’exécution peuvent néanmoins nécessiter leurs propres accès.

Consultez le guide des identifiants si une source distante ou une cible d’exécution nécessite un accès.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`workflowId`	`string`	`""`	-
`agentNodeId`	`string`	`""`	-
`input`	`string`	`"{{input}}"`	-
`name`	`string`	`"call_agent"`	-
`description`	`string`	`"Delegate a task to a specialist agent."`	-

Aide de configuration

workflowId Workflow de l’agent: Seuls les workflows publiés que vous pouvez lire et exécuter sont proposés. Les droits sont vérifiés à chaque appel.
agentNodeId Agent à appeler: Sélectionnez un agent IA actif du workflow. Sa réponse est disponible dans text, ses étapes dans steps et le nombre de tours dans iterations.
input Tâche et contexte transmis: Accepte un texte ou une expression renvoyant un objet. L’agent reçoit cette valeur dans input, sans les variables ni les sorties du workflow appelant. Comme outil d’un agent, ce champ est remplacé par l’argument input choisi par le modèle.
name Nom de l’outil: Nom unique utilisé par l’agent orchestrateur pour appeler cet outil. Préférez un nom court sans espaces.
description Quand déléguer à cet agent: Décrivez son expertise et les tâches à lui confier. L’agent orchestrateur utilise cette description pour choisir cet outil.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "workflowId": "",
  "agentNodeId": "",
  "input": "{{input}}",
  "name": "call_agent",
  "description": "Delegate a task to a specialist agent."
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.