Referenz für Agenten
Wenn Sie angepasste Agenten erstellen, lesen Sie diesen Artikel für weitere Informationen zu wichtigen Einstellungen wie Anweisungen und Ausgabeschemata. Eine schrittweise Einrichtungsanleitung finden Sie unter Angepasste Agenten erstellen. Eine Einführung finden Sie unter Braze Agents und Häufig gestellte Fragen.
Modelle
Wenn Sie einen Agenten einrichten, können Sie das Modell auswählen, das er zur Generierung von Antworten verwendet. Sie haben zwei Optionen: ein von Braze bereitgestelltes Modell verwenden oder Ihren eigenen API-Schlüssel mitbringen.

Das von Braze bereitgestellte Auto-Modell ist für Modelle optimiert, deren Denkfähigkeiten ausreichen, um Aufgaben wie Katalogsuche und Segment-Zugehörigkeit durchzuführen. Bei der Verwendung anderer Modelle empfehlen wir, durch Tests zu bestätigen, dass Ihr Modell für Ihren Anwendungsfall gut funktioniert. Möglicherweise müssen Sie Ihre Anweisungen anpassen, um Modellen mit unterschiedlichen Geschwindigkeiten und Fähigkeiten verschiedene Detailstufen oder schrittweises Denken zu ermöglichen.
Option 1: Ein von Braze bereitgestelltes Modell verwenden
Dies ist die einfachste Option, ohne zusätzliche Einrichtung. Braze bietet direkten Zugang zu Large Language Models (LLMs). Um diese Option zu nutzen, wählen Sie Auto, das Gemini-Modelle verwendet.

Wenn Sie Braze Auto nicht als Option im Modell-Dropdown beim Erstellen eines Agenten sehen, wenden Sie sich an Ihren Customer-Success-Manager, um zu erfahren, wie Sie für die Nutzung des Braze-Auto-Modells berechtigt werden können.
Option 2: Eigenen API-Schlüssel mitbringen
Mit dieser Option können Sie Ihr Braze-Konto mit Anbietern wie OpenAI, Anthropic oder Google Gemini verbinden. Wenn Sie Ihren eigenen API-Schlüssel von einem LLM-Anbieter mitbringen, werden Token-Kosten direkt über Ihren Anbieter abgerechnet, nicht über Braze.
Wir empfehlen, regelmäßig die neuesten Modelle zu testen, da ältere Modelle nach einigen Monaten eingestellt oder als veraltet markiert werden können. Stellen Sie sicher, dass Sie über ausreichend Guthaben bei Ihrem Anbieter verfügen, um Ihre Agenten im großen Maßstab auszuführen. Sie können sich auch für Agent-Console-Benachrichtigungen in den Benachrichtigungseinstellungen anmelden, um benachrichtigt zu werden, wenn Braze erkennt, dass ein Modell nicht mehr verfügbar ist oder Abrechnungsprobleme mit Ihrem LLM-Anbieter auftreten.
So richten Sie dies ein:
- Gehen Sie zu Partnerintegrationen > Technologie-Partner und suchen Sie Ihren Anbieter.
- Geben Sie Ihren API-Schlüssel vom Anbieter ein.
- Wählen Sie Speichern.
Anschließend können Sie zu Ihrem Agenten zurückkehren und Ihr Modell auswählen.
Wenn Sie ein von Braze bereitgestelltes LLM verwenden, agieren die Anbieter eines solchen Modells als Braze-Unterauftragsverarbeiter, vorbehaltlich der Bedingungen des Datenverarbeitungszusatzes (DPA) zwischen Ihnen und Braze. Wenn Sie Ihren eigenen API-Schlüssel mitbringen, gilt der Anbieter Ihres LLM-Abonnements als Drittanbieter gemäß dem Vertrag zwischen Ihnen und Braze.
Denkstufen
Einige LLM-Anbieter ermöglichen es Ihnen, die Denkstufe eines ausgewählten Modells anzupassen. Denkstufen definieren den Umfang des Denkprozesses, den das Modell vor der Antwort durchläuft – von schnellen, direkten Antworten bis hin zu längeren Argumentationsketten. Dies beeinflusst die Antwortqualität, Latenz und Token-Nutzung.
| Stufe | Wann verwenden |
|---|---|
| Minimal | Einfache, klar definierte Aufgaben (wie Katalogsuche, einfache Klassifizierung). Schnellste Antworten und niedrigste Kosten. |
| Niedrig | Aufgaben, die von etwas mehr Überlegung profitieren, aber keine tiefgehende Analyse erfordern. |
| Mittel | Mehrstufige oder nuancierte Aufgaben (wie die Analyse mehrerer Eingaben, um eine Aktion zu empfehlen). |
| Hoch | Komplexe Argumentation, Grenzfälle oder wenn das Modell Schritte durcharbeiten soll, bevor es antwortet. |
Wir empfehlen, mit Minimal zu beginnen und die Antworten Ihres Agenten zu testen. Anschließend können Sie die Denkstufe auf Niedrig oder Mittel anpassen, wenn der Agent Schwierigkeiten hat, genaue Antworten zu liefern. In seltenen Fällen kann eine hohe Denkstufe erforderlich sein, obwohl diese Stufe zu hohen Token-Kosten und längeren Antwortzeiten oder einem höheren Risiko von Timeout-Fehlern führen kann. Wenn Ihr Agent Schwierigkeiten hat, mehrstufige Argumentation mit angemessenen Antwortzeiten in Einklang zu bringen, erwägen Sie, Ihren Anwendungsfall in mehr als einen Agenten aufzuteilen, die in einem Canvas oder Katalog zusammenarbeiten können.
Braze verwendet für ausgehende LLM-Aufrufe dieselben IP-Bereiche wie für Connected-Content. Die Bereiche sind in der Connected-Content-IP-Zulassungsliste aufgeführt. Wenn Ihr Anbieter IP-Zulassungslisten unterstützt, können Sie den Schlüssel auf diese Bereiche beschränken, sodass nur Braze ihn verwenden kann.

