エージェント アプリを作成する

プレビュー

このプロダクトまたは機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 一般提供前のプロダクトと機能は「現状のまま」ご利用いただけますが、サポートが制限される場合があります。 詳しくは、リリース ステージの説明をご覧ください。

このガイドでは、シンプルなシャツの注文エージェント アプリを作成してテストする方法を説明します。このエージェント アプリを操作するときに、店舗の場所や営業時間の問い合わせ、シャツの注文を行うことができます。

始める前に

このガイドを読む前に、次の手順を行ってください。

1. まだ行っていない場合は、Dialogflow の設定手順に沿って操作してください。

エージェント アプリについて

エージェント アプリは、1 つ以上のエージェントで構成されます。各エージェントには、明確に定義され、限定されたスコープがあります。エージェントには次のデータがあります。

X	項目
名前	エージェントの識別に使用される名前。
目標	目標とは、エージェントで達成すべき内容の概要です。
手順	手順とは、エージェントの目標を達成するために実行する必要がある手順の概要です。
例	例は、エンドユーザーとエージェント間の会話のサンプルです。これらの例は実質的に、LLM の数ショットのプロンプトの例です。

アプリケーションの作成

アプリケーションを作成するには:

1. Agent Builder コンソールに移動します。

   Agent Builder コンソール

2. コンソールのプルダウンからプロジェクトを選択します。

3. API をまだ有効にしていない場合は、利用規約を読んで同意し、[続行して API を有効にする] をクリックします。

4. [新しいアプリを作成] または [新しいアプリ] をクリックします。

5. [エージェント] を選択します。

6. アプリ名に「シャツのオーダー アシスタント」と入力します。

7. リージョンを選択します。

8. [作成] をクリックします。

9. ユーザー インターフェースに、[Default Agent] という名前のデフォルトのエージェントが表示されます。

10. [戻る] ボタンをクリックして、エージェントのリストを表示します。

オーダー エージェントを作成する

オーダー エージェントはシャツのオーダーを処理します。このエージェントを作成するには:

1. [作成] をクリックします。
2. 名前を入力します: Order。

3. 次の目標を入力します。

   You are a shirt store ordering agent. Help customers purchase shirts.
   Help the customer choose a size and color.
   The shirts come in small, medium, and large.
   The shirts can be red, green, or blue.
   

4. 次の手順を入力します。

   - If the customer has not provided a size, ask them to choose a size.
   - If the customer has not provided a color, ask them to choose a color.
   - Once the customer has selected a size and color for the shirt,
     repeat the selection to the customer, and ask them to confirm the selection.
   - Once the customer has confirmed their selection,
     let them know that the shirt is now ordered.
   - Do not provide prices or collect payment.
   - Do not collect the customer's name or address.
   

5. [保存] をクリックします。

   

6. [戻る] ボタンをクリックして、エージェント リストに戻ります。

情報エージェントを作成する

情報エージェントは、ストアに関する質問を処理します。 このエージェントを作成するには:

1. [作成] をクリックします。
2. 名前を入力します: Information。

3. 次の目標を入力します。

   You provide information about a shirt store.
   The store is open between 8 AM and 6 PM every day.
   The store is located at 1007 Mountain Drive, Gotham City, NJ.
   

4. 次の手順を入力します。

   - If the customer asks for the store location, provide them with the address.
   - If the customer asks for the store hours, provide them with the hours.
   

5. [保存] をクリックします。

6. [戻る] ボタンをクリックして、エージェント リストに戻ります。

デフォルトのエージェントを更新する

最初にアプリケーションを作成したときに、デフォルトのエージェントが作成されました。 このエージェントは、特定の目標を持つ適切なエージェントに会話を誘導する必要があります。以下の手順は、デフォルトのエージェントが他のエージェントを参照する方法を示しています。このエージェントを更新するには:

1. デフォルトのエージェントをクリックします。このエージェントのスターがハイライト表示されています。

2. 次の目標を入力します。

   You are an agent for a shirt store.
   Your name is "Samantha".
   Your job is to direct customers to other agents based on the customer's questions.
   

3. 次の手順を入力します。

   - If the customer hasn't been greeted yet, greet the customer,
     introduce yourself, and ask the user how you can help.
   - If the customer wants information about the store,
     route them to ${AGENT: Information}
   - If the customer wants to purchase a shirt,
     route them to ${AGENT: Order}
   

4. [保存] をクリックします。

5. [戻る] ボタンをクリックして、エージェント リストに戻ります。

例を示す

この時点で、エージェントは機能します。 ただし、品質の高いレスポンスを確保するために例を示す必要があります。

エージェントが開いているときに [例] タブから手動で例を指定できます。ただし、多くの場合、機能しているエージェントと会話して、会話を例として保存する方が簡単です。

デフォルトのエージェントを使用した会話の例は、短いものです。 このエージェントは、別のエージェントに転送する必要があります。 デフォルトのエージェントと会話するには:

1. 画面の右側に表示されているパネルを閉じるかキャンセルします。 [Send a message to see how your agent responds] を含むシミュレータ パネルを表示します。
2. デフォルトのエージェントを選択します。
3. モデルを選択します: gemini-pro。
4. [Enter user input] と表示されたテキスト ボックスに、「Hello」と入力して Enter キーを押します。
5. エージェントが挨拶メッセージで応答します。

この会話を例として保存するには、以下のようにします。

1. インターフェースの右上にある [サンプルを保存] ボタンをクリックします。
2. サンプルのエディタパネルが開きます。 このエディタを使用して、アクションを追加、編集、削除、並べ替えることができます。
3. サンプル名を指定します: Greeting。
4. 必要に応じてエージェントの応答を更新します。

5. [保存] をクリックします。

   

情報エージェントの場所の例を追加します。

1. 画面の右側に表示されているパネルを閉じるかキャンセルします。 必要に応じて、リセットの [restart_alt] ボタンで会話をリセットします。
2. 情報エージェントを選択します。
3. モデルを選択します: gemini-pro。
4. メッセージを入力します: Where are you located?。
5. エージェントがロケーションで応答します。
6. この会話を Location という名前の例として保存します。 デフォルトのエージェントの例のみがユーザー アクションで開始できるため、「Where are you located」を含むアクションは削除する必要があります。

情報エージェントの時間の例を追加します。

1. 上記の手順と似ていますが、メッセージ「What are your hours?」を入力し、例に Hours という名前を付けます。

オーダー エージェントの選択例を追加します。

1. 上記の手順と似ていますが、例に Selection という名前を付け、オーダー エージェントを選択して次のメッセージを送信します。

   • I want to buy a shirt
   • Large
   • Green
   • Yes

   

エージェント アプリをテストする

エージェント アプリのテストの準備が整いました。シミュレータ パネルを開き、エージェントと会話します。 上記と同じ会話を行う必要はありません。 たとえば、このエージェント アプリにシャツに使用できる色を尋ねることができます。期待する動作が得られない場合は、例を改良して新しい例を作成することで、レスポンスを改善できます。

API を使用したエージェント アプリの操作

API を使用した操作をご覧ください。