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

プレビュー

このプロダクトまたは機能には、サービス固有の利用規約の「一般的なサービス規約」の「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 を使用した操作をご覧ください。