Wenn Sie ein von Braze bereitgestelltes LLM verwenden, agieren die Anbieter eines solchen Modells als Braze-Unterauftragsverarbeiter, vorbehaltlich der Bedingungen des Datenverarbeitungszusatzes (DPA) zwischen Ihnen und Braze. Wenn Sie Ihren eigenen API-Schlüssel mitbringen, gilt der Anbieter Ihres LLM-Abonnements als Drittanbieter gemäß dem Vertrag zwischen Ihnen und Braze.
Bestimmen, welches Modell verwendet werden soll
Jeder LLM-Anbieter hat eine leicht unterschiedliche Mischung aus Modellfähigkeiten, Kosten und Denkstufen. Hier sind einige allgemeine Richtlinien und Best Practices:
- Für Kosteneffizienz priorisieren Sie das Testen von Modellen mit niedrigeren Token-Kosten gegenüber teureren Modellen. Wechseln Sie nur dann zu teureren Modellen, wenn günstigere Modelle mit dem Anwendungsfall Schwierigkeiten haben oder inkonsistente oder ungenaue Ergebnisse liefern.
- Für Geschwindigkeit und Performance-Effizienz priorisieren Sie das Testen niedrigerer Denkstufen gegenüber höheren Denkstufen. Wechseln Sie nur dann zu höheren Denkstufen, wenn niedrigere Denkstufen mit dem Anwendungsfall Schwierigkeiten haben oder inkonsistente oder ungenaue Ergebnisse liefern.
- Wenn günstigere Modelle oder niedrigere Denkstufen mit dem Anwendungsfall Schwierigkeiten haben oder inkonsistente oder ungenaue Ergebnisse liefern, erwägen Sie den Wechsel zu teureren Modellen oder höheren Denkstufen.
- Achten Sie beim Testen darauf, Zuverlässigkeit und Genauigkeit mit Token-Nutzung und Aufruf-Dauer in Einklang zu bringen.
- Jeder Anwendungsfall kann ein anderes optimales Modell und eine andere optimale Denkstufe haben. Wir empfehlen gründliches Testen, um konsistente Qualität ohne Timeouts sicherzustellen.
Steuerung des Aufruf-Flusses
Die folgenden Steuerungen des Aufruf-Flusses gelten pro Workspace:
- Von Braze bereitgestelltes Modell: 5.000 Aufrufe pro Minute
- Eigener API-Schlüssel: 5.000 Aufrufe pro Minute
Wenn viele Nutzer:innen gleichzeitig einen Agenten-Schritt betreten, reiht Braze Aufrufe gemäß diesen Limits in eine Warteschlange ein, sodass die Verarbeitung bei Sendungen mit hohem Volumen länger dauern kann.
Tägliche Aufruf- und Credit-Limits
Jeder Agent hat ein tägliches Aufruf-Limit (Standard 250.000; Maximum 1.000.000, sofern Ihr Vertrag nichts Höheres erlaubt). Jeder Aufruf (einschließlich Agent-Console-Vorschauen und Test-Canvas-Durchläufe, die Antwort simulieren verwenden) wird auf dieses Limit angerechnet.
In der Agent Console schätzt das Tägliche Aktions-Credit-Kostenlimit die maximalen Credits, die ein Agent pro Tag verbrauchen kann. Braze multipliziert das Pro-Aufruf-Credit-Verhältnis Ihres Workspace für das ausgewählte Modell mit dem täglichen Aufruf-Limit.
Wann Credits verbraucht werden
Braze berechnet Credits nur für Aufrufe, die die Verarbeitung abschließen. Credits werden nicht verbraucht, wenn ein Aufruf fehlschlägt aufgrund von:
- Einem Rate-Limit-Fehler des LLM-Anbieters (einschließlich Wiederholungsversuche, die letztendlich fehlschlagen)
- Nichtverfügbarkeit des ausgewählten Modells
- Erreichen des täglichen Aufruf-Limits durch den Agenten
Credits werden verbraucht, wenn ein Aufruf ein Timeout erreicht, auch wenn der Agent kein verwertbares Ergebnis zurückgibt.
Credit-Nutzung überwachen
Gehen Sie zu Einstellungen > Abrechnung > Credit-Nutzung > Agent Console, um den Credit-Verbrauch, die Aufrufzahlen und die Credit-Verhältnisse pro Agent einzusehen.
Credit-Verhältnisse stammen aus Ihrem Vertrag und erscheinen im Credit-Nutzung-Dashboard (Tab Credit-Verhältnisse und Tab Agent Console). Die Schätzung wird aktualisiert, wenn Sie das Modell oder das Aufruf-Limit ändern.
Um Ausgaben zu steuern, senken Sie das tägliche Aufruf-Limit. Bei Bring-your-own (BYO)-Modellen können Sie auch ein günstigeres Modell wählen oder die Denkstufe reduzieren, um die Token-Kosten beim Anbieter zu senken. Braze Auto unterstützt keine Anpassung der Denkstufe.
Rate-Limit-Fehler
Wenn der LLM-Anbieter während eines Canvas-Schritt-Agenten- oder Katalog-Agenten-Aufrufs einen Rate-Limit-Fehler zurückgibt, wiederholt Braze die Anfrage kontinuierlich mit exponentiellem Backoff, bis der Aufruf erfolgreich ist oder Braze feststellt, dass er nicht abgeschlossen werden kann.
Wenn die Wiederholungsversuche für Canvas oder Katalog erschöpft sind, zeigt das Logs-Detailpanel Error und die Anbieternachricht (wie Rate limit exceeded) unter Output an. Wiederholungsversuche sind in den Logs sichtbar, einschließlich des allerersten Aufrufs unabhängig von seinem letztendlichen Erfolg oder Misserfolg. Wenn es für eine:n bestimmte:n Nutzer:in vier Wiederholungsversuche braucht, um schließlich einen Erfolg zu erzielen, können Sie die Nutzer-ID suchen und alle fünf (Original plus vier Wiederholungsversuche) in den Logs sehen, wobei das Original und die ersten drei Wiederholungsversuche Error mit Rate limit exceeded anzeigen.
Rate-Limit-Fehler verbrauchen keine Braze-Credits, einschließlich fehlgeschlagener Wiederholungsversuche, die in den Logs angezeigt werden.

