Zum Hauptinhalt springen

Erstellen Sie Ihren ersten Agentengraphen.

Entwickeln Sie ein Beispiel für die Erstellung von Antworten mit fünf Knoten, einem Router, einer begrenzten Prüfschleife und einer menschlichen Übergabe. Sie lernen, wie man Knoten verbindet, eine Version veröffentlicht und den Verlauf eines Durchlaufs überprüft.

Bevor Sie beginnen: Sie benötigen die Berechtigung zum Lesen und Bearbeiten von Agentengraphen sowie Zugriff auf die im Beispiel verwendeten Modelle. Verwenden Sie in diesem Tutorial durchgehend synthetische Nachrichten. Planen Sie etwa eine Stunde ein.

Alle Steuerelemente und Schemafelder sind in der Agentengraph-Referenz beschrieben. Weitere Layouts und häufige Fehler finden Sie unter Agentengraph-Muster.

Entscheiden Sie: Graph, Agent oder Workflow​

Du brauchstVerwendenWarum
Eine Persona, die antwortet oder chattet, möglicherweise mit WerkzeugenEin einzelner AgentAm günstigsten in Aufbau und Betrieb. Ein Diagramm erhöht die Latenz und die Betrachtungsfläche ohne zusätzlichen Nutzen.
Ein LLM, der zur Laufzeit entscheidet, welcher Spezialist hinzugezogen werden soll.Ein Agent mit sub_agentsJeder Subagent wird dem übergeordneten Agenten als Werkzeug zur Verfügung gestellt. Vier Agenten im initialisierten Katalog deklarieren sub_agents (zum Beispiel clinical-workflow-orchestrator); es handelt sich um Agenten, nicht um Graphen.
Ein fester oder verzweigter mehrstufiger Ablauf, bei dem Sie jeden Zwischenschritt anzeigen, für jede Stufe ein anderes Modell verwenden, Eingabeaufforderungen anheften, einen Prüfer hinzufügen oder deterministische Schritte zwischen Modellschritten einfügen müssen.Ein Agentengraph (diese Seite)Eine Schrittreihe pro Aktivierung, fixierte Versionen, Tore, Wiederholung.
Datenübertragung und -transformation ohne Begründung (ETL, HL7 zu FHIR)Ein Workflow oder eine PipelineVerwenden Sie keine Modellaufrufe für die Datenverarbeitung. Siehe „Beliebigen Workflow erstellen“.
Eine Produktfunktion mit Reihen, Warteschlangen für die Freigabe und stundenlangen RezensionenEin Diagramm plus ein Service Ihrer WahlDie menschliche Pause im Motor ist in einem Prozess (Sicherheit und Governance) verankert. Nutzen Sie sie für Minuten, nicht für Tage.

Faustregel aus dem Designleitfaden: Falls ein Arzt oder Prüfer jemals fragen wird: „Warum wurde das so angezeigt?“, verwenden Sie ein Diagramm. Wenn ein einzelner Parameter ausreicht, verzichten Sie darauf.

Ein Graph kann weiterhin Workflow-Knoten verwenden: Die überbrückten Handler fhir.read, fhir.propose, fhir.write, notify.send und script.run führen Pipeline-Knoten (oder ein festes Skript) als deterministische Schritte aus (Graphanatomie).

Anleitung: Ein Antwortgenerator mit Router und Reviewer-Schleife​

Sie werden einen Fünf-Knoten-Graphen für eine Klinik erstellen: Er liest eine Nachricht aus dem Patientenportal, leitet dringende Nachrichten an eine Krankenschwester weiter, entwirft eine Antwort für Routineanfragen, lässt diese von einem Prüfer überprüfen (bis zu zwei Überarbeitungen) und übergibt sie an eine Krankenschwester, wenn der Prüfer sich wiederholt weigert.

Prüfprozess: Vom Verfasser zum Prüfer, von der Freigabe zur finalen Version, maximal zweimalige Überarbeitung zurück an den Verfasser, dann Rückfall auf einen menschlichen Prüfer.

Design zuerst​

Notieren Sie sich Folgendes, bevor Sie das Studio öffnen:

