Erstellen eines Workflows in Microsoft Foundry

Workflows sind benutzeroberflächenbasierte Tools in Microsoft Foundry. Verwenden Sie sie, um deklarative, vordefinierte Sequenzen von Aktionen zu erstellen, die Agents und Geschäftslogik in einem visuellen Generator koordinieren.

Workflows ermöglichen es Ihnen, intelligente Automatisierungssysteme zu erstellen, die KI-Agents nahtlos visuell mit Geschäftsprozessen verbinden. Herkömmliche Einzel-Agent-Systeme sind in ihrer Fähigkeit eingeschränkt, komplexe, vielschichtige Aufgaben zu verarbeiten. Durch die Orchestrierung mehrerer Agents mit speziellen Fähigkeiten oder Rollen können Sie Systeme erstellen, die robuster, adaptiver sind und in der Lage sind, reale Probleme gemeinsam zu lösen.

Voraussetzungen

Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie über keins verfügen, erstellen Sie ein kostenloses Azure-Konto, das ein kostenloses Testabonnement enthält.
Ein Projekt in Microsoft Foundry. Weitere Informationen finden Sie unter Erstellen von Projekten.
Zugriff auf das Erstellen und Ausführen von Workflows in Ihrem Foundry-Projekt. Weitere Informationen finden Sie unter Azure role-based access control (RBAC) in Foundry.

Entscheiden, wann Workflows verwendet werden sollen

Workflows eignen sich ideal für Szenarien, in denen Sie Folgendes benötigen:

Orchestrieren Sie mehrere Agents in einem wiederholbaren Prozess.
Fügen Sie Verzweigungslogik (z. B. if/else) und variable Behandlung ohne Schreiben von Code hinzu.
Erstellen Sie Schritte mit menschlicher Beteiligung (z. B. Genehmigungen oder Klärung von Fragen).

Wenn Sie Workflow-YAML in Visual Studio Code bearbeiten oder Workflows in einem lokalen Playground ausführen möchten, lesen Sie:

Grundlegendes zu Workflowmustern

Foundry stellt Vorlagen für allgemeine Orchestrierungsmuster bereit. Beginnen Sie mit einem leeren Workflow, oder wählen Sie eine Vorlage aus:

Muster	Description	Typischer Anwendungsfall
Mensch im Regelkreis	Stellt dem Benutzer eine Frage und wartet auf die Benutzereingabe, um fortzufahren.	Erstellen von Genehmigungsanforderungen während der Workflowausführung und Warten auf menschliche Genehmigung oder Abrufen von Informationen vom Benutzer
Sequenziell	Übergibt das Ergebnis von einem Agent an die nächste in einer definierten Reihenfolge.	Schrittweise Workflows, Pipelines oder mehrstufige Verarbeitung
Gruppenchat	Dynamisches Übergeben der Steuerung zwischen Agents basierend auf Kontext oder Regeln	Dynamische Workflows, Eskalations-, Fallback- oder Expertenhandoffszenarien

Weitere Informationen finden Sie unter Microsoft Agent Framework-Workflow-Orchestrierungen.

Erstellen eines Workflows

Dieses Verfahren zeigt, wie ein sequenzieller Workflow erstellt wird. Die gleichen allgemeinen Schritte gelten für andere Workflowtypen.

Melden Sie sich bei Microsoft Foundry an. Stellen Sie sicher, dass die Umschaltfläche "Neue Gießerei " aktiviert ist. Diese Schritte beziehen sich auf Foundry (neu).
Wählen Sie im oberen rechten Menü " Erstellen" aus.
Wählen Sie " Neuen Workflow>sequenziell erstellen" aus.
Weisen Sie einem Agentenknoten einen Agenten zu, indem Sie jeden Agentenknoten im Workflow auswählen und entweder den gewünschten Agenten auswählen oder einen neuen erstellen. Weitere Informationen finden Sie weiter unten in diesem Artikel unter Hinzufügen von Agents .
Wählen Sie im Visualizer "Speichern" aus, um die Änderungen zu speichern.

Von Bedeutung

Die Gießerei speichert Workflows nicht automatisch. Wählen Sie "Speichern nach jeder Änderung " aus, um Ihre Arbeit beizubehalten.
Wählen Sie Workflow ausführen aus.
Interagieren Sie mit dem Workflow im Chatfenster.
Fügen Sie ihrem Workflow optional neue Knoten hinzu. Der nächste Abschnitt in diesem Artikel enthält Informationen zu Knoten.

Überprüfen Sie die Workflow-Ausführung

Nachdem Sie "Workflow ausführen" ausgewählt haben, stellen Sie folgendes sicher:

Jeder Knoten wird in der Schnellansicht abgeschlossen.
Die erwarteten Antworten werden im Chatfenster angezeigt.
Alle Variablen, die Sie speichern (z. B. JSON-Ausgabe von einem Agentknoten), enthalten die erwarteten Werte.

Hinzufügen von Knoten

Knoten sind die Bausteine Ihres Workflows. Jeder Knoten führt eine bestimmte Aktion in Folge aus.

Zu den allgemeinen Knotentypen gehören:

Agent: Rufen Sie einen Agent auf.
Logik: Verwenden Sie if/else, goto oder für jedes.
Datentransformation: Legen Sie eine Variable fest oder analysieren Sie einen Wert.
Einfacher Chat: Senden Sie eine Nachricht, oder stellen Sie eine Frage an einen Agent.

Wenn Sie einen vordefinierten Workflow auswählen, zeigt der Generator die Knoten in Sequenz an. Wenn Sie Knoten neu anordnen möchten, wählen Sie die drei Punkte auf einem Knoten aus, und wählen Sie dann "Verschieben" aus. Um Knoten hinzuzufügen, wählen Sie das Pluszeichen (+) im Arbeitsbereich aus.

Hinzufügen von Agents

Fügen Sie dem Workflow einen beliebigen Foundry-Agent aus Ihrem Projekt hinzu. Mit Agentknoten können Sie auch neue Agents mit angepassten Funktionen erstellen, indem Sie das Modell, die Eingabeaufforderung und die Tools konfigurieren.

Für erweiterte Agent-Erstellungsoptionen wechseln Sie zur Registerkarte " Foundry Agent" im Foundry-Portal .

Hinzufügen eines vorhandenen Agents

Wählen Sie in der Workflowschnellansicht das Pluszeichen aus.
Wählen Sie in der Popup-Dropdownliste den Aufruf-Agent aus.
Wählen Sie im Fenster " Neuen Agent erstellen " die vorhandene Option aus.
Geben Sie den Agentnamen ein, um nach vorhandenen Agents in Ihrem Foundry-Projekt zu suchen.
Wählen Sie den gewünschten Agent aus, um ihn ihrem Workflow hinzuzufügen.

Erstellen eines neuen Agents

Wählen Sie in der Workflowschnellansicht das Pluszeichen aus.
Wählen Sie in der Popup-Dropdownliste den Aufruf-Agent aus.
Geben Sie einen Agentnamen und eine Beschreibung der Funktionsweise des Agents ein.
Klicken Sie auf Hinzufügen.
Konfigurieren Sie den Agenten im Fenster "Agenten aufrufen".
Wählen Sie Speichern aus.

Konfigurieren eines Ausgabeantwortformats

So konfigurieren Sie einen Agent für die Rückgabe einer strukturierten JSON-Ausgabe:

Wählen Sie im Fenster " Agent-Konfiguration aufrufen " die Option "Neuen Agent erstellen" aus.
Konfigurieren Sie den Agent so, dass die Ausgabe als JSON-Schema gesendet wird:
1. Wählen Sie Details aus.
2. Wählen Sie das Parametersymbol aus.
3. Wählen Sie für das TextformatDAS JSON-Schema aus.
Kopieren Sie das gewünschte JSON-Schema, und fügen Sie es in das Fenster "Antwortformat hinzufügen " ein. Der folgende Screenshot zeigt ein mathematisches Beispiel. Wählen Sie Speichern aus.

Von Bedeutung

Schließen Sie keine geheimen Schlüssel (Kennwörter, Schlüssel, Token) in JSON-Schemas, Eingabeaufforderungen oder gespeicherten Workflowvariablen ein.

{
  "name": "math_response",
  "schema": {
    "type": "object",
    "properties": {
      "steps": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "explanation": {
              "type": "string"
            },
            "output": {
              "type": "string"
            }
          },
          "required": [
            "explanation",
            "output"
          ],
          "additionalProperties": false
        }
      },
      "final_answer": {
        "type": "string"
      }
    },
    "additionalProperties": false,
    "required": [
      "steps",
      "final_answer"
    ]
  },
  "strict": true
}

Wählen Sie "Aktionseinstellungen" aus. Wählen Sie dann "Ausgabejson_object/json_schema als speichern" aus.
Wählen Sie " Neue Variable erstellen" aus. Wählen Sie einen Variablennamen und dann "Fertig" aus.

Konfigurieren zusätzlicher Features

YAML-Visualisierungsansicht: Legen Sie die Umschaltfläche "YAML Visualizer View " auf "Ein " fest, um den Workflow als YAML-Datei zu speichern. Bearbeiten Sie entweder im Visualizer oder in der YAML-Ansicht. Beim Speichern wird eine neue Version mit vollständiger Versionshistorie erstellt.

