ハンドブックを使用してエージェントを構築する

ハンドブックを使用してシャツの注文エージェントを構築してテストします。エージェントを使用して、店舗の場所を尋ねる、営業時間を確認する、シャツを注文するなどの操作を行います。

始める前に

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

ハンドブックについて

エージェントは 1 つ以上のハンドブックで構成されます。各ハンドブックには、明確に定義され、限定されたスコープがあります。次の表に、ハンドブックのデータを示します。

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

エージェントを作成する

エージェントを作成する手順は次のとおりです。

  1. https://conversational-agents.cloud.google.com にアクセスします。
  2. まだ作成していない場合は、プロジェクトを選択または作成します。
  3. [Create agent] をクリックします。
  4. [Build your own] をクリックする。
  5. エージェント名に「シャツのオーダー - プレイブック」と入力します。
  6. 場所を入力します。
  7. タイムゾーンを入力します。
  8. デフォルトの言語を入力します。
  9. [会話の開始] オプションで [ハンドブック] を選択します。
  10. [作成] をクリックします。
  11. ユーザー インターフェースに、[Default Generative Playbook] という名前のデフォルトの生成プレイブックが表示されます。
  12. [戻る] をクリックして、ハンドブックのリストに戻ります。

注文ハンドブックを作成する

注文ハンドブックはシャツの注文を処理します。

ハンドブックを作成するには:

  1. [作成] をクリックします。
  2. [タスク ハンドブック] オプションを選択します。
  3. ハンドブック名を入力します: Order。

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

    You are a shirt store ordering assistant. 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.

  5. 次の指示を入力します。

    - 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.

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

  7. [戻る] をクリックして、ハンドブックのリストに戻ります。

情報ハンドブックを作成する

情報ハンドブックは、ストアに関する質問を処理します。

ハンドブックを作成するには:

  1. [作成] をクリックします。
  2. [タスク ハンドブック] オプションを選択します。
  3. ハンドブック名を入力します: Information。

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

    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.

  5. 次の指示を入力します。

    - 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.

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

  7. [戻る] をクリックして、ハンドブックのリストに戻ります。

デフォルトのハンドブックを更新する

エージェントを初めて作成すると、デフォルトのハンドブックが作成されます。このハンドブックは、特定の目標を持つ適切なハンドブックに会話を誘導します。以下の手順は、デフォルトのハンドブックが他のハンドブックを参照する方法を示しています。

ハンドブックを更新するには:

  1. デフォルトのハンドブック（星印が付いているもの）をクリックします。

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

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

  3. 次の指示を入力します。

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

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

  5. まだ例がないため、ハンドブックの参照がハイライト表示されていることがわかります。これらは次のセクションで追加します。

  6. [戻る] をクリックして、ハンドブックのリストに戻ります。

例を示す

ハンドブックは機能しますが、例を提供することで、品質の高いレスポンスを確保できます。

ハンドブックが開いているときに、[例] タブから例を指定できます。ただし、エージェントと会話して、その会話を例として保存する方が簡単な場合がよくあります。

デフォルトのハンドブックの会話は短いものです。このハンドブックは、会話を別のハンドブックに転送する必要があります。

デフォルトのハンドブックと会話するには:

  1. 画面の右側に表示されているパネルを閉じるかキャンセルします。
  2. 上部のナビゲーションにあるシミュレーター ボタン をタップします。
  3. リソースとして、デフォルトのハンドブックを選択します。
  4. デフォルトのモデルを使用するか、別のモデルを選択します。
  5. [Enter user input] フィールドに「Hello」と入力し、Enter キーを押します。
  6. ハンドブックが挨拶メッセージで応答します。

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

  1. [呼び出し] リストでデフォルトのハンドブックを選択します。
  2. [例として保存] をクリックします。
  3. サンプル 編集パネルで、アクションを追加、編集、削除、並べ替えします。
  4. サンプル名として「Greeting」を入力します。
  5. 必要に応じてハンドブックの回答を更新します。
  6. [End example with output information] セクションの [Summary] フィールドに「The user is greeted.」と入力します。
  7. [保存] をクリックします。

情報ハンドブックに位置情報の例を追加します。

  1. 画面の右側に表示されているパネルを閉じるかキャンセルします。
  2. 必要に応じて、リセットの [restart_alt] ボタンで会話をリセットします。
  3. シミュレータの [Start Resource] メニューで、情報ハンドブックを選択します。
  4. 「Where are you located?」と入力して Enter キーを押します。
  5. [呼び出し] メニューで情報ハンドブックを選択します。
  6. [例として保存] をクリックします。
  7. サンプル名として「Location」と入力します。
  8. デフォルトのハンドブックの例のみがユーザー アクションで開始できるため、Where are you located? を含むアクションを削除します。
  9. [Summary of the preceding conversation] セクションを開き、[Starts example with input information] フィールドに「The customer asked "Where are you located?"」と入力します。
  10. [Summary of the playbook execution] セクションを開き、[End example with output information] フィールドに「The store is located at 1007 Mountain Drive, Gotham City, NJ.」と入力します。
  11. [保存] をクリックします。

情報ハンドブックに営業時間の例を追加します。

  1. シミュレーターで情報ハンドブックを選択します。
  2. メッセージ What are your hours? を入力します。
  3. 会話を Hours という名前の例として保存します。

次の手順に沿って、注文ハンドブックの選択例を追加します。

  1. サンプルに Selection という名前を付けます。
  2. 注文のハンドブックを選択します。
  3. 次のメッセージを送信します。
    • I want to buy a shirt
    • Large
    • Green
    • Yes

エージェントをテストする

これで、エージェントをテストする準備が整いました。シミュレータ パネルを開き、エージェントと会話します。前述の会話とは異なる会話を行うことができます。たとえば、このエージェントにシャツで入手可能な色を尋ねることができます。必要な結果が得られない場合は、例を改良または追加することで、レスポンスを改善できます。

API を使用してエージェントとやり取りする

API の操作の詳細については、API を使用した操作をご覧ください。

前へ
設定とクリーンアップ
次へ
フローを使用してエージェントをビルドする