注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

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

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

関数の入力

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

  • **userInput:**チャットボットが応答するユーザー入力の文字列です。

  • **sessionRid(任意):**現在のセッションを識別する、次の形式の文字列です。

    ri.aip-agents..session.{uuid}
    
    • チャットボットとの新しいセッションを開始するには、sessionRid の入力を空のままにします。空の文字列を指定せず、この入力自体を省略してください。
    • 既存のセッションを続行するには、そのセッションの RID を値として指定します。
    • この RID は、関数を実行するたびに返されます。
  • アプリケーションの状態に使用されるすべてのアプリケーション変数が、任意の入力として追加されます。これらの変数を使用して、アプリケーションの状態のデフォルト値を上書きできます。

    • オブジェクトセット変数のデフォルト値は、オブジェクトタイプの基準オブジェクトセットです。つまり、デフォルトでは、そのオブジェクトタイプのすべてのオブジェクトが含まれます。
    • 文字列変数のデフォルト値は、Chatbot Studio で表示および設定されます。

関数の出力

関数として公開されたチャットボットは、次の値を出力します。

  • **markdownResponse:**チャットボットが生成した最終的なテキストレスポンスです。Markdown 形式で記述されます。

  • **sessionRid:**現在のセッションを識別する、次の形式の文字列です。

    ri.aip-agents..session.{uuid}
    
    • この RID は、関数を実行するたびに返されます。
    • セッションを続行するには、次回の関数実行時にこの値を指定します。
  • アプリケーションの状態に使用されるすべてのアプリケーション変数が、任意の出力として追加されます。

    • これらの変数は、値が更新された場合にのみ値が出力されます。更新されなかった変数は空になります。

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

  1. Chatbot Studio でチャットボットを関数として公開するには、右上の公開ボタンの右側にある公開設定アイコンを選択します。設定を公開ダイアログが開きます。

    公開設定アイコン。

  2. Agent の関数を公開オプションをオンにすると、公開する関数の追加設定オプションが表示されます。

    「Agent の関数を公開」トグル。

  3. 展開された設定を公開ダイアログで、オントロジーを選択し、関数名、API名、説明などの関数の詳細を入力します。必要に応じて、バージョン設定の下にあるチェックボックスを選択すると、チャットボットの保存時に関数のマイナーバージョンをリリースできます。

    展開された公開設定ダイアログ。

  4. ダイアログの下部にある Agent と関数を公開を選択します。

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

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

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

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

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

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

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

作成したスイート。選択すると AIP Evals で開きます。

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

  • チャットボットとの新しいセッションを開始するには、sessionRid が null に設定されていることを確認してください。セッション RID が指定されている場合、チャットボットは既存のセッションを続行しますが、これはテスト時の意図とは異なる可能性が高い動作です。

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

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

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

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