カスタムエージェントを作成する

カスタムエージェントの作成方法、開始前に準備すべき事項、そしてメッセージング、意思決定、データ管理の分野でそれらを活用する方法を学びます。より一般的な情報については、Brazeエージェントを参照してください。

前提条件

始める前に、以下が必要です。

• ワークスペースでエージェントコンソールにアクセスするための権限。このオプションが表示されない場合は、Braze管理者に確認してください。
• カスタムAIエージェントを作成および編集する権限。
• エージェントに何を達成させたいかについてのアイデア。Brazeエージェントは以下のアクションをサポートできます。
  • パーソナライズされたメッセージング： 件名、見出し、製品内コピー、その他のコンテンツを生成します。
  • ユーザールーティング： 行動、好み、またはカスタム属性に基づいてキャンバス内でユーザーをルーティングします。
  • データ管理： 値を計算し、カタログエントリをエンリッチし、プロファイルフィールドを更新します。

仕組み

エージェントを作成する際に、その目的を定義し、動作に関するガードレールを設定します。公開後、エージェントはBrazeにデプロイして、パーソナライズされたコピーの生成、リアルタイムの意思決定、カタログフィールドの更新を行うことができます。エージェントの構築中に下書きとして保存でき、ダッシュボードからいつでもエージェントを一時停止または更新できます。保存するたびに新しいバージョンが作成され、バージョン履歴タブで確認できます。

以下のユースケースは、カスタムエージェントを活用するいくつかの方法を紹介しています。

ユースケース	説明
顧客フィードバックの処理	ユーザーのフィードバックをエージェントに渡して、センチメントを分析し、共感的なフォローアップメッセージを生成します。高価値ユーザーの場合、エージェントはレスポンスをエスカレーションしたり、特典を含めたりすることがあります。
コンテンツのローカライズ	グローバルキャンペーン向けにカタログテキストを別の言語に翻訳したり、地域固有のチャネルに合わせてトーンや長さを調整したりします。たとえば、「Classic Clubmaster Sunglasses」をスペイン語で「Gafas de sol Classic Clubmaster」に翻訳したり、SMSキャンペーン向けに説明文を短縮したりできます。
レビューやフィードバックの要約	センチメントやフィードバックを新しいフィールドに要約します。たとえば、Positive、Neutral、Negativeなどのセンチメントスコアを割り当てたり、「ほとんどの顧客はフィット感が良いと述べていますが、配送が遅いと指摘しています」のような短いテキスト要約を作成したりします。

エージェントを作成する

ステップ1：エージェントタイプを選択する

エージェントを作成するには、まずエージェントタイプを選択します。

1. エージェントコンソールに移動します。
2. キャンバスステップエージェントまたはカタログエージェントを選択します。

ステップ2：エージェントの構築方法を選択する

エージェントを作成を選択し、次のいずれかのオプションを選択します。

• カスタムエージェント：白紙の状態からエージェントを構築します
• オペレーターでエージェントを作成のオプション：BrazeAI Operatorを使用して開始テンプレートを適用します

オペレーターを使用する場合は、次のステップに進む前に、チャットで変更内容を確認して承認してください。

ステップ3：詳細を設定する

次に、エージェントの詳細を設定します。

1. チームがその目的を理解できるように、名前と説明を入力します。
2. （オプション）エージェントをフィルタリングするためのタグを追加します。
3. エージェントが使用するモデルを選択します。
4. Braze Autoモデルを使用していない場合は、モデルの思考レベルを選択します。最小、低、中、高から選択できます。まず最小から始めて、エージェントの応答をテストし、必要に応じて調整することをお勧めします。
5. 1日の呼び出し上限を設定します。デフォルトでは250,000に設定されていますが、1,000,000まで引き上げることができます。1,000,000を超える上限に引き上げたい場合は、カスタマーサクセスマネージャーに連絡して詳細をご確認ください。テスト後の計画オーディエンスサイズに十分な上限を設定してください。上限が低すぎると、1日の上限エラーが発生します（クレジットは消費されませんが、フォールバック値が適用されるか、出力がnullのままになります）。

