Agents IA

Un agent IA est un assistant multi-étapes. Il lit la conversation, planifie, appelle des outils (vos outils IA, des outils MCP et une recherche dans une base de connaissances), examine les résultats et rappelle le modèle jusqu'à obtenir une réponse. Le nœud Générer une réponse IA effectue un seul appel de modèle puis répond ; le nœud Agent IA peut enchaîner plusieurs appels de modèle et d'outils, dans les limites que vous définissez, avant de répondre.

Utilisez un agent lorsqu'une demande nécessite plusieurs étapes, par exemple « retrouver la commande du client, vérifier son statut de livraison et proposer une nouvelle date ». Pour une réponse directe à partir d'instructions et d'une base de connaissances, le nœud IA est plus simple et moins coûteux.

Les éléments de base

Élément	Ce que c'est	Où le définir
Harness IA	Le moteur qui exécute la boucle de l'agent : celui de MonoChat, un SDK d'agent ou un service d'agent hébergé.	Paramètres › Automatisation › Harness IA
Modèles	Les modèles IA avec lesquels l'agent réfléchit : un modèle principal, un modèle de secours facultatif et un modèle rapide facultatif. Les harness hébergés utilisent à la place les modèles de leur propre fournisseur.	Le nœud Agent IA
Outils	Les périmètres IA, les fonctions Outil IA et les outils MCP.	Le nœud Agent IA
Budget d'exécution	Les limites d'appels de modèle, d'appels d'outils, de jetons, de durée et de nouvelles tentatives pour chaque exécution.	Le nœud Agent IA
Exécution	Une exécution de l'agent. Chaque exécution est enregistrée dans Exécutions d'agent IA.	Créée par le nœud ou par l'API

Harness IA

Paramètres › Automatisation › Harness IA liste les harness sur lesquels vos agents peuvent s'exécuter : ceux que MonoChat propose à tous les espaces de travail, et ceux que vous ajoutez avec vos propres identifiants.

Harness	Où il s'exécute	Modèles utilisés	Qui l'ajoute
MonoChat Native	Dans MonoChat	Vos modèles IA	MonoChat
OpenAI Agents SDK	Dans MonoChat	Vos modèles IA	MonoChat
Claude Agent SDK	Sur l'exécuteur d'agents MonoChat	Vos modèles IA	MonoChat
pi	Sur l'exécuteur d'agents MonoChat	Vos modèles IA	MonoChat
OpenAI Agents API	Dans le cloud d'OpenAI	Les modèles autorisés du harness	Vous, avec votre clé d'API OpenAI (MonoChat peut aussi en proposer une)
Claude Managed Agents	Dans le cloud d'Anthropic	Les modèles autorisés du harness	Vous, avec votre clé d'API Anthropic (MonoChat peut aussi en proposer une)
Custom Endpoint	Sur votre propre serveur	Vos modèles IA (facultatif)	Vous, avec votre point de terminaison et votre secret

Les harness qui s'exécutent sur MonoChat sont proposés par MonoChat ; votre espace de travail ne peut ajouter que des harness fonctionnant avec ses propres identifiants. Claude Agent SDK et pi nécessitent l'exécuteur d'agents de MonoChat : là où il n'est pas configuré, une exécution sur ces harness échoue avec « Ce harness n'est pas disponible sur ce serveur. »

Quel que soit le harness, MonoChat garde le contrôle : chaque appel de modèle d'un harness qui utilise vos modèles IA passe par MonoChat (la facturation et le budget s'appliquent donc), chaque appel d'outil exécute vos fonctions, outils MCP et périmètres IA dans votre espace de travail, et le budget est appliqué sur tous les harness.

Ajouter un harness

