このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。

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

この記事では、Braze Agentsに関するよくある質問にお答えします。

一般

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

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

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

Operatorは、ダッシュボードで構築作業を行うお客様をサポートします。Braze Agentsは送信時に実行され、ユーザーごとに異なる結果を生成します。詳細については、コンテンツを生成するを参照してください。

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

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

Autoモデルと独自モデル (BYO) を使用する場合を比べたメリットは何ですか？

Braze Autoモデルを使用するメリットは次のとおりです。

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

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

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

エージェントの指示で条件付きLiquidステートメントを使用できますか？

いいえ。{% if %}ステートメントのようなLiquidブロックを記述しようとすると、検証エラーが発生する可能性があります。代わりに、プロンプト内で自然言語による説明を記述することで、エージェントがさまざまなシナリオに対応できます。

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

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

また、エージェントは必要なデータが欠けていても警告しません。プロンプトに含まれている内容だけで処理を進めます。エージェントの設定は、入力から出力までを意図的に設計するものとして扱ってください。エージェントが必要とするすべてのフィールドを渡し、エージェントのログタブで入力を確認してください。ガイダンスについては、エージェントが受け取るデータを参照してください。

トラブルシューティング

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

できるだけ、肯定的で明確な指示を書いてください。エージェントに何をすべきかを伝え、制限は具体的な言葉で示します。例: 「{{product_name}}が空の場合は、値が提供されなかったものとして扱ってください。」

プロンプトの確認にはOperatorを使用してください。Operatorは指示を順に確認し、エージェントがどこで想定と異なる動作をした可能性が高いかを説明します。

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

カタログエージェントは、実行に必須とマークした列が空白または欠落している行をスキップします。たとえば、genderフィールドが入力されていない場合です。入力列を選択した後、カタログフィールドで必須入力のコントロールを有効にし、エージェントの実行前に値が入っている必要がある列を選択します。選択した列はデフォルトで必須になりますが、空でもかまわない列は除外できるため、呼び出しがブロックされません。これにより、不完全なデータでトークンを無駄にすることを防げます。

エージェントは列の依存関係も考慮します。出力列が他の列に依存している場合 (たとえば、列Dに列Bと列Cの値が必要な場合)、その行で上流の列に値が入るまでエージェントは実行されません。

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

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

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

失敗の種類	クレジットを消費するか
レート制限エラー	いいえ
モデルが利用できない	いいえ
1日の呼び出し上限に到達	いいえ
タイムアウト	はい

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

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

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

エージェント1は、受信した非構造化のキャンバスコンテキストデータを標準化および変換します。
エージェント2は、アイテムの詳細を含むカタログを参照し、関連性がありそうなアイテムを特定します。
エージェント3は、各アイテムのさまざまな説明を含む別のカタログを参照し、メールに掲載するためにユーザーに最も関連性の高いアイテムの説明を特定します。

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

カスタムエージェントは、次のような場合にタイムアウトすることがあります。

エージェントの指示が不完全であるか、矛盾している
エージェントの指示がすべてのシナリオを網羅していない、またはフォールバック条件 (「すべての入力が空の場合は『Could not personalize』と出力する」など) が含まれていない
エージェントの指示が、出力タブで指定した形式とは異なる出力形式を求めている (たとえば、エージェントの指示では文字列を求めているのに、出力タブでは出力が数値として定義されている場合)
エージェントのタスクが複雑すぎるため、代わりにサブエージェントのアプローチを使った方がよい

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

エージェントが頻繁にタイムアウトする場合は、タイムアウト上限の引き上げについてアカウントマネージャーに問い合わせる前に、次のことを試してください。

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

注

タイムアウトは、エージェントが使用可能な出力を返さなかった場合でもBrazeクレジットを消費します。クレジットが消費されるタイミングを参照してください。

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

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

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

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

コンプライアンス

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

はい。顧客がBraze Autoモデル (Gemini搭載) を使用する場合、GoogleはBrazeのサブプロセッサーとして機能し、顧客とBrazeの間で締結されたデータ処理補遺 (DPA) の条件に従います。

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

はい。Braze Autoモデルを使用する場合、BrazeはAutoモデルを支えるGeminiを対象として、Googleとの間でHIPAAに関する個別の契約であるBusiness Associate Addendum (BAA) を締結しています。

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

ユーザーが削除されると、エージェントのログはどうなりますか？

ユーザープロファイルを削除すると、Brazeはエージェントのログからそのユーザーのコンテンツを編集削除します。これは、単一のユーザーを削除した場合、ユーザーのセグメントを削除した場合、ワークスペースを削除した場合に適用されます。

そのユーザーの各ログエントリで、Brazeは以下を置き換えるか消去します。

エージェントへの入力 (レンダリングされたLiquidやキャンバスのコンテキストを含む)
Brazeが入力に追加したプロファイルデータ
エージェントの出力とフォールバック値
ツール呼び出しの引数と出力

また、Brazeはユーザー IDも削除するため、そのユーザーでログを検索しても、これらのエントリは返されなくなります。エージェントの指示は変更されません。

ログエントリ自体は残るため、エージェントの呼び出し回数とクレジット使用量には引き続き含まれます。削除前にエクスポートされたログは変更されません。

New Stuff!