Anweisungen schreiben
Anweisungen sind die Regeln oder Richtlinien, die Sie dem Agenten geben (System-Prompt). Sie definieren, wie sich der Agent bei jeder Ausführung verhalten soll. Systemanweisungen können bis zu 25 KB umfassen.
Wenn Sie Ihren Agenten mit BrazeAI Operator unter Verwendung eines Starttemplate erstellt haben, überprüfen Sie die vorausgefüllten Anweisungen und bearbeiten Sie diese nach Bedarf.
Hier sind einige allgemeine Best Practices für den Einstieg in das Prompting:
- Beginnen Sie mit dem Ziel vor Augen. Formulieren Sie zuerst das Ziel.
- Geben Sie dem Modell eine Rolle oder Persona („Du bist ein …“).
- Setzen Sie klaren Kontext und Einschränkungen (Zielgruppe, Länge, Tonalität, Format).
- Fordern Sie Struktur an („Gib JSON/Aufzählung/Tabelle zurück …“).
- Zeigen statt erzählen. Fügen Sie einige hochwertige Beispiele hinzu.
- Unterteilen Sie komplexe Aufgaben in geordnete Schritte („Schritt 1 … Schritt 2 …“).
- Fördern Sie das Nachdenken („Denke die Schritte intern durch und gib dann eine prägnante Endantwort“ oder „erkläre kurz deine Entscheidung“).
- Testen, prüfen und iterieren. Kleine Anpassungen können zu großen Qualitätsverbesserungen führen.
- Behandeln Sie Randfälle, fügen Sie Leitplanken hinzu und ergänzen Sie Ablehnungsanweisungen.
- Messen und dokumentieren Sie, was intern funktioniert, zur Wiederverwendung und Skalierung.
Beispiele
Für Startkonfigurationen in der Agent Console siehe Agenten-Templates, erstellt mit Operator.
Für vollständige Anweisungsbeispiele, die Sie kopieren oder anpassen können, siehe die Anwendungsfall-Bibliothek für Braze Agents.
| Beispiel | Kategorie | Agententyp | Beschreibung |
|---|---|---|---|
| Personalisierte Nachrichten basierend auf dem Kontext der Nutzer:innen schreiben | Inhaltserstellung | Canvas-Schritt-Agent | Generiert koordinierte E-Mail-Betreffzeile/Preheader und Push-Titel/Text für Nutzer:innen, die gesucht, aber nicht gebucht haben. |
| Nutzerfeedback analysieren, um nächste Schritte zu bestimmen | Datenstandardisierung | Canvas-Schritt-Agent | Klassifiziert Stimmung und Thema einer Umfrage nach der Reise und empfiehlt dann einen CRM-Folgeschritt. |
| Nutzer:innen anhand vorhandener Attribute in Interessens-Buckets kategorisieren | Affinitäts-Agent | Canvas-Schritt-Agent | Klassifiziert Nutzer:innen anhand von Attributen und Signalen mit hoher Absicht in Interessens-Buckets und empfiehlt dann das beste nächste Erlebnis oder den besten Artikel. |
| Nutzer:innen basierend auf aktuellem Verhalten zum relevantesten Canvas-Pfad weiterleiten | Affinitäts-Agent | Canvas-Schritt-Agent | Leitet die Motivation aus dem aktuellen Verhalten ab und gibt den besten Routenschlüssel für den nächsten Canvas-Schritt der Nutzer:innen zurück. |
| Nutzer:innen anhand von Realtime-Aktionen mit hoher Absicht Interessenskategorien zuweisen | Affinitäts-Agent | Canvas-Schritt-Agent | Weist Interessenskategorien basierend auf Aktionen mit hoher Absicht zu und empfiehlt das beste nächste Erlebnis oder den besten Artikel. |
| Eingehende Nachrichten auf Opt-out-Absicht klassifizieren | Klassifizierung und Routing | Canvas-Schritt-Agent | Gibt einen strikten booleschen Wert zurück, der angibt, ob eine Nachricht eine Opt-out-Anfrage ist. |
| Eingehende Nachrichten in strukturierte Daten für die Automatisierung standardisieren | Datenstandardisierung | Canvas-Schritt-Agent | Normalisiert eingehende SMS oder Chat-Nachrichten in strukturierte Absichten, Entitäten und Compliance-Flags für nachgelagerte Automatisierung. |
| Konversionsstarke Beschreibungen schreiben, die den Markenrichtlinien entsprechen | Inhaltserstellung | Catalog Agent | Generiert kurze, markenkonforme Beschreibungen für jede Catalog-Zeile. |
| Übersetzungen basierend auf der regionalen Sprache bereitstellen | Catalog-Anreicherung | Catalog Agent | Lokalisiert UI- und Marketing-Strings pro Gebietsschema und Zeichenlimit. |
| Catalog-Artikel mit Beschreibungen, Kategorien und Tags anreichern | Catalog-Anreicherung | Catalog Agent | Generiert erweiterte Beschreibungen, Kategorien und Tags aus vorhandenen Catalog-Artikeldaten. |
Liquid verwenden
Die Einbindung von Liquid in die Anweisungen Ihres Agenten kann eine zusätzliche Ebene der Personalisierung in seiner Antwort hinzufügen. Sie können die genaue Liquid-Variable angeben, die der Agent erhält, und sie in den Kontext Ihres Prompts einbinden. Anstatt beispielsweise explizit „Vorname“ zu schreiben, können Sie das Liquid-Snippet {{${first_name}}} verwenden:
1
Tell a one-paragraph short story about this user, integrating their {{${first_name}}}, {{${last_name}}}, and {{${city}}}. Also integrate any context you receive about how they are currently thinking, feeling, or doing. For example, you may receive {{context.${current_emotion}}}, which is the user's current emotion. You should work that into the story.
Im Bereich Logs der Agent Console können Sie die Details zu Eingabe und Ausgabe des Agenten überprüfen, um zu verstehen, welcher Wert aus dem Liquid gerendert wird.
Welche Daten Agenten erhalten
Der Agentenkontext ist kein offenes Konversationsgedächtnis. Anders als ein Chat-Assistent sieht ein Agent nur die Daten, die Sie ihm zum Aufrufzeitpunkt explizit übergeben – er durchsucht keine Nutzerprofile, leitet fehlende Felder ab und teilt Ihnen auch nicht mit, wenn erforderliche Informationen fehlen.
Gestalten Sie jeden Agenten als eine bewusste Eingabe-zu-Ausgabe-Pipeline. Verbinden Sie jeden Datenpunkt, den der Agent benötigt, über eine oder mehrere der folgenden Methoden:
- Liquid in Anweisungen: Verwenden Sie Nutzerattribute (
{{${first_name}}}) und Canvas-Kontextvariablen ({{context.${variable_name}}}) direkt im Agenten-Prompt als Template. - + Agent context: Wählen Sie Catalogs, Segmentzugehörigkeit, Markenrichtlinien, All Canvas Context oder Nutzerinteraktionsdaten in der Agent Console aus.
- Context-Schritte: Setzen oder aktualisieren Sie
context.*-Variablen im Canvas vor der Ausführung eines Agenten-Schritts. - Zusätzlicher Kontext im Agenten-Schritt: Übergeben Sie alle zusätzlichen Liquid-Template-Werte, die nicht bereits über die anderen Methoden angegeben wurden, zum Sendezeitpunkt über die Schrittkonfiguration an den Agenten.
Stellen Sie sicher, dass Sie diese Kontextvariablen entweder als Liquid-Template in den Agentenanweisungen verwenden oder Add All Canvas Context auswählen. Wenn ein Wert nicht über einen dieser Kanäle übergeben wird, erhält der Agent ihn nicht. Listen Sie erforderliche Eingaben in Ihren Anweisungen oder in den Voraussetzungen für Anwendungsfälle auf und überprüfen Sie die Eingaben unter Agent Console > Logs nach dem Testen.

