Aller au contenu principal

Créer et exécuter un agent

Un agent est un modèle de langage doté d'une invite système, d'un ensemble d'outils qu'il peut appeler et, éventuellement, d'autres agents auxquels il peut déléguer des tâches. Vous interagissez avec lui, et il décide à chaque étape s'il doit appeler un outil, confier une partie de la tâche à un sous-agent ou répondre.

Ce guide vous accompagne de la création d'un projet vide à la mise en service d'un agent que vous avez testé et appelé Tiet · Studio l'API. L'exemple pratique consiste à copier un agent de catalogue réel, à le modifier, puis à le déployer.

Agent, flux de travail ou graphe d'agents​

Vous avez besoinUtiliserPourquoi
Une conversation ou une tâche ouverte où le modèle décide des outils à utiliserAgent (cette page)Une seule invite, un seul modèle, des outils choisis à l'exécution. Diffuse une réponse de chat en continu.
Les mêmes étapes fixes à chaque fois, câblées par vos soins, sans qu'aucun modèle ne détermine l'ordreWorkflow dans le générateur : Créez n’importe quel flux de travailNœuds déterministes. Un flux de travail peut contenir un nœud Agent Executor même si une étape nécessite un modèle avec des outils.
Plusieurs étapes de modélisation avec différents rôles ou modèles, épinglées à chaque étape, avec un enregistrement par étapeAgent graph : Construire un graphe d'agentsGraphique versionné des nœuds LLM exécuté en une seule fois. Plus lent et plus coûteux qu'un agent unique.

Commencez par un seul agent. N'utilisez un graphe que si une seule invite ne suffit pas à contenir la logique, ou si vous avez besoin de modèles différents à chaque étape.

Comment un agent répond​

Boucle de l'agent : le modèle réfléchit, puis appelle un outil, délègue à un sous-agent ou répond ; les résultats sont observés et réinjectés pour le cycle suivant.

  • Les actions Tools sont celles que l'agent peut exécuter, telles que pubmed, medical-calculator ou memory. Vous les assignez dans l'onglet Conception. Un outil dont l'effet dépasse le plafond d'autonomie de l'exécution n'est pas proposé au modèle (voir Agents et gouvernance).
  • Il existe Sub-agents autres agents auxquels l'agent peut déléguer des tâches. Chacun d'eux est exposé au parent en tant qu'outil nommé agent_<tool_name> et s'exécute avec sa propre invite de commande et ses propres outils.
  • Models provient du registre dans Tiet · Agentic → Agents → Models. La section Model de l'onglet Conception en sélectionne un. Différents modèles peuvent être acheminés vers différentes phases (voir ci-dessous).
  • Agent type est définie lors de la création de l'agent : Conversational (conversation à plusieurs tours avec mémoire), Task (tâche unique), Hybrid (conversation et tâche) ou ReAct (boucle raisonnement, action, observation avec outils). Utilisez ReAct pour un agent qui utilise des outils.

Où sont les choses​

Ouvrez l'onglet Tiet · Agentic → Agents. Cette page comporte six onglets : Agents, Agent Graphs, Agent Catalog, Models, Tools et Skills. Seuls les onglets pour lesquels vous disposez des autorisations sont visibles. En haut à droite se trouvent les sélecteurs Project, Run in et New Agent. L'option Run in permet de choisir l'environnement d'exécution des fichiers lancés depuis Studio (l'environnement par défaut de l'organisation, sauf si vous en sélectionnez un autre). Un environnement autorisant les brouillons exécute les fichiers demandés par l'éditeur ; tout autre environnement n'exécute que les versions qui y sont déployées. Voir Environnements et promotion.

La barre latérale comporte également trois éléments frères et sœurs de moins de Tiet · Agentic → Agents :

  • Le bouton Agent Workspace vous permet de discuter avec un agent ou de lancer une course.
  • Monitor (Agent activity) liste les exécutions récentes sur chaque agent et graphe.
  • Reviews (SEPL commit reviews) liste les modifications d'agents proposées en attente d'une décision humaine, pour tous les agents. Voir Agents et gouvernance.