Allez dans Paramètres › Automatisation › Harness IA et cliquez sur + (Créer).
Saisissez un Nom et, si vous le souhaitez, une Description.
Choisissez le Harness. Chaque option indique où il s'exécute.
Sous Identifiants, saisissez ce dont le harness a besoin :
- OpenAI Agents API, Claude Managed Agents : Clé d'API.
- Custom Endpoint : Point de terminaison et Clé d'API.
Pour un harness hébergé, renseignez les Modèles autorisés : saisissez les noms de modèle du fournisseur (par exemple l'ID de modèle OpenAI ou Anthropic). Utilisez Ajouter un modèle pour ajouter jusqu'à 10 modèles. Les agents de ce harness ne peuvent choisir que dans cette liste.
Cliquez sur Enregistrer.

Lorsque vous modifiez un harness, le type de Harness ne peut pas être changé, et le champ de la clé affiche Clé API (laisser vide pour conserver la clé enregistrée).

Claude Managed Agents

La première fois qu'un harness de ce type est utilisé, MonoChat crée un agent et un environnement dans ce compte Anthropic, puis les réutilise ensuite.

Custom Endpoint

Un harness Custom Endpoint envoie les exécutions à votre propre service, par exemple un agent auto-hébergé. Pour chaque exécution, MonoChat envoie un POST à <Endpoint>/runs avec Authorization: Bearer <API Key>. Le corps contient l'ID de l'exécution, les instructions, l'entrée, les messages de la conversation, le budget, les alias de modèle (agent-main, agent-fallback, agent-fast) et trois URL avec un jeton propre à cette exécution :

une passerelle de modèles (URL de base compatibles OpenAI …/v1 et compatibles Anthropic) qui appelle les modèles IA du nœud et applique le budget,
un serveur MCP qui expose les outils de l'exécution,
une URL d'événements où votre service signale le résultat (completed avec result, ou failed avec error).

Le jeton de l'exécution cesse de fonctionner lorsque l'exécution se termine.

Le nœud Agent IA

Ajoutez un agent à un flux avec le nœud Agent IA, parmi les nœuds hybrides du concepteur de flux. Voir Flux pour savoir comment ajouter et connecter des nœuds.

Champs

Section	Champ	Description
	Nom	Le nom du nœud affiché sur le canevas.
	Harness IA	Obligatoire. Le harness qui exécute l'agent.
	Instructions	Les instructions système de l'agent : son rôle, son ton, ses règles et ce qu'il peut ou ne peut pas faire.
	Tâche (ajoutée aux instructions de l'agent ; balises possibles)	Ce que ce nœud demande à l'agent de faire. Elle est ajoutée après les instructions et peut utiliser les mêmes balises que le prompt du nœud IA, par exemple pour inclure des données du client.
Modèles	Modèle principal	Le modèle utilisé par l'agent. Obligatoire pour tous les harness sauf Custom Endpoint.
	Modèle de repli (après la limite souple)	Le modèle sur lequel l'agent bascule une fois la limite souple d'appels de modèle atteinte, généralement un modèle moins cher ou plus rapide.
	Modèle rapide (tâches de fond légères)	Un modèle qu'un harness peut utiliser pour ses appels légers en arrière-plan.
	Modèle (un des modèles autorisés du harness)	Affiché à la place des trois champs ci-dessus pour un harness hébergé.
Session de l'agent	Session	Poursuivre la session d'agent existante (par défaut) ou Démarrer une nouvelle session d'agent. Voir Sessions d'agent.
	Clé de tâche (une session d'agent par tâche)	Facultatif. Conserve une session d'agent distincte par clé dans la même conversation, par exemple `booking` et `support`.
	Limite de l'historique des messages	Le nombre de messages de la conversation que l'agent reçoit.
	Modèles IA de transcription	Un modèle avec Transcription. Les messages vocaux de la conversation parviennent à l'agent sous forme de texte.
Paramètres des outils	Périmètres IA	Les bases de connaissances que l'agent peut consulter. Elles sont proposées à l'agent comme un outil de recherche dans la base de connaissances.
	Outil IA	Les fonctions de type Outil IA que l'agent peut appeler.
	Définir les outils de contenu du client MCP IA	Ouvre le panneau où vous ajoutez des outils MCP. Voir Clients MCP.
Messages	Transmettre les messages intermédiaires au client	Désactivé par défaut. Ce que l'agent écrit pendant qu'il travaille encore (par exemple « Je vérifie votre commande ») est envoyé au client lorsque l'option est activée ; sinon, c'est ajouté à la session comme un message chuchoté que seule votre équipe voit.
	Envoyer la réponse	Activé par défaut. Envoie la réponse finale de l'agent au client. Désactivez-le pour n'utiliser la réponse qu'à l'intérieur du flux.
Budget d'exécution	Appels de modèle max.	4 par défaut.
	Limite souple : appels de modèle	Facultatif. Après ce nombre d'appels de modèle, l'agent bascule sur le modèle de secours. Doit être inférieure à Appels de modèle max. et nécessite un modèle de secours.
	Appels d'outils maximum	6 par défaut. Avec `0`, l'exécution se termine en Budget dépassé dès que l'agent tente d'appeler un outil.
	Tokens totaux max.	20000 par défaut. Jetons en entrée et en sortie de tous les appels de modèle de l'exécution.
	Durée max. (secondes)	30 par défaut.
	Tentatives maximum	2 par défaut. Nombre de nouvelles tentatives d'un appel de modèle en échec.

astuce

Écrivez les règles stables dans Instructions et la mission précise de cette étape dans Tâche. Ainsi, plusieurs nœuds Agent IA d'un flux peuvent partager les mêmes instructions et ne différer que par leur tâche.

attention

Les harness hébergés ne prennent pas en charge de limite souple, car ils ne peuvent pas basculer sur un modèle de secours. Laissez Limite souple : appels de modèle vide pour eux.

Ce qui se passe lorsque le flux atteint le nœud

MonoChat vérifie votre solde et les paramètres du nœud, puis démarre une exécution. L'exécution est En file d'attente, puis En cours. L'instance de flux attend sur le nœud.
L'agent reçoit les instructions et la tâche, et, lorsque le flux appartient à une conversation, les messages de la conversation jusqu'à la Limite de l'historique des messages, les messages vocaux étant transcrits.
L'agent appelle des modèles et des outils jusqu'à obtenir une réponse ou atteindre une limite. Le texte qu'il écrit entre deux appels d'outils est traité comme un message intermédiaire.
Lorsque l'exécution se termine :
- si elle est Terminé et que Envoyer la réponse est activé, la réponse est envoyée au client. Les longues réponses sont découpées en plusieurs messages lorsqu'elles dépassent la limite du canal (4096 caractères sur WhatsApp) ;
- si elle s'est terminée autrement, un message chuchoté « Exécution de l'agent IA terminée : statut. erreur » est ajouté à la session pour votre équipe.
Le flux continue sur la sortie correspondant à la façon dont l'exécution s'est terminée.

Les exécutions d'une même session d'agent sont traitées une par une, dans l'ordre.

Sorties

Sortie	Quand
Terminé	L'agent a terminé avec une réponse.
Budget dépassé	L'exécution a épuisé Appels de modèle max., Appels d'outils maximum ou Tokens totaux max..
Délai dépassé	L'exécution a atteint Durée max. (secondes).
Haine, Contournement, Automutilation, Sexuel, Violence	Le filtre de contenu du fournisseur de modèle a arrêté l'exécution pour cette catégorie. Ce sont les mêmes sorties que celles du nœud IA.
En cas d'échec	L'exécution a échoué pour toute autre raison, ou a été annulée. Un arrêt par le filtre de contenu arrive aussi ici sur les nœuds enregistrés avant l'existence de ces sorties ; ouvrez et enregistrez un tel nœud pour les obtenir.

Connectez au moins Terminé et En cas d'échec. Un schéma courant consiste à envoyer Budget dépassé, Délai dépassé et En cas d'échec vers un nœud Attribuer la conversation afin qu'un collègue prenne le relais.

Sessions d'agent

Une session d'agent est la mémoire de l'agent d'une exécution à l'autre. MonoChat conserve une session d'agent active par conversation, par harness et par clé de tâche.

Poursuivre la session d'agent existante la réutilise : l'agent reprend là où il s'était arrêté. Sur les harness hébergés, la session propre au fournisseur se poursuit aussi.
Démarrer une nouvelle session d'agent ferme la session active et repart de zéro, par exemple au début d'un nouveau sujet.
Une Clé de tâche permet de conserver des sessions indépendantes côte à côte dans la même conversation.

Facturation

Les appels de modèle sur les modèles IA fournis par MonoChat sont facturés sur votre solde comme d'habitude. Les appels sur vos propres modèles sont facturés par votre fournisseur.
Un harness fourni par MonoChat peut ajouter ses propres frais par exécution, par minute et par appel d'outil, et, pour un harness hébergé, les jetons indiqués par son fournisseur. Ils apparaissent dans les Transactions sous Exécution d'agent IA, Durée d'agent IA, Appel d'outil d'agent IA et des catégories de jetons IA.
Un harness que vous ajoutez avec vos propres identifiants n'a aucun frais MonoChat ; son fournisseur vous facture.
Une exécution ne démarre pas lorsque votre solde est insuffisant.

Événement Exécution de l'agent IA terminée

Exécution de l'agent IA terminée est un nœud d'événement. Il se déclenche lorsqu'une exécution liée à un client se termine, qu'elle ait été lancée par un flux ou via l'API avec une session. Comme les autres nœuds d'événement, il dispose de paramètres facultatifs Condition et Délai dépassé. Utilisez-le pour démarrer un flux distinct après les exécutions d'agent, par exemple pour consigner les résultats ou prévenir une équipe.

Lancer un agent depuis du code

Les fonctions personnalisées et les clients d'API peuvent lancer des agents avec ces méthodes (permission Lancer / Consulter / Annuler des exécutions d'agents IA dans l'automatisation) :

Méthode	Ce qu'elle fait
`business.tenants.automation.ai.aiAgentRuns.create`	Lance une exécution. Renvoie `aiAgentRunId` et `aiAgentSessionId`.
`business.tenants.automation.ai.aiAgentRuns.show`	Renvoie une exécution (`_id`) avec son statut, son usage, ses étapes et son résultat.
`business.tenants.automation.ai.aiAgentRuns.cancel`	Annule une exécution en file d'attente ou en cours (`_id`).

create accepte aiHarnessClientId, input (la tâche), et facultativement sessionId (pour travailler dans une conversation), aiAgentSessionId, taskKey et isNewSession, ainsi que options avec les mêmes paramètres que le nœud : instructions, aiModelClientId, fallbackAiModelClientId, fastAiModelClientId, harnessModel, toolCustomFunctionIds, aiScopeIds, aiMcpClientDatas, messageHistoryLimit, speechToTextAiModelClientId, forwardIntermediateMessages, willSendAnswer et un budget obligatoire. Via l'API, forwardIntermediateMessages et willSendAnswer valent false par défaut.

const { aiAgentRunId } = await sdk.method({ name: 'business.tenants.automation.ai.aiAgentRuns.create' }).callAsync({
  payload: {
    aiHarnessClientId: 'HARNESS_ID',
    input: 'Summarise the open orders of this customer.',
    sessionId: 'SESSION_ID',
    options: {
      instructions: 'You are the order assistant of our store.',
      aiModelClientId: 'MODEL_ID',
      toolCustomFunctionIds: ['FUNCTION_ID'],
      budget: { maxLlmCalls: 4, maxToolCalls: 6, maxTotalTokens: 20000, maxDurationSeconds: 30, maxRetries: 2 },
    },
  },
})

L'exécution est asynchrone : lisez-la plus tard avec show, ou réagissez-y avec l'événement Exécution de l'agent IA terminée. Sans sessionId, chaque appel démarre une nouvelle session d'agent, sauf si vous transmettez l'aiAgentSessionId renvoyé par un appel précédent ; l'agent voit alors les exécutions terminées précédentes de cette session d'agent comme son historique. Voir Method pour appeler des méthodes depuis une fonction.

Permissions

Permission	Autorise
Consulter / Créer / Modifier / Supprimer les harness IA dans l'automatisation	Gérer les Harness IA
Consulter les exécutions d'agents IA dans l'automatisation	Voir les Exécutions d'agent IA
Lancer des exécutions d'agents IA dans l'automatisation	Appeler `aiAgentRuns.create`
Annuler des exécutions d'agents IA dans l'automatisation	Appeler `aiAgentRuns.cancel`

Voir Rôles.

Exécutions d'agent IA : voir ce que chaque exécution a fait
Modèles IA
Clients MCP
Périmètres IA
Flux

Les éléments de base​

Harness IA​

Ajouter un harness​

Custom Endpoint​

Le nœud Agent IA​

Champs​

Ce qui se passe lorsque le flux atteint le nœud​

Sorties​

Sessions d'agent​

Facturation​

Événement Exécution de l'agent IA terminée​

Lancer un agent depuis du code​

Permissions​

Voir aussi​