Zum Inhalt springen

Amazon Bedrock Register Tools-Aktivität in Jitterbit Studio

Einführung

Eine Amazon Bedrock Register Tools-Aktivität registriert mit ihrer Amazon Bedrock-Verbindung Tools zur Verwendung mit den unterstützten Modellen von Amazon Bedrock. Die Aktivität unterstützt nur Amazon-, Anthropic-, Cohere- und Meta-Modelle und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen. Tool-Schemas können aus der List Tools-Aktivität des MCP Client-Connectors stammen oder direkt über die Request-Transformation als benutzerdefinierte Funktionsdefinitionen bereitgestellt werden.

Wenn der Vorgang ausgeführt wird, speichert Jitterbit die registrierten Tool-Schemas im Speicher des privaten Agenten. Jeder Vorgang, der nach diesem ausgeführt wird, hat automatisch Zugriff auf diese Schemas, wenn er das LLM aufruft. Es ist nicht erforderlich, die Register Tools-Antwort zu erfassen oder die Tool-Definitionen explizit an den nachfolgenden Prompt-Vorgang zu übergeben.

Wichtig

Um die Register Tools-Aktivität zu verwenden, muss ein privater Agent verwendet werden.

Voraussetzungen

Um diese Aktivität erfolgreich zu verwenden, benötigen Sie die folgenden AWS IAM-Kontoberechtigungen:

  • bedrock:ListFoundationModels
  • bedrock:GetFoundationModel
  • bedrock:InvokeModel

Erstellen einer Amazon Bedrock Register Tools-Aktivität

Eine Instanz einer Amazon Bedrock Register Tools-Aktivität wird aus einer Amazon Bedrock-Verbindung mit ihrem Aktivitätstyp Register Tools erstellt.

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

Eine vorhandene Amazon Bedrock Register Tools-Aktivität kann an diesen Orten bearbeitet werden:

Konfigurieren einer Amazon Bedrock Register Tools-Aktivität

Führen Sie diese Schritte aus, um eine Amazon Bedrock Register Tools-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein, wählen Sie ein Modell aus und legen Sie 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 Amazon Bedrock Register Tools-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Alle Modelle auflisten: Wählen Sie diese Option, um aus einer Liste von Modellen auszuwählen, die von Amazon Bedrock abgerufen werden:

    • Modell auswählen: Dieser Bereich zeigt unterstützte Amazon-, Anthropic-, Cohere- und Meta-Modelle an, die in Amazon Bedrock verfügbar sind.

      Hinweis

      Es werden nur Modelle angezeigt, die Tool-Nutzung unterstützen.

      • Ausgewähltes Modell: Nach der Auswahl eines Modells wird es hier aufgelistet.

      • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Modelle zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Wenn Modelle bereits in der Tabelle angezeigt werden, werden die Tabellenresultate mit jedem Tastendruck in Echtzeit gefiltert. Um Modelle vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

      • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Modelle vom Amazon Bedrock-Endpunkt neu zu laden. Dies kann hilfreich sein, wenn Modelle zu Amazon Bedrock hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der angezeigten Modelle in der Konfiguration verwendet werden.

      • Modell auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Modell auszuwählen. Es kann nur ein Modell ausgewählt werden. Die für jedes Modell verfügbaren Informationen werden vom Amazon Bedrock-Endpunkt abgerufen:

        • Modellkennung: Die Modell-ID.

        • Modellanbietern: Der Anbieter des Modells.

        • Modellname: Der Name des Modells.

      Tipp

      Wenn die Tabelle nicht mit verfügbaren Modellen gefüllt wird, ist die Amazon Bedrock-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

      Alternativ kann das Modell im Feld Modellkennung angegeben oder in der Anforderungstransformation bereitgestellt werden. Wenn ein Modell an mehreren Stellen angegeben wird, wird diese Rangfolge befolgt:

      1. Ein in der Anforderungstransformation bereitgestelltes Modell setzt alle folgenden Felder außer Kraft.
      2. Ein im Feld Modellkennung angegebenes Modell setzt das verbleibende Feld unten außer Kraft, auch wenn Alle Modelle auflisten ausgewählt ist.

      3. Ein in der Liste Modell auswählen ausgewähltes Modell hat die niedrigste Priorität.

      4. Eingabeaufforderung: Geben Sie eine anfängliche Eingabeaufforderung für das Modell ein. Die Eingabeaufforderung sollte den grundlegenden Kontext und die Richtlinien für die Antworten des Modells festlegen.

  • Modellkennung eingeben: Wählen Sie diese Option, um die Kennung eines unterstützten Amazon-, Anthropic-, Cohere- oder Meta-Modells in Amazon Bedrock manuell einzugeben.

    • Modellkennung: Geben Sie die Modell-ID ein, z. B. amazon.nova-lite-v1:0.

    • Eingabeaufforderung: Geben Sie eine anfängliche Eingabeaufforderung für das Modell ein. Die Eingabeaufforderung sollte den grundlegenden Kontext und die Richtlinien für die Antworten des Modells festlegen.

  • Speichern und beenden: 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 der letzten Seite auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an 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 Anforderungs- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

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

    Der Amazon Bedrock-Connector verwendet die Amazon Bedrock API. Weitere Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Amazon Bedrock-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.

  • 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.

Fehlerbehebung

Bei der Ausführung von Aktivitäten können folgende Fehler auftreten:

Invocation of model ID <model-name> with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.

Dieser Fehler tritt auf, weil einige Modelle keinen On-Demand-Durchsatz unterstützen und stattdessen die ID eines regionsübergreifenden Inferenzprofils anstelle der Modell-ID erforderlich ist, die in der Liste Modell auswählen zurückgegeben wird.

Navigieren Sie in der AWS Management Console zu Amazon Bedrock > Inference profiles und suchen Sie die Inferenzprofil-ID für das Modell. Beispielsweise ist die Inferenzprofil-ID für anthropic.claude-3-5-haiku-20241022-v1:0 in den USA us.anthropic.claude-3-5-haiku-20241022-v1:0. Um die Inferenzprofil-ID einzugeben, müssen Sie die Option Modellkennung eingeben in Schritt 1 verwenden.

Nächste Schritte

Nach der Konfiguration einer Amazon Bedrock-Aktivität Register Tools schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten, Transformationen oder Skripte 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.

Um einen Tool-Calling-Workflow abzuschließen, verketten Sie einen Prompt-Vorgang, der nach diesem ausgeführt wird. Da Jitterbit die Tool-Schemas im Speicher des privaten Agenten speichert, empfängt der Prompt-Vorgang sie automatisch ohne zusätzliche Zuordnung. Um den Prompt-Vorgang mit dem Gesprächsverlauf dieser Sitzung zu verknüpfen, erfassen Sie die chatId aus der Register Tools-Antwort und übergeben Sie sie an die Prompt-Aktivität in der Anforderungstransformation.

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

Amazon Bedrock-Aktivitäten Register Tools 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 validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.