Créer un agent​

Il existe trois façons d'intégrer un agent à votre projet.

Le Agent Catalog contient Tietai agent de base géré. Environ 110 agents sont déployés, couvrant la codification et la facturation, l'aide à la décision clinique, la documentation, les soins infirmiers, la pharmacie, les soins spécialisés, les opérations et plus encore. Ce sont des points de départ testés avec des invites et des listes d'outils réels.

  1. Sélectionnez votre Project en haut à droite. Il est indispensable ; sans lui, la copie ne peut pas être créée.
  2. Ouvrez l'onglet Agent Catalog ou cliquez sur New Agent → Start from a Tietai base agent.
  3. Trouvez l'agent. Le champ de recherche du catalogue indique « Rechercher des agents par nom, description ou mots-clés… ».
  4. Cliquez sur Deploy to my org. Entrez Agent Name, puis Deploy.

Le résultat est une copie modifiable dans votre projet, sur laquelle s'ouvre l'éditeur. Malgré l'intitulé du bouton, la copie n'est pas encore déployée : elle est active, son numéro de version est celui de l'agent principal, les affectations d'outils sont copiées et les références des sous-agents sont copiées par référence. La copie conserve en mémoire le modèle d'origine, et l'onglet Historique affiche Review Changes lorsque le modèle est mis à jour ultérieurement.

Partir de zéro​

  1. Cliquez sur New Agent, puis Start from scratch (« Configurez un agent vierge avec vos propres paramètres. »).
  2. Remplissez la boîte de dialogue New Agent :
ChampSignificationExemple
NameRequis.Discharge Summary Helper
TypeConversationnel, Tâche, Hybride ou ReAct. Conversationnel par défaut.Réagir
DescriptionFacultatif.Drafts a discharge summary from a pasted note.
ProjectExtrait du sélecteur de projets. La boîte de dialogue affiche l'avertissement « Aucun projet actif — veuillez d'abord en sélectionner un. » et Create reste désactivée jusqu'à ce qu'un projet soit sélectionné.Projet de démonstration
  1. Cliquez sur Create. L'interface de conception s'ouvre. L'invite système, les outils et le modèle y sont configurés.

Dupliquer un agent existant​

Sur la fiche d'un agent, ouvrez le menu Actions et sélectionnez Duplicate. La copie est nommée <name> (Copy) et inclut les outils, les compétences et les politiques. Elle est volontairement créée inactive et n'est jamais copiée lors du déploiement ou de la publication dans Inference. Si la copie de certains éléments liés échoue, le message suivant s'affiche : « … a été créé, mais N éléments de configuration liés n'ont pas pu être copiés. Vérifiez la copie avant utilisation. » Le Designer ne propose aucune option pour réactiver un agent inactif. Par conséquent, pour une copie que vous souhaitez exécuter, privilégiez la méthode décrite ci-dessus.

Déplacer les agents vers un autre projet​

Sur la fiche d'un agent, le menu Actions affiche Move to project…. Cochez les cases de plusieurs fiches (Maj + clic pour sélectionner une plage) et utilisez la barre de sélection pour les déplacer ensemble. Seul le projet est modifié. Les agents du catalogue principal et les agents d'autres organisations ne peuvent pas être déplacés ; vous devez disposer d'une autorisation pour mettre à jour les agents. La destination doit être un projet de la même organisation.

L'agent concepteur​

Cliquez sur un agent pour ouvrir l'interface de conception. Les onglets sont :

