Agents – Häufig gestellte Fragen

Dieser Artikel enthält Antworten auf häufig gestellte Fragen zu Braze Agents.

Allgemein

Was ist der Unterschied zwischen Canvas-Agents und Katalog-Agents?

Beim Erstellen eines Agents legen Sie fest, ob Sie einen Canvas-Agent oder einen Katalog-Agent erstellen möchten. Dies bestimmt, welche Arten von Anweisungen und Optionen der Agent unterstützen kann. Canvas-Agents verarbeiten Nutzer:innen in Realtime innerhalb von Journeys, während Katalog-Agents Katalogdaten anreichern, indem sie Spalten mit verarbeiteten Informationen hinzufügen oder aktualisieren.

Welche Vorteile bietet das Auto-Modell im Vergleich zum Bring-your-own-Modell (BYO)?

Vorteile des Braze Auto-Modells:

• Es sind keine API-Schlüssel, kein Abrufen von Zugangsdaten und kein Integrations-Setup erforderlich.
• Jeder Aufruf wird automatisch an das effektivste Modell für die jeweilige Aufgabe weitergeleitet.

Wo kann ich meine aktuelle Agent-Nutzung einsehen?

Gehen Sie zu Einstellungen > Abrechnung > Credit-Nutzung, um Details zu Ihrer Agent-Nutzung und den Credit-Kosten einzusehen.

Kann ich bedingte Liquid-Anweisungen in Agent-Anweisungen verwenden?

Nein. Der Versuch, Liquid-Blöcke wie {% if %}-Anweisungen zu schreiben, kann zu einem Validierungsfehler führen. Agents können verschiedene Szenarien stattdessen über natürlichsprachliche Beschreibungen im Prompt abdecken.

Können Agents auf Nutzerdaten zugreifen, die über die spezifischen Liquid-Attribute oder -Werte hinausgehen, die ich ihnen übergebe?

Nein. Agents erhalten nur die spezifischen Datenpunkte, die ihnen über Liquid übergeben werden, sowie Ressourcen, die dem Agent-Kontext hinzugefügt wurden. Agents können nicht in Nutzerprofilen nach Attributen suchen, für deren Abfrage sie vom Marketer nicht konfiguriert wurden.

Fehlerbehebung

Warum hat mein Agent meine Anweisungen oder Regeln nicht befolgt?

Verwenden Sie Operator, um herauszufinden, warum Ihr Agent Ihre Anweisungen nicht befolgt. Operator kann Schritt-für-Schritt-Anleitungen und detaillierte Erklärungen liefern.

Warum hat mein Katalog-Agent einige Zeilen übersprungen?

Katalog-Agents überspringen eine Zeile, wenn eine Spalte, die Sie als zum Ausführen erforderlich markiert haben, leer ist oder fehlt – beispielsweise ein gender-Feld, das noch nicht ausgefüllt wurde. Nachdem Sie Eingabespalten ausgewählt haben, aktivieren Sie die Pflichtfeld-Kontrolle für das Katalogfeld und legen fest, welche Spalten Werte enthalten müssen, bevor der Agent ausgeführt wird. Ausgewählte Spalten sind standardmäßig als erforderlich markiert, aber Sie können Spalten entfernen, die leer sein dürfen, ohne den Aufruf zu blockieren. So werden keine Token für unvollständige Daten verschwendet.

Der Agent berücksichtigt auch Spaltenabhängigkeiten. Wenn eine Ausgabespalte von anderen Spalten abhängt (z. B. Spalte D Werte in den Spalten B und C erfordert), wird der Agent für diese Zeile erst ausgeführt, wenn die vorgelagerten Spalten befüllt sind.

Weitere Informationen finden Sie unter Best Practices für Katalog-Agents.

Mein Agent hat Schwierigkeiten mit einer komplexen Aufgabe. Wie kann ich seine Performance verbessern?

Wenn der Agent mit den gestellten Aufgaben Schwierigkeiten hat, ziehen Sie einen Sub-Agent-Ansatz in Betracht. Sie könnten beispielsweise drei Agents für folgende Aufgaben einsetzen:

• Agent 1 standardisiert und transformiert eingehende unstrukturierte Canvas-Kontextdaten.
• Agent 2 referenziert einen Katalog mit Artikeldetails und identifiziert, welche Artikel relevant sein könnten.
• Agent 3 referenziert einen anderen Katalog, der verschiedene mögliche Beschreibungen für jeden Artikel enthält, und wählt die für die/den Nutzer:in relevanteste Artikelbeschreibung für eine E-Mail aus.

Was kann dazu führen, dass ein angepasster Agent häufig ein Timeout hat?

Ein angepasster Agent kann ein Timeout haben, wenn:

• Die Agent-Anweisungen unvollständig oder widersprüchlich sind
• Die Agent-Anweisungen nicht alle Szenarien abdecken oder keine Fallback-Bedingung enthalten (z. B. „Wenn alle Eingaben leer sind, gib ‚Konnte nicht personalisieren’ aus“)
• Die Agent-Anweisungen ein anderes Ausgabeformat verlangen als das im Tab Ausgabe festgelegte (z. B. wenn die Agent-Anweisungen einen String verlangen, aber im Tab Ausgabe die Ausgabe als Zahl definiert ist)
• Die Aufgabe des Agents zu komplex ist und von einem Sub-Agent-Ansatz profitieren würde

Konfigurieren Sie für Canvas-Agents Fallback-Werte in der Agentenkonsole, damit Nutzer:innen auch dann eine Ausgabe erhalten, wenn ein Aufruf fehlschlägt.

Compliance

Ist die Agentenkonsole DSGVO-/CCPA-konform?

Ja. Wenn Kund:innen das Braze Auto-Modell (basierend auf Gemini) verwenden, agiert Google als Braze-Unterauftragsverarbeiter, vorbehaltlich der Bedingungen des Datenverarbeitungszusatzes (DPA) zwischen den Kund:innen und Braze.

Ist die Agentenkonsole HIPAA-konform?

Ja. Bei Verwendung des Braze Auto-Modells haben wir eine spezifische HIPAA-Vereinbarung, den Business Associate Addendum (BAA), mit Google für Gemini abgeschlossen, das unser Auto-Modell betreibt.

Unser BAA gilt nur für Kund:innen, die das Braze Auto-Modell verwenden. Wenn Kund:innen ihren eigenen LLM-Schlüssel verwenden, sendet Braze keine geschützten Gesundheitsinformationen (PHI), die dem US-Gesetz zum Schutz medizinischer Daten (HIPAA) unterliegen, in ihrem Namen an ein LLM – die Kund:innen senden diese direkt. In diesem Fall gilt der BAA zwischen Braze und Google nicht. Die Datenverarbeitung über den eigenen LLM-Schlüssel unterliegt dem Vertrag der Kund:innen und etwaigen BAAs, die sie direkt mit ihrem LLM-Anbieter abgeschlossen haben.