Erstellen von agentenbasierten Workflows im Workflow-Builder

Details zum agentischen Workflow bearbeiten

So bearbeiten Sie die Details des agentischen Workflows:

1. Gehen Sie im Menü auf „Build “.

2. Navigieren Sie zu Alle Werkzeuge.

   Wählen Sie in der Umgebung „ IBM Cloud “ den mit dem Workflow verknüpften Arbeitsbereich aus der Arbeitsbereichsliste aus.

3. Wählen Sie den Workflow aus, klicken Sie auf das Symbol „Optionen“ und wählen Sie „Details bearbeiten “.

4. Aktualisieren Sie auf der Registerkarte „Übersicht“ den Namen und geben Sie eine Beschreibung für das Tool ein.

5. Klicken Sie auf die Registerkarte „Parameter“, um die Ein- und Ausgänge des Werkzeugs zu konfigurieren.

6. Klicken Sie auf Eingänge hinzufügen, um den Eingang zu definieren. Detaillierte Anweisungen finden Sie unter Hinzufügen von Eingängen

7. Klicken Sie auf Ausgänge hinzufügen, um den Ausgang zu definieren. Eine ausführliche Anleitung finden Sie unter Hinzufügen von Ausgängen

8. Klicken Sie auf Done (Fertig).

Pfade hinzufügen

So fügen Sie einen Pfad zu einem Zweig hinzu:

1. Klicken Sie auf die Verzweigung.

2. Wählen Sie im Verzweigungsfenster Pfad hinzufügen.

Pfadbedingungen hinzufügen

So fügen Sie eine Bedingung zu einem Pfad hinzu:

1. Klicken Sie auf die Verzweigung.

2. Suchen Sie den Pfad und wählen Sie Bedingung bearbeiten. Wählen Sie eine der folgenden Optionen, um eine Bedingung zu definieren:

   • So erstellen Sie eine Bedingung mit dem Condition Builder :

     1. Klicken Sie im Fenster „Bedingungsgenerator“ auf und wählen Sie eine Variable aus der Dropdown-Liste „Verfügbare Variablen“ aus.

     2. Klicken Sie auf und wählen Sie einen Operator aus der Dropdown-Liste aus.

     3. Klicken Sie auf und geben Sie einen Wert ein.

     4. Drücken Sie die Eingabetaste. Um mehr als eine Bedingung hinzuzufügen, wählen Sie Bedingung hinzufügen.

   • Um eine Bedingung mit dem Ausdruckseditor zu erstellen:

     1. Wählen Sie den Ausdruckseditor aus.

     2. Klicken Sie auf Ausdruck eingeben und geben Sie den Ausdruck Python ein.

3. Klicken Sie zurück.

Eine Bedingung bearbeiten oder löschen

So bearbeiten Sie die Bedingungen eines Pfades:

1. Klicken Sie auf die Verzweigung.

2. Suchen Sie den Pfad und wählen Sie Bedingung bearbeiten. Wählen Sie eine der folgenden Optionen, um eine Bedingung zu bearbeiten:

   • So bearbeiten Sie eine Bedingung mit dem Condition Builder :

     1. Aktualisieren Sie die Variable, den Operator und den Wert.

     2. Klicken Sie auf Eingabe.

   • Um eine Bedingung mit dem Ausdruckseditor zu bearbeiten:

     1. Wählen Sie den Ausdruckseditor aus.

     2. Klicken Sie auf den Ausdruck, um das Editorfenster zu öffnen und den Ausdruck Python zu aktualisieren.

So löschen Sie die Bedingung für einen Pfad:

1. Klicken Sie auf die Verzweigung.

2. Suchen Sie den Pfad und wählen Sie Bedingung bearbeiten.

3. Klicken Sie auf „Bedingung löschen “.

Pfade bearbeiten

Sie können die Pfade in Ihrem Zweig verwalten, indem Sie die Reihenfolge ändern, einen Pfad umbenennen oder einen Pfad löschen.

Um die Reihenfolge der Pfade zu ändern:

1. Klicken Sie auf die Verzweigung.

2. Klicken Sie auf „Weitere Aktionen “.

3. Wählen Sie „Nach oben“ oder „Nach unten“ aus der Liste, um die Reihenfolge zu ändern.

Sie können die Pfade auch neu anordnen, indem Sie auf das Symbol neben dem Pfad klicken und es ziehen.

Um einen Pfad zu bearbeiten:

1. Klicken Sie auf die Verzweigung.

2. Klicken Sie auf „Weitere Aktionen “.

3. Wählen Sie Pfadname bearbeiten und geben Sie den neuen Namen ein.

So löschen Sie einen Pfad:

1. Klicken Sie auf die Verzweigung.

2. Klicken Sie auf „Weitere Aktionen “.

3. Wählen Sie Löschen.

Liste auswählen

So wählen Sie eine Liste für die Für jede Kontrolle:

1. Klicken Sie auf die Schaltfläche Für jedes Steuerelement.

2. Verwenden Sie eine der folgenden Optionen, um eine Liste auszuwählen:

   • Standardmäßig ist die automatische Zuordnung aktiviert, wodurch ein Listenobjekt aus der Eingabe des agentischen Workflows ausgewählt wird.

Sie können dieses Standardverhalten jedoch ändern und das Listenobjekt durch die Wahl von Variablen- oder Ausdrucksoptionen konfigurieren.

• Um ein Listenobjekt mithilfe einer Variablen zu konfigurieren, wählen Sie und wählen Sie eine Variable aus der Liste „Verfügbare Variablen“ aus.

• Um ein Listenobjekt mithilfe eines Ausdrucks zu konfigurieren, wählen Sie aus und klicken Sie unter „Listenfeld auswählen“ auf „Ausdruck eingeben“, um das Editorfenster zu öffnen und den Ausdruck „ Python “ zu aktualisieren.

Sobald das Listenobjekt ausgewählt ist, werden die Iterator- und Indexvariablen automatisch bereitgestellt.

Lokale Variablen hinzufügen

Lokale Variablen werden nur innerhalb eines For each Controls verwendet und sind außerhalb davon nicht zugänglich. Jede Iteration des For each kann Zwischenergebnisse speichern, die für diese Iteration spezifisch sind. Diese Werte werden in ihnen gespeichert und können nicht zwischen verschiedenen Iterationen ausgetauscht werden.

So fügen Sie lokale Variablen zu den Für jedes Steuerelement:

1. Klicken Sie auf die Schaltfläche Für jedes Steuerelement.

2. Klicken Sie im Abschnitt „Lokale Variablen“ auf.

3. Wählen Sie im Fenster Lokale Variablen die Option Hinzufügen.

4. Wählen Sie den Variablentyp aus der Dropdown-Liste.

5. Geben Sie den Namen und die Beschreibung ein.

6. Aktivieren Sie das Kontrollkästchen Liste von {object type}, wenn Sie eine Liste von Werten in der Variablen speichern möchten.

7. Klicken Sie auf Hinzufügen.

Um weitere lokale Variablen hinzuzufügen, klicken Sie auf „Hinzufügen “.

Lokale Variable bearbeiten oder löschen

Um eine lokale Variable zu bearbeiten:

1. Klicken Sie auf die Schaltfläche Für jedes Steuerelement.

2. Klicken Sie im Abschnitt „Lokale Variablen“ auf.

3. Bewegen Sie den Mauszeiger über die Variable und wählen Sie .

4. Aktualisieren Sie den Namen und die Beschreibung im Fenster Ausgabe aktualisieren.

5. Klicken Sie auf Speichern.

So löschen Sie eine lokale Variable:

1. Klicken Sie auf die Schaltfläche Für jedes Steuerelement.

2. Klicken Sie im Abschnitt „Lokale Variablen“ auf.

3. Bewegen Sie den Mauszeiger über die Variable und wählen Sie .

Benutzeraktivitäten