Für Catalog Agents verwenden Sie Fields im Bereich Output anstelle eines JSON-Schemas; Sie können dennoch Anweisungen schreiben, die das Modell nach einer Schlüssel-Wert-Ausgabe fragen, die diesen Feldnamen entspricht.
Weitere Details zu Best Practices für das Prompting finden Sie in den Leitfäden der folgenden Modellanbieter:
Ausgaben
Wenn Sie Ihren Agenten mit BrazeAI Operator unter Verwendung eines Startvorlagen erstellt haben, überprüfen Sie das vorausgefüllte Ausgabeschema und bearbeiten Sie es nach Bedarf.
Einfache Schemas
Einfache Schemas sind eine einfache Ausgabe, die ein Agent zurückgibt. Dies kann ein String, eine Zahl, ein Boolean, ein String-Array oder ein Zahlen-Array sein.
Wenn Sie beispielsweise Stimmungswerte von Nutzer:innen aus einer einfachen Feedback-Umfrage erfassen möchten, um festzustellen, wie zufrieden Ihre Kund:innen nach dem Erhalt eines Produkts sind, können Sie Number als einfaches Schema auswählen, um das Ausgabeformat zu strukturieren.

Arrays sind nur für Canvas-Schritt-Agenten verfügbar, nicht für Katalog-Agenten.

