エージェントに関するよくある質問

この記事では、Brazeエージェントに関するよくある質問への回答を提供します。

一般

Braze Agentと意思決定エージェントの違いは何ですか？

Braze Agentは、キャンバスステップまたはカタログフィールドにおいて、1人のユーザーのコンテキストに基づいて推論を行います。Decisioning Studioの意思決定エージェントは、母集団全体の測定結果から学習します。詳しくは、Braze Agentと意思決定エージェントを参照してください。

Braze AgentとBrazeAI Operatorの違いは何ですか？

BrazeAI Operatorは、ダッシュボードで構築する際にあなたと一緒に作業します。Braze Agentは送信時に実行され、ユーザーごとに異なる結果を生成します。詳しくは、コンテンツを生成するを参照してください。

キャンバスステップエージェントとカタログエージェントの違いは何ですか？

エージェントを作成する際に、キャンバスステップエージェントとカタログエージェントのどちらを作成するかを指定します。これにより、エージェントがサポートできるインストラクションとオプションの種類が決まります。キャンバスステップエージェントはジャーニー内でユーザーをリアルタイムに処理し、カタログエージェントは処理した情報でカラムを追加または更新してカタログデータを拡充します。

Auto モデルとBYO（Bring-Your-Own）モデルを使用するメリットは何ですか？

Braze Auto モデルを使用するメリットには以下があります。

• APIキーの取得・入力やインテグレーションの設定が不要です
• 各呼び出しが、そのタスクに最も効果的なモデルに自動的にルーティングされます

現在のエージェント使用量はどこで確認できますか？

設定 > 請求 > クレジット使用量 > エージェントコンソールに移動すると、クレジット消費量、呼び出し回数、エージェントごとのクレジット比率を確認できます。詳しくは、1日の呼び出しとクレジットの制限を参照してください。

エージェントのインストラクションで条件付きLiquidステートメントを使用できますか？

いいえ、{% if %}ステートメントなどのLiquidブロックを記述しようとすると、バリデーションエラーが発生する場合があります。エージェントは、プロンプト内の自然言語による説明を通じて、さまざまなシナリオに対応できます。

エージェントは、渡した特定のLiquid属性やキャンバスコンテキスト以外のユーザーデータにアクセスできますか？

いいえ。エージェントは、インストラクション内でLiquidを使用して渡された特定のユーザーデータポイント、+ エージェントコンテキストの選択、キャンバス内の上流のコンテキストステップ、またはエージェントステップの追加コンテキストのみを受け取ります。エージェントは、受信するように設定していない属性をユーザープロファイルから検索することはできません。

また、エージェントは必要なデータが不足していることを警告できません。プロンプトにある情報をそのまま使って処理を進めます。エージェントの設定は、意図的な入力から出力への設計として扱ってください。エージェントが必要とするすべてのフィールドを渡し、エージェントコンソール > ログで入力を確認してください。ガイダンスについては、エージェントが受け取るデータを参照してください。

トラブルシューティング

エージェントが指示やルールに従わないのはなぜですか？

可能な限り、肯定的で明確な指示を記述してください。エージェントに何をすべきかを伝え、制約事項は具体的な言葉で記述してください。例：「{{product_name}}が空の場合、提供されなかったものとして扱ってください。」

Operatorを使用してプロンプトを確認してください。Operatorは指示内容を順に確認し、エージェントがどこで逸脱した可能性があるかを説明します。

カタログエージェントが一部の行をスキップしたのはなぜですか？

カタログエージェントは、実行に必須と指定した列が空白または欠落している場合にその行をスキップします。例えば、まだ入力されていないgenderフィールドなどが該当します。入力列を選択した後、カタログフィールドの必須入力コントロールを有効にし、エージェントが実行される前に値が含まれている必要がある列を選択してください。選択された列はデフォルトで必須として設定されますが、呼び出しをブロックせずに空のままにできる列は削除できます。これにより、不完全なデータに対するトークンの無駄遣いを防ぐことができます。

エージェントは列の依存関係も尊重します。出力列が他の列に依存している場合（例えば、列Dが列Bと列Cの値を必要とする場合）、エージェントはその行のそれらの上流列にデータが入力されるまで実行されません。

詳細については、カタログエージェントのベストプラクティスを参照してください。

失敗したエージェントの呼び出しはクレジットを消費しますか？

失敗の種類によって異なります。