Sie können die Benutzeraktivität nutzen, um eine chatbasierte Interaktion zu erstellen, um Eingaben zu sammeln und das Ergebnis innerhalb eines agentenbasierten Workflows anzuzeigen. Weitere Informationen finden Sie unter „Benutzeraktivitäten hinzufügen “.

Ein Beispielvideo zum Hinzufügen von Benutzeraktivitäten finden Sie unter „Erstellen eines agentenbasierten Workflows mit Benutzeraktivitäten“ unter „ watsonx Orchestrate “ im Bereich „Videos “.

Logikblöcke

Sie können den Logikblock verwenden, um benutzerdefinierte „ Python “-Logik direkt in einen agentenbasierten Workflow einzufügen. Weitere Informationen finden Sie unter „Logikblöcke hinzufügen “.

Generative Eingabeaufforderungen

Sie können einen generativen Prompt verwenden, wenn Sie Hilfe bei Aufgaben benötigen, die das Verstehen natürlicher Sprache erfordern. Es arbeitet mit einem großen Sprachmodell (LLM), um Text oder strukturierte Inhalte zu erzeugen. Für generative Prompts in agentenbasierten Workflows können Sie neue Modelle über das AI Gateway hinzufügen. Weitere Informationen finden Sie unter „Generative Eingabeaufforderungen hinzufügen “.

Ein Beispielvideo zum Hinzufügen generativer Eingabeaufforderungen finden Sie unter „Aufbau eines agentischen Workflows mit generativen Eingabeaufforderungen“ im Abschnitt „ watsonx Orchestrate “ unter „Videos “.

Dokumentenklassifikatoren

Sie können Dokumentenklassifikatoren zu agentenbasierten Workflows hinzufügen, um Dokumententypen automatisch zu identifizieren. Weitere Informationen finden Sie unter „Dokumentklassifizierer hinzufügen “.

Dokumentenextraktoren

Sie können Dokumentenextraktoren zu agentischen Workflows hinzufügen, um Felder oder Entitäten wie Datum, Namen und andere aus Dokumenten zu extrahieren. Weitere Informationen finden Sie unter „Dokumentenextraktoren hinzufügen “.

Text-Extraktoren

Sie können einen Textextraktor in einem agentischen Workflow verwenden, um Text aus einem Dokument zu extrahieren. Weitere Informationen finden Sie unter „Textextraktoren hinzufügen “.

Eingaben hinzufügen

So fügen Sie Eingaben für den Arbeitsablauf hinzu:

1. Klicken Sie auf den Startknoten.

2. Klicken Sie im Fenster Eingaben auf Hinzufügen.

3. Wählen Sie einen Eingabetyp aus der Liste aus.

4. Geben Sie einen Namen und eine Beschreibung ein.

5. Optional: Aktivieren Sie das Kontrollkästchen Liste von {data type} um eine Liste von Werten im Eingabefeld zu speichern.

6. Optional: Aktivieren Sie den Schalter „Standardwerte festlegen“, um den Eingang mit einem Standardwert festzulegen.

7. Geben Sie einen Wert ein und klicken Sie auf im Feld für den Standardwert.

8. Klicken Sie auf Hinzufügen.

   • Wenn Sie das Kontrollkästchen „ Liste von {data type} aktivieren, können Sie im Feld „Liste der Standardwerte“ mehr als einen Standardwert hinzufügen.

   • Das Kontrollkästchen „Liste der {data type} “ ist für Dateieingaben nicht verfügbar, und die Option „Standardwert festlegen“ ist für Datei- und Objekteingaben nicht verfügbar.

   • Bei Objektdatentypen können Sie zwischen der einfachen Ansicht und der JSON-Ansicht wählen, um die Objekteigenschaften anzuzeigen.

Ausgänge hinzufügen

So fügen Sie agentische Workflow-Ausgaben hinzu:

1. Klicken Sie auf den Endknoten.

2. Klicken Sie im Fenster Ausgänge auf Hinzufügen.

3. Wählen Sie die Ausgabeart aus der Liste aus.

4. Optional: Aktivieren Sie das Kontrollkästchen „Liste der Werte“ (List of {data type} ), um eine Liste der Werte als Ausgabe zu generieren.