Erweiterte Schemas
Erweiterte Schema-Optionen umfassen die manuelle Strukturierung von Feldern oder die Verwendung von JSON.
- Fields: Eine No-Code-Methode, um eine konsistente Agentenausgabe zu erzwingen.
- JSON: Ein Code-Ansatz zur Erstellung eines präzisen Ausgabeformats, bei dem Sie Variablen und Objekte innerhalb des JSON-Schemas verschachteln können. Nur für Canvas-Schritt-Agenten verfügbar, nicht für Katalog-Agenten.
Wir empfehlen die Verwendung erweiterter Schemas, wenn der Agent eine Datenstruktur mit mehreren Werten in strukturierter Form zurückgeben soll, anstatt einer einzelnen Ausgabe. Dadurch kann die Ausgabe besser als konsistente Kontextvariable formatiert werden.
Fallback-Ausgabe
Fallback-Werte sind nur für Canvas-Schritt-Agenten verfügbar. Im Abschnitt Output der Agent-Konsole für einen Canvas-Schritt-Agenten können Sie Werte definieren, die Braze verwendet, wenn ein Aufruf fehlschlägt.
Bei JSON-Schemas liest Braze das Schema und generiert ein Eingabefeld für jede Eigenschaft, sodass Sie einen Fallback-Wert pro Schlüssel festlegen können. Bei Fields-Schemas geben Sie einen Fallback-Wert für jedes Feld ein. Bei einfachen Schemas geben Sie einen einzelnen Fallback-Wert ein. Canvas-Schritt-Agenten unterstützen Liquid in Fallback-Werten.
Informationen zu den Einrichtungsschritten finden Sie unter Fallback-Werte konfigurieren. Informationen zum Laufzeitverhalten in Canvas finden Sie unter Fehlerbehandlung und Fallback-Verhalten.
Beispielsweise können Sie ein Ausgabeformat innerhalb eines Agenten verwenden, der eine Beispielreiseroute für Nutzer:innen basierend auf einem eingereichten Formular erstellen soll. Das Ausgabeformat ermöglicht es Ihnen festzulegen, dass jede Agentenantwort mit Werten für tripStartDate, tripEndDate und destination zurückkommen soll. Jeder dieser Werte kann aus Kontextvariablen extrahiert und in einem Nachrichtenschritt zur Personalisierung mit Liquid platziert werden.
Wenn Sie Antworten auf eine einfache Feedback-Umfrage formatieren möchten, um festzustellen, wie wahrscheinlich es ist, dass Befragte die neueste Eissorte Ihres Restaurants weiterempfehlen, können Sie die folgenden Felder einrichten, um das Ausgabeformat zu strukturieren:
| Feldname | Wert |
|---|---|
| likelihood_score | Number |
| explanation | String |
| confidence_score | Number |

