Zum Inhalt springen

Anthropic Claude Register Tools-Aktivität in Jitterbit Studio

Einführung

Eine Anthropic Claude Register Tools-Aktivität verwendet ihre Anthropic Claude-Verbindung und registriert Tools zur Verwendung mit Claude-Modellen. Sie ist als Quelle konzipiert, um Daten in einem Vorgang bereitzustellen. 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. Sie müssen die Register Tools-Antwort nicht erfassen oder die Tool-Definitionen explizit an den nachfolgenden Prompt-Vorgang übergeben.

Wichtig

Um die Register Tools-Aktivität zu verwenden, müssen Sie einen privaten Agenten verwenden.

Erstellen einer Anthropic Claude Register Tools-Aktivität

Eine Instanz einer Anthropic Claude Register Tools-Aktivität wird aus einer Anthropic Claude-Verbindung mit ihrem Register Tools-Aktivitätstyp 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 Anthropic Claude Register Tools-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Anthropic Claude Register Tools-Aktivität

Führen Sie diese Schritte aus, um eine Anthropic Claude 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 geben Sie einen Prompt und optionale Einstellungen an. 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 Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, 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 Anthropic Claude Register Tools-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Chat ID: Geben Sie optional eine Chat-ID ein, um den Kontext aus einem vorherigen Gespräch abzurufen.

  • Option wählen: Geben Sie die Modellauswahlmethode an, entweder Alle Modelle auflisten oder Modellkennung eingeben.

  • Alle Modelle auflisten: Wählen Sie diese Option, um aus einer Liste unterstützter Claude-Modelle auszuwählen:

    • Modell auswählen: Dieser Bereich zeigt die für den Anthropic Claude-Endpunkt verfügbaren Modelle an.

      • 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 Modellliste zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Wenn Modelle bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse 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 Anthropic Claude-Endpunkt neu zu laden. Dies kann hilfreich sein, wenn Modelle aktualisiert wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der angezeigten Modelltabelle 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. Für jedes Modell sind folgende Informationen verfügbar:

        • Anzeigename: Der Anzeigename des Modells.

        • ID: Die Modellkennung, die in API-Anfragen verwendet wird.

        • Veröffentlicht: Das Veröffentlichungsdatum des Modells.

      Tipp

      Wenn die Tabelle nicht mit verfügbaren Modellen gefüllt wird, ist die Anthropic Claude-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 Modell-ID angegeben oder in der Anfragetransformation bereitgestellt werden. Wenn ein Modell an mehreren Stellen angegeben wird, wird diese Prioritätsreihenfolge befolgt:

      1. Ein in der Anfragetransformation bereitgestelltes Modell überschreibt alle folgenden Felder.
      2. Ein im Feld Modell-ID angegebenes Modell überschreibt die verbleibenden Felder darunter, auch wenn Alle Modelle auflisten ausgewählt ist.
      3. Ein in der Liste Modell auswählen ausgewähltes Modell hat die niedrigste Priorität.

  • Modellkennung eingeben: Wählen Sie diese Option, um die ID eines Claude-Modells manuell einzugeben.

    • Modell-ID: Geben Sie die Modellkennung ein.

  • Prompt: Geben Sie den Text ein, mit dem das Modell aufgefordert werden soll.

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

    • Max. Ausgabe-Token: Geben Sie die maximale Anzahl der Token ein, die in der Antwort generiert werden sollen. Der Standardwert ist 2000. Der Maximalwert hängt vom ausgewählten Modell ab. Informationen zu den Ausgabe-Token-Limits pro Modell finden Sie in der Anthropic-Modellübersicht.

    • Erweitertes Denken aktivieren: Wählen Sie diese Option, um erweitertes Denken zu aktivieren, das es dem Modell ermöglicht, komplexe Probleme durchzudenken, bevor eine Antwort generiert wird. Diese Option ist standardmäßig deaktiviert.

      Wichtig

      Erweitertes Denken wird nicht von allen Claude-Modellen unterstützt. Wenn diese Option für ein Modell aktiviert ist, das dies nicht unterstützt, gibt Anthropic einen Fehler zurück. Informationen dazu, ob das ausgewählte Modell erweitertes Denken unterstützt, finden Sie in der Anthropic-Modellübersicht.

      • Aufwand: Wählen Sie die Stufe des anzuwendenden Denkaufwands. Diese Einstellung ist sichtbar, wenn Erweitertes Denken aktivieren ausgewählt ist. Die Optionen sind Niedrig, Mittel, Hoch (Standard), Sehr hoch und Maximum. Höhere Aufwandsstufen ermöglichen gründlicheres Denken, erhöhen aber die Antwortzeit und die Token-Nutzung.

    • Prompt Caching aktivieren: Wählen Sie diese Option, um Prompt Caching zu aktivieren, das es dem Modell ermöglicht, zuvor verarbeitete Inhalte wiederzuverwenden und Latenz und Kosten für wiederholte Prompt-Komponenten zu reduzieren. Diese Option ist standardmäßig deaktiviert.

  • Cache Up To: Wählen Sie den Teil des Prompts aus, der zwischengespeichert werden soll. Diese Einstellung ist sichtbar, wenn Enable Prompt Caching ausgewählt ist. Die Optionen folgen einer additiven Hierarchie, bei der jede Ebene alle Inhalte der darüber liegenden Ebenen enthält:

        -   **Tools:** Speichert nur die dem Modell bereitgestellten Tool-Definitionen zwischen.
    -   **Tools + System Prompt:** (Standard.) Speichert Tool-Definitionen und den System-Prompt zwischen.
    -   **Tools + System + Chat History:** Speichert Tool-Definitionen, den System-Prompt und den vollständigen Chat-Verlauf zwischen.

    Weitere Informationen finden Sie in der [Anthropic-Dokumentation zum Prompt Caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching).
    • Continue on error: 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.

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

  • Next: 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 Finished im letzten Schritt klicken.

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

Step 2: Review the data schemas

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

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

    Hinweis

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

    Der Anthropic Claude Connector verwendet die Anthropic API. Informationen zu den Schema-Knoten und Feldern finden Sie in der API-Dokumentation.

  • Refresh: Klicken Sie auf das Aktualisierungssymbol oder das Wort Refresh, um Schemas vom Anthropic Claude Endpoint 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.

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

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

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

Next steps

Nach der Konfiguration einer Anthropic Claude Register Tools Aktivität schließen Sie die Konfiguration der Operation ab, indem Sie weitere Aktivitäten, Transformationen oder Skripte als Operationsschritte hinzufügen und konfigurieren. Sie können auch die Operationseinstellungen konfigurieren, die die Möglichkeit bieten, Operationen zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Um einen Tool-Calling-Workflow abzuschließen, verketten Sie eine Prompt Operation, um nach dieser ausgeführt zu werden. Da Jitterbit die Tool-Schemas im Speicher des privaten Agenten speichert, erhält die Prompt Operation sie automatisch ohne zusätzliche Zuordnung. Um die Prompt Operation 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 Request-Transformation.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Activity actions menu in Connector basics.

Anthropic Claude Register Tools Aktivitäten können als Quelle mit diesen Operationsmustern 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 alles bereit ist, stellen Sie die Operation bereit und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Operationsprotokolle überprüfen.