このガイドでは、ハンドブックを使用して簡単なシャツの注文エージェントを作成し、テストする方法を説明します。 このエージェントを操作するときに、店舗の場所を尋ねる、営業時間を確認する、シャツを注文するといった操作が可能です。
始める前に
このガイドを読む前に、次の手順を行ってください。
- まだ行っていない場合は、 設定 手順に沿って操作してください。
ハンドブックについて
エージェントは、1 つ以上のハンドブックで構成されます。 各ハンドブックには、明確に定義され、限定されたスコープがあります。 ハンドブックには次のデータがあります。
| X | 項目 |
|---|---|
| 名前 | ハンドブックの識別に使用される名前。 |
| 目標 | 目標とは、ハンドブックで達成すべき内容の概要です。 |
| 手順 | 手順は、ハンドブックの目標を達成するために必要な手順の概要です。 |
| 例 | 例は、エンドユーザーとエージェント間の会話のサンプルです。これらの例は実質的に、LLM の数ショットのプロンプトの例です。 |
エージェントを作成する
エージェントを作成する手順は次のとおりです。
会話エージェント コンソールに移動します。
まだ行っていない場合は、プロジェクトを選択するか、新しく作成します。
[Create agent] をクリックします。
[Build your own] をクリックする。
エージェント名に「Shirt Ordering - Playbooks」と入力します。
場所を指定します location。
タイムゾーンを指定します。
[Conversation start] オプションで [Playbook] を選択します。
[作成] をクリックします。
ユーザー インターフェースに、[Default Generative Playbook] という名前のデフォルトのハンドブックが表示されます。
[戻る] ボタンをクリックすると、ハンドブックのリストが表示されます。
注文ハンドブックを作成する
注文ハンドブックはシャツの注文を処理します。このハンドブックを作成する手順は次のとおりです。
- [作成] をクリックします。
- [Task playbook] オプションを選択します。
- ハンドブック名「
Order」を入力します。 次の目標を入力します。
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.次の指示を入力します。
- 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.[保存] をクリックします。
[戻る] ボタンをクリックして、ハンドブックのリストに戻ります。
情報ハンドブックを作成する
情報ハンドブックは、ストアに関する質問を処理します。 このハンドブックを作成する手順は次のとおりです。
- [作成] をクリックします。
- [Task playbook] オプションを選択します。
- ハンドブック名「
Information」を入力します。 次の目標を入力します。
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.次の指示を入力します。
- 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.[保存] をクリックします。
[戻る] ボタンをクリックして、ハンドブックのリストに戻ります。
デフォルトのハンドブックを更新する
最初にアプリケーションを作成したときに、デフォルトのハンドブックが作成されました。 このハンドブックは、特定の目標を持つ適切なハンドブックに会話を誘導します。以下の手順は、デフォルトのハンドブックが他のハンドブックを参照する方法を示しています。 このハンドブックを更新する手順は次のとおりです。
- デフォルトのハンドブックをクリックします。このハンドブックにはハイライト表示された星があります。
次の目標を入力します。
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.次の指示を入力します。
- 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}[保存] をクリックします。
まだ例がないため、ハンドブックの参照がハイライト表示されます。 これらは次のセクションで追加します。
[戻る] ボタンをクリックして、ハンドブックのリストに戻ります。
例を示す
この時点で、ハンドブックは機能します。 ただし、品質の高いレスポンスを確保するために例を示す必要があります。
ハンドブックが開いているときに、[例] タブから手動で例を指定できます。 ただし、多くの場合、機能しているハンドブックと会話して、その会話を例として保存する方が簡単です。
デフォルトのハンドブックを使用した会話の例は、短いものです。 このハンドブックは、別のハンドブックに転送するだけで済みます。 デフォルトのハンドブックと会話する手順は次のとおりです。
- 画面の右側に表示されているパネルを閉じるかキャンセルします。
- 上部のナビゲーション行にあるシミュレータの ボタンをクリックします。
- リソースとして、デフォルトのハンドブックを選択します。
- デフォルトのモデルを使用するか、別のモデルを選択します。
- [ユーザー入力] と表示されたテキスト ボックスに、
Helloと入力して Enter キーを押します。 - ハンドブックが挨拶メッセージで応答します。
この会話を例として保存するには、以下のようにします。
- [Invocations] プルダウンでデフォルトのハンドブックを選択します。
- インターフェースの右上にある [例として保存] ボタンをクリックします。
- サンプルのエディタパネルが開きます。 このエディタを使用して、アクションの追加、編集、削除、並べ替えを行うことができます。
- サンプル名を指定します:
Greeting。 - 必要に応じてハンドブックのレスポンスを更新します。
- [End example with output information] までスクロールし、[Summary] セクションに「
The user is greeted.」と入力します。 - 保存アイコンをクリックします。
情報ハンドブックの位置情報の例を追加します。
- 画面の右側に表示されているパネルを閉じるかキャンセルします。
- 必要に応じて、リセットの [restart_alt] ボタンで会話をリセットします。
- シミュレータの [Start Resource] プルダウンで情報ハンドブックを選択します。
- メッセージ「
Where are you located?」を入力します。 - ハンドブックがロケーションで応答します。
- [Invocations] プルダウンで情報ハンドブックを選択します。
- [例として保存] ボタンをクリックします。
- サンプル名を指定します:
Location。 - この会話を例として保存する前に、「Where are you located」を含むアクションを削除する必要があります。 デフォルトのハンドブックの例のみがユーザー アクションで開始できます。
- 会話を開始したコンテキストの例を示すには、
[**Summary of the preceding conversation...**] セクションを開き、
次の情報を
[**Starts example with input information**] フィールドに入力します:
The customer asked "Where are you located?" - 会話を完了するコンテキストの例を示すには、[Summary of the playbook execution...] セクションを開き、[End example with output information] フィールドに「
The store is located at 1007 Mountain Drive, Gotham City, NJ.」と入力します。 - 保存アイコンをクリックします。
情報ハンドブックの時間の例を追加します。
- 上記の手順と似ていますが、メッセージ「
What are your hours?」を入力し、例にHoursという名前を付けます。
注文ハンドブックの選択例を追加します。
上記の手順と似ていますが、例に
Selectionという名前を付け、注文ハンドブックを選択して次のメッセージを送信します。I want to buy a shirtLargeGreenYes
エージェントをテストする
エージェントをテストする準備が整いました。 シミュレータ パネルを開き、エージェントと会話します。 上記と同じ会話を行う必要はありません。 たとえば、このエージェントにシャツで入手可能な色を尋ねることができます。 期待する動作が得られない場合は、例を改良して新しい例を作成することで、レスポンスを改善できます。
API を使用してエージェントとやり取りする
API を使用した 操作をご覧ください。