5. Klicken Sie auf Hinzufügen.

   • Das Kontrollkästchen „Liste der {data type} “ ist für Dateieingaben nicht verfügbar.

   • Bei Objektdatentypen können Sie zwischen der einfachen Ansicht und der JSON-Ansicht wählen, um die Objekteigenschaften anzuzeigen.

Hinzufügen von Durchflussvariablen

Um Flussvariablen hinzuzufügen:

1. Klicken Sie auf das Symbol auf der linken Seite des Fensters „Agentischer Workflow“.

2. Klicken Sie auf Hinzufügen und wählen Sie den Variablentyp in der Liste aus.

3. Geben Sie einen Namen und eine Beschreibung ein.

4. Optional: Aktivieren Sie das Kontrollkästchen Liste vom {data type} um eine Liste von Werten in der Variablen zu speichern.

5. Optional: Aktivieren Sie den Schalter „Standardwerte festlegen“, um die Variable mit einem Standardwert zu versehen.

6. Geben Sie einen Wert ein und klicken Sie auf im Feld für den Standardwert.

7. Klicken Sie auf Hinzufügen.

   • Wenn Sie das Kontrollkästchen „ Liste von {data type} aktivieren, können Sie im Feld „Liste der Standardwerte“ mehr als einen Standardwert hinzufügen.

   • Die Option „Standardwert festlegen“ ist für Datei-, Objekt- und Benutzervariablen nicht verfügbar.

   • Bei Objektdatentypen können Sie zwischen der einfachen Ansicht und der JSON-Ansicht wählen, um die Objekteigenschaften anzuzeigen.

Voraussetzungen für die Verwendung des Benutzerdatentyps in einem agentenbasierten Workflow

Mit dem Datentyp „Benutzerdaten“ können Sie Variablen definieren, die Details zu Mandantenbenutzern enthalten. Bevor Sie Benutzer in einem agentenbasierten Workflow auflisten können, müssen Sie den Zugriff auf die APIs der Plattform „ IBM Cloud “ konfigurieren.

Führen Sie als Mieteradministrator die folgenden Schritte aus, um den Zugriff zu konfigurieren:

1. Erstellen Sie eine Service-ID oder einen Benutzer, der Ihre Anwendung oder Ihren Workflow repräsentiert. Weitere Informationen finden Sie unter „Verwalten von Dienst-IDs “.

2. Generieren Sie einen API-Schlüssel für die Service-ID. Weitere Informationen finden Sie unter „Verwalten von API-Schlüsseln für Service-IDs “.

3. Weisen Sie der Service-ID oder dem Benutzer die folgenden Rollen zu:

   • Administratorrolle, die auf den Ziel- wxO -Mandanten als Ressource beschränkt ist

   • Betrachterrolle für alle IAM-Kontoverwaltungsdienste

Weitere Informationen zur Zuweisung von Rollen finden Sie unter „Zugriff auf Ressourcen verwalten “. Nachdem Sie diese Rollen zugewiesen haben, registrieren Sie den API-Schlüssel der Service-ID oder des Benutzers als Verbindung mit der vordefinierten Anwendungs-ID WXO_PLATFORM_USER_API.

Diese Voraussetzung gilt nur für „ watsonx Orchestrate “-Mandanten, die auf IBM Cloud gehostet werden.

Eigenschaften zu einem Objektdatentyp hinzufügen

Sie können einem Objektdatentyp Eigenschaften für Eingaben, Ausgaben und Variablen hinzufügen.

So fügen Sie Eigenschaften zu einem Objektdatentyp hinzu:

1. Wählen Sie den Datentyp „Objekt“ aus der Liste aus.

2. Geben Sie einen Namen und eine Beschreibung ein.

3. Optional: Aktivieren Sie das Kontrollkästchen „Liste der Objekte“, um eine Liste von Werten im Objekttyp zu speichern.

4. Klicken Sie neben dem Objektnamen in der Objektstruktur oder klicken Sie im Abschnitt „Objekteigenschaften“ auf „Hinzufügen“ (+).