LanguetteCe qu'il contient
DesignConfiguration : Identité, Invite, Variables, Outils, Compétences, Exécution, Sous-agents, Mémoire, Modèle. Boutons Enregistrer et Déployer à droite.
PoliciesRègles de gouvernance pour cet agent. Cinq types de règles sont New Policy : IntentGuard (bloquer les intentions utilisateur correspondant à un déclencheur), Playbook (intégrer des instructions pas à pas dans l’invite système), ToolGuide (ajouter des instructions à la description d’un outil), ToolApproval (attendre une validation humaine avant d’exécuter un outil, avec un délai d’expiration en minutes) et OutputFormatter (indiquer la mise en forme de la réponse finale). Déclencheurs : mot-clé, sémantique, nom_de_l’outil ou toujours. Chaque règle possède une priorité et un paramètre d’activation.
ActivityEnregistrement détaillé d'une session : sélectionnez une session, consultez ses étapes et sa durée, puis ouvrez-la dans l'explorateur de traces. Laissez ce champ vide jusqu'à ce que l'agent soit exécuté (« Aucune session pour le moment. Exécutez l'agent pour voir l'activité. »).
TestDiscuter avec l'agent déployé : Ask the Agent, Test Inputs (messages et fichiers enregistrés avec un résultat attendu optionnel) et Execution History.
ValidateRun Validation vérifie la configuration et liste les problèmes par champ, par exemple prompt_template: system prompt is required et model_config: model configuration is required.
HistoryListe des versions. La New draft version crée un brouillon avec des notes de modification facultatives.
APIClés API pour cet agent, point de terminaison d'appel, schéma de requête et exemples de code en cURL, TypeScript, Python et Java.
EvolutionInvites auto-évolutives (SEPL) : mode, Run Evolution, paramètres, révisions en attente et historique. Voir Agents et gouvernance.

La barre supérieure affiche le nom de l'agent, un sélecteur de version, un badge Deployed indiquant que le service est en ligne et un bouton Copilot qui ouvre un panneau d'assistance à côté des onglets. Les utilisateurs ayant le rôle de gestionnaire de plateforme voient également Publish to Catalog.

Les sections de l'onglet Conception​

SectionChamps et commandes
IdentityNom, Description, Version, Étiquettes (saisissez une étiquette et appuyez sur Entrée), Type d'agent.
PromptSystem Prompt : envoyé au modèle au début de chaque conversation. Indiquez {{name}} pour une valeur à renseigner lors de chaque appel (l’API Invoke appelle ces variables). Avec le routage de modèle activé, cela correspond à quatre invites par phase (Planification, Appel d’outil, Raisonnement, Synthèse) plus une invite par défaut pour les phases vides.
VariablesIndique ce que l'appelant fournit pour chaque {{name}} dans l'invite : nom, type (chaîne, texte, nombre ou booléen), obligatoire et un exemple. Ajoutez Add variable ou Declare N from the prompt pour les espaces réservés utilisés par l'invite et non déclarés. Maximum 50. Les déclarations sont versionnées avec l'agent et les préréglages des variables sont vérifiés par rapport à celles-ci (une valeur obligatoire manquante, une valeur non numérique ou une chaîne de plus de 1 000 caractères est refusée ; déclarez les valeurs longues comme text). Le point de terminaison d'appel lui-même ne les applique pas.
ToolsTous les outils disponibles pour votre organisation, regroupés par catégorie. Cliquez sur un outil pour l'attribuer ou le supprimer. L'attribution d'un outil disposant de droits d'action, et non seulement de lecture, ouvre d'abord une boîte de dialogue de vérification des autorisations.
SkillsCette fonctionnalité permet de charger les figurines à la demande. Le commutateur automatique injecte les instructions d'une compétence avant le premier tour de figurines.
ExecutionDefault Execution Mode (Rapide, Équilibré, Précis), Auto Variable Tracking, Auto Planning, Model Routing (un modèle par phase), Shortlister (classe les outils par pertinence ; nécessite Qdrant) et Code-Act Mode.
Sub-AgentsAdd Sub-Agent. Pour chacun : Agent ID, Tool Name, Invocation (sequential, parallel, fire-and-forget) et Description (« Quand déléguer à cet agent »).
MemoryEnable memory, puis le type de mémoire (épisodique, sémantique, procédurale, de travail), le backend de mémoire et une stratégie de récupération pour le backend Memora.
ModelModel sélecteur (avec « ensemble de touches » ou « pas de touche » pour le modèle sélectionné), Temperature, Max Tokens (256 à 128000), Enable streaming, et Manage model credentials.