FrageAntwort für dieses Diagramm
Was muss auf jede Antwort zutreffen?Keine Diagnose, keine Medikamentendosierungen, keine Versprechen bezüglich des Zeitpunkts, unter 120 Wörtern.
Wer entscheidet was?Ein Router entscheidet über die Dringlichkeit. Ein anderes, leistungsfähigeres Modell prüft die Situation. Eine Person kümmert sich um dringende Angelegenheiten oder Fälle, die der Regelkreis nicht lösen kann.
Was ist deterministisch?Hier gibt es nichts. Ein realer Klinikgraph würde einen fhir.read Knoten hinzufügen, um den Kontext abzurufen, anstatt ihn von einem Modell abrufen zu lassen.
Was sind Schleifen und wie werden sie begrenzt?Entwurf und Überprüfung können wiederholt werden: max_traversals 2 am Überarbeitungsrand, per_node_max_visits 3, max_total_steps 12.
Um welche Sicherheitsklasse handelt es sich?Es betrifft die klinische Kommunikation, daher ist affects_clinical_output wahr. Das System behandelt es als klinisch (Sicherheit und Governance).

Die Definition​

Laden Sie die vollständige Beispieldefinition herunter. Die gespeicherte Backend-Prüfung hat diese Definition mit denselben Parametern Validate() und Lint() überprüft, die auch zum Zeitpunkt der Veröffentlichung verwendet wurden. Wählen Sie in Ihrer Organisation verfügbare Modelle aus und validieren Sie diese erneut, bevor Sie sie in Ihrer Bereitstellung veröffentlichen.

