Zum Hauptinhalt springen

Agentengraphmuster

Verwenden Sie diese Muster, nachdem Sie Ihren ersten Graphen erstellt haben. Beachten Sie Schema und Governance bei der Konfiguration des Graphen.

Entwurfsmuster​

Wählen Sie das Muster, das dem Informations- und Risikofluss entspricht. Zerlegen Sie die Daten nach Information: Geben Sie jedem Mitarbeiter einen begrenzten Datenausschnitt, da die Übereinstimmung zwischen Mitarbeitern, die alle Daten gesehen haben, nur ein schwaches Indiz ist.

Router​

Router: Ein Klassifikator mit Single-Routing sendet die Anfrage an einen Spezialisten, mit einem Fallback auf einen allgemeinen Knoten.

Verwenden Sie diese Methode, wenn Anfragen in wenige Kategorien fallen und jede Kategorie unterschiedliche Anweisungen oder Werkzeuge erfordert. Halten Sie den Klassifikator ressourcenschonend und geben Sie jeder Route eine präzise Beschreibung. Fügen Sie immer eine fallback hinzu.

Spezialisten- und Gutachterschleife​

Der Graph aus dem Tutorial. Verwenden Sie ihn, wenn ein Entwurf überprüfbare Regeln enthält. Begrenzen Sie die Schleife an den Kanten, Knoten und im Ablauf und geben Sie dem erschöpften Fall eine Ausweichmöglichkeit. Eine Alternative mit demselben Effekt ist ein verification Gate für den Ersteller mit einer __verify_failed__ Kante zu einem Korrekturknoten.

Planen und ausführen (Hub-and-Spoke-System)​

Planen und ausführen: Der Planer leitet die Routen zu den Mitarbeitern, jeder Mitarbeiter kehrt zum Planer zurück.

Diese Methode wird angewendet, wenn Anzahl und Reihenfolge der Schritte nicht im Voraus bekannt sind. Ein Planer mit routing_mode: single hat eine Route pro Arbeiter plus eine Route done; jeder Arbeiter hat eine deterministische Rückverbindung. Der initialisierte Graph meda-clinical-encounter.json hat folgende Struktur: einen Knoten plan mit acht Routen, Arbeiter, die zu ihm zurückkehren, per_node_max_visits von 24 auf plan, max_total_steps 60 und ein Richtertor beim Medikamentenarbeiter, dessen Kante __verify_failed__ ebenfalls zum Planer zurückführt. Da der Planer mehrmals ausgeführt werden kann, ist seine Besuchsbegrenzung die wichtigste Sicherheitsmaßnahme im Graphen.

Map und Reduce mit einem Join​

Mapping und Reduce: Fächer auf drei Worker aufteilen, Kanten zusammenführen und einem Reducer zuführen.

Verwenden Sie diese Funktion, wenn unabhängige Teile separat analysiert und anschließend kombiniert werden können. Der Split-Knoten verfügt über mehrere ausgehende deterministische Kanten (bei fan_out_mode: all, dem Standardwert, werden alle ausgeführt). Jeder Worker gibt JSON mit eigenen Schlüsseln zurück und verwendet eine join Kante zum Reducer. Der Reducer startet einmalig, sobald alle Join-Kanten angekommen sind. Der Seeded- handoff-icu-pause.json verbindet auf diese Weise sechs Critique-Knoten zu einem qa -Knoten. Standardmäßig ist die Ausführungsreihenfolge serial: Die Branches werden nacheinander ausgeführt. Stellen Sie scheduling.mode auf parallel mit mindestens 2 auf max_parallel_workers ein, um sie gleichzeitig auszuführen; parallele Branches arbeiten mit Kopien des Zustands und werden zusammengeführt, sobald alle erfolgreich waren; zwei Branches, die denselben Schlüssel mit unterschiedlichen Werten schreiben, führen zu einem Konfliktfehler.

Eskalation zu einem Menschen​

Eskalation: Bei fehlgeschlagener Verifizierung wird der Weg zu einem menschlichen Knoten, dann zu einem Vorschlagsknoten und schließlich zum endgültigen Knoten geleitet.