La colonne de droite comporte Save Changes, Deploy, une case à cocher Publish to Inference (qui transforme l'agent en modèle sur la page d'inférence médicale) et un panneau Status (Actif, Déployé, Publié, À jour).

remarque

La valeur Invocation est enregistrée avec chaque référence de sous-agent. Dans le chemin de discussion et d'invocation, chaque sous-agent est enregistré comme un outil appelable nommé agent_<tool_name>, et le modèle détermine quand l'appeler ; ce chemin ne comporte aucune branche sequential, parallel ou fire-and-forget. Ne vous fiez pas au mode pour modifier le fonctionnement de la délégation.

Une délégation s'interrompt par défaut après 20 appels de modèle ou 10 cycles d'appel d'outil, ce qui provoque une erreur que le processus parent interprète comme un échec d'appel d'outil. Une conversation est également limitée à 30 délégations par heure et par processus serveur. Si max_sub_agent_depth n'est pas définie, la limite de profondeur est de 2.

Versions : brouillon, déploiement, version figée​

Cycle de vie des versions de l&#39;agent : non déployée, déployée et figée, nouvelle version brouillon, redéployée

  • Un agent non déployé est modifié sur place. La Save Changes demande des notes de modification facultatives et incrémente la version du correctif (par exemple, 1.1.0 à 1.1.1).
  • La valeur Deploy enregistre la configuration actuelle comme version déployée et indique que l'agent est actif. L'onglet Test, l'espace de travail de l'agent et l'API d'appel permettent d'exécuter la configuration déployée.
  • La version déployée est figée. Toute modification est refusée (erreur HTTP 409, code AGENT_DEPLOYED_IMMUTABLE) et le concepteur indique : « Cette version est déployée et immuable. Créez une nouvelle version pour la modifier. » Le nom, la description, les étiquettes, le projet et le paramètre d’inférence restent modifiables.
  • Pour modifier un agent déployé, cliquez sur New version (ou New draft version dans l'historique). Vous modifiez le brouillon ; l'agent en cours d'exécution reste inchangé. Save draft, puis Deploy vX.Y.Z. Discard draft le supprime.
  • Chaque version reste lisible. Pour revenir à une version antérieure, créez un brouillon à partir de celle-ci (« Nouvelle version à partir de celle-ci ») et déployez-le.
  • L'attribution des outils et des compétences ne fait pas partie de la version. Elle est modifiable en direct et n'est pas figée avec celle-ci. Les éléments déclarés comme Variables font partie de la version.

Le concepteur ne possède pas de bouton Undeploy, bien que l'API en possède POST /api/agents/{id}/undeploy.

Exemple fonctionnel : copier, ajuster, tester, déployer, appeler​

Vous copierez l'agent de catalogue Laboratory Results Interpreter, ajouterez une règle et l'appellerez. Sa définition de catalogue : type react, modèle gemini-2.5-pro (fournisseur google), température 30, nombre maximal de jetons 8192, compliance_level: hipaa, outils medical-calculator, pubmed, memory et ui, aucun sous-agent. Son invite interprète les résultats de laboratoire par rapport aux plages de référence, recherche les valeurs critiques et les problèmes pré-analytiques tels que l'hémolyse, et rédige des sections Markdown telles que ## Result Summary et ## Critical Value Screen.

Utilisez uniquement des données synthétiques.

1. Copiez-le​

  1. Sélectionnez un projet.
  2. Tiet · Agentic → Agents → Agent Catalog. Recherchez « Laboratoire ».
  3. Sur Laboratory Results Interpreter, cliquez sur Deploy to my org, définissez Agent Name sur Lab Interpreter (Demo Hospital) et cliquez sur Deploy.

Vous arrivez dans l'interface de conception. La barre supérieure affiche v1.1.0 et aucun badge Deployed Dans l' Tools (4) les quatre outils sont cochés.

2. Ajustez-le​

  1. Design → Identity : changer Description en Interprets lab results for Demo Hospital clinicians.
  2. Policies → New Policy → Playbook. Nommez-le Units on every value, définissez le déclencheur sur toujours, et dans Instructions (Markdown) écrivez 1. Print every value with the unit exactly as reported by the source laboratory. Cliquez Create Policy.
  3. Design → Save Changes, ajoutez la note Demo Hospital description et confirmez. La version devient 1.1.1.

Une stratégie Playbook injecte vos instructions dans l'invite système sans que vous ayez à modifier l'invite du catalogue, qui est longue et possède son propre contrat de sortie. Les stratégies ne font pas partie d'une version ; vous pouvez donc les modifier après le déploiement.

3. Valider et déployer​

  1. Validate → Run Validation. Vous devriez voir Agent is valid. Sinon, chaque problème indique le nom du champ.
  2. Design → Deploy. Le badge Deployed apparaît et l'onglet Test devient utilisable.

4. Testez-le​

  1. Ouvrez l'onglet Test Avant le déploiement, le message « Agent non déployé. Déployez l'agent depuis l'onglet Conception pour commencer les tests. » s'affiche.

  2. Dans Ask the Agent, envoyez :

    Test Patient A, 54 years old. Potassium 6.4 mmol/L, creatinine 2.1 mg/dL.
    The specimen is marked hemolyzed. Interpret these results.
  3. Vous devriez voir apparaître le flux de réponses, avec les appels d'outils effectués par l'agent. Vérifiez qu'il détecte bien les valeurs critiques, signale l'hémolyse comme cause pré-analytique possible et affiche les unités.

  4. Ouvrez Activity pour voir la même session étape par étape, et Test → Execution History pour l'enregistrement de l'exécution.

Pour conserver un message pour plus tard, utilisez Test Inputs : entrez un Input name, le Message, les pièces jointes facultatives et un Expected result facultatif.

5. Discutez avec lui dans l'espace de travail de l'agent.​

  1. Tiet · Agentic → Agents → Agent Workspace. Le lanceur affiche vos agents et graphiques actifs sous forme de cartes, triées par nom. Un agent conversationnel, hybride ou ReAct est en mode Ask ; un agent de tâche est en mode Tool.
  2. Ouvrez la fiche de votre agent et cliquez sur Start conversation. Saisissez « Demander un suivi, coller un lien ou joindre un fichier… ». L’écran affiche la mention « Aide à la décision clinique uniquement ».

6. Appelez-la depuis l'API​

  1. Ouvrez l'onglet API et cliquez sur Generate Key. Renseignez les champs Name, Description (facultatif), Expires in (30 jours, 90 jours, 1 an ou Jamais), Rate limit (requêtes par minute, 0 étant illimité) et IP whitelist (facultatif, une par ligne). La clé est associée à cet agent (agent:<agent id>:execute).

  2. Copiez immédiatement le jeton : « Conservez ce jeton — il ne sera plus affiché ».

  3. Appelez le point de terminaison. Via la passerelle, le chemin est /api/v1/hydra-platform/v1/agents/{id}/invoke :

    curl -X POST https://api.tiet.ai/api/v1/hydra-platform/v1/agents/AGENT_ID/invoke \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "message": "Test Patient A. Potassium 6.4 mmol/L, hemolyzed specimen. Interpret.",
    "stream": false
    }'