Die vollständige JSON-Definition anzeigen
{
"entry_node_id": "triage",
"exit_node_ids": [
"finalize"
],
"guards": {
"max_total_steps": 12,
"max_model_calls": 14,
"max_retry_attempts": 4,
"per_node_max_visits": {
"draft": 3,
"review": 3
}
},
"compliance": {
"regulated": false,
"affects_clinical_output": true,
"data_classification": "none"
},
"metadata": {
"owner": "Demo Hospital",
"tags": [
"tutorial",
"portal-reply"
]
},
"intended_use": {
"statement": "Drafts a reply to a patient portal message for clinic staff to review before anything is sent.",
"intended_users": [
"Clinic nurse"
]
},
"input_schema": [
{
"key": "query",
"label": "Patient message",
"type": "text",
"required": true,
"description": "The text of the portal message. Use synthetic text only."
}
],
"examples": [
{
"name": "Refill question",
"input": {
"query": "Hello, this is Test Patient A. Can I get my usual refill sent to the pharmacy on Main Street?"
}
},
{
"name": "Urgent symptom",
"input": {
"query": "Test Patient B here. Since this morning I have chest pain that spreads to my arm."
}
}
],
"nodes": [
{
"id": "triage",
"name": "Triage",
"description": "Decides whether the message is routine or urgent.",
"routing_mode": "single",
"routes": [
{
"name": "routine",
"description": "Administrative or non-urgent question that a nurse can answer in writing."
},
{
"name": "urgent",
"description": "Any symptom that could need same-day clinical attention."
}
],
"inline_model_config": {
"provider": "google",
"model_name": "gemini-2.5-flash",
"temperature": 0.1
},
"inline_prompt": {
"template": "You triage patient portal messages for Demo Hospital.\nMessage: {{.query}}\n\nReturn JSON with the key \"category\" (one short label such as refill, appointment, results, symptom) and choose the route. When in doubt, choose urgent."
},
"output_schema": {
"type": "object",
"properties": {
"route": {
"type": "string"
},
"category": {
"type": "string"
}
}
},
"retry_policy": {
"max_attempts": 2,
"backoff_ms": 500
}
},
{
"id": "draft",
"name": "Drafter",
"description": "Writes the reply, and rewrites it when the reviewer asks for changes.",
"routing_mode": "none",
"inline_model_config": {
"provider": "google",
"model_name": "gemini-2.5-flash",
"temperature": 0.3
},
"inline_prompt": {
"template": "Write a short reply (under 120 words, plain text) to this patient portal message for a nurse to review.\nMessage: {{.query}}\nCategory: {{.category}}\n{{if .feedback}}\nA reviewer rejected the previous draft.\nReviewer feedback: {{.feedback}}\nPrevious draft: {{.text}}\nRewrite the draft and fix every point.\n{{end}}\nRules: no diagnosis, no medication doses, no promises about timing."
},
"retry_policy": {
"max_attempts": 2,
"backoff_ms": 500
}
},
{
"id": "review",
"name": "Reviewer",
"description": "Checks the draft against the rules and approves it or asks for a rewrite.",
"routing_mode": "single",
"routes": [
{
"name": "approve",
"description": "The draft follows every rule."
},
{
"name": "revise",
"description": "The draft breaks a rule; explain what to fix in \"feedback\"."
}
],
"inline_model_config": {
"provider": "google",
"model_name": "gemini-2.5-pro",
"temperature": 0
},
"inline_prompt": {
"template": "You review a draft reply to a patient portal message.\nMessage: {{.query}}\nDraft: {{.text}}\n\nRules: no diagnosis, no medication doses, no promises about timing, under 120 words.\nReturn JSON with the keys \"route\" and \"feedback\". Put the specific problems in \"feedback\" when you choose revise, and an empty string when you choose approve."
},
"output_schema": {
"type": "object",
"properties": {
"route": {
"type": "string"
},
"feedback": {
"type": "string"
}
}
},
"retry_policy": {
"max_attempts": 2,
"backoff_ms": 500
}
},
{
"id": "escalate",
"name": "Nurse takes over",
"description": "Pauses the run until a nurse supplies the reply text.",
"routing_mode": "none",
"human_in_the_loop": true,
"inline_model_config": {
"provider": "google",
"model_name": "gemini-2.5-flash"
},
"inline_prompt": {
"template": "Human review step. The reply is supplied by a person: {{.query}}"
}
},
{
"id": "finalize",
"name": "Finalize",
"description": "Applies the clinic sign-off format to the approved text.",
"routing_mode": "none",
"inline_model_config": {
"provider": "google",
"model_name": "gemini-2.5-flash",
"temperature": 0
},
"inline_prompt": {
"template": "Return the reply below unchanged, followed on a new line by: \"Reviewed by clinic staff before sending.\"\n\n{{.text}}"
}
}
],
"edges": [
{
"id": "e1",
"source_node_id": "triage",
"target_node_id": "draft",
"kind": "route",
"route_name": "routine"
},
{
"id": "e2",
"source_node_id": "triage",
"target_node_id": "escalate",
"kind": "route",
"route_name": "urgent"
},
{
"id": "e3",
"source_node_id": "triage",
"target_node_id": "escalate",
"kind": "fallback"
},
{
"id": "e4",
"source_node_id": "draft",
"target_node_id": "review",
"kind": "deterministic"
},
{
"id": "e5",
"source_node_id": "review",
"target_node_id": "finalize",
"kind": "route",
"route_name": "approve"
},
{
"id": "e6",
"source_node_id": "review",
"target_node_id": "draft",
"kind": "route",
"route_name": "revise",
"max_traversals": 2
},
{
"id": "e7",
"source_node_id": "review",
"target_node_id": "escalate",
"kind": "fallback"
},
{
"id": "e8",
"source_node_id": "escalate",
"target_node_id": "finalize",
"kind": "deterministic"
}
]
}

