Zum Inhalt springen

Azure OpenAI Request Image-Aktivität in Jitterbit Studio

Einführung

Eine Azure OpenAI Request Image-Aktivität generiert mithilfe ihrer Azure OpenAI-Verbindung ein Bild basierend auf einer angegebenen Eingabeaufforderung in Azure OpenAI und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Erstellen einer Azure OpenAI Request Image-Aktivität

Eine Instanz einer Azure OpenAI Request Image-Aktivität wird aus einer Azure OpenAI-Verbindung mit dem Aktivitätstyp Request Image erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Azure OpenAI Request Image-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Azure OpenAI Request Image-Aktivität

Führen Sie diese Schritte aus, um eine Azure OpenAI Request Image-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie den Eingabeaufforderungstext und optionale Einstellungen fest. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Azure OpenAI Request Image-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Eingabeaufforderungstext: Geben Sie eine Beschreibung des zu generierenden Bildes ein. Die maximale Länge beträgt 1000 Zeichen.

  • Modell-ID: Wählen Sie ein Bildgenerierungsmodell. Die Bereitstellungen Ihrer Azure OpenAI-Instanz füllen die Modellliste auf. Klicken Sie auf Aktualisieren, um die Liste zu aktualisieren, wenn Sie seit dem Öffnen dieser Konfiguration neue Modelle bereitgestellt haben. Modelle müssen zunächst in Azure bereitgestellt werden, um als Optionen angezeigt zu werden. Informationen zur Bereitstellung von Modellen finden Sie in der Microsoft-Dokumentation.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Antwortformat: Wählen Sie das Format des generierten Bildes:

      • URL: (Standard.) Die API lädt das generierte Bild auf einen temporären Server hoch und gibt eine URL für dieses Bild zurück. Die URL ist 24 Stunden lang aktiv.
      • Base 64: Das generierte Bild wird als Base64-String codiert und direkt in die Antwort eingefügt. Diese Option kann zu einer großen Antwort-Payload führen, die die API-Antwortsizenlimits überschreitet.

    • Größe: Wählen Sie die Abmessungen des Bildes in Pixeln. Wählen Sie eine der Optionen 1024x1024 (Standard), 1024x1792 oder 1792x1024.

    • Gesamtzahl der Bilder: Geben Sie die Anzahl der zu generierenden Bilder ein. Der Standardwert ist 1 und der Maximalwert ist 5.

    • Bildqualität: Wählen Sie die Bildqualität:

      • Standard: (Standard.) Erstellt Bilder in Standardqualität mit schnellerer Generierungszeit.
      • HD: Erstellt Bilder mit höherer Auflösung und verbessertem Detail.

    • Stil: Wählen Sie den Bildstil:

      • Vivid: (Standard.) Erstellt dramatische, künstlerische und stilisierte Bilder.
      • Natural: Erstellt realistische und gedämpfte Bilder.

    • Unterstützte Versionen: Wählen Sie die Modellversion, entweder 2024-10-21 (Standard) oder 2025-03-01 preview.

  • Bei Fehler fortfahren: Wählen Sie diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Batch-Anfrage ein Fehler auftritt. Falls Fehler auftreten, werden diese in das Operationsprotokoll geschrieben.

  • Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie nach Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden erneut während der Transformationszuordnung angezeigt.

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

    Der Azure OpenAI-Connector verwendet die Azure OpenAI Service REST API. Weitere Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Azure OpenAI-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Datenschema, um den Editor für dieses Datenschema zu öffnen. Der Editor ermöglicht es Ihnen, Knoten und Felder hinzuzufügen, zu löschen und neu zu organisieren sowie deren Datentypen zu ändern. Alle neu hinzugefügten Knoten und Felder werden auf [0, 1] Kardinalität gesetzt. Änderungen an den Datenschemas müssen für den Endpunkt akzeptabel sein und sollten nur nach Rücksprache mit der verfügbaren Dokumentation für den Endpunkt vorgenommen werden. Nach der Bearbeitung von Schemas wird oben im entsprechenden Schema ein Datum der letzten Bearbeitung angezeigt, um anzuzeigen, dass das Schema manuell bearbeitet wurde. Das Aktualisieren der Schemas setzt die Schemas auf ihre Standardstrukturen zurück.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Azure OpenAI-Aktivität Bild anfordern schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Azure OpenAI-Aktivitäten Bild anfordern können als Ziel mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen Sie ihn aus und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.