Wenn Sie Nutzerfeedback für das letzte Restauranterlebnis in Ihrer Restaurantkette erfassen möchten, können Sie JSON Schema als Ausgabeformat auswählen und das folgende JSON einfügen, um ein Datenobjekt zurückzugeben, das eine Stimmungsvariable und eine Begründungsvariable enthält.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"type": "object",
"properties": {
"sentiment": {
"type": "string"
},
"reasoning": {
"type": "string"
}
},
"required": [
"sentiment",
"reasoning"
]
}
Kataloge und Felder
Wählen Sie bestimmte Kataloge aus, auf die ein Agent verweisen soll, und geben Sie Ihrem Agenten den Kontext, den er benötigt, um Ihre Produkte und andere nicht nutzerbezogene Daten zu verstehen, wenn dies relevant ist. Agenten verwenden Tools, um nur die relevanten Artikel zu finden und diese an das LLM zu senden, um den Token-Verbrauch zu minimieren. Für einen besseren Katalogazugriff erstellen Sie eine Wissensquelle und fügen Sie diese als Agentenkontext hinzu, anstatt den Katalog direkt anzuhängen.

Wenn Sie einen Catalog Agent in einem Katalogfeld bereitstellen, aktivieren Sie die Pflichtfeld-Steuerung und wählen Sie aus, welche ausgewählten Spalten ausgefüllt sein müssen, bevor der Agent ausgeführt wird. Der Agent überspringt eine Zeile nur dann, wenn eine dieser Pflichtspalten leer ist oder fehlt – zum Beispiel ein gender-Feld, das noch nicht ausgefüllt wurde. Ausgewählte Spalten sind standardmäßig als Pflichtfelder markiert, aber Sie können Spalten entfernen, die leer sein dürfen, ohne die Ausführung zu blockieren. Dies verhindert verschwendete Token bei unvollständigen Daten.
Catalog Agents berücksichtigen auch die Spaltenreihenfolge, wenn Eingabefelder voneinander abhängen. Wenn Spalte D aus den Spalten B und C generiert werden soll, führt der Agent Spalte D erst aus, wenn B und C Werte für diese Zeile enthalten.
Informationen zu Bereitstellungsszenarien und Beispielen finden Sie unter Catalog Agents verwenden und Best Practices für Catalog Agents.
Segment-Mitgliedschaftskontext
Sie können bis zu fünf Segmente auswählen, gegen die der Agent die Segment-Mitgliedschaft jedes Nutzers bzw. jeder Nutzerin abgleichen kann, wenn der Agent in einem Canvas verwendet wird. Angenommen, Ihr Agent hat die Segment-Mitgliedschaft für ein Segment „Loyalty Users“ ausgewählt und wird in einem Canvas verwendet. Wenn Nutzer:innen einen Agent-Schritt betreten, kann der Agent für jede:n Nutzer:in prüfen, ob er oder sie Mitglied der in der Agent-Konsole angegebenen Segmente ist, und die Mitgliedschaft (oder Nicht-Mitgliedschaft) jedes Nutzers bzw. jeder Nutzerin als Kontext für das LLM verwenden.