5. Wählen Sie eine Immobilie aus der Liste aus.

6. Geben Sie einen Namen und eine Beschreibung ein.

7. Optional: Aktivieren Sie das Kontrollkästchen „Liste der {data type} “, um eine Liste von Werten in der Objekteigenschaft zu speichern.

8. Optional: Aktivieren Sie den Schalter „Standardwerte festlegen“, um die Eigenschaften mit einem Standardwert festzulegen.

9. Geben Sie einen Wert ein und klicken Sie auf im Feld für den Standardwert.

10. Sie können zwischen der einfachen Ansicht und der JSON-Ansicht wählen, um die Objekteigenschaften anzuzeigen.

11. Klicken Sie auf Speichern.

Objektdatentypen

Beachten Sie bei der Definition eines Objekts die folgenden Elemente. Ein Objekt umfasst einen Namen, eine optionale Beschreibung und eine Reihe von Eigenschaften, die unter Verwendung einer vereinfachten Teilmenge des JSON-Schema-Standards definiert sind. Weitere Informationen finden Sie in der Dokumentation zum JSON-Schema.

Eigenschaften können selbst Objekte mit eigenen verschachtelten Eigenschaften sein. Es kann sich auch um Listen handeln, die mithilfe des JSON-Schema-Array-Typs definiert werden.

Hier ist ein Beispiel, das die Eigenschaften eines Employee-Objekts zeigt, das mithilfe eines JSON-Schemas definiert wurde

{
    "id": {
        "type": "integer",
        "description": "Unique identifier for the employee"
    },
    "firstName": {
        "type": "string",
        "description": "Employee's first name"
    },

    "lastName": {
        "type": "string",
        "description": "Employee's last name"
    },
    "email": {
        "type": "string",
        "description": "Employee's email address"
    },
    "department": {
        "type": "string",
        "description": "Employee's department"
    },
    "salary": {
        "type": "number",
        "description": "Employee's salary"
    },
    "isActive": {
        "type": "boolean",
        "description": "Whether the employee is currently active"
    },
    "startDate": {
        "type": "string",
        "format": "date",
        "description": "Employee's start date"
    },
    "badges": {
        "type": "array",
        "items": {
            "type": "string"
        },
        "description": "Employee's badges"
    },
    "address": {
        "type": "object",
        "properties": {
            "street": {
                "type": "string"
            },
            "city": {
                "type": "string"
            },
            "zipCode": {
                "type": "string"
            }
        }
    }
}

Das Schema des Mitarbeiterobjekts umfasst die folgenden Eigenschaften:

• id, email, salary, isActive und startDate sind einfache Eigenschaften, die ganzzahlige, Zeichenfolgen-, Dezimal-, Boolesche und Datumswerte enthalten.

• address ist eine Objekteigenschaft mit verschachtelten Eigenschaften: Straße, Stadt und zipCode.

• badges ist eine Liste, ausgedrückt als JSON-Schema-Array von Zeichenfolgenwerten.

Unter https://github.com/IBM/ibm-watsonx-orchestrate-adk/tree/main/examples/flow_builder/Employee_information können Sie einen Beispiel-Agentic-Workflow herunterladen, der sich auf den Datentyp „Object“ bezieht. Weitere Informationen finden Sie unter „Beispiele für agentische Workflows “.

Zuordnen der Daten

Knoten innerhalb eines agentenbasierten Arbeitsablaufs können Daten als Input benötigen. Diese Daten können aus den Eingaben in den agentengestützten Arbeitsablauf, aus den Ausgaben der vorgelagerten Knoten und aus dem Kontext der Chatsitzung stammen.

Wenn ein agenturgestützter Arbeitsablauf abgeschlossen ist, kann er auch Daten als Output produzieren. Die Daten, die vom agentenbasierten Workflow erzeugt werden, können von den Eingaben des agentenbasierten Workflows oder von Knoten innerhalb des agentenbasierten Workflows stammen.

