Aller au contenu principal

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​

Routeur : un classificateur à routage unique envoie la requête à un spécialiste, avec un nœud général en cas de repli.

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)​

Planification et exécution : le planificateur se rend auprès des travailleurs, chaque travailleur retourne au planificateur.

À 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​

Map and reduce : diviser les nœuds en trois nœuds de calcul, joindre les arêtes pour alimenter un réducteur.

À 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​

Escalade : en cas d'échec de la vérification, le processus est redirigé vers un nœud humain, puis vers un nœud de proposition, et enfin vers le nœud final.

À 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.

#ErreurTexte d'erreurRéparer
1Aucune limite de pasguards.max_total_steps must be > 0Définir Max Steps (par exemple 12).
2Entrée ou sortie impossible, ou pièce d'identité incorrecteentry_node_id is required, at least one exit_node_id is required, entry_node_id "nope" does not match any nodeSur General, Set as entry et Mark as exit.
3Un nœud de modèle sans modèle ni invitenode "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.
4Une porte sans voie de secoursnode "draft" ("Drafter") has a verification gate but no outgoing "__verify_failed__" route edge for failed verdictsAjouter une arête de route nommée __verify_failed__ à un nœud de remédiation.
5Une jointure casséeedge "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.
6Paramètres du modèle sur un nœud déterministenode "finalize" ("Finalize"): handler_type is set — deterministic nodes must not declare model/prompt/agent config ; également deterministic nodes cannot declare tool_refsSupprimez le modèle, l'invite et les paramètres de l'outil, ou laissez tomber handler_type.
7Un itinéraire sans bord, ou un bord vers rienLint : 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.
8Une touche d'invite qui ne fournit rienLint : 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.
9Une boucle sans limiteDurée d'exécution : node "x" exceeded max_visits=N, ou l'exécution s'arrête à max_total_stepsRéglez max_traversals sur le bord arrière et per_node_max_visits. Le studio avertit : « Protection anti-boucle recommandée ».
10Limites et paramètres incorrectsnode "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 foundCorrigez 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.

remarque

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.