L'onglet API remplit automatiquement les champs AGENT_ID et vos propres noms {{variable}}).

Champ de requêteTaperNotes
messagechaîneObligatoire sauf si vous envoyez attachments.
variablesobjet de chaînes de caractèresValeurs des espaces réservés à {{name}} dans l'invite.
streambooléentrue renvoie des événements envoyés par le serveur (data: {...} image). L'exemple de flux de l'onglet API en ajoute Accept: text/event-stream.
historytableau de {role, content}Vous prenez la parole plus tôt, si vous menez la conversation vous-même.
attachmentstableauFichiers du modèle ; envoyés à la place d’un message ou avec un message.

Avec stream: false la réponse est un objet JSON. Il contient content (la réponse), input_tokens et output_tokens, et, si les outils ont été exécutés, tool_calls et tool_trace. Avec stream: true le flux se termine par une trame contenant "done": "true", le nombre de jetons et final_content ; une erreur le termine avec {"type": "error", ...}.

7. Modifiez-le après le déploiement​

  1. Ouvrez l'agent et l'onglet Design Un message indique que la configuration en cours ne peut pas être modifiée sur place.
  2. Cliquez sur New version, modifiez le brouillon, Save draft, puis Deploy v1.1.2.
  3. La History affiche désormais les versions précédentes et la nouvelle. Les versions déployées plus anciennes restent lisibles.