失敗	クレジットを消費しますか？
レート制限エラー	いいえ
モデル利用不可	いいえ
1日の呼び出し制限に到達	いいえ
タイムアウト	はい

詳細については、クレジットが消費されるタイミングを参照してください。

エージェントが複雑なタスクに苦戦しています。パフォーマンスを改善するにはどうすればよいですか？

エージェントが依頼したタスクに苦戦している場合は、サブエージェントアプローチを検討してください。例えば、3つのエージェントを使用して以下のように対応できます。

• エージェント1：受信した非構造化キャンバスコンテキストデータを標準化・変換します。
• エージェント2：アイテム詳細のカタログを参照し、関連する可能性のあるアイテムを特定します。
• エージェント3：各アイテムのさまざまな説明が含まれた別のカタログを参照し、ユーザーに最も関連性の高いアイテムの説明を特定してメールに挿入します。

カスタムエージェントが頻繁にタイムアウトする原因は何ですか？

カスタムエージェントは以下の場合にタイムアウトする可能性があります。

• エージェントの指示が不完全または矛盾している
• エージェントの指示がすべてのシナリオをカバーしていない、またはフォールバック条件が含まれていない（例：「すべての入力が空白の場合、’パーソナライズできませんでした’と出力してください」）
• エージェントの指示が出力タブで指定された出力形式と異なる出力形式を要求している（例：エージェントの指示が文字列を要求しているが、出力タブでは出力が数値として定義されている）
• エージェントのタスクが複雑すぎるため、サブエージェントアプローチの方が適している

タイムアウトを減らす方法

エージェントが頻繁にタイムアウトする場合は、より高いタイムアウト制限についてアカウントマネージャーに問い合わせる前に、以下を試してください。

• よりシンプルまたは低コストのモデルを選択する： 高速なモデルは通常、デフォルトのタイムアウト時間内に完了します。使用するモデルの決定を参照してください。
• 思考レベルを下げる（BYOモデルのみ）： 最小から開始し、出力品質が低下した場合のみレベルを上げてください。思考レベルを参照してください。
• プロンプトを簡素化する： 冗長な指示を削除し、例を短縮し、出力スキーマを絞り込んでください。Operatorを使用して指示を確認し、改善してください。
• 複雑なワークフローを複数のエージェントに分割する： ユースケースに複数のサブステップがある場合（例：インテントを分類してからコピーを生成する）、1つのエージェントですべてを処理するのではなく、キャンバスまたはカタログ内で別々のエージェントを順番に使用してください。サブエージェントアプローチを参照してください。

キャンバスステップエージェントの場合、呼び出しが失敗してもユーザーが出力を受け取れるように、エージェントコンソールでフォールバック値を設定してください。

テストではエージェントが正常に動作したのに、キャンバスで起動するとユーザー固有のデータを取得できないのはなぜですか？

エージェントがテスト中は正しく動作するが、ライブキャンバスでユーザー固有のデータを受信しない場合は、以下のトラブルシューティング手順を試してください。

• エージェントに受信させたいユーザー固有のデータが、エージェントの指示内でLiquid変数として入力されていることを確認してください。
• キャンバスコンテキストに重要なデータがある場合は、エージェント設定のすべてのキャンバスコンテキストを追加オプションを使用して、エージェントがキャンバスコンテキスト全体を受信するようにしてください。
• エージェントにアクセスさせたいキャンバスコンテキストが、キャンバスコンテキストとして保存されていることを確認してください。エージェントステップの前にコンテキストステップを使用して、このデータを保存してください。

コンプライアンス

エージェントコンソールはGDPR/CCPAに準拠していますか？

はい。顧客がBraze Autoモデル（Geminiを搭載）を使用する場合、GoogleはBrazeの復処理者として、顧客とBraze間のデータ処理補遺（DPA）の条件に従います。

エージェントコンソールはHIPAAに準拠していますか？

はい。Braze Autoモデルを使用する場合、Autoモデルを動かすGeminiを対象とした、Googleとの特定のHIPAA契約である業務提携補遺（BAA）を締結しています。

当社のBAAは、Braze Autoモデルを使用する顧客にのみ適用されます。顧客が自身のLLMキーを使用する場合、Brazeは顧客に代わってHIPAAの対象となる保護対象医療情報（PHI）をLLMに送信しません。顧客が直接送信します。この場合、BrazeとGoogle間のBAAは適用されません。顧客自身のLLMキーを通じたデータ処理は、顧客の契約およびLLMプロバイダーと直接締結しているBAAに準拠します。