Sous-agent IA

Catalogue des nœuds Intelligence artificielle

Sur cette page

Permettre à un agent de faire appel à un autre agent.

Utilisation et spécificités

Sélectionnez le workflow publié et son agent accessible, puis construisez son entrée. Les permissions et les limites de l’agent cible restent applicables. Les cycles sont refusés ; une approbation d’outil ne peut pas suspendre un agent imbriqué.

Type technique : ai_tool_ai_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`	`""`	-
`targetScope`	`enum`	-	`local`, `workflow`
`name`	`string`	`"nested_agent"`	-
`description`	`string`	`"Nested AI agent"`	-
`agentNodeId`	`string`	`""`	-
`maxDepth`	`number`	`1`	-; ≥ 1, ≤ 3

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.
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.
maxDepth Niveaux de délégation: Limite les appels d’agents imbriqués, indépendamment des tours de dialogue. Les appels récursifs sont toujours refusés.

Configuration initiale

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

json

{
  "workflowId": "",
  "name": "nested_agent",
  "description": "Nested AI agent",
  "agentNodeId": "",
  "maxDepth": 1
}

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.