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

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

始める前に

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

ハンドブックについて

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

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

エージェントを作成する

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

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

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

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

ハンドブックを作成する手順は次のとおりです。

  1. [作成] をクリックします。
  2. [Task playbook] オプションを選択します。
  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. [Task playbook] オプションを選択します。
  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. 上部のナビゲーションのシミュレータの [button] をタップします。
  3. リソースとして、デフォルトのハンドブックを選択します。
  4. デフォルトのモデルを使用するか、別のモデルを選択します。
  5. [ユーザー入力] フィールドに「Hello」と入力して Enter キーを押します。
  6. ハンドブックが挨拶メッセージで応答します。

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

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

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

  1. 画面の右側にあるパネルを閉じるか、キャンセルします。
  2. 必要に応じて、リセットの [reset] [restart_alt] ボタンで会話をリセットします。
  3. シミュレータの [Start Resource] メニューで情報ハンドブックを選択します。
  4. 「Where are you located?」と入力して Enter キーを押します。
  5. [Invocations] メニューで情報ハンドブックを選択します。
  6. [Save as example] をクリックします。
  7. 例の名前として「Location」と入力します。
  8. デフォルトのハンドブックの例のみがユーザー アクションで開始できるため、「Where are you located?」を含むアクションは削除します。
  9. [Summary of the preceding conversation] セクションを開き、 The customer asked "Where are you located?" を [Starts example with input information] フィールドに入力します。
  10. [Summary of the playbook execution] セクションを開き、The store is located at 1007 Mountain Drive, Gotham City, NJ. を [End example with output information] フィールドに入力します。
  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 を使用した操作をご覧ください。

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