Baue es im Studio​

  1. Öffnen Sie Tiet · Agentic, Agents, Agent Graphs und wählen Sie New graph aus. Benennen Sie es Portal reply drafter, dann Create. Erstellen Sie eine Version 1.0.0 mit New version, falls dies vom Studio nicht getan wurde.
  2. Auf der Registerkarte Info geben Sie die Beschreibung ein, unter Guards stellen Sie Max Steps auf 12 ein. Öffnen Sie Usage und füllen Sie Intended use und Intended users aus, fügen Sie eine Eingabe query (Text eingeben, erforderlich) und zwei Example presets (eine Nachfüllfrage und ein dringendes Symptom) hinzu.
  3. Füge fünf Knoten mit + Node hinzu, wobei du jedes Mal Inline node auswählst: triage, draft, review, escalate, finalize. Gib jedem Knoten seine Display name.
  4. Auf Registerkarte triage: Routing, Modus single, Routen routine und urgent mit Beschreibungen. Registerkarte Model: Ein kleines, schnelles Modell. Registerkarte Prompt: Die Vorlage aus der JSON-Datei. Klicken Sie auf Set as entry, wenn Sie auf General klicken.
  5. Bei draft und finalize: Nur Modell und Eingabeaufforderung. Bei finalize Klicken Sie auf Mark as exit.
  6. Bei review: Modus single, Routen approve und revise sowie ein stärkeres Modell als der Zeichner. Verwenden Sie ein anderes Modell als den Zeichner, damit kein Modell seine eigene Arbeit absegnet.
  7. Bei escalate: Human-in-the-loop einschalten. Inline-Modell und Eingabeaufforderung beibehalten; Studio und die Veröffentlichungsprüfung fordern diese weiterhin an.
  8. Zeichnen Sie die Kanten mit den Kantenwerkzeugen. Wählen Sie Route und ziehen Sie von den Routenpunkten triage zu draft (routine) und escalate (urgent). Wählen Sie Fallback und verbinden Sie triage mit escalate. Chain verbindet draft mit review. Von review, Route. approve zu finalize und revise zurück zu draft; klicken Sie auf die Kante revise und setzen Sie Max Traversals auf 2. Fallback verbindet review mit escalate Chain escalate mit finalize.
  9. Klicken Sie auf Validate. Sie möchten, dass „Ein- und Ausgang definiert“, „Alle 5 Knoten erreichbar“ und „Alle Routen auflösbar“ ohne Fehler sind.
  10. Klicken Sie auf Save, dann Publish.

Führe es aus​

  1. Klicken Sie auf Run. Wählen Sie in Run graph die voreingestellte "Nachfüllfrage" aus und starten Sie den Vorgang.
  2. Schau dir Events an. Der erwartete Pfad ist triage (Route routine), draft, review, dann finalize. Wenn der Prüfer eine Überarbeitung verlangt, siehst du wieder draft und review.
  3. Öffnen Sie Step Inspector auf draft. Prüfen Sie Resolved prompt: Nachricht und Kategorie sind ausgefüllt. Beim ersten Durchlauf sehen Sie außerdem ein Ereignis step.unresolved_vars für draft, das feedback und text auflistet. Das ist hier zu erwarten, da Block {{if .feedback}}. Schlüssel liest, die erst nach einer Ablehnung durch den Prüfer existieren. Der Text innerhalb des Blocks wird nicht gesendet.
  4. Führen Sie die Voreinstellung „Dringendes Symptom“ aus. Der Lauf erreicht Status escalate und pausiert mit Status paused. Übermitteln Sie eine Nutzlast, z. B. {"text": "Synthetic review complete. Route this test message to the demonstration review queue."} in Human Review Required. Der Lauf wird bis finalize fortgesetzt und endet.
  5. Um die Schleife gezielt zu testen, stellen Sie die Prüfereinstellung so ein, dass alle Anfragen abgelehnt werden. Nach zwei Wiederholungen ist die revise. Kante aufgebraucht, es gibt keine übereinstimmenden Routen, und die Ausweichkante leitet den Lauf an escalate weiter.

Warum es so gebaut ist​

  • Der Prüfer gibt JSON mit route und feedback zurück. route wird von der Engine verarbeitet; der Antworttext in text bleibt unverändert, sodass finalize weiterhin den Text des Verfassers liest.
  • Die Schleife ist auf drei Arten begrenzt: durch die Kante, den Knoten und den gesamten Lauf. Verwenden Sie alle drei.
  • Die Ausweichkanten bedeuten, dass kein Modellfehler dazu führen kann, dass der Lauf nirgendwohin führt.
  • escalate benötigt keine Begründung, aber die Worte der Person werden zu text, daher verarbeitet finalize beide Pfade mit einer einzigen Eingabeaufforderung.

Nächste Schritte​

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