Référence du graphe d'agent
Contrôles, champs de schéma, cycle de vie d'exécution et limites de Graph Agent Studio. Pour un exemple guidé, commencez par « Créer votre premier graphe d'agents ».
Visite du studio Graph Agent
Ouvrez-le à partir de l'onglet Tiet · Agentic, puis Agents, puis Agent Graphs (l'onglet affiche le nombre de graphiques, par exemple « Graphiques d'agents (3) » ; son adresse est /studio/graphs). Choisissez un graphique dans la liste ou créez-en un avec le bouton New graph (titre « Nouveau graphique », boîte de dialogue « Nouveau graphique », champ d'espace réservé « ex. Pipeline QA + Rédacteur », bouton Create).
barre d'outils
| Contrôle | Ce que cela fait |
|---|---|
| New graph / New version (boutons icônes) | Créer un graphique ou une nouvelle version (espace réservé 1.0.0). |
| + Node (étiquette « Nœud », infobulle « Ajouter un nœud ») | Ajouter un nœud. Désactivé sur une version publiée : « Les versions publiées sont immuables ; commencez par créer une copie de brouillon. » |
| Draft (infobulle « Élaborez ce graphique à partir d’une description ») | L'IA génère un graphique à partir de la description que vous saisissez. Vérifiez le résultat avant de vous y fier. |
| Save | Affiche Unsaved, Saved ou Save error. Sur une version publiée, l'infobulle indique : « Les versions publiées sont immuables — Enregistrer créera un nouveau brouillon (crée une copie de la version actuelle) ». |
| Publish | Publie la version. Infobulle : « Publier cette version (nécessaire pour l’exécution) ». Désactivé si déjà publié. |
| Validate | Info-bulle : « Valider la structure du graphe (entrée/sortie, accessibilité, itinéraires, boucles) ». Affiche les erreurs et les avertissements dans l’éditeur. |
| Run (bouton de fractionnement) | Run (« Exécuter le graphe complet ») et, dans le menu contextuel, Debug step-by-step (« Pause à chaque nœud »). Désactivé jusqu'à la publication d'une version. Une boîte de dialogue intitulée « Exécuter le graphe » ou « Exécution de débogage » demande une entrée (un Form de votre liste input_schema, ou Raw JSON, et un Preset si vous avez enregistré des exemples). |
| Pause, Cancel | Apparaissent pendant une course. |
Les superutilisateurs voient également un bouton Catalog qui permet de partager un graphique publié avec toutes les organisations.
Panneau de gauche : Nœuds et palette
Nodes liste les nœuds de la version ouverte avec un champ de recherche. Palette liste les éléments que vous pouvez déposer sur le canevas :
| Section | Entrées |
|---|---|
| Cœur | Agent existant, LLM intégré, Agent d'outils, Planificateur |
| Routage | Routeur (route unique, deux routes pré-remplies), Routeur multiple (plusieurs routes, distribution en éventail), Portail de vérification (portail de vérification plus la route __verify_failed__) |
| Durée d'exécution | Vérification humaine (point de contrôle avec intervention humaine), agent de mémoire, lecteur de pièces jointes |
| Déterministe | Une entrée par gestionnaire déterministe signalé par le serveur, nommée par son handler_type |
Outils Edge
Au-dessus du canevas, vous choisissez le comportement de la prochaine connexion que vous tracez :
| Outil | Signification (infobulle) |
|---|---|
| Auto | Déduire l'itinéraire ou le plan de repli à partir du port source |
| Chain | Bord déterministe |
| Parallel | Bordure en éventail avec graphique fan_out_mode=all |
| Cycle | Bord arrière délimité avec traversées maximales |
| Route | Bord de route à partir d'une route nommée |
| Fallback | Bord de repli |
| Join | Rejoignez le bord pour le ventilateur-in |
| Condition | Arête déterministe qui ouvre l'éditeur de conditions |
Cliquer sur une arête ouvre sa boîte de dialogue : Source node, Target node, Kind (Déterministe, Route, Repli, Joindre), Route Name, une condition, Transform, Priority et Max Traversals. Le canevas comporte également un zoom, Fit view, Auto-arrange nodes et un commutateur d’arête Routing (Smart ou Curved).
Inspecteur de nœud
Cliquez sur un nœud pour ouvrir l'inspecteur dans le panneau de droite. Ses onglets sont General, Model, Prompt, Tools, Memory, Routing et Verify.
| Languette | Ce que vous avez défini |
|---|---|
| Général | Nom d'affichage, description, Set as entry / Entry node, Mark as exit / Exit node, bascules Human-in-the-loop, Receive attachments, Memory, le Memory backend (Hériter, Plat, Memora, affiché avec la bascule Mémoire), le Prompt-injection defence choix (Hériter, Directive Plateforme, Directive Personnalisée, Désactivé), Max retries, Timeout (ms). |
| Modèle | Language model, Max tokens, Streaming ; pour les nœuds RLM et ParSer, le mode d'exécution et leurs champs. |
| Rapide | System Prompt (un modèle Go sur un état partagé). |
| Outils | Add tool du catalogue d'outils de l'organisation, Add skill. |
| Mémoire | L'éditeur de contrôle de la mémoire (onglet « Mémoire »). |
| Routage | Routing mode (none, single, multi) et la liste des itinéraires (nom plus une description affichée au modèle). |
| Vérifier | Verification gate avec Mode (juge, fondé, consensus), Evidence state keys, Verifiers, Pass threshold, Min confidence, Verifier model, Candidate key, Rubric. |
Lorsque vous ajoutez un nœud, vous pouvez soit référencer un agent existant, soit en créer un (New agent, soit choisir l' Inline node (« Un nœud avec sa propre invite et son modèle intégrés — aucun enregistrement d'agent requis »). Un nœud déterministe (de la section Déterministe de la palette) ne possède ni modèle, ni invite, ni outils.
Panneau de droite
Onglets : Info, Usage, History, API, Assistant.
- Info : nom et description du graphe, Guards (Max Steps, Fan-Out Mode, Scheduling, Workers), Prompt-injection defence (Boundary directive), Runtime patterns (quels types d'arêtes le graphe utilise), Medical inference (Expose to inference, Default engine).
- Usage : Intended use, Intended users, Run inputs (votre
input_schema), Example presets. - History : exécutions précédentes avec leurs étapes et appels d'outils.
- API : extraits de
curlTypeScript et Python prêts à l'emploi, et un bouton pour créer un jeton limité àgraph:<id>:execute. - Assistant : un copilote qui répond aux questions ou génère un graphique pour une tâche.
Panneau inférieur et débogage
Onglets du bas : Events (n), Step Output, Step Inspector, Trace, Variables. L’inspecteur d’étapes affiche Input, Output, Resolved prompt, Thinking, l’enregistrement de vérification et Tool calls (n). Trace liens vers l’explorateur de traces (arbre complet, coût, nouvelles tentatives, exécutions imbriquées).
Dans une exécution de débogage, le panneau de débogage comporte Continue (F5), Step over (F10), Step into (F11) et Stop, plus trois onglets : Overrides (Override route, Mock tool call, modifier l'entrée et Apply & Continue), Step Inspector (avec Rerun step) et Breakpoints. Les types de points d'arrêt sont before_node, after_prompt_render, before_tool_call, after_tool_call et after_node ; laissez l'ID du nœud vide pour s'arrêter à tous les nœuds.
Une exécution qui atteint un nœud avec intervention humaine ouvre une boîte de dialogue intitulée Human Review Required avec un champ Payload (JSON) et des boutons Skip et Submit.
Anatomie d'un graphique
Le Studio modifie un document JSON, la définition. Vous pouvez le lire et l'écrire via l'API (le point de terminaison de version accepte {"version": "1.0.0", "definition": {...}}). Tout ce qui suit est un champ de ce document.
Champs de niveau supérieur
| Champ | Signification | Règle |
|---|---|---|
entry_node_id | Premier nœud à exécuter | Obligatoire, doit correspondre à un nœud. |
exit_node_ids | Nœuds où l'exécution peut se terminer | Au moins une ; chacune doit correspondre à un nœud. La réponse est le text du nœud de sortie. |
nodes, edges | Le graphique | Identifiants uniques ; chaque arête nécessite un id ainsi qu'une source et une cible existantes. |
guards | Limites strictes (ci-dessous) | La valeur max_total_steps est requise et doit être supérieure à 0. |
fan_out_mode | all (par défaut), first, by_priority | Comportement de plusieurs arêtes non routées correspondantes issues d'un même nœud. first et by_priority activent les priority plus petits nombres. |
scheduling | mode serial (par défaut) ou parallel, max_parallel_workers | Le mode sériel nécessite 0 nœuds de calcul. Le mode parallèle nécessite au moins 2 nœuds et pas plus que la limite de nœuds actifs. |
compliance | regulated, affects_clinical_output, data_classification (none, pseudonymised, phi), research_only | L’absence de blocage signifie « clinique » (sécurité et gouvernance). |
input_schema | Entrées de la séquence d'exécution : key, label, type (string, text, number, boolean, json), required, default, description, enum | Génère le formulaire d'exécution. Vide signifie un texte libre query. |
examples | Préréglages d'entrée enregistrés (name, description, input) | Affiché comme Preset dans la boîte de dialogue d'exécution. |
intended_use | statement, intended_users | Documentation, versionnée avec le graphique, non obligatoire. |
metadata | owner, tags, protocol_ref, schedule_permission | Non utilisé par le moteur. |
variables, shared_state_schema | Déclarations de ce qui circule dans le graphe | Déclaration uniquement. Une variable nécessite un nom en minuscules, une description, un type connu et une source. |
prompt_defense | Valeur par défaut au niveau du graphe pour la défense contre les injections | Un nœud peut le remplacer. Activé par défaut. |
Types de nœuds
Chaque nœud possède id, name (tous deux obligatoires), un description optionnel et un canevas position. Le type est déterminé par les autres paramètres que vous définissez.
1. Nœud de modèle (LLM). Par défaut. Il nécessite un modèle et une invite, provenant chacun d'un seul et même endroit :
| Besoin | Options |
|---|---|
| Modèle | inline_model_config (provider, model_name, temperature, max_tokens), ou model_config_ref (id, version), ou agent_id (le propre modèle de l'agent). |
| Rapide | inline_prompt.template, ou prompt_ref (id, version), ou agent_id (l'invite de l'agent, utilisée telle quelle, suivie de ## Input et du text précédent). |
Autres champs : tool_refs (id, version, allowed_urls optionnel ), skill_slugs et skill_refs, max_tool_rounds (par défaut 5, au maximum 20), fallback_models (sécurité et gouvernance), retry_policy (max_attempts, backoff_ms, retry_on), timeout_ms, thinking_tokens (un plafond, pas un interrupteur), routing_mode et routes, verification, checks, memory_config, record_only, accept_attachments, inherit_agent_tools, access_requests, retry_safe, output_schema (voir la note dans les erreurs graphiques courantes).
2. Nœud déterministe. Définir handler_type et handler_config. Le moteur exécute du code enregistré au lieu d'un modèle. Il ne doit pas déclarer de modèle, d'invite, d'agent, ni les éléments tool_refs, max_tool_rounds, fallback_models, checks ou verification. Il gère toujours les nouvelles tentatives, les délais d'attente, les lignes d'étape, les points d'arrêt et les événements. Types de gestionnaires intégrés :
handler_type | Fait | Classe d'effet |
|---|---|---|
fhir.read | FHIR search ou read. Une recherche nécessite au moins un filtre. | lire |
fhir.propose | Crée ou met à jour les ressources FHIR uniquement à l'état de brouillon ou de proposition. Une ressource PUT nécessite une ressource ifMatch. | proposer |
fhir.write | Toute opération FHIR | écrire (exécutions autonomes uniquement) |
notify.send | Message Slack ou webhook | écrire |
script.run | Un script Python fixe. Il lit ses entrées comme context et assigne un dictionnaire à output. | lire |
Le serveur enregistre également les gestionnaires de domaine (par exemple record.build, record.snapshot, signal.infer). La section Palette déterministe répertorie les fonctionnalités offertes par votre serveur.
Un gestionnaire ponté est configuré comme ceci (d'après les notes de conception) :
{"id": "fhir_slots", "name": "Find slots", "handler_type": "fhir.read",
"handler_config": {"config": {"operation": "search", "resource_type": "Slot"},
"inputs": {"search_params": "val.slot_search"},
"optional_inputs": {}, "values": {}, "output_key": "slots"}}
inputs associe un port de gestionnaire à un chemin d'état partagé ; un chemin manquant entraîne l'échec de l'étape. Le résultat est fusionné dans l'état partagé sous output_key. Les gestionnaires qui proposent ou écrivent s'exécutent une seule fois et ignorent retry_policy.
3. Nœud RLM. execution_mode: "rlm" + rlm.context_state_keys (obligatoire, aucune clé vide ou répétée). Le modèle traite de grandes quantités de données dans un environnement de code plutôt que de les lire dans l'invite de commande. Il ne peut pas être combiné avec handler_type.
4. Nœud ParSer. Bloc execution_mode: "parser" plus un bloc parser (clés de contexte ou sources de pièces jointes, modèle de lecteur, limites de tours et de segments). Les modèles de lecteur économiques citent des enregistrements longs. La publication refuse un graphe dont guards.max_model_calls ne peuvent pas couvrir une activation. L'exemple initialisé est parser-long-record-qa.json du dépôt tietai-hydra-platform.
5. Nœud avec intervention humaine. human_in_the_loop: true. L'exécution est suspendue jusqu'à ce qu'un utilisateur soumette une charge utile JSON, qui devient la sortie du nœud. Ce dernier nécessite toujours un modèle et une invite pour la validation (ces éléments ne sont pas utilisés pendant l'attente) et ne peut pas comporter de barrière de vérification.
Bords
| Champ | Signification |
|---|---|
kind | deterministic (par défaut ; se déclenche toujours, éventuellement protégé par condition), route (se déclenche lorsque la sortie de la source choisit route_name), fallback (se déclenche lorsqu'aucune arête de route ne correspond), join (barrière). |
route_name | Requis pour route arêtes. |
condition | Une garde évaluée après la correspondance du type. Syntaxe : chemins pointés sur output. (le nœud qui vient de s'exécuter) et state. (état partagé), ==, !=, <, >, <=, >=, &&, ` |
transform | { key: path, ... }, associe la sortie source à l'entrée cible. Vide laisse passer la sortie. |
priority | Le nombre le plus bas l'emporte lorsque fan_out_mode vaut first ou by_priority. |
max_traversals | Nombre de fois où cette arête peut s'activer au cours d'une exécution. 0 signifie illimité. |
Join d'arêtes crée une barrière : la cible est exécutée une seule fois, lorsque toutes les arêtes de jonction y sont arrivées. Le moteur conserve les arrivées malgré les pauses et les redémarrages. Règles vérifiées lors de la publication : le nœud source doit avoir routing_mode none ou être vide ; une arête de jonction ne peut pas avoir condition ; et une cible de jonction doit avoir au moins deux parents de jonction.
Modes de routage
routing_mode | Le modèle doit renvoyer | Des bords qui s'enflamment |
|---|---|---|
none (ou vide) | rien de spécial | Les arêtes non routées dont la condition est vérifiée. |
single | JSON avec "route": "<name>" | Le bord de la route avec ce route_name. |
multi | JSON avec "route": ["a", "b"] | Chaque bord de route mentionné dans la liste. |
Il n'est pas nécessaire de décrire le format dans votre invite : lorsqu'un nœud possède des routes, le moteur ajoute ROUTING INSTRUCTIONS à l'invite affichée, listant chaque route et sa description. Rédigez des descriptions de route claires ; elles constituent l'instruction. Si aucune arête de route ne correspond (le modèle a renvoyé un nom inconnu ou l'arête correspondante a déjà utilisé toutes ses max_traversals), les arêtes de repli sont déclenchées. Une chaîne optionnelle route_reason est enregistrée avec la décision. Une arête de route et une route déclarée doivent correspondre : Studio Validate signale « Routes non résolues » pour une arête dont la route n'est pas déclarée, et une route déclarée sans arête constitue une erreur de linting (unwired_route). La seule exception est __verify_failed__, que vous n'avez pas besoin de déclarer.
État partagé
Tous les nœuds lisent et écrivent un objet JSON, l' état partagé.
- Vos
initial_inputclés servent de base (queryest la clé par défaut). - Lorsqu'un nœud termine son exécution, sa sortie est fusionnée par clé de niveau supérieur. Si le modèle a renvoyé un objet JSON, chaque clé devient une clé d'état. Sinon, son texte est
text. Un nœud ultérieur qui écrit la même clé la remplace. - L'invite de commande interprète toute touche comme
{{.key}}(Gotext/template). Si une touche est manquante, le chiffre<no value>s'affiche ; testez avec{{if .key}}...{{end}}lorsqu'une touche est facultative. - La réponse de l'exécution est le
textdu nœud de sortie.
Deux conséquences sont importantes lors de la conception : un nœud qui ne renvoie que du JSON de routage (route, feedback) laisse les text précédents en place, et deux nœuds qui renvoient tous deux du texte brut s'écrasent mutuellement text). Dans la planification parallel, deux branches écrivant la même clé avec des valeurs différentes échouent (parallel branch state conflict for key "text" from nodes [...]. Attribuez à chaque nœud de calcul parallèle sa propre clé JSON. Le moteur gère les éléments response_language, __verification_failure__, __attachments__ et __attachment_refs__) et dérive les indicateurs de pièce jointe has_attachments, has_image_attachments, has_dicom_attachments, has_signal_attachments et has_lab_documents des fichiers de la requête avant l'exécution du premier nœud ; ne les écrivez pas, mais utilisez-les pour le routage dans les cas limites (par exemple, state.has_dicom_attachments == true). Un fichier DICOM est également considéré comme une image (has_image_attachments), mais un nœud LLM ne reçoit jamais ses données de pixels (seulement une note d'une ligne avec ses informations d'en-tête). Envoyez donc le DICOM directement à un nœud déterministe compatible DICOM, en attribuant à cette arête un numéro priority) inférieur à celui des arêtes de l'image afin qu'elle soit prioritaire.
Gardes
| Garde | Signification |
|---|---|
max_total_steps | Obligatoire, supérieur à 0. Limite maximale d'activations de nœuds par exécution. |
per_node_max_visits | Carte des identifiants de nœuds et des visites maximales. |
max_model_calls | Limiter le nombre de requêtes de modèles, y compris les nouvelles tentatives, les itérations d'outils et les appels de vérification. |
max_total_tokens, max_cost_usd | Plafonds de jetons et de coûts. Le coût nécessite une tarification complète du modèle. |
max_retry_attempts | Nouvelles tentatives après la première traversée. |
max_active_nodes | Largeur de la file d'attente. Ne doit pas dépasser max_total_steps. |
max_tool_result_bytes | Archives des résultats des outils volumineux et présentation d'un résumé du modèle. Désactivé par défaut. |
untrusted_fence, repeat_advisory, wrap_up_turn | Protections optionnelles, désactivées par défaut. La valeur wrap_up_turn effectue un appel de modèle supplémentaire lorsqu'un nœud utilise tous ses cycles d'outils. repeat_advisory avertit le modèle lorsqu'il répète un appel d'outil identique. |
max_child_executions, max_recursion_depth | Limites pour les exécutions imbriquées. |
Une exécution réussie (code per_node_max_visits échoue (code node "x" exceeded max_visits=N. Les cycles sont autorisés ; ces gardes les empêchent. Studio Validate avertit : « Garde de boucle conseillée : le graphe contient un cycle — Max Steps (N) le limitera ».
Rédiger, publier, exécuter, rejouer
| Scène | Ce qui se produit |
|---|---|
| Brouillon | Modifiable. L'enregistrement d'un brouillon ne le valide pas. Des erreurs s'affichent lors de la publication ou si vous cliquez sur Validate. |
| Publier | Exécution de la version Validate() et de la politique invariante. Une erreur renvoie le code d'état 422 avec le message. La publication peut également être refusée par un contrôle de conformité (409, « contrôle de conformité : … ») ou, lorsque la vérification des autorisations est obligatoire, par une vérification vous demandant de confirmer que la version étend les capacités du graphe. Une version publiée est immuable. |
| Nouvelle version | Enregistrer une version publiée crée une copie. Choisissez une nouvelle version sémantique (semver) pour celle-ci. |
| Courir | Nécessite une version publiée. Vous choisissez la version ; l’exécution l’enregistre. |
| Rejouer | La combinaison POST .../executions/{id}/replay et de step_id (avec des options de remplacement d'entrée ou d'état) crée une exécution enfant qui démarre à cette étape avec l'état enregistré. La combinaison rewind permet de revenir à une étape antérieure de cette même exécution. Le Studio ne propose pas de bouton de relecture pour les graphiques ; utilisez l'API. La combinaison Rerun step dans le panneau de débogage correspond à la version interactive. |
Qu'est-ce qui est épinglé ?
model_config_ref,prompt_refettool_refscontiennentidetversion. Une versionprompt_refpeut êtrelatest; le moteur la résout une fois au démarrage de l'exécution, stocke le résultat commeresolved_prompt_versions, et une relecture utilise cette carte telle quelle.- Les valeurs
inline_promptetinline_model_configfont partie de la définition publiée, elles y sont donc figées. - Un nœud ne contenant que la valeur
agent_idutilise la configuration déployée de cet agent. Les agents possèdent leurs propres versions (brouillon, déployée, figée après déploiement). Les outils et compétences attribués à un agent ne sont pas versionnés ; une entrée contenant uniquement la valeurskill_slugssuit la compétence active. Utilisezskill_refsavec une version pour l'épingler. - Une rediffusion s'exécute avec le même niveau d'autonomie que l'original.
La relecture garantit : la même version du graphique, les mêmes versions des invites épinglées et le même état initial. Elle ne garantit pas : une sortie identique. Les résultats du modèle peuvent varier d’une exécution à l’autre et les outils peuvent renvoyer de nouvelles données.
Sécurité et gouvernance
plafond d'autonomie
Chaque parcours a une limite supérieure qui restreint ce que ses outils et ses opérateurs peuvent faire :
| Plafond | Permet | Choisi lorsque |
|---|---|---|
research_only | lire | compliance.research_only est vrai. Une telle exécution ne peut être liée à une conversation ou à une consultation. |
propose | lire et proposer | Le graphique est regulated, affecte les résultats cliniques ou ne comporte aucun bloc compliance (aucun bloc n'est considéré comme clinique). |
autonomous | tout | Un bloc compliance qui n'est ni réglementé ni clinique. |
Une exécution imbriquée applique la limite la plus stricte entre sa propre limite et celle de son parent. La limite propose n'est appliquée que lorsque le serveur fonctionne avec HYDRA_AUTONOMY_ENFORCEMENT=enforce. Par défaut, il fonctionne en mode audit : les tentatives de refus sont enregistrées et autorisées. Le profil pilote-clinique requiert la limite enforce. Un refus génère une erreur de niveau step.tool_denied Consultez votre administrateur pour connaître le mode utilisé par votre environnement avant de vous fier à cette limite.
classes d'effets secondaires
Les gestionnaires sont classés selon leur effet : fhir.read et script.run lecture ; fhir.propose proposition ; fhir.write et notify.send écriture. Avec un plafond propose, un graphe peut proposer une ébauche ou une ressource FHIR proposée, mais pas écrire la version finale. Chaque effet secondaire doit être placé dans son propre nœud après le nœud de décision, jamais dans la même étape que le modèle. Les gestionnaires de proposition et d’écriture s’exécutent une seule fois et ignorent les nouvelles tentatives ; une réponse perdue ne peut donc pas entraîner la répétition d’une modification.
Portails de vérification
Attribuez la valeur verification à un nœud de modèle pour vérifier sa sortie avant qu'il n'atteigne l'état partagé :
| Mode | Vérifications |
|---|---|
judge | Un vérificateur évalue le candidat par rapport à votre rubric. |
grounded | Chaque revendication doit être soutenue par les clés d'état partagé listées dans grounding_state_keys (vide signifie l'état entier). |
consensus | verifiers vérificateurs indépendants (par défaut 3, au maximum 7) votent. pass_threshold (par défaut 0,5) est la part qui doit être validée. |
Autres champs : min_confidence, candidate_key (text par défaut), verifier_model (utiliser un modèle différent de celui du nœud), categorize, expose_candidate_on_failure. En cas d’échec, le nœud est réessayé jusqu’à retry_policy.max_attempts. Le candidat est ensuite mis en attente : aucune de ses clés n’est écrite, le moteur enregistre un enregistrement __verification_failure__ (nœud, tentatives, mode, confiance, justification, revendications non prises en charge, hachage du candidat) et la route __verify_failed__ du nœud est déclenchée. Le nœud doit avoir une arête de route sortante nommée __verify_failed__, sinon la publication échoue. Une porte n’est pas autorisée sur un nœud déterministe ou à intervention humaine. expose_candidate_on_failure est autorisé uniquement si chaque cible __verify_failed__ est un nœud déterministe ou à intervention humaine, afin qu’aucun modèle ne puisse transformer une réponse rejetée en réponse finale.
Pause humaine
human_in_the_loop met le véhicule en attente (execution.paused, raison human_in_the_loop) jusqu'à l'arrivée d'une charge utile (POST .../executions/{id}/human_input avec node_id et payload, ce que fait Submit). Connaître les limites :
- L'attente est gérée par un processus serveur et n'a pas de limite propre. Un redémarrage du serveur peut la perdre.
- Avec
HYDRA_GRAPH_DURABLE_RUNS=true(désactivée par défaut) et un nœud marquéretry_safe, les exécutions persistent après les redémarrages dus aux interruptions liées à l'approbation des outils et aux demandes d'accès. Veuillez vérifier auprès de votre administrateur si cette option est activée. - Pour les révisions qui durent plusieurs heures (files d'attente pour validation), conservez la révision comme un enregistrement dans votre propre service et lancez une deuxième exécution du graphique une fois celle-ci terminée.
Autres commandes
fallback_models: jusqu’à{id, version}références de modèle, testées dans l’ordre en cas d’échec de l’appel (limite de débit, délai d’attente dépassé, erreur 5xx, erreur de transport, paiement requis ou modèle introuvable). Jamais en cas d’erreur d’authentification ou de requête incorrecte. Vous les choisissez ; le moteur de workflow ne change jamais de modèle automatiquement. Chaque saut est vérifié par rapport à la politique de sortie PHI. Enregistré commestep.model_fallback. Nœuds de modèle standard uniquement.checks: règles sur les appels d'outils d'un nœud (refuser un appel dont les arguments correspondent, ou exiger un appel réussi antérieur).record_only: limite le rédacteur aux outils terminologiques afin qu'il ne puisse pas lire le FHIR en direct.- Mandatory invariant block : pour les activations cliniques, le moteur ajoute un bloc
<mandatory_invariant_core>à la fin de l’invite de chaque nœud de modèle. Vous ne pouvez pas saisir cette balise dans une invite (la publication renvoie 422 avec le messageprompt contains the reserved <mandatory_invariant_core> tag»).invariant_exemptionnécessite une justification d’au moins 20 caractères et une référence, et est refusé dans le cadre du profil pilote-clinique. Ne tentez pas de reproduire ou d’atténuer ce bloc dans votre propre invite. - Prompt-injection defence : activé par défaut. L'entrée est traitée comme une donnée ; une entrée suspecte émet
step.prompt_injection. - Spend :
max_model_calls,max_total_tokensetmax_cost_usdarrêtent une course qui coûte plus cher que prévu.
Liste de contrôle clinique avant publication
complianceindiqué honnêtement ; l'absence de case cochée signifie clinique.intended_useindique qui utilise les résultats et qu'un clinicien les examine.- Chaque résultat de modèle important est soumis à un contrôle, une vérification déterministe, un examinateur ou une personne.
- Chaque boucle comporte
max_traversals,per_node_max_visitsetmax_total_steps. - Les effets secondaires sont gérés dans leurs propres nœuds déterministes.
- Vous l'avez exécuté sur des données synthétiques, en mode débogage, et vous avez lu chaque Resolved prompt.
Lire une course
Chaque exécution génère un journal d'événements ordonné. Ouvrez le flux Events (n) dans le panneau inférieur, ou consultez-le via le flux GET .../executions/{id}/events et le flux .../stream.
| Événement | Signification |
|---|---|
graph.execution.started, execution.completed | Défilet de limites. |
step.started, step.completed, step.failed, step.retried | Activation d'un nœud. Une nouvelle tentative signifie que la première tentative a échoué ou que sa sortie était vide ou inutilisable. |
step.tool_called, step.tool_returned | Un appel d'outil et son résultat. |
execution.paused, execution.resumed, execution.cancelled | Pause humaine, reprise, annulation. |
execution.paused_at_breakpoint | Un point d'arrêt de débogage a été atteint. |
step.verified | Un verdict de vérification. |
step.tool_denied, step.check_denied, step.approval_required | Un contrôle de gouvernance a interrompu un appel d'outil. |
step.model_fallback | Un modèle de repli a été utilisé. |
step.unresolved_vars | Un message d'erreur faisait référence à une clé manquante. Il a affiché <no value>. |
step.rounds_exhausted, step.repeat_advisory, execution.budget_exhausted | Une boucle ou une limite de dépenses. |
step.invariant_core, step.phi_egress, step.prompt_injection | Les services de sécurité ont consigné leur décision. |
execution.replayed, execution.rewound | Une rediffusion ou un retour en arrière a commencé. |
L'état d'exécution passe par pending, running, paused, puis succeeded, failed ou cancelled.
When an answer is wrong, travaillez à rebours :
- Trouvez la première étape qui a échoué ou qui a produit une valeur incorrecte. Step Inspector correspond à Input et Output.
- Lisez le Resolved prompt. Est-ce que tous
{{.key}}sont remplis ? Y a-t-il un<no value>? - Lecture Output. Un routeur a-t-il renvoyé un nom de route que vous n'avez pas déclaré ?
- Lecture Tool calls. Un appel a-t-il renvoyé une erreur ou un résultat vide ?
- Ouvrez Trace pour le coût, les nouvelles tentatives et les exécutions imbriquées.
- Corrigez l'invite dans une nouvelle version, publiez-la et exécutez à nouveau la même entrée. Comparez les exécutions dans History.
Testez avant de publier
- Validate, puis corrigez chaque erreur. Lisez les avertissements.
- Exécutez avec Debug step-by-step. Définissez
after_prompt_renderpoint d'arrêt pour lire chaque invite, utilisez Override route pour forcer une branche et Mock tool call pour éviter les outils réels. - Testez chaque arête, pas seulement le chemin optimal : forcez chaque itinéraire, poussez une boucle de révision à sa limite, renvoyez un résultat d’outil vide.
- Enregistrez vos entrées de test à Example presets afin que chaque version soit exécutée sur les mêmes cas.
Limites
- Les étiquettes de Graph Agent Studio sont du texte anglais fixe dans la source ; elles ne sont pas traduites.
- Il n'existe pas de bouton Studio pour la relecture ou le retour en arrière ; utilisez l'API ou Rerun step en mode débogage.
- Il n'existe pas de nœud de récupération dédié (RAG). Utilisez les nœuds Skills, Memory Settings, RLM ou ParSer pour les documents longs, ou un gestionnaire qui récupère les données dans un état partagé.
- L'application en temps réel des valeurs
max_child_executionsetmax_recursion_depthest décrite dans le code source comme n'étant pas active dans une tranche de stratégie ; ne vous y fiez pas pour arrêter les exécutions imbriquées. - La pause humaine est en cours (sécurité et gouvernance).
- Le plafond d'autonomie est indicatif (mode audit) sauf si votre serveur fonctionne avec
HYDRA_AUTONOMY_ENFORCEMENT=enforce.
Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.