Agent (Agent)

Nœud de l'agent autonome: configurez un agent d'IA avec un modèle, des requêtes, des outils et des ressources pour raisonner et effectuer des tâches.

Ce qu’il fait

Exécute un agent d'IA que vous créez sur la zone de dessin. Vous lui donnez un modèle, des instructions, des outils et un contexte, et il raisonne sur vos données pour effectuer une tâche et fournir un résultat.

Le nœud est libellé Agent autonome dans la palette. Utilisez-le pour les décisions basées sur l'IA, la génération de contenu, la classification, l'extraction ou toute étape qui bénéficie d'un raisonnement plutôt que d'une logique fixe.

Un agent autonome raisonne en boucle. Elle lit les invites, décide s'il faut appeler un outil ou consulter son contexte, intègre ce qui revient et répète jusqu'à ce qu'il ait une réponse ou atteigne sa limite d'itération. Vous façonnez cette boucle avec le modèle, les invites et les ressources que vous connectez aux handles du nœud.

Quand utiliser ce processus par rapport à ce processus BPMN

Contexte	Utiliser (Use)
Vous souhaitez définir le modèle, les requêtes et les outils de l'agent directement dans ce flux	Agent autonome
Vous souhaitez invoquer un agent déjà publié dans votre organisation	Processus BPMN
Vous avez besoin d'une branche fixe basée sur des règles sans raisonnement	Décision ou commutateur

Un agent autonome est créé en ligne: sa configuration réside sur le nœud et se déplace avec le flux. Un processus BPMN fait référence à un agent dont la version est versionnée et déployée séparément.

Ajouter un agent

Ajoutez le nœud, puis configurez-le dans le panneau Propriétés.

1. Sélectionnez le bouton + sur une gestion de sortie, ou ouvrez la palette de nœuds dans la barre d'outils inférieure.
2. Sélectionnez la catégorie de l'agent , puis Agent autonome. Flow ajoute le nœud et ouvre son panneau Propriétés.
3. Configurez le modèle et les invites comme décrit ci-dessous.

Résultat: le nœud Agent autonome est ajouté au canevas avec son panneau Propriétés ouvert, prêt à être configuré.

Référence de la configuration

Champ	Requis	Default	Description
Modèle	Non (No)	Modèle d'agent par défaut de l'organisation	Le modèle LLM (Large Language Model) utilisé par l’agent. Sélectionnez un modèle dans le sélecteur, qui répertorie les modèles disponibles pour votre organisation.
Requête système	Oui (Yes)	Aucun (None)	Le rôle de l’agent et les instructions permanentes: qui il est et comment il doit se comporter. Écrivez des directives durables qui s’appliquent à chaque invocation, telles que le personnage, les contraintes et les attentes de résultat de l’agent.
Requête utilisateur	Oui (Yes)	Aucun (None)	La tâche de cette invocation. Référencez les données du workflow avec des expressions, par exemple $vars.start.output.request.
Température	Non (No)	0	Échantillonnage du caractère aléatoire, de 0 à 1. Des valeurs plus faibles rendent les réponses plus déterministes; des valeurs plus élevées rendent les réponses plus diversifiées ou créatives.
Nombre max. de jetons par réponse	Non (No)	16384	Longueur maximale de chaque réponse du modèle. Le plafond dépend du modèle sélectionné.
Nombre maximal d’itérations	Non (No)	25	Nombre maximal d’étapes de raisonnement et d’appel d’outils avant l’arrêt de l’agent. Accepte les valeurs comprises entre 1 et 100.
Garde-fous	Non (No)	Aucun (None)	Règles qui contraignent le comportement et les sorties de l'agent, telles que le blocage du contenu non autorisé ou le maintien de l'agent dans une étendue définie. Les garde-fous s'appliquent à l'agent dans son ensemble.

Variables d’entrée et de sortie

Déclarez les données que l'agent échange avec le reste du flux dans l'onglet Variables du panneau Propriétés.

• Les variables d’entrée sont des valeurs que vous transmettez à l’agent et que vous liez aux données du workflow. L'agent peut les référencer pendant son raisonnement. Les nouveaux agents commencent sans variables d'entrée.
• Les variables de sortie sont les champs structurés renvoyés par l’agent. Chaque agent commence par une variable de sortie, content, qui contient le texte de la réponse. Ajoutez davantage de variables de sortie pour que l’agent renvoie des données structurées.

