データアクションを使用してガイドを外部サービスに接続する

前提条件

仮想エージェントが有効組織内で。詳細については、担当のカスタマーサクセスマネージャーにお問い合わせください。。
ガイド用の AI Studio 権限。必要な権限の詳細については、以下を参照してください。 AI Studioの権限。

データアクションにより、AI エージェントは外部データソースにアクセスし、取得したデータを使用してタスクを実行できるようになります。会話中に、AI エージェントは CRM データベースから、名前、住所、連絡先番号、アカウント番号、アカウントステータスなど、連絡先に関する関連情報を取得できます。

カスタムデータアクションの作成の詳細については、以下を参照してください。統合用のカスタムアクションを作成する。

データアクションを使用する

管理をクリックします。
下AIスタジオ、クリックガイド。
既存のガイドを開くか、新しいガイドを作成します。
の中で説明書タブで、データアクションを挿入する場所にカーソルを置き、「/」と入力します。
データアクションまたは変数を挿入するためのオプションを示すポップアップダイアログボックスが表示されます。
選択データアクション。ダイアログボックスに、使用可能なデータアクションが一覧表示されます。
必要なデータアクションを選択します。エディターはガイド内に存在する変数を青い下線で強調表示します。
データアクションの詳細を表示するには、データアクション名をクリックします。
右側のパネルが展開され、データアクションに関する情報が表示されます。クリックビュー特定のデータアクションを新しいブラウザタブで開くか、終わりパネルを閉じて説明タブに戻ります。

表示
保存するをクリックします。

メモ:

ガイドに含めることができるデータアクションの最大数は 5 です。
ガイドで使用できるデータアクションの入力パラメータの最大数は 4 です。
ガイド内のデータアクション呼び出しの数は、セッションあたりのデータアクション実行制限にカウントされます。

データアクションの可用性

ガイドではセキュアデータアクションは使用できません。
データアクションは、次のように構成されている場合、ガイドで選択できないことがあります。
- NULL値パラメータを持つデータアクション
- 4つ以上の入力パラメータを持つデータアクション
- 名前が正しくないデータアクション。データアクションの名前は、次の要件に準拠する必要があります。
  - 100文字未満にしてください
  - 英数字で始まる必要があります
  - 英数字、アンダースコア、ハイフンのみを含める必要があります
  - 連続したアンダースコアやハイフンを含めることはできません

注記：利用可能なデータアクションリストにデータアクションが表示されない場合は、ページを更新してみてください。利用可能なデータアクションのリストは、ページの読み込み時に取得されます。

データアクションのパラメータを使用する

ガイドでデータアクションの入力または出力パラメータを使用するには、パラメータの正確な名前を指定します。例:Save OrderStatus 。Architect にデータを送信したり、Architect からデータを受信したりする場合を除き、データアクションパラメータの変数を作成しないでください。

データアクションパラメータの変数を作成する必要がある場合は、システムがデータアクション出力をガイドの変数にマップできるように、ガイドにステップを追加します。例えば、Save OrderStatus as CustomerOrderStatus 。

説明書の作成とガイドの公開の詳細については、以下を参照してください。ガイドを書いて公開する。