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
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)
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
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
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.
| # | Fehler | Fehlermeldung | Fix |
|---|---|---|---|
| 1 | Keine Schrittbegrenzung | guards.max_total_steps must be > 0 | Setzen Sie Max Steps (zum Beispiel 12). |
| 2 | Kein Ein- oder Ausgang oder falsche ID | entry_node_id is required, at least one exit_node_id is required, entry_node_id "nope" does not match any node | Auf General, Set as entry und Mark as exit. |
| 3 | Ein Modellknoten ohne Modell oder Eingabeaufforderung | node "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. |
| 4 | Ein Tor ohne Ausfallweg | node "draft" ("Drafter") has a verification gate but no outgoing "__verify_failed__" route edge for failed verdicts | Füge einem Sanierungsknoten eine Routenkante mit dem Namen __verify_failed__ hinzu. |
| 5 | Eine gebrochene Verbindung | 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) | Verbinde dich nur von none Knoten aus, ohne Bedingung, mit zwei oder mehr übergeordneten Knoten. |
| 6 | Modelleinstellungen auf einem deterministischen Knoten | node "finalize" ("Finalize"): handler_type is set — deterministic nodes must not declare model/prompt/agent config; auch deterministic nodes cannot declare tool_refs | Entfernen Sie das Modell, die Eingabeaufforderung und die Werkzeugeinstellungen oder lassen Sie handler_type weg. |
| 7 | Eine Route ohne Kante, oder eine Kante zu nichts | Lint: 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. |
| 8 | Eine Eingabetaste, die nichts liefert | Lint: 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. |
| 9 | Eine Schleife ohne Begrenzung | Laufzeit: node "x" exceeded max_visits=N, oder der Lauf stoppt bei max_total_steps | Stellen Sie max_traversals auf die hintere Kante und per_node_max_visits ein. Studio warnt: „Schlaufenschutz empfohlen“. |
| 10 | Falsche Grenzwerte und Einstellungen | 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 | Korrigieren 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.
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..