Skip to content

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

カスタムエージェントの作成方法、始める前に準備すべきこと、メッセージング、デシジョン、データ管理にわたってエージェントを活用する方法を学習する。一般的な情報については、Braze Agentsを参照のこと。

前提条件

開始する前に、次のものが必要になります。

  • ワークスペース内のエージェントコンソールにアクセスする。このオプションが表示されない場合は、Brazeの管理者に確認すること。
  • カスタムAIエージェントの作成・編集権限。
  • 代理人に何を成し遂げてほしいかのアイデア。Braze Agentsは以下のアクションをサポートできる：
    • メッセージングだ：件名、見出し、製品内コピー、その他のコンテンツを作成する。
    • 決断する：行動、好み、またはカスタム属性に基づいてキャンバスでユーザーをルーティングする。
    • データマネージャー：値の計算、カタログエントリの充実、プロファイルフィールドの更新を行う。

仕組み

エージェントを作成するとき、その目的を定義し、どのように振る舞うべきかのガードレールを設定する。本番稼動後、エージェントはパーソナライズされたコピーの生成、リアルタイムの意思決定、カタログフィールドの更新のためにBrazeに配備することができる。エージェントの一時停止や更新はダッシュボードからいつでもできる。

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

エージェントを作成する

ステップ 1: 設定内容

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

  1. ダッシュボードのAgent Console>Agent Managementに進む。
  2. エージェントの作成」を選択する。
  3. チームがその目的を理解できるように、名前と説明を入力する。
  4. (オプション）タグを追加してエージェントをフィルターする。
  5. インタラクションサイト（エージェントが配置されている場所）を選択する。エージェントが作成された後では、インタラクションサイトは更新できないことに注意。
  6. エージェントが使用するモデルを選択する。

Brazeでカスタムエージェントを作成するためのエージェントコンソールインターフェイス。画面には、エージェント名と説明を入力し、モデルを選択するフィールドが表示される。

ステップ 2:指示を書く

代理人に指示を出す。ガイダンスについては、代理店リファレンスを参照のこと。

ステップ 2.1: コンテキストを追加

Add contextを選択して、エージェントが参照できるものを選択する。これには以下が含まれます:

  • カタログフィールド：エージェントが参照するカタログフィールドを提供する。
  • セグメンテーションのメンバーである：メッセージをパーソナライズさせる際、ユーザーのセグメンテーションへの参加状況を考慮する。セグメンテーションは3つまで選択できる。
  • ブランド・ガイドラインエージェントが従うべきブランドボイスとスタイルガイドラインを参照する。例えば、ユーザーにジムの会員登録を促すSMSコピーをエージェントに生成させたい場合、このフィールドを使って、事前に定義した太字でやる気を起こさせるガイドラインを参照することができる。
  • キャンバスのコンテキスト変数：このエージェントが起動されたとき、ユーザーのすべてのキャンバスコンテキスト変数を分析する。

ステップ 2.2:オプション設定を追加する

オプション設定では、エージェントが生成したコピーの温度を調整できる。温度が高ければ高いほど、エージェントは提供された情報を使ってより創造的になることができる。

また、エージェントの1日の実行上限を設定することもできる。デフォルトでは、この値は50,000に設定されているが、100,000まで引き上げることができる。100,000を超える限度額の引き上げに興味がある場合は、カスタマー・サクセス・マネージャーに問い合わせを。

ステップ 3:出力を選択する

出力セクションでは、基本スキーマまたは詳細スキーマによって、エージェントの出力を整理し定義することができる。

基本スキーマ

基本スキーマはエージェントが返す単純な出力である。これは文字列、数値、ブーリアン、文字列の配列、数値の配列である。

例えば、製品を受け取った後の顧客の満足度を調べるために、簡単なフィードバック調査からユーザーのセンチメントスコアを収集したいとしよう。出力フォーマットを構成する基本スキーマとして、Numberを選択することができる。

基本スキーマとして番号が選択されたエージェントコンソール。

高度なスキーマ

高度なスキーマ・オプションには、手動でフィールドを構造化したり、JSONを使ったりするものがある。

  • フィールド:コードなしで、一貫して使用できるエージェント出力を強制する方法である。
  • JSONである：JSONスキーマの中で変数やオブジェクトをネストすることができる。

例えば、簡単なフィードバック調査の回答をフォーマットして、回答者があなたのレストランの最新のアイスクリームフレーバーを推薦する可能性を判断したいとしよう。以下のフィールドを設定して、出力フォーマットを構成することができる：

尤度スコア、説明、信頼度スコアの3つの出力フィールドを示すエージェントコンソール。

例えば、あなたのレストラン・チェーンで最近食事をしたユーザーのフィードバックを集めたいとしよう。出力形式としてJSONスキーマを選択し、以下のJSONを挿入することで、センチメント変数と推論変数を含むデータオブジェクトを返すことができる。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
  "type": "object",
  "properties": {
    "sentiment": {
      "type": "string"
    },
    "reasoning": {
      "type": "string"
    }
  },
  "required": [
    "sentiment",
    "reasoning"
  ]
}

ステップ 4: エージェントのテストと作成

プレビューペインは、コンフィギュレーションエクスペリエンス内でサイドバイサイドパネルとして表示されるエージェントのインスタンスである。エージェントの作成中や更新中のテストに使用し、エンドユーザーと同じように体験することができる。このステップを踏むことで、期待通りの動作が確認でき、本番前に微調整をするチャンスが得られる。

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

カスタムエージェントをテストするためのプレビューペインを示すエージェントコンソール。インターフェイスには、顧客データの例が表示されるサンプル入力フィールド、テスト実行ボタン、エージェント出力が表示されるレスポンシブエリアが表示される。

批判的な目でアウトプットを見直す。次の質問を考えてみよう：

  • コピーはブランドにふさわしいか？
  • 意思決定ロジックは意図した通りに顧客をルーティングしているか？
  • 計算値は正確か？

何かおかしいと感じたら、エージェントの設定を更新し、再度テストする。いくつかの異なる入力を実行し、エージェントがシナリオ間でどのように適応するか、特にデータなしや無効なレスポンスのようなエッジケースを確認する。

ステップ 5: エージェントを利用し、監視する

これでエージェントを使用する準備が整った！詳細については、エージェントのデプロイを参照のこと。

エージェントのログタブでは、キャンバスとカタログで発生した実際のエージェントコールを監視することができる。日付範囲、結果（成功か失敗か）、呼び出し場所などの情報でフィルターをかけることができる。

ストーリー・テラー・エージェントのログで、エージェントがいつ、どこで呼び出されたかを含む。

入力、出力、ユーザーIDを見るには、特定のエージェント・コールの[表示]を選択する。

ストーリーテラー諜報員のためのログ。詳細パネルには、入力プロンプト、出力レスポンス、関連するユーザーIDが表示される。
Github   GitHub でこのページを編集
New Stuff!