Sowohl die Visualisierung als auch yaML können bearbeitet werden. Änderungen an der YAML-Datei werden sofort im Visualizer angezeigt.
Versionsverwaltung: Jedes Speichervorgang erstellt eine neue, unveränderliche Version. Um den Versionsverlauf anzuzeigen oder ältere Versionen zu löschen, öffnen Sie die Dropdownliste " Version " links neben der Schaltfläche " Speichern ".
Hinweise: Fügen Sie der Workflowschnellansicht Notizen für zusätzlichen Kontext hinzu. Wählen Sie in der oberen linken Ecke der Visualisierung die Option "Notiz hinzufügen" aus.

Ausdrücke mit Power Fx erstellen

Power Fx ist eine Low-Code-Sprache, die Formeln ähnlich wie in Excel verwendet. Verwenden Sie Power Fx, um komplexe Logik zu erstellen, mit der Ihre Agents Daten bearbeiten können. Beispielsweise kann eine Power Fx-Formel einen Variablenwert festlegen, eine Zeichenfolge analysieren oder eine Bedingung auswerten. Weitere Informationen finden Sie in der Übersicht über Power Fx und in der Formelreferenz.

Verwenden von Variablen in einer Formel

Um eine Variable in einer Power Fx Formel zu verwenden, müssen Sie ihrem Namen ein Präfix hinzufügen, das den Gültigkeitsbereich der Variablen angibt:

Verwenden Sie für Systemvariablen System.
Verwenden Sie für lokale Variablen Local.

Hier sind die Systemvariablen:

Name	Description
`Activity`	Informationen zur aktuellen Aktivität
`Bot`	Informationen zum Agenten
`Conversation`	Informationen zum aktuellen Gespräch
`Conversation.Id`	Eindeutige ID der aktuellen Unterhaltung
`Conversation.LocalTimeZone`	Zeitzone des Benutzers im IANA-Zeitzonendatenbankformat
`Conversation.LocalTimeZoneOffset`	Zeitoffset von UTC für die aktuelle lokale Zeitzone
`Conversation.InTestMode`	Boolesche Kennzeichnung, die angibt, ob die Unterhaltung auf einer Test-Canvas stattfindet
`ConversationId`	Eindeutige ID der aktuellen Unterhaltung
`InternalId`	Interner Bezeichner für das System
`LastMessage`	Informationen zur vorherigen Nachricht, die der Benutzer gesendet hat
`LastMessage.Id`	ID der vorherigen Nachricht, die der Benutzer gesendet hat
`LastMessage.Text`	Vorherige Nachricht, die der Benutzer gesendet hat
`LastMessageId`	ID der vorherigen Nachricht, die der Benutzer gesendet hat
`LastMessageText`	Vorherige Nachricht, die der Benutzer gesendet hat
`Recognizer`	Informationen zur Absichtserkennung und zur auslösenden Nachricht
`User`	Informationen über den Benutzer, der aktuell mit dem Agent spricht
`User.Language`	Benutzersprachen-Standort pro Gespräch
`UserLanguage`	Benutzersprachen-Standort pro Gespräch

Literalwerte in einer Formel verwenden

Sie können in einer Power Fx-Formel nicht nur Variablen verwenden, sondern auch Literalwerte angeben. Um einen Literalwert in einer Formel zu verwenden, müssen Sie ihn im entsprechenden Format des Typs eingeben.

In der folgenden Tabelle sind die Datentypen und das Format der entsprechenden Literalwerte aufgeführt:

Typ	Formatbeispiele
String	`"hi"`, `"hello world!""copilot"`
Boolean	Nur `true` oder `false`
Nummer	`1`, `5325.258-9201`
Datensatz und Tabelle	`[1]`, , `[45, 8, 2]["cats", "dogs"]`, `{ id: 1 }`, , `{ message: "hello" }{ name: "John", info: { age: 25, weight: 175 } }`
Datum und Uhrzeit	`Time(5,0,23)`, `Date(2022,5,24)DateTimeValue("May 10, 2022 5:00:00 PM")`
Auswahl	Nicht unterstützt
Blank	Nur `Blank()`

Häufige Power Fx-Formeln

In der folgenden Tabelle sind die Power Fx-Formeln aufgeführt, die Sie mit jedem Datentyp verwenden können.