1日のアクションクレジットコスト上限フィールドは、このエージェントが1日に消費できるクレジットの最大数を指定します。Brazeは、選択したモデルのワークスペースごとの呼び出しあたりのクレジット比率（契約に基づき、クレジット比率ページに表示されます）に1日の呼び出し上限を掛けて計算します。モデルまたは呼び出し上限を変更すると、見積もりが更新されます。

コストを管理するには、1日の呼び出し上限を下げてください。自前のAPIキー（BYO）モデルの場合は、より低コストのモデルに切り替えるか、思考レベルを下げることもできます。Braze Autoは思考レベルの調整をサポートしていません。実際の使用状況は設定 > 請求 > クレジット使用量 > エージェントコンソールで追跡できます。

ステップ4：指示を記述する

エージェントに指示を与えます。オペレーターテンプレートを使用した場合は、事前入力された指示を確認し、必要に応じて編集してください。

予期しないシナリオやあいまいなシナリオでエージェントが何をすべきかの指示を含めてください。これにより、エージェントの混乱がエラーにつながるリスクを最小限に抑えられます。たとえば、エージェントに「ポジティブ」または「ネガティブ」のセンチメント値のみを求めるのではなく、判断できない場合は「不明」を返すように指示してください。

ベストプラクティスについては指示の記述を、エージェントへのプロンプトのインスピレーションについては例を参照してください。

コンテキストを追加する

+ エージェントコンテキストを選択して、エージェントが参照できるものを選択します。これには以下が含まれます。

• カタログフィールド：より正確な応答のために、エージェントにカタログデータへのアクセスを許可します。
• ナレッジソース：カタログを直接添付するよりも正確な検索のために、ナレッジソースを通じてエージェントにカタログデータへのアクセスを許可します。
• セグメントメンバーシップ：ユーザーが属するセグメントに基づいて、エージェントが応答をパーソナライズできるようにします。最大5つのセグメントを選択できます。
• ブランド・ガイドライン：エージェントが従うべきブランドボイスとスタイルガイドラインを参照します。たとえば、エージェントにジムの会員登録を促すSMSコピーを生成させたい場合、このフィールドを使用して、事前に定義した大胆でモチベーショナルなガイドラインを参照できます。
• すべてのキャンバスコンテキスト：このエージェントが呼び出されたときに、指示セクションで参照されていない変数を含む、ユーザーのすべてのキャンバスコンテキストデータを分析します。
• ユーザーインタラクションデータ：各ユーザーの最近のキャンペーンおよびキャンバスの開封、クリック、コンバージョンデータをエージェントに提供します。

ステップ5：出力を選択する

出力セクションでは、エージェントの出力を基本スキーマまたは高度なスキーマで整理および定義できます。オペレーターテンプレートを使用した場合は、事前入力された出力スキーマを確認し、必要に応じて編集してください。

最良の結果を得るには、出力セクションで指定する内容が、ステップ4で入力したエージェントの指示と一致していることを確認してください。たとえば、エージェントの指示で2つの文字列を持つオブジェクトが必要と記述した場合は、出力セクションでも2つの文字列を持つオブジェクトを指定してください。エージェントの指示と指定した出力が一致しない場合、エージェントが混乱したり、タイムアウトしたり、望ましくない出力を生成したりする可能性があります。

フォールバック値を設定する

フォールバック値はキャンバスステップエージェントでのみ使用できます。キャンバスステップエージェントの出力セクションでは、エージェントの呼び出しが失敗した場合（たとえば、LLMがタイムアウトしたり、無効なAPIキーエラーを返した場合）にBrazeが使用する値を定義できます。フォールバック値はパーソナライゼーションのデフォルトのように機能します。エージェントが実行できない場合でも、ユーザーに有用な出力を提供する静的な件名や短いメッセージを設定できます。