Wenn ein Knoten Daten als Eingabe benötigt, versucht die agentische Workflow-Engine standardmäßig, potenzielle Datenquellen zu ermitteln. Wenn die agentenbasierte Workflow-Engine eine Quelle findet, ordnet sie diese Daten automatisch dem Knoten zu. Sie können dieses Standardverhalten jedoch außer Kraft setzen und eine Abbildung auf Knoten oder die Ausgabe des agentenbasierten Workflows bereitstellen. Um das Zuordnungsverhalten für die Ausgabe des agenturischen Workflows außer Kraft zu setzen, markieren Sie den Knoten Ende des agenturischen Workflows.

Um die Datenzuordnung in einem Agenten-Workflow zu bearbeiten, wählen Sie den Knoten aus und klicken Sie dann auf Datenzuordnung bearbeiten.

Die folgenden Optionen für die Datenzuordnung sind verfügbar:

• Automatische Zuordnung: Ein agentenbasierter Arbeitsablauf ordnet Daten automatisch zwischen den einzelnen Schritten zu, indem er die Eingaben der Knoten mit den Ausgaben anderer Knoten oder mit den Eingaben des agentenbasierten Arbeitsablaufs selbst verbindet. Wenn ein erforderlicher Teil der Daten von keinem Knoten innerhalb des agenturischen Workflows erzeugt wird, können Sie eine Eingabe auf der Ebene des agenturischen Workflows mit demselben Namen und Typ definieren. Die agenturgestützte Workflow-Engine bildet sie dann automatisch ab, was einen nahtlosen Datentransfer im gesamten agenturgestützten Workflow gewährleisten kann.

Datums- und Zeitformat für Codeblöcke und Ausdrücke

Wenn Sie Datums- und Zeitwerte in Codeblöcken oder Datenzuordnungsausdrücken definieren, verwenden Sie das Standardformat nach ISO 8601 mit Unterstützung für IANA-Zeitzonen:

ISO 8601-Format : YYYY-MM-DDThh:mm:ss±hh:mm[timezone/location]

Beispiel : 2026-02-19T07:15:00+05:00[Europe/London]

Aufschlüsselung nach Format :

• Datum : YYYY (Jahr), MM (Monat), DD (Tag)

• Zeit : hh (Stunde), mm (Minuten), ss (Sekunden)

• Trennzeichen : Ein „T“ trennt das Datum und die Uhrzeit voneinander

• Zeitzone : „Z“ (UTC) oder eine ±hh:mm Zeitverschiebung

• Zeitzonenangabe : IANA-Zeitzonenbezeichnung in eckigen Klammern (z. B. [Europe/London])

Die Angabe der Zeitzone wird empfohlen, kann aber weggelassen werden. Dieses Format gewährleistet eine logische Sortierung, beseitigt Mehrdeutigkeiten und sorgt für internationale Anerkennung.

Nächste Schritte

Ihr agentischer Workflow ist nun erstellt. Sie können die Chat-Vorschau verwenden, um Ihren agentischen Arbeitsablauf zu testen.

• Benutzeraktivitäten hinzufügen

Eine Benutzeraktivität besteht aus einer oder mehreren chatbasierten Interaktionen zur Erfassung von Eingaben und zur Anzeige von Ergebnissen innerhalb eines agentengestützten Arbeitsablaufs.

• Logikblöcke hinzufügen

Ein Logikblock fügt benutzerdefinierte Logik als „ Python “-Logik in Ihren agentenbasierten Workflow ein.

• Hinzufügen generativer Eingabeaufforderungen

Eine generative Eingabeaufforderung nutzt die Fähigkeiten von großen Sprachmodellen (LLMs) für Aufgaben.

• Dokumentklassifizierer hinzufügen

Ein Dokumentenklassifikator identifiziert automatisch Dokumententypen.

• Dokumenten-Extraktoren hinzufügen

Ein Dokumentenextraktor ruft Felder und Entitäten aus Dokumenten ab.

• Text-Extraktoren hinzufügen

Ein Textextraktor holt den Text aus einem Dokument.