Surveillez les actions des agents.​

La section Tiet · Agentic → Agents → Monitor (« Activité des agents : exécutions récentes sur l’ensemble des agents et sous-agents ») affiche les vignettes Runs, Success rate, Failed, Running now, Avg duration et Cost, des filtres par type, statut, période, agent et nom, ainsi qu’un tableau Executions contenant l’agent, le type, le statut, la date de début, la durée, les jetons, le coût, l’élément déclencheur et un lien vers la trace. L’appel API de l’étape 6 apparaît ici.

Limites​

  • L'onglet Test exécute uniquement un agent déployé.
  • L'attribution des outils et des compétences est instantanée et ne fait pas l'objet d'un versionnage.
  • Les modes du sous-agent Invocation sont stockés, mais ne sont pas appliqués dans le chemin de conversation (voir la note ci-dessus).
  • La gestion des modèles de repli, la persistance des exécutions et la protection contre les boucles relèvent des nœuds du graphe d'agents, et non d'un agent unique. Voir Agents et gouvernance.
  • Les agents de base du catalogue sont en lecture seule pour vous. Seul un administrateur de plateforme peut les modifier, et ces modifications affectent toutes les organisations.

Dépannage​

Tu voisCause et solution
L'option Create est désactivée et la boîte de dialogue affiche « Aucun projet actif — veuillez d'abord sélectionner un projet. »Choisissez un projet dans le sélecteur de projets en haut à droite.
Bouton New Agent manquantVous ne disposez pas de l'autorisation de création d'agent. Veuillez contacter un administrateur de l'organisation.
Onglet Test : « Agent non déployé »Cliquez sur Deploy dans l'onglet Conception (enregistrez d'abord ; le déploiement est désactivé tant qu'il y a des modifications non enregistrées).
« Cette version est déployée et immuable. Créez une nouvelle version pour la modifier. » (409 AGENT_DEPLOYED_IMMUTABLE)Cliquez sur New version, modifiez le brouillon, déployez-le.
Validation : system prompt is required ou model configuration is requiredRemplissez la section « Invite » ou choisissez un modèle dans la section « Modèle ».
La section Modèle indique « Aucun modèle configuré » ou « Aucune clé ».Enregistrez le modèle et sa clé sous Tiet · Agentic → Agents → Models.
La fonction Invoke renvoie 400 message or attachments requiredLe corps ne contient pas message.
La fonction Invoke renvoie 403 Access denied ou Agent is not activeLa clé appartient à une autre organisation, ou l'agent est inactif (par exemple, un doublon non utilisé).
La fonction Invoke renvoie une erreur 404 Agent not foundIdentifiant d'agent incorrect dans l'URL.
La délégation échoue avec le message « limite de délégation de sous-agents atteinte ».La conversation a utilisé ses 30 délégations pour l'heure. Lancez une nouvelle conversation ou réduisez le nombre de délégations.

Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.