カタログエージェントは、エージェントコンソールでのフォールバック値の設定をサポートしていません。

キャンバスエージェントの場合、フォールバック値はLiquidテンプレートをサポートしているため、フォールバックテキストでユーザー属性やコンテキスト変数を参照できます。

フォールバックフィールドは、キャンバスステップエージェントの出力形式に応じて変化します。

出力形式	フォールバック設定
文字列、数値、またはブール値	単一のフォールバック値を入力します（Liquidをサポート）。
フィールド（高度なスキーマ）	エージェントの出力で定義された各フィールドにフォールバック値を入力します。
JSONスキーマ（高度なスキーマ）	BrazeがJSONスキーマを読み取り、各プロパティの入力フィールドを生成するため、キーごとにフォールバック値を定義できます。

フォールバック値を持つキャンバスステップエージェントがエージェントステップで実行されると、Brazeはユーザーごとにフォールバックをレンダリングし、nullの代わりに出力変数に格納します。フォールバック値を設定しない場合、失敗した呼び出しではキャンバスの出力が未設定（null）のままになります。

ランタイムの動作については、エラー処理とフォールバック動作を参照してください。

ステップ6：エージェントをテストする

プレビューペインは、設定画面内にサイドバイサイドパネルとして表示されるエージェントのインスタンスです。このセクションを使用して、エージェントの作成中や更新中にテストし、エンドユーザーと同様の方法で体験できます。このステップにより、期待どおりに動作していることを確認でき、本番稼働前に微調整する機会が得られます。

1. エージェントをテストフィールドに、サンプルの顧客データや顧客の応答など、エージェントが処理する実際のシナリオを反映したものを入力します。
2. ランダムユーザー、既存ユーザー、またはカスタムユーザーに対するエージェントの応答をプレビューします。
3. 応答をシミュレートを選択します。エージェントが設定に基づいて実行され、応答が表示されます。

出力を批判的な目で確認してください。以下の質問を検討してください。

• コピーはブランドに合っていますか？
• 判断ロジックは意図どおりに顧客をルーティングしていますか？
• 計算された値は正確ですか？

何か違和感がある場合は、エージェントの設定を更新して再度テストしてください。データなしや無効な応答などのエッジケースを含め、さまざまな入力を実行して、エージェントがシナリオ全体でどのように適応するかを確認してください。

ステップ7：エージェントを使用する

エージェントの準備が整いました！詳細については、エージェントのデプロイを参照してください。

オペレーターで構築されたエージェントテンプレート

オペレーターは、以下のエージェントコンソール開始テンプレートの指示、出力フィールド、コンテキストを事前設定できます。オペレーターでテンプレートを選択するか、名前を指定してオペレーターにテンプレートの適用を依頼してください。

キャンバスステップエージェントテンプレート

テンプレート	説明	出力例
パーソナライズドコピーライター	ユーザー属性、キャンバスコンテキスト、ブランドガイドラインからチャネル固有のメッセージコピーを生成します	メールの件名とプリヘッダー、プッシュのタイトルと本文
フィードバックアナリスト	自由記述のアンケートやサポートフィードバックを、キャンバス分岐用の構造化フィールドに解析します	感情、トピック、推奨される次のアクション
ジャーニールーター	プロファイルとジャーニーコンテキストに基づいて、各ユーザーを最も関連性の高いキャンバスパスに振り分けます	パス名または条件分岐ステップ用のブール値

カタログエージェントテンプレート

テンプレート	説明	出力例
説明文ライター	既存のカタログ列から短いマーケティング説明文を作成します	製品または送信先の説明
アイテムカテゴライザー	行データからカテゴリやタグを割り当てます	フィルタリングやおすすめ用のカテゴリラベル
ローカライゼーション翻訳者	文字数制限内でカタログ文字列をターゲットロケールに翻訳します	ロケールごとのローカライズされたテキスト

関連リソース

• エージェントのリファレンス
• よくある質問
• Braze ウェビナー：AI in Action: 3 new use cases for 1:1 personalization