Zum Inhalt springen

Anthropic Claude Prompt-Aktivität in Jitterbit Studio

Einführung

Eine Anthropic Claude Prompt-Aktivität verwendet ihre Anthropic Claude-Verbindung und sendet einen Prompt an das angegebene Claude-Modell. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Erstellen einer Anthropic Claude Prompt-Aktivität

Eine Instanz einer Anthropic Claude Prompt-Aktivität wird aus einer Anthropic Claude-Verbindung mit dem Aktivitätstyp Prompt erstellt.

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

Eine vorhandene Anthropic Claude Prompt-Aktivität kann an diesen Orten bearbeitet werden:

Konfigurieren einer Anthropic Claude Prompt-Aktivität

Führen Sie diese Schritte aus, um eine Anthropic Claude Prompt-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 sowie 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.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. 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 Prompt-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Chat-ID: Geben Sie eine Chat-ID ein, um den Kontext aus einer vorherigen Unterhaltung abzurufen. Wenn leer und nicht in der Request-Transformation angegeben, wird eine neue Chat-ID generiert und in der Aktivitätsantwort bereitgestellt.

  • 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 von Modellen auszuwählen, die vom Anthropic Claude-Endpunkt abgerufen werden:

    • Modell auswählen: Dieser Bereich zeigt die im Anthropic Claude-Endpunkt verfügbaren Modelle an.
  • Ausgewähltes Modell: Nach der Auswahl eines Modells wird es hier aufgelistet.

  • Suche: Geben Sie einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Liste der Modelle zu filtern. Die Suche ist nicht case-sensitiv. Wenn Modelle bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Modelle vom Endpunkt neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Modelle vom Anthropic Claude-Endpunkt neu zu laden. Dies kann nützlich sein, wenn neue Modelle hinzugefügt 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. Die verfügbaren Informationen für jedes Modell werden vom Anthropic Claude-Endpunkt abgerufen:

    • Anzeigename: Der Anzeigename des Modells.

    • ID: Die ID des Modells.

    • 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 Request-Transformation bereitgestellt werden. Wenn ein Modell an mehreren Stellen angegeben wird, gilt diese Rangfolge:

  1. Ein in der Request-Transformation bereitgestelltes Modell überschreibt alle unten aufgeführten Felder.
  2. Ein im Feld Modell-ID angegebenes Modell überschreibt die verbleibenden Felder unten, 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. Modellkennung eingeben: Wählen Sie diese Option, um die ID eines Modells manuell einzugeben:

    • Modell-ID: Geben Sie die Modell-ID ein.
  5. Eingabeaufforderung: Geben Sie den Text ein, mit dem Sie das Modell auffordern möchten.

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

    • Max. Ausgabe-Token: Geben Sie die maximale Anzahl von 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 Token-Limits für die Ausgabe 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 sie 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 Aufwandstufen 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 bis zu: Wählen Sie den Teil der Eingabeaufforderung aus, der zwischengespeichert werden soll. Diese Einstellung ist sichtbar, wenn Prompt-Caching aktivieren 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 + Systemaufforderung: (Standard.) Speichert Tool-Definitionen und die Systemaufforderung zwischen.
        • Tools + System + Chat-Verlauf: Speichert Tool-Definitionen, die Systemaufforderung und den vollständigen Chat-Verlauf zwischen.

Für Details siehe die Anthropic-Dokumentation zur Prompt-Zwischenspeicherung.

  • 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. Alle Fehler werden im Operationsprotokoll protokolliert.

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

  • Änderungen verwerfen: 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.

Schritt 2: Datenschemas überprüfen

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

  • Datenschema: 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. Felder wie Chat-ID, Prompt, Modell-ID und Max. Ausgabe-Token können in der Anfragetransformation bereitgestellt oder überschrieben werden.

    Der Anthropic-Claude-Connector verwendet die Anthropic-API. Weitere Informationen finden Sie in der API-Dokumentation.

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

Nächste Schritte

Nach der Konfiguration einer Anthropic-Claude-Aktivität vom Typ Prompt 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.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Designoberfläche verfügbar. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Anthropic-Claude-Aktivitäten vom Typ Prompt können als Ziel mit diesen Vorgangsmustern verwendet werden:

Konversation muss mit einer Benutzereingabe enden

Die Anthropic-API erfordert, dass jede Konversation mit einer Nachricht des Benutzers endet, nicht des Assistenten. Wenn der Chat-Verlauf mit einer Assistentennachricht endet, gibt die API einen Fehler zurück. Gestalten Sie Vorgänge so, dass jeder Aufruf der Anthropic-Claude-Aktivität vom Typ Prompt zuletzt eine Benutzernachricht sendet.

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.