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

このガイドでは、Playbook を使用してシンプルなシャツの注文エージェントをビルドしてテストする方法について説明します。このエージェントを操作するときに、店舗の場所を尋ねる、営業時間を確認する、シャツを注文するといった操作が可能です。

始める前に

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

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

ハンドブックについて

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

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

エージェントを作成する

エージェントを作成するには:

  1. 会話エージェント コンソールに移動します。

    会話エージェント コンソール

  2. まだ作成していない場合は、プロジェクトを選択または作成します。

  3. [Create Agent（エージェントを作成）] をクリックします。

  4. [独自のビジュアリゼーションを作成] をクリックします。

  5. エージェント名に「シャツのオーダー - プレイブック」と入力します。

  6. ロケーションを指定します。

  7. タイムゾーンを指定します。

  8. デフォルトの言語を指定します。

  9. [会話の開始] オプションで [Playbook] を選択します。

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

  11. ユーザー インターフェースに、[Default Generative Playbook] という名前のデフォルトのハンドブックが表示されます。

  12. [戻る] ボタンをクリックすると、ハンドブックのリストが表示されます。

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

注文ハンドブックはシャツの注文を処理します。このハンドブックを作成するには:

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

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

    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.

  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 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 the user 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. シミュレータ パネルの左側で、デフォルトの Playbook を選択します。
  2. インターフェースの右上にある [サンプルを保存] ボタンをクリックします。
  3. サンプルのエディタパネルが開きます。 このエディタでは、アクションの追加、編集、削除、並べ替えを行うことができます。
  4. サンプル名を指定します: Greeting。
  5. 必要に応じて、プレイブックの回答を更新します。
  6. [作成] をクリックします。

情報プレイブックに場所の例を追加します。

  1. 画面の右側に表示されているパネルを閉じるかキャンセルします。
  2. 必要に応じて、リセットの [restart_alt] ボタンで会話をリセットします。
  3. シミュレーターで情報ハンドブックを選択します。
  4. メッセージを入力します: Where are you located?。
  5. ハンドブックがロケーションで応答します。
  6. この会話を例として保存する前に、「Where are you located」を含むアクションを削除する必要があります。デフォルトのハンドブックの例のみがユーザー アクションで開始できます。
  7. 会話を開始したコンテキストをサンプルに指定するには、[入力と出力] フィールドを開き、[入力情報でサンプルを開始] フィールドに The customer asked "Where are you located?" と入力します。
  8. 会話を完了するコンテキストをサンプルに提供するには、[出力情報を持つエンドサンプル] フィールドに The store is located at 1007 Mountain Drive, Gotham City, NJ. を入力します。
  9. サンプル名を指定します: Location。
  10. [作成] をクリックします。

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

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

注文ハンドブックの選択例を追加します。

  1. 上記の手順と似ていますが、例に Selection という名前を付け、注文ハンドブックを選択して次のメッセージを送信します。

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

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

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

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

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