Typ	Power Fx-Formeln
String	Funktion „Text“ Funktionen „Concat“ und „Concatenate“ Funktion „Len“ Funktionen „Lower“, „Upper“ und „Proper“ Funktionen „IsMatch“, „Match“ und „MatchAll“ Funktionen „EndsWith“ und „StartsWith“ Funktion „Find“ Funktion „Replace“ und „Substitute“
Boolean	Funktion „Boolean“ Funktionen „And“, „Or“ und „Not“ Funktionen „If“ und „Switch“
Nummer	Funktionen „Decimal“, „Float“ und „Value“ Funktionen "Int", "Round", "RoundDown", "RoundUp" und "Trunc"
Datensatz und Tabelle	Funktionen „Concat“ und „Concatenate“ Funktionen „Count“, „CountA“, „CountIf“ und „CountRows“ Funktion „ForAll“ Die Funktionen „First“, „FirstN“, „Index“, „Last“ und „LastN“ Funktionen „Filter“, „Search“ und „LookUp“ JSON-Funktion Funktion „ParseJSON“
Datum und Uhrzeit	Funktionen „Date“, „DateTime“ und „Time“ Funktionen „DateValue“, „TimeValue“ und „DateTimeValue“ Funktionen „Day“, „Month“, „Year“, „Hour“, „Minute“, „Second“ und „Weekday“ Funktionen „Now“, „Today“, „IsToday“, „UTCNow“ und „UTCToday“, „IsUTCToday“ Die Funktionen „DateAdd“, „DateDiff“ und „TimeZoneOffset“ Funktion „Text“
Blank	Funktionen „Blank“, „Coalesce“, „IsBlank“ und „IsEmpty“ Funktionen „Error“, „IfError“, „IsError“, „IsBlankOrError“

Festlegen einer Variable mit Power Fx

In diesem Beispiel wird gezeigt, wie der Name eines Kunden in Großbuchstaben gespeichert und ausgegeben wird:

Erstellen Sie einen Workflow, und fügen Sie einen Frageknoten hinzu.
Geben Sie im daraufhin angezeigten Bereich im Feld "Frage stellen " "Was ist Ihr Name?" oder eine andere Nachricht ein. Geben Sie im Feld "Benutzerantwort speichern" einen Variablennamen ein. beispiel: Var01. Wählen Sie dann Fertig aus.
Fügen Sie eine Senden-Nachricht-Aktion hinzu. Geben Sie im angezeigten Bereich im Bereich "Nachricht zum Senden " die Eingabetaste {Upper(Local.Var01)}ein. Wählen Sie dann Fertig aus.
Wählen Sie Vorschau aus.
Senden Sie im Vorschaubereich eine Nachricht an den Agent, um den Workflow aufzurufen.

Erstellen von If/Else-Flüssen mit Power Fx

In diesem Beispiel wird gezeigt, wie Sie einen If/Else-Fluss hinzufügen und eine Bedingung mit Systemvariablen erstellen.

Erstellen Sie einen Workflow, und fügen Sie einen Frageknoten hinzu.
Wählen Sie das + Symbol aus, und fügen Sie einen If/Else-Fluss hinzu.
Geben Sie System. in das Feld Bedingung ein, um eine Bedingung für jeden if/else-Zweig zu erstellen.
Wählen Sie eine nächste Aktion für den nächsten Schritt im Workflow aus.
Wählen Sie Fertig aus. Wählen Sie "Speichern" aus, um Ihren Workflow zu speichern.

Problembehandlung

Thema	Lösung
Option "Workflows " ist nicht sichtbar oder kann Workflows nicht erstellen/bearbeiten	Vergewissern Sie sich, dass Sie über die Rolle "Mitwirkender " oder höher für Ihr Projekt verfügen. Siehe Azure role-based access control (RBAC) in Foundry.
Änderungen werden nach der Bearbeitung nicht angezeigt	Wählen Sie im Visualizer "Speichern" aus. Die Gießerei speichert keine Änderungen automatisch.
Workflowausführung erzeugt unerwartete Ausgabe	Überprüfen Sie, ob jedem Agentknoten ein Agent zugewiesen ist. Überprüfen Sie, ob gespeicherte Ausgaben (JSON-Schema) gültig sind.
Power Fx-Formelfehler: "Name ist ungültig"	Fügen Sie das richtige Bereichspräfix hinzu. Verwenden Sie `System.` für Systemvariablen und `Local.` für lokale Variablen.
Power Fx-Formelfehler: "Typkonflikt"	Überprüfen Sie, ob der Variabletyp mit der erwarteten Eingabe übereinstimmt. Verwenden Sie Konvertierungsfunktionen wie `Text()` oder `Value()` bei Bedarf.
Workflow-Zeitüberschreitung	Teilen Sie komplexe Workflows in kleinere Segmente auf. Überprüfen Sie, ob externe Dienste innerhalb erwarteter Zeitrahmen reagieren.

Bereinigen von Ressourcen

So löschen Sie einen Workflow, den Sie nicht mehr benötigen:

Öffnen Sie den Workflow im Foundry-Portal.
Wählen Sie die Dropdownliste "Version " links neben der Schaltfläche " Speichern " aus.
Wählen Sie "Löschen" für die Version aus, die Sie entfernen möchten.

Feedback

War diese Seite hilfreich?

Last updated on 2026-02-28