Markenrichtlinien
Sie können Markenrichtlinien auswählen, an die sich Ihr Agent in seinen Antworten halten soll. Wenn Sie beispielsweise möchten, dass Ihr Agent SMS-Texte generiert, die Nutzer:innen dazu ermutigen, sich für eine Fitnessstudio-Mitgliedschaft anzumelden, können Sie dieses Feld verwenden, um auf Ihre vordefinierte, motivierende Markenrichtlinie zu verweisen.
Nutzerspezifischer Interaktionsverlauf
Die Interaktionsdaten von Nutzer:innen umfassen ihre letzten Campaign- und Canvas-Öffnungen, Klicks und Conversion-Daten. Sie können diesen Kontext beispielsweise einbeziehen, damit ein Agent ihn bei der Auswertung in einem Canvas referenzieren kann. Der nutzerspezifische Interaktionsverlauf kann auch dazu beitragen, einen Agenten zu beeinflussen, dessen Aufgabe es ist, personalisierte Nachrichtentexte zu verfassen.
Versionsverlauf
Die Agentenkonsole zeichnet jedes Mal eine neue Version auf, wenn Sie Änderungen am Agenten speichern. Der Tab Versionsverlauf listet jede gespeicherte Version und die Änderungen zwischen den Speichervorgängen auf.
- Öffnen Sie den Agenten in der Agentenkonsole.
- Wählen Sie den Tab Versionsverlauf.
- Wählen Sie eine Version aus, um deren Konfiguration zu überprüfen.
Um zu sehen, was sich in einer Version geändert hat, wählen Sie Anzeigen. Braze zeigt einen Inline-Diff im Code-Stil an, der Ergänzungen und Löschungen hervorhebt. Gelöschte Inhalte werden mit roter Durchstreichung dargestellt.

Wenn Sie Anweisungen aus einer früheren Version wiederherstellen möchten, öffnen Sie Anzeigen für diese Version, kopieren Sie den Anweisungstext und fügen Sie ihn in Ihr aktuelles Feld Anweisungen ein.

In der Inline-Diff-Ansicht drücken Sie ⌘ + A (macOS) oder Ctrl + A (Windows), um alle Anweisungen ohne die rote Löschungsmarkierung auszuwählen, sodass Sie den sauberen Text kopieren und wiederherstellen können.
Agenten duplizieren
Duplizieren Sie einen Agenten, um Verbesserungen oder Iterationen Seite an Seite mit dem Original zu testen. Verwenden Sie den Versionsverlauf, um frühere Konfigurationen zu überprüfen oder wiederherzustellen. So duplizieren Sie einen Agenten:
- Bewegen Sie den Mauszeiger über die Zeile des Agenten und wählen Sie das Menü aus.
- Wählen Sie Duplizieren aus.
Agenten archivieren
Wenn Sie mehr angepasste Agenten erstellen, können Sie die Seite Agent Management organisieren, indem Sie Agenten archivieren, die nicht aktiv verwendet werden. So archivieren Sie einen Agenten:
- Bewegen Sie den Mauszeiger über die Zeile des Agenten und wählen Sie das Menü aus.
- Wählen Sie Archivieren aus.