関数としてのチャットボット

AIP Chatbot は関数として公開でき、プラットフォーム内の関数を実行できるあらゆる場所で使用できます。たとえば、ビルダーは AIP Chatbot を関数として公開することで、AIP Evals で評価したり、Automate でチャットボットのワークフローを自動化したり、Code Repositories でチャットボットを使用したりできます。チャットボットが公開されるたびに、または保存されるたびに、関数のバージョンが公開されるように設定できます。

関数の入力

関数として公開されたチャットボットは、次の入力を受け取ります。

userInput： チャットボットが応答するユーザー入力の文字列です。
sessionRid (任意)： 現在のセッションを識別する文字列で、次の形式を使用します。
```
ri.aip-agents..session.{uuid}
```
- チャットボットとの新しいセッションを開始するには、sessionRid の入力を空にします。空の文字列を指定せず、この入力自体を省略してください。
- 既存のセッションを継続するには、そのセッションの RID を値として指定します。
- この RID は、関数が実行されるたびに返されます。
アプリケーションの状態に使用されるすべてのアプリケーション変数は、任意の入力として追加されます。これらの変数を使用して、アプリケーションの状態のデフォルト値を上書きできます。
- オブジェクトセット変数のデフォルト値は、オブジェクトタイプのベースオブジェクトセットです。つまり、デフォルトではオブジェクトタイプ内のすべてのオブジェクトが含まれます。
- 文字列変数のデフォルト値は、AIP Chatbot で表示および設定されます。

関数の出力

関数として公開されたチャットボットの出力は、次のとおりです。

markdownResponse： チャットボットが生成した最終的なテキストレスポンスで、Markdown 形式になっています。
sessionRid： 現在のセッションを識別する文字列で、次の形式を使用します。
```
ri.aip-agents..session.{uuid}
```
- この RID は、関数が実行されるたびに返されます。
- セッションを継続するには、次の関数実行時にこの値を指定します。
アプリケーションの状態に使用されるすべてのアプリケーション変数は、任意の出力として追加されます。
- これらの変数の値は、更新された場合にのみ出力されます。更新されなかった変数は空になります。

チャットボットを関数として公開する

AIP Chatbot でチャットボットを関数として公開するには、右上の公開ボタンの右側にある公開設定アイコンを選択します。設定を公開ダイアログが開きます。
Agent の関数を公開オプションをオンにすると、公開される関数の追加の設定オプションが表示されます。
拡張された設定を公開ダイアログで、オントロジーを選択し、関数名、API名、説明などの関数の詳細を入力します。必要に応じて、バージョン設定の下にあるチェックボックスを選択し、チャットボットの保存時に関数のマイナーバージョンをリリースするように設定できます。
ダイアログの下部にある Agent と関数を公開を選択します。

公開後、チャットボットと関数が公開されたことを知らせるトースト通知が表示されます。この通知には、公開された関数を Ontology Manager で表示するためのリンクが含まれます。設定を公開を開き、公開された関数の下で関数を選択して表示することもできます。

チャットボットの関数公開を無効にする

関数の公開を無効にするには、設定を公開を開き、Agent の関数を公開オプションをオフにします。このオプションを無効にすると、再度有効にするまで、今後公開されるチャットボットのバージョンは関数として登録されません。このオプションはいつでも再度有効にできます。再度有効にした後に関数を公開するには、チャットボットを公開します。

AIP Evals でチャットボットを評価する

チャットボットを関数として公開すると、AIP Evals の評価スイートで評価できます。AIP Chatbot から評価スイートを作成するには、チャットボットが関数として公開されていることを確認してから、左側のツールバーにある評価タブを開きます。ここで評価スイートを作成するを選択すると、スイートの名前を入力し、チャットボットと同じプロジェクトを選択するためのダイアログが表示されます。

「評価」タブにある評価スイートを作成する選択肢。

評価スイートは、チャットボットと同じプロジェクト内に配置する必要があります。作成後に評価スイートを AIP Evals で開くには、作成したスイートの右側にある矢印アイコンを選択します。

作成されたスイートと、スイートを AIP Evals で開くために選択できる矢印アイコン。

AIP Evals でテストケースを設定する際は、次の点に注意してください。

チャットボットとの新しいセッションを開始するには、sessionRid が null に設定されていることを確認してください。セッション RID を指定すると、チャットボットは既存のセッションを継続しますが、通常、これはテスト時の意図に合いません。

評価スイートのテストケースで sessionRid を null に設定する選択肢。

オブジェクトセット変数は、null に設定するか、実際の値を含める必要があります。オブジェクトセット変数を空にすることはできません。

評価スイートのテストケースでオブジェクトセットを選択する選択肢。

評価スイートの詳細については、AIP Evals のドキュメントを参照してください。

←

PREVIOUSツール / AIP Chatbot Studioでコマンドをツールとして使用

NEXTセッションのログ記録

→