Verwenden Sie diese Methode, wenn eine fehlgeschlagene Prüfung oder ein dringender Fall die Unterstützung einer Person erfordert. Leiten Sie von einer Kante __verify_failed__, einer Ausweichkante oder einer bedingten Kante wie z. B. state.urgent == true zu einem Knoten human_in_the_loop weiter. Platzieren Sie den Nebeneffekt (fhir.propose oder eine Benachrichtigung) in einem Knoten nach der Person, damit nichts geschrieben wird, bevor diese eine Entscheidung getroffen hat.

Die zehn häufigsten Fehler​

Der Fehlertext entspricht dem Ergebnis der Veröffentlichungsprüfung oder Validate Die ersten neun Fehler wurden reproduziert, indem der eigentliche Validator mit jeweils einer Änderung auf dem Tutorial-Graphen ausgeführt wurde.

#FehlerFehlermeldungFix
1Keine Schrittbegrenzungguards.max_total_steps must be > 0Setzen Sie Max Steps (zum Beispiel 12).
2Kein Ein- oder Ausgang oder falsche IDentry_node_id is required, at least one exit_node_id is required, entry_node_id "nope" does not match any nodeAuf General, Set as entry und Mark as exit.
3Ein Modellknoten ohne Modell oder Eingabeaufforderungnode "draft" ("Drafter"): no model resolvable — set model_config_ref, inline_model_config, or agent_id ... und ... no prompt resolvable — set inline_prompt.template, prompt_ref.id, or agent_id ...Stellen Sie das Modell auf dem Tab Model und die Eingabeaufforderung auf dem Tab Prompt ein. Ein Human-in-the-Loop-Knoten benötigt diese ebenfalls.
4Ein Tor ohne Ausfallwegnode "draft" ("Drafter") has a verification gate but no outgoing "__verify_failed__" route edge for failed verdictsFüge einem Sanierungsknoten eine Routenkante mit dem Namen __verify_failed__ hinzu.
5Eine gebrochene Verbindungedge "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)Verbinde dich nur von none Knoten aus, ohne Bedingung, mit zwei oder mehr übergeordneten Knoten.
6Modelleinstellungen auf einem deterministischen Knotennode "finalize" ("Finalize"): handler_type is set — deterministic nodes must not declare model/prompt/agent config; auch deterministic nodes cannot declare tool_refsEntfernen Sie das Modell, die Eingabeaufforderung und die Werkzeugeinstellungen oder lassen Sie handler_type weg.
7Eine Route ohne Kante, oder eine Kante zu nichtsLint: node "review" declares route "revise" but no route edge wires it (unwired_route); Studio: "Nicht aufgelöste Routen"Zeichne die Kante oder lösche die Route. Lint blockiert die Veröffentlichung nicht, aber die Route würde nirgendwohin führen.
8Eine Eingabetaste, die nichts liefertLint: reference "patient_age" in node "draft" field "inline_prompt.template" is not defined at this point in the flow (unresolved_prompt_reference). Zur Laufzeit wird <no value> ausgegeben und step.unresolved_vars emittiert.Füge es zu input_schema hinzu, lass es von einem vorgelagerten Knoten zurückgeben oder korrigiere den Tippfehler.
9Eine Schleife ohne BegrenzungLaufzeit: node "x" exceeded max_visits=N, oder der Lauf stoppt bei max_total_stepsStellen Sie max_traversals auf die hintere Kante und per_node_max_visits ein. Studio warnt: „Schlaufenschutz empfohlen“.
10Falsche Grenzwerte und Einstellungennode "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 foundKorrigieren Sie das benannte Feld.

Zwei Fehler führen zu keinem Fehler: eine Router-Aufforderung, die die Auswahl nicht eindeutig macht (das Modell gibt einen nicht deklarierten Routennamen zurück, daher wird der Fallback ausgelöst), und Worker, die Klartext zurückgeben (sie überschreiben text oder schlagen im Parallelmodus aufgrund eines Zustandskonflikts fehl). Geben Sie den Routen aussagekräftige Beschreibungen und jedem Worker einen eigenen JSON-Schlüssel.

hinweis

Die Angabe output_schema an einem Knoten wird zur Laufzeit nicht erzwungen. Seine properties Namen teilen dem Editor und dem Lint mit, welche Schlüssel der Knoten erzeugt, sodass eine nachfolgende {{.key}} akzeptiert wird. Dies bewirkt nicht, dass das Modell dem Schema folgt; geben Sie in der Eingabeaufforderung an, was Sie benötigen.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..