Agent IA

Propre à OrkyvoToutes les offres1 entrée · 1 sortie

Agent conversationnel : un modèle de langage répond, en appelant si besoin les outils qui lui sont reliés, dans des limites contrôlées.

Éléments reçusAgent IAÉléments produits

Fonctionnement

Pour chaque élément reçu, l'agent envoie les instructions et le message au modèle relié, avec la mémoire de la conversation et la description des outils reliés. Quand le modèle demande un outil, le serveur vérifie l'outil, les arguments (schéma), les droits, les limites et l'approbation éventuelle avant de l'exécuter, puis renvoie le résultat au modèle.

Paramètres

Paramètre	Type	Détail
Instructions	texte long	Rôle, règles et format attendu. Les résultats d'outils et les documents sont toujours traités comme des données, jamais comme des instructions.
Message de l'utilisateurobligatoire	texte long	Avec un déclencheur de chat : {{ $json.chatInput }}.
Sortie	choix	Valeurs : Texte, JSON validé (sous-bloc « Format de sortie » requis).
Tentatives de correction du JSONselon les autres paramètres	choix	Si la réponse ne respecte pas le schéma, le modèle reçoit les erreurs et peut corriger. Un JSON invalide n'est jamais présenté comme conforme. Valeurs : Aucune, 1, 2.
Tours maximum (appels au modèle)	nombre	—
Appels d'outils maximum	nombre	—
Durée maximale (secondes d'activité)	nombre	Hors attentes d'approbation et de tâches distantes. 240 s au plus.
Budget de jetons par élément	nombre	Entrée et sortie cumulées. Facultatif.
Budget de coût par élément	texte	Dans la devise des paramètres IA. Exige un prix saisi pour le modèle. Facultatif.
Diffuser la réponse en direct	oui / non	Texte partiel visible pendant l'exécution ; la sortie du bloc reste la réponse finale complète.
En cas d'échec	choix	Valeurs : Arrêter le workflow, Continuer avec une sortie d'erreur (status).

Données reçues et renvoyées

EntréeListe d'éléments ; un passage de l'agent par élément.
Sortie{ response, status, toolCalls: [{ name, status, durationMs }], durationMs, usage: { inputTokens, outputTokens, source, cost, currency }, model, provider, conversationId? }

Erreurs

Modèle non relié, connexion refusée, limites atteintes (tours, outils, durée, jetons, coût), boucle répétitive, JSON invalide, fournisseur indisponible.

À savoir. Aucun fournisseur de secours n'est utilisé automatiquement.

À savoir. Une action externe dont le résultat est incertain (interruption) n'est jamais relancée automatiquement.

À savoir. Un appel proposé par le modèle n'est compté comme exécuté que s'il a réellement réussi.

Exemple

Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.

Paramètres de l'exemple (JSON)Ouvrir l'éditeur

{
  "instructions": "Tu es l'assistant du support.",
  "prompt": "{{ $json.chatInput }}",
  "outputMode": "text",
  "maxIterations": "8"
}