Modèles de graphes d'agents
Utilisez ces modèles après avoir terminé votre premier graphique. Consultez le schéma et la gouvernance lors de la configuration du graphique.
Modèles de conception
Choisissez le modèle qui correspond à la circulation de l'information et des risques. Décomposez les données par type d'information : attribuez à chaque intervenant une portion limitée des données, car un consensus entre des agents ayant tout vu ne constitue pas une preuve suffisante.
Routeur
Utilisez cette méthode lorsque les requêtes se répartissent en plusieurs catégories et nécessitent chacune des instructions ou des outils différents. Privilégiez un classificateur peu coûteux et fournissez une description précise pour chaque itinéraire. Ajoutez systématiquement une arête de niveau fallback.
Boucle de spécialistes et d'évaluateurs
Le graphe du tutoriel. À utiliser lorsqu'un brouillon comporte des règles vérifiables. Limitez la boucle sur l'arête, sur les nœuds et sur le parcours, et prévoyez une solution de repli pour le cas épuisé. Une alternative équivalente consiste à ajouter une porte verification sur le rédacteur, reliée par une arête __verify_failed__ à un nœud de remédiation.
Planifier et exécuter (modèle en étoile)
À utiliser lorsque le nombre et l'ordre des étapes sont inconnus à l'avance. Un planificateur avec routing_mode: single possède un itinéraire par travailleur, plus un itinéraire done ; chaque travailleur dispose d'une arête de retour déterministe. Le graphe initialisé meda-clinical-encounter.json a la forme suivante : un nœud plan avec huit itinéraires, des travailleurs qui y retournent, per_node_max_visits sur 24 sur plan, max_total_steps 60, et une porte de jugement sur le travailleur chargé de la distribution des médicaments, dont l'arête __verify_failed__ retourne également au planificateur. Étant donné que le planificateur peut s'exécuter plusieurs fois, sa limite de visites est la protection la plus importante du graphe.
Mapper et réduire avec une jointure
À utiliser lorsque des éléments indépendants peuvent être analysés séparément puis combinés. Le nœud de division possède plusieurs arêtes sortantes déterministes (avec fan_out_mode: all, la valeur par défaut, elles sont toutes activées). Chaque nœud de travail renvoie un JSON avec ses propres clés et utilise une arête join vers le réducteur. Le réducteur démarre une fois que toutes les arêtes de jonction sont arrivées. Le nœud initial handoff-icu-pause.json combine ainsi six nœuds de critique en un seul nœud qa Par défaut, l'ordonnancement est serial : les branches s'exécutent l'une après l'autre. Définissez scheduling.mode à parallel avec max_parallel_workers ou au moins 2 pour les exécuter simultanément ; les branches parallèles travaillent sur des copies de l'état et sont fusionnées une fois que toutes ont réussi ; deux branches qui écrivent la même clé avec des valeurs différentes génèrent une erreur de conflit.
Escalade vers un humain
À utiliser lorsqu'un contrôle a échoué ou qu'une intervention urgente est nécessaire. Acheminez le code vers un nœud human_in_the_loop à partir d'une arête __verify_failed__, d'une arête de repli ou d'une arête conditionnelle comme state.urgent == true. Placez l'effet secondaire (fhir.propose ou une notification) dans un nœud suivant l'intervention de la personne, afin qu'aucune donnée ne soit écrite avant sa décision.
Les dix erreurs les plus courantes
Le texte d'erreur correspond à la valeur renvoyée par la vérification de publication (Validate. Les neuf premières erreurs ont été reproduites en exécutant le validateur réel sur le graphe du tutoriel, avec une modification à chaque fois.
| # | Erreur | Texte d'erreur | Réparer |
|---|---|---|---|
| 1 | Aucune limite de pas | guards.max_total_steps must be > 0 | Définir Max Steps (par exemple 12). |
| 2 | Entrée ou sortie impossible, ou pièce d'identité incorrecte | entry_node_id is required, at least one exit_node_id is required, entry_node_id "nope" does not match any node | Sur General, Set as entry et Mark as exit. |
| 3 | Un nœud de modèle sans modèle ni invite | node "draft" ("Drafter"): no model resolvable — set model_config_ref, inline_model_config, or agent_id ... et ... no prompt resolvable — set inline_prompt.template, prompt_ref.id, or agent_id ... | Configurez le modèle dans l'onglet Model et l'invite dans l'onglet Prompt Un nœud nécessitant une intervention humaine en a également besoin. |
| 4 | Une porte sans voie de secours | node "draft" ("Drafter") has a verification gate but no outgoing "__verify_failed__" route edge for failed verdicts | Ajouter une arête de route nommée __verify_failed__ à un nœud de remédiation. |
| 5 | Une jointure cassée | edge "j1": join edges require source "triage" to have routing_mode "none"; edge "j1": join edges cannot carry a condition (a false condition would deadlock the barrier); node "review" is the target of a single join edge — a barrier needs ≥2 join parents (use kind "deterministic" for a plain edge) | N'effectuer de jointure qu'à partir de none nœud, sans condition, avec deux parents ou plus. |
| 6 | Paramètres du modèle sur un nœud déterministe | node "finalize" ("Finalize"): handler_type is set — deterministic nodes must not declare model/prompt/agent config ; également deterministic nodes cannot declare tool_refs | Supprimez le modèle, l'invite et les paramètres de l'outil, ou laissez tomber handler_type. |
| 7 | Un itinéraire sans bord, ou un bord vers rien | Lint : node "review" declares route "revise" but no route edge wires it (unwired_route) ; Studio : « Routes non résolues » | Dessinez l'arête ou supprimez la route. Lint n'empêche pas la publication, mais la route ne mènera nulle part. |
| 8 | Une touche d'invite qui ne fournit rien | Lint : reference "patient_age" in node "draft" field "inline_prompt.template" is not defined at this point in the flow (unresolved_prompt_reference). À l'exécution, il affiche <no value> et émet step.unresolved_vars. | Ajoutez-le à input_schema, demandez à un nœud en amont de le renvoyer, ou corrigez la faute de frappe. |
| 9 | Une boucle sans limite | Durée d'exécution : node "x" exceeded max_visits=N, ou l'exécution s'arrête à max_total_steps | Réglez max_traversals sur le bord arrière et per_node_max_visits. Le studio avertit : « Protection anti-boucle recommandée ». |
| 10 | Limites et paramètres incorrects | node "draft" ("Drafter"): at most 3 fallback_models; fallback_models[0] needs an id and a version; tool_refs[0] has no tool id; pick a tool or remove the entry; max_tool_rounds must be between 1 and 20 (0 uses the default 5); scheduling.max_parallel_workers must be >= 2 in parallel mode; guards.max_active_nodes must not exceed guards.max_total_steps; compliance.data_classification must be none, pseudonymised, or phi; execution_mode "rlm" requires rlm.context_state_keys; duplicate node id "draft"; edge "e1": target_node_id "ghost" not found | Corrigez le champ nommé. |
Deux erreurs ne produisent aucune erreur : une invite de routeur qui ne précise pas le choix (le modèle renvoie un nom de route non déclaré, ce qui déclenche une solution de repli), et des workers qui renvoient du texte brut (ils écrasent la valeur text ou échouent en raison d'un conflit d'état en mode parallèle). Fournissez des descriptions claires aux routes et attribuez à chaque worker sa propre clé JSON.
output_schema sur un nœud n'est pas appliquée lors de l'exécution. Ses noms properties indiquent à l'éditeur et à l'outil de vérification les clés produites par le nœud ; une valeur {{.key}} en aval est donc acceptée. Cela ne force pas le modèle à respecter le schéma ; indiquez ce dont vous avez besoin dans l'invite de commande.
Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.