Aller au contenu principal

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ôleCe 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.
SaveAffiche 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) ».
PublishPublie la version. Infobulle : « Publier cette version (nécessaire pour l’exécution) ». Désactivé si déjà publié.
ValidateInfo-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, CancelApparaissent 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 :

SectionEntrées
CœurAgent existant, LLM intégré, Agent d'outils, Planificateur
RoutageRouteur (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écutionVérification humaine (point de contrôle avec intervention humaine), agent de mémoire, lecteur de pièces jointes
DéterministeUne 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 :

OutilSignification (infobulle)
AutoDéduire l'itinéraire ou le plan de repli à partir du port source
ChainBord déterministe
ParallelBordure en éventail avec graphique fan_out_mode=all
CycleBord arrière délimité avec traversées maximales
RouteBord de route à partir d'une route nommée
FallbackBord de repli
JoinRejoignez le bord pour le ventilateur-in
ConditionArê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.

LanguetteCe que vous avez défini
GénéralNom 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èleLanguage model, Max tokens, Streaming ; pour les nœuds RLM et ParSer, le mode d'exécution et leurs champs.
RapideSystem Prompt (un modèle Go sur un état partagé).
OutilsAdd tool du catalogue d'outils de l'organisation, Add skill.
MémoireL'éditeur de contrôle de la mémoire (onglet « Mémoire »).
RoutageRouting mode (none, single, multi) et la liste des itinéraires (nom plus une description affichée au modèle).
VérifierVerification 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 curl TypeScript 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​

ChampSignificationRègle
entry_node_idPremier nœud à exécuterObligatoire, doit correspondre à un nœud.
exit_node_idsNœuds où l'exécution peut se terminerAu moins une ; chacune doit correspondre à un nœud. La réponse est le text du nœud de sortie.
nodes, edgesLe graphiqueIdentifiants uniques ; chaque arête nécessite un id ainsi qu'une source et une cible existantes.
guardsLimites strictes (ci-dessous)La valeur max_total_steps est requise et doit être supérieure à 0.
fan_out_modeall (par défaut), first, by_priorityComportement 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.
schedulingmode serial (par défaut) ou parallel, max_parallel_workersLe 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.
complianceregulated, affects_clinical_output, data_classification (none, pseudonymised, phi), research_onlyL’absence de blocage signifie « clinique » (sécurité et gouvernance).
input_schemaEntrées de la séquence d'exécution : key, label, type (string, text, number, boolean, json), required, default, description, enumGénère le formulaire d'exécution. Vide signifie un texte libre query.
examplesPréréglages d'entrée enregistrés (name, description, input)Affiché comme Preset dans la boîte de dialogue d'exécution.
intended_usestatement, intended_usersDocumentation, versionnée avec le graphique, non obligatoire.
metadataowner, tags, protocol_ref, schedule_permissionNon utilisé par le moteur.
variables, shared_state_schemaDéclarations de ce qui circule dans le grapheDéclaration uniquement. Une variable nécessite un nom en minuscules, une description, un type connu et une source.
prompt_defenseValeur par défaut au niveau du graphe pour la défense contre les injectionsUn 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 :

BesoinOptions
Modèleinline_model_config (provider, model_name, temperature, max_tokens), ou model_config_ref (id, version), ou agent_id (le propre modèle de l'agent).
Rapideinline_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_typeFaitClasse d'effet
fhir.readFHIR search ou read. Une recherche nécessite au moins un filtre.lire
fhir.proposeCré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.writeToute opération FHIRécrire (exécutions autonomes uniquement)
notify.sendMessage Slack ou webhookécrire
script.runUn 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​

ChampSignification
kinddeterministic (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_nameRequis pour route arêtes.
conditionUne 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.
priorityLe nombre le plus bas l'emporte lorsque fan_out_mode vaut first ou by_priority.
max_traversalsNombre 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​

Modes de routage : aucun active l’arête déterministe, unique active la route sélectionnée, multiple active toutes les routes sélectionnées

routing_modeLe modèle doit renvoyerDes bords qui s'enflamment
none (ou vide)rien de spécialLes arêtes non routées dont la condition est vérifiée.
singleJSON avec "route": "<name>"Le bord de la route avec ce route_name.
multiJSON 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é.

  1. Vos initial_input clés servent de base (query est la clé par défaut).
  2. 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.
  3. L'invite de commande interprète toute touche comme {{.key}} (Go text/template). Si une touche est manquante, le chiffre <no value> s'affiche ; testez avec {{if .key}}...{{end}} lorsqu'une touche est facultative.
  4. La réponse de l'exécution est le text du 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​

GardeSignification
max_total_stepsObligatoire, supérieur à 0. Limite maximale d'activations de nœuds par exécution.
per_node_max_visitsCarte des identifiants de nœuds et des visites maximales.
max_model_callsLimiter 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_usdPlafonds de jetons et de coûts. Le coût nécessite une tarification complète du modèle.
max_retry_attemptsNouvelles tentatives après la première traversée.
max_active_nodesLargeur de la file d'attente. Ne doit pas dépasser max_total_steps.
max_tool_result_bytesArchives 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_turnProtections 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_depthLimites 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​

Cycle de vie d&#39;un graphe d&#39;agent : brouillon, vérifications de publication, version publiée, exécution, relecture

ScèneCe qui se produit
BrouillonModifiable. L'enregistrement d'un brouillon ne le valide pas. Des erreurs s'affichent lors de la publication ou si vous cliquez sur Validate.
PublierExé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 versionEnregistrer une version publiée crée une copie. Choisissez une nouvelle version sémantique (semver) pour celle-ci.
CourirNécessite une version publiée. Vous choisissez la version ; l’exécution l’enregistre.
RejouerLa 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_ref et tool_refs contiennent id et version. Une version prompt_ref peut être latest ; le moteur la résout une fois au démarrage de l'exécution, stocke le résultat comme resolved_prompt_versions, et une relecture utilise cette carte telle quelle.
  • Les valeurs inline_prompt et inline_model_config font partie de la définition publiée, elles y sont donc figées.
  • Un nœud ne contenant que la valeur agent_id utilise 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 valeur skill_slugs suit la compétence active. Utilisez skill_refs avec 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 :

PlafondPermetChoisi lorsque
research_onlylirecompliance.research_only est vrai. Une telle exécution ne peut être liée à une conversation ou à une consultation.
proposelire et proposerLe graphique est regulated, affecte les résultats cliniques ou ne comporte aucun bloc compliance (aucun bloc n'est considéré comme clinique).
autonomoustoutUn 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​

Fonctionnement d&#39;un contrôle de vérification : candidat, vérificateur, validation ou nouvelle tentative, puis suspension et redirection.

Attribuez la valeur verification à un nœud de modèle pour vérifier sa sortie avant qu'il n'atteigne l'état partagé :

ModeVérifications
judgeUn vérificateur évalue le candidat par rapport à votre rubric.
groundedChaque revendication doit être soutenue par les clés d'état partagé listées dans grounding_state_keys (vide signifie l'état entier).
consensusverifiers 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é comme step.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 message prompt contains the reserved <mandatory_invariant_core> tag »). invariant_exemption né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_tokens et max_cost_usd arrêtent une course qui coûte plus cher que prévu.

Liste de contrôle clinique avant publication​

  • compliance indiqué honnêtement ; l'absence de case cochée signifie clinique.
  • intended_use indique 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_visits et max_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énementSignification
graph.execution.started, execution.completedDéfilet de limites.
step.started, step.completed, step.failed, step.retriedActivation 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_returnedUn appel d'outil et son résultat.
execution.paused, execution.resumed, execution.cancelledPause humaine, reprise, annulation.
execution.paused_at_breakpointUn point d'arrêt de débogage a été atteint.
step.verifiedUn verdict de vérification.
step.tool_denied, step.check_denied, step.approval_requiredUn contrôle de gouvernance a interrompu un appel d'outil.
step.model_fallbackUn modèle de repli a été utilisé.
step.unresolved_varsUn message d'erreur faisait référence à une clé manquante. Il a affiché <no value>.
step.rounds_exhausted, step.repeat_advisory, execution.budget_exhaustedUne boucle ou une limite de dépenses.
step.invariant_core, step.phi_egress, step.prompt_injectionLes services de sécurité ont consigné leur décision.
execution.replayed, execution.rewoundUne 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 :

  1. Trouvez la première étape qui a échoué ou qui a produit une valeur incorrecte. Step Inspector correspond à Input et Output.
  2. Lisez le Resolved prompt. Est-ce que tous {{.key}} sont remplis ? Y a-t-il un <no value> ?
  3. Lecture Output. Un routeur a-t-il renvoyé un nom de route que vous n'avez pas déclaré ?
  4. Lecture Tool calls. Un appel a-t-il renvoyé une erreur ou un résultat vide ?
  5. Ouvrez Trace pour le coût, les nouvelles tentatives et les exécutions imbriquées.
  6. 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_render point 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_executions et max_recursion_depth est 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.