Chaque variable de sortie que vous déclarez devient un champ sur l’objet output de l’agent. Donnez à chacun un nom et un type, puis indiquez à l’agent dans l’invite système pour le remplir. L'agent renvoie tous les champs déclarés ensemble dans un seul output structuré.

Ressources

Un agent autonome compose avec des nœuds de ressources que vous connectez à ses handles. Le nœud a trois gestionnaires de ressources, chacun avec sa propre étiquette dans la zone de dessin: Outils, Contexte et Escalades. Connectez une ressource à un handle, puis configurez cette ressource dans son propre panneau de propriétés. Les ressources se déplacent avec le flux.

Chaque handle accepte uniquement son type de ressource correspondant. La zone de dessin bloque les connexions qui ne correspondent pas, vous ne pouvez donc pas, par exemple, connecter un outil à la gestion du contexte.

Outils

Connectez des outils au handle Outils pour donner à l’agent les fonctionnalités qu’il peut appeler lors du raisonnement. L’agent décide pendant sa boucle s’il faut appeler chaque outil connecté. Chaque outil comporte une description qui indique à l'agent à quoi sert l'outil, alors écrivez des descriptions claires lorsqu'un outil en expose un.

Les types d'outils que vous pouvez connecter sont les suivants:

• Outils intégrés, trois outils prêts à l'emploi décrits ci-dessous.
• Outils de connecteur, qui permettent à l’agent d’appeler une opération Integration Service, par exemple l’envoi d’un e-mail ou la création d’un enregistrement dans un système en aval.
• Les outils de workflow RPA et de fonction d’API , qui permettent à l’agent d’invoquer un processus RPA ou un workflow d’API publié en tant qu’outil.
• Les outils de serveur MCP , qui exposent les outils publiés sur un serveur MCP.

Outils intégrés

Trois outils intégrés sont livrés avec Flow. Chacune est une ressource autonome que vous connectez à la gestion des outils et configurez dans son propre panneau.

• Analyser les fichiers: analyse un ou plusieurs fichiers avec un LLM pour extraire, synthétiser ou répondre à des questions sur leur contenu. Décrivez les fichiers que l’agent transmettra et la tâche d’analyse à exécuter sur ces derniers.
• Transformation par lots: traite et transforme un fichier CSV ligne par ligne. Fournissez le fichier source, décrivez la tâche par ligne et définissez les colonnes de sortie ajoutées par l'outil. Vous pouvez activer ou désactiver l’ancrage de la recherche Web pour la transformation.
• Résumer: produit une synthèse de documents (jusqu’à 1 000 pages) avec des citations. Fournissez la source, décrivez ce qu’il faut synthétiser et choisissez l’extension de fichier. Lorsque la source est un PDF, vous pouvez activer ou désactiver les citations.

Context

Connectez une ressource de contexte au handle de contexte pour ancrer l’agent dans vos données. L'agent s'appuie sur ces données d'ancrage lors du raisonnement au lieu de s'appuyer sur le modèle seul. Une ressource de contexte pointe vers un index de contexte dans votre organisation.

Configurez la façon dont l’agent récupère à partir de l’index, y compris le mode de récupération (sémantique, structuré, DeepRAG ou transformation par lots), la requête, le nombre de résultats à renvoyer, un seuil de pertinence et s’il faut inclure des citations. Pour créer un nouvel index de contexte, utilisez l'action Créer un nouveau contexte dans le panneau d'ajout du handle, qui ouvre la création d'un index dans un nouvel onglet.

Escalade

Connectez le handle des escalades pour acheminer vers une personne lorsque l’agent atteint un incident qu’il ne devrait pas décider seul. L’agent se met en pause, un humain agit sur l’escalade, et l’agent reprend avec le résultat. Vous pouvez associer l’une ou l’autre de ces deux ressources d’escalade:

• Escalade: redirige vers une tâche d'application d'action. Configurer l’application d’action, les destinataires, les notifications, les entrées transmises à l’application et la façon dont le résultat de l’application est mappé à l’agent.
• Escalade d'application d'action: redirige vers une application d'action codée, avec les mêmes destinataires, la même notification, la même entrée et la même configuration de mappage de résultat.

Les deux ressources d’escalade sont configurées de la même manière. Choisissez Escalade d’application d’action lorsque votre cible d’escalade est une application d’action codée plutôt qu’une application d’action standard. L'attachement de l'une ou l'autre ressource nécessite la version 1.2 ou ultérieure du nœud de l'agent autonome.

Entrées et sorties

Entrée

L'agent reçoit des données du nœud en amont via son gestionnaire d'entrée et de toutes les variables d'entrée que vous déclarez.

Sortie

L'agent renvoie un objet output contenant les variables de sortie que vous avez déclarées. Le champ par défaut est content, le texte de la réponse. Accédez à un champ avec $vars.<node>.output.<field>, par exemple:

$vars.agent1.output.content

Si l’agent échoue, le nœud remplit un objet error à la place. Reportez-vous à la section Gestion des erreurs pour connaître la forme de l'erreur et la façon de procéder.

{
  "output": {
    "content": "string. The agent's response text, plus any output variables you declared."
  },
  "error": "object. Populated only on failure. See Error handling."
}

Ramification sur le résultat

Suivez l'agent avec une Décision pour acheminer ce qu'il a renvoyé:

Autonomous Agent → Decision ($vars.agent1.output.content.includes("approved"))
  → True:  continue processing
  → False: escalate or terminate

Lisez un champ de sortie déclaré dans un nœud de script en aval:

return $vars.agent1.output.content;

Exemples

Exemple 1: classer une demande entrante

Ce qu'il fait: classe une demande d'assistance comme un remboursement, une réclamation ou une question, et renvoie le libellé sous forme de sortie structurée.

Requête système:

You are a support triage assistant. Classify each request into exactly one category: refund, complaint, or question. Respond with only the category.

Requête utilisateur:

Classify this request: $vars.start.output.request

Déclarez une variable de sortie category . L’agent renvoie:

{
  "output": {
    "category": "refund"
  }
}

Routez sur $vars.agent1.output.category avec un commutateur en aval.

Exemple 2: résoudre une requête de facture de bout en bout

Ce qu'il fait: répond à la question d'un client sur la facture en lisant la facture, en ancrant la réponse dans la politique, en appelant un workflow lorsqu'il doit agir et en faisant l'escalade lorsque le montant dépasse un seuil.

Reliez les handles de l'agent:

• Contexte: un index de contexte contenant votre politique de facturation afin que l'agent ancre sa réponse dans des directives approuvées.
• Outils: un outil intégré Analyser les fichiers pour lire la facture jointe et un outil de workflow RPA qui émet un remboursement dans le système de facturation.
• Escalades: une ressource d'escalade qui achemine les incidents à forte valeur vers un réviseur dans une application d'action.

Requête système:

You are a billing support agent. Use the billing policy in your context to answer invoice questions. Read the attached invoice before answering. If a refund is warranted and the amount is at or below 200, issue it with the refund workflow. If the amount exceeds 200, escalate for review instead of acting. Always return a structured result.

Requête utilisateur:

Resolve this customer query: $vars.start.output.query
Invoice: $vars.start.output.invoiceFile

Déclarez les variables de sortie resolution , refundIssued et amount (nombre). Un cas résolu renvoie:

{
  "output": {
    "resolution": "Refund issued for duplicate charge.",
    "refundIssued": true,
    "amount": 48.5
  }
}

Suivez l'agent avec une Décision sur $vars.agent1.output.refundIssued pour ramifier entre un message de confirmation et un chemin de suivi. L'agent gère le cas de dépassement du seuil en escalade, de sorte que la branche n'a pas besoin d'une logique supplémentaire dans le flux.

Problèmes couramment rencontrés

Une erreur de validation d’entrée s’affiche avant que vous puissiez déboguer. Le modèle, l'invite système et l'invite utilisateur sont tous requis. Le nœud signale une erreur de validation jusqu’à ce que chacun soit défini.

L'expression d'un élément de boucle ne se résout pas dans l'agent. Lorsque vous référencez l'élément actuel d'une boucle dans une invite, utilisez l'expression élément actuel de la boucle, par exemple $vars.loop1.currentItem.<field>. Le référencement d’une étendue incorrecte laisse la valeur non résolue au moment du runtime.

L’agent renvoie le texte lorsque vous attendiez des données structurées. Par défaut, l'agent renvoie uniquement content. Déclarez une variable de sortie pour chaque champ structuré souhaité et indiquez à l’agent dans l’invite système de les remplir.

Un outil de transformation par lots connecté signale une erreur de validation. La transformation par lots nécessite au moins une colonne de sortie. Définissez les colonnes que l’outil doit ajouter avant de déboguer le flux.

Vous ne pouvez pas connecter une escalade d’application d’action à l’agent. L’escalade d’application d’action nécessite la version 1.2 ou une version ultérieure du nœud de l’agent autonome. Mettez à niveau le nœud si la connexion est bloquée.

Pages liées

• Orchestrer un agent d’IA
• Processus BPMN
• Tâche humaine