Agent IA

Catalogue des nœuds Intelligence artificielle

Sur cette page

Planifie et exécute des outils

Utilisation et spécificités

Connectez les composants de modèle, mémoire et outils, ou renseignez la configuration explicite. maxIterations borne les appels d’outils. Les outils à effets externes doivent conserver leurs règles d’approbation.

Type technique : ai_agent. Runtime : nodulz.

Exemple guidé

Pour vérifier un premier agent sans action d’écriture externe :

Préparez un identifiant de modèle accessible et choisissez un modèle disponible pour ce compte.
Reliez le déclencheur manuel à l’agent par les connexions d’exécution. Reliez le composant de modèle au port de modèle de l’agent, ou renseignez sa configuration explicite.
Utilisez le payload manuel { "question": "Reformule en une phrase : notre réunion est reportée à demain." }.
Renseignez userPrompt avec {{ input.question }} et systemPrompt avec Réponds en français, en une phrase, sans ajouter de faits..
Exécutez et vérifiez le texte dans la propriété text de la sortie.

Ajoutez ensuite un seul outil de lecture dont vous maîtrisez la cible. Reliez-le au port d’outils, donnez-lui un nom unique et une description précisant quand l’utiliser. Demandez une tâche qui nécessite cette lecture et inspectez la trace pour vérifier l’appel réel. Mentionner un outil dans le prompt ou dans toolsJson ne remplace pas sa connexion.

La sortie contient text, steps, iterations, usage, durationMs et trace. Dans une étape suivante, lisez par exemple {{ nodes.agent1.text }} en adaptant agent1 au nom technique réel. Une réponse peut varier entre deux appels : vérifiez surtout les faits, le format et les outils utilisés.

maxIterations borne les tours d’agent, maxTokens la sortie d’un appel et maxTotalTokens l’usage cumulé de cet agent. Les outils appelant d’autres modèles ont leur propre usage. Commencez avec une tâche courte ; augmentez une limite après avoir identifié celle qui bloque.

Pour un outil qui écrit dans un service, configurez l’approbation lorsque nécessaire et vérifiez la reprise depuis l’historique. Une mémoire est facultative : ajoutez-la seulement si plusieurs échanges doivent partager leur contexte.

Identifiants et prérequis

Créer et configurer l’identifiant : ai-model

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le guide des identifiants pour les accès et la rotation.

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
`credentialId`	`string`	-	-
`model`	`string`	`""`	-
`modelNodeId`	`string`	-	-
`fallbackModelNodeIds`	`array`	`[]`	-
`modelRoutes`	`array`	`[]`	-
`modelRoutes[].modelNodeId`	`string`	-	-; min 1
`modelRoutes[].combinator`	`enum`	`"and"`	`and`, `or`
`modelRoutes[].conditions`	`array`	-	-; min 1
`modelRoutes[].conditions[].field`	`string`	`""`	-
`modelRoutes[].conditions[].operator`	`enum`	`"equals"`	`equals`, `not_equals`, `contains`, `not_contains`, `gt`, `gte`, `lt`, `lte`, `empty`, `not_empty`
`modelRoutes[].conditions[].value`	`string`	`""`	-
`memoryNodeId`	`string`	-	-
`systemPrompt`	`string`	`"You are a helpful AI agent with access to tools."`	-
`userPrompt`	`string`	`""`	-
`agentMode`	`enum`	`"tools_agent"`	`tools_agent`, `react`
`maxIterations`	`number`	`10`	-; ≥ 1, ≤ 50
`maxTokens`	`number`	-	-; ≥ 1
`maxTotalTokens`	`number`	-	-; ≥ 1, ≤ 10000000
`timeoutSeconds`	`number`	-	-; ≥ 1, ≤ 3600
`toolNodeIds`	`array`	`[]`	-
`toolsJson`	`string`	`""`	-
`temperature`	`number`	-	-; ≥ 0, ≤ 2

Aide de configuration

systemPrompt Rôle et consignes: Précisez le domaine d’expertise, les outils à utiliser, les limites et le format de réponse attendu.
userPrompt Tâche à accomplir: Accepte les expressions du workflow. Vide : utilise automatiquement l’entrée reçue, y compris lors d’un appel depuis un autre agent.
credentialId Identifiant: Identifiant requis pour accéder au service externe.
model Modèle: Identifiant du modèle chez le fournisseur (ex. gpt-4o, claude-3-5-sonnet).
maxTotalTokens Budget total de tokens: Facultatif. Cumule les tokens d’entrée et de sortie de cet agent. Réserve le contexte avant chaque appel, borne la sortie et bloque la suite si le fournisseur omet l’usage ou dépasse le budget. Les outils appelant d’autres modèles ont leur propre usage.
maxIterations Nombre maximal de tours: Nombre maximal de tours agent/outils avant arrêt.
maxTokens Tokens max.: Nombre maximal de tokens de sortie, raisonnement compris pour les modèles concernés. Une réponse tronquée provoque une erreur : augmentez cette limite ou réduisez la demande.
timeoutSeconds Délai maximal (secondes): Durée maximale d’un appel au modèle, pièces jointes comprises. De 1 à 3 600 secondes ; 120 par défaut. L’annulation du workflow interrompt aussi l’appel.
temperature Température: Une valeur basse favorise des réponses régulières. Laissez vide pour utiliser le réglage du fournisseur ; certains modèles ignorent ce paramètre.
toolsJson Schémas des outils (JSON avancé): Avancé : tableau JSON qui décrit les outils reliés à cet agent. Utilisez leurs noms exacts et précisez parameters (JSON Schema) pour guider les arguments. Un outil doit être relié pour être exécuté.

Configuration initiale

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

json

{
  "model": "",
  "fallbackModelNodeIds": [],
  "modelRoutes": [],
  "systemPrompt": "You are a helpful AI agent with access to tools.",
  "userPrompt": "",
  "agentMode": "tools_agent",
  "maxIterations": 10,
  "toolNodeIds": [],
  "toolsJson": ""
}

Vérification

Vérifiez d’abord une réponse sans outil, puis une demande qui exige l’outil de lecture configuré. Comparez le texte à la sortie réelle de l’outil et inspectez steps, trace et usage. Testez aussi une donnée manquante et un refus d’approbation avant toute action d’écriture en production. Un texte affirmant qu’une action a eu lieu ne prouve pas son exécution.

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