Skip to content

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

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

全般

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

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

Autoモデルと持ち込み（BYO）モデルの利点の違いは何ですか？

Braze Autoモデルを使用する利点は以下のとおりです。

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

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

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

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

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

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

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

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

トラブルシューティング

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

オペレーターを使用して、エージェントが指示に従わない理由をトラブルシューティングすることを検討してください。オペレーターは、ステップバイステップの手順と詳細な説明を提供できます。

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

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

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

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

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

失敗の種類によります。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

コンプライアンス

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

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

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

はい。Braze Autoモデルを使用する場合、Autoモデルを支えるGeminiを対象とした、Googleとの特定のHIPAA契約であるBusiness Associate Addendum（BAA）を締結しています。

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