IBM Cloud Docs
テンプレートからのアクションの作成

テンプレートからのアクションの作成

アクションの作成時に、解決しようとしている問題に関連するテンプレートを選択できます。 テンプレートは、ビジネス・ニーズに固有の項目を含めるようにアクションを調整するのに役立ちます。 各テンプレートの例は、アクションがどのように機能するかを学習するのにも役立ちます。

テンプレートは、会議の予約、サポート・チケットの作成、支払いなど、さまざまなユース・ケースで使用できます。 テンプレートには、アクションを構成するすべての部分 (ステップ、条件、および顧客の回答を収集するためのさまざまな応答タイプなど) が含まれています。

テンプレートは、英語のアシスタントでのみ使用できます。

これらの機能は、アクション・テンプレートに例として含まれています。

特徴
機能 説明 詳細情報
ステップの条件 ステップ条件は、ランタイム値に基づくブール・テストです。 このステップは、テストが true と評価された場合にのみ使用されます。 ステップへの条件の追加
オプション同義語 シノニムは、顧客が入力する可能性があるオプション値のバリエーションです。 オプション
カスタマイズされた応答の検証 顧客応答を予期するステップを編集するときは、検証エラーの処理方法をカスタマイズできます。 無効な回答を顧客がした場合
アクション変数 顧客がアシスタントに応答するときには、顧客自身に関する情報や顧客が望んでいることに関する情報が伝えられます。 アシスタントは、この情報、および会話に関するその他の情報を変数として記憶します。 変数を使用して会話情報を管理
セッション変数 特定のアクションに必ずしも関連付けられていない値は、セッション変数として保管できます。 セッション変数は長期メモリーです。セッション変数はユーザーとアシスタントの対話全体にわたって存続し、アシスタントは任意のアクションからセッション変数を参照できます。 変数を使用して会話情報を管理
正規表現応答タイプ 正規表現応答は、正規表現として表現されるパターンに一致するテキスト・ストリングを収集します。 この応答は、特定のパターンまたはフォーマット (E メール・アドレスや電話番号など) に準拠しなければならない値を取り込む場合に使用します。 Regex
はい/いいえ応答タイプ 確認応答では、ボタンとして「はい」または「いいえ」のいずれかを選択できます。 確認
エージェントにつなげる (Connect to agent) サポートされているサービス・デスク・システムの 1 つにアシスタントが統合されている場合は、必要に応じて会話をライブ・エージェントに転送するロジックを構築できます。 ライブ・エージェントへの接続
埋め込みビデオ ハウツー・デモンストレーション、プロモーション・クリップ、またはその他のビデオ・コンテンツを表示するためのビデオが含まれています。 Web チャットでは、動画の応答は埋め込み動画プレイヤーとしてレンダリングされます。 ビデオ応答の追加
URL で参照される顧客応答 アシスタントの出力で、顧客に固有の情報 (アカウント番号や E メール・アドレスなど) を含む、URL リンクをパーソナライズするための変数を参照できます。 変数の追加と参照
カスタマイズされたエージェントのハンドオフ情報 サポートされているサービス・デスク・システムの 1 つにアシスタントが統合されている場合は、必要に応じて会話をライブ・エージェントに転送するロジックを構築できます。 転送の一部としてアシスタントが表示するメッセージをカスタマイズできます。 ライブ・エージェントへの接続

テンプレートからのアクションの作成

テンプレートからアクションを作成するには:

  1. **「アクション」**ページを開きます。

  2. アクションがない場合は、 「新規アクションの作成」 を選択します。 既にいくつかのアクションがある場合は、 「新規アクション」 を選択します。

  3. 「アクションの作成」 で、 「テンプレートを使用したクイック・スタート」 を選択します。

    「アクションの作成」
    「アクションの作成」

  4. 「テンプレートを使用したクイック・スタート」 で、テンプレートをクリックすると、その機能の詳細が表示されます。 あるいは、チェック・ボックスをクリックして、すぐにテンプレートを選択することもできます。

    スターター・キット・テンプレートを選択した場合、これらのアクションでは、スターター・キットからアクションを追加する前に、カスタム拡張を追加する必要があります。 詳しくは、 スターター・キット拡張のセットアップ を参照してください。

    テンプレートを使用したクイック・スタート
    テンプレートを使用したクイック・スタート

  5. テンプレートの詳細を確認し、 「このテンプレートを選択」 をクリックします。

    「テンプレートの詳細」
    「テンプレートの詳細」

  6. 選択したテンプレートのリストには、選択したすべてのテンプレートが含まれています。 テンプレートは必要な数だけ選択できます。 考えが変わった場合は、ごみ箱アイコンをクリックして、リストからテンプレートを削除します。

    「選択されたテンプレート」
    「選択されたテンプレート」

  7. 準備ができたら、 「テンプレートの追加」 をクリックします。

  8. アクション・エディターでは、新しいアクションをそのまま使用することも、ユース・ケースに合わせて変更することもできます。

    「新規アクション」
    「新規アクション」

同じテンプレートから複数のアクションを作成できます。 例えば、 [会議の予約] テンプレートを使用してアクションを作成した場合は、そのテンプレートを再度選択できます。 最初のアクションの名前が [会議を予約] のままの場合、新しいアクションは [会議を予約 (1)] という名前で追加されます。

アクションのプレビュー

ほとんどのアクション・テンプレートは完了しています。 (スターター・キット・テンプレートにはアスタリスクのマークが付けられており、セットアップが必要です。) 変更を行わなくても、すぐにアクションを試すことができます。

テンプレートから作成したアクションをプレビューするには、以下のようにします。

  1. アクション・エディターで、 「プレビュー」 をクリックします。

  2. アシスタントがどのように応答するかを確認するには、 Customer starts with のいくつかのサンプル・フレーズを試してください。

    「プレビュー」
    「プレビュー」

スターター・キット拡張のセットアップ

スターター・キット・テンプレートは、 watsonx Assistantの外部のデータおよびシステムに接続するために拡張機能を使用できるアクションを追加します。 一般的な拡張機能について詳しくは、 カスタム拡張機能のビルド を参照してください。

最初に拡張機能をアシスタントに追加して、インストールされている拡張機能をスターター・キット・アクションで検出できるようにすることが重要です。 最初に拡張機能を追加せずにスターター・キット・アクションを追加しないでください。

この表には、各スターター・キット、拡張機能をセットアップするために必要な OpenAPI 仕様ファイルをダウンロードするためのリンク、およびセットアップ手順へのリンクがリストされています。

スターター・キット
スターター・キット OpenAPI 仕様ファイル セットアップ手順
Coveo 検索 coveo.openapi.json Coveo 検索のセットアップ
Google カスタム検索 google-custom-search-openapi.json Google カスタム検索のセットアップ
HubSpot hubspot.advanced.openapi.json HubSpot のセットアップ
NeuralSeek NeuralSeekのインスタンスに固有のファイルが必要です。 セットアップ手順を参照してください。 NeuralSeek 拡張のセットアップ
ServiceNow sn.openapi.json ServiceNow 拡張のセットアップ
Zendesk zendesk-openapi.json Zendesk 拡張機能のセットアップ

Coveo 検索拡張のセットアップ

Coveo 検索用に拡張機能をセットアップするには、 Coveo 検索拡張機能のセットアップ を参照してください。

Google カスタム検索拡張機能のセットアップ

Google カスタム検索の拡張機能をセットアップするには、 Google カスタム検索拡張機能のセットアップ を参照してください。

HubSpot 拡張のセットアップ

HubSpotの拡張をセットアップするには、以下のようにします。

  1. HubSpotでは、開発者アカウントを作成してから、専用アプリを作成する必要があります。 プライベート・アプリには、認証に必要なアクセス・トークンが含まれています。 詳しい手順については、 HubSpot Custom Extension スターター・キット GitHub リポジトリーの プライベート・アプリ・アクセス・トークンの取得 を参照してください。

  2. HubSpot アカウントにはカスタム・プロパティーが必要です。 HubSpot Custom Extension スターター・キット GitHub リポジトリーの Adding Custom Properties in HubSpot の説明に従ってください。

  3. OpenAPI 仕様ファイル hubspot.advanced.openapi.jsonをダウンロードします。

  4. アシスタントの 「統合 (Integrations)」 ページで 「カスタム拡張のビルド (Build custom extension)」 をクリックし、 OpenAPI 仕様ファイルを使用してカスタム拡張をビルドします。 カスタム拡張の作成に関する一般的な説明については、 カスタム拡張の作成 を参照してください。

  5. HubSpot カスタム検索拡張を作成し、それが 「統合」 ページに表示されたら、 「追加」 をクリックしてアシスタントに追加します。 HubSpot 専用アプリ・アクセス・トークンを使用して認証します。 カスタム拡張を追加する一般的な手順については、 アシスタントへの拡張の追加 を参照してください。

  6. **「アクション」**ページを開きます。

  7. アクションがない場合は、 「新規アクションの作成」 を選択します。 既にいくつかのアクションがある場合は、 「新規アクション」 を選択します。

  8. 「アクションの作成」 で、 「テンプレートを使用したクイック・スタート」 を選択します。

  9. 「テンプレートを使用したクイック・スタート」 で、 HubSpot スターター・キットを追加します。

NeuralSeek 拡張のセットアップ

NeuralSeekの拡張機能をセットアップするには、 NeuralSeek 拡張機能のセットアップ を参照してください。

ServiceNow 拡張のセットアップ

ServiceNowの拡張機能をセットアップするには、以下のようにします。

  1. ServiceNow Personal Developer インスタンスを要求します。 詳細な手順については、 個人用開発者インスタンスを参照してください。

  2. OpenAPI 仕様ファイル sn.openapi.jsonをダウンロードします。

  3. アシスタントの 「統合 (Integrations)」 ページで 「カスタム拡張のビルド (Build custom extension)」 をクリックし、 OpenAPI 仕様ファイルを使用してカスタム拡張をビルドします。 カスタム拡張の作成に関する一般的な説明については、 カスタム拡張の作成 を参照してください。

  4. ServiceNow 拡張を作成し、それが 「統合 (Integrations)」 ページに表示されたら、 「追加」 をクリックしてアシスタントに追加します。 ServiceNow 管理者のユーザー名とパスワードを使用して認証します。 デフォルトのインスタンス・サーバー変数を独自の変数に置き換えます。 カスタム拡張を追加する一般的な手順については、 アシスタントへの拡張の追加 を参照してください。

  5. **「アクション」**ページを開きます。

  6. アクションがない場合は、 「新規アクションの作成」 を選択します。 既にいくつかのアクションがある場合は、 「新規アクション」 を選択します。

  7. 「アクションの作成」 で、 「テンプレートを使用したクイック・スタート」 を選択します。

  8. 「テンプレートを使用したクイック・スタート」 で、 ServiceNow スターター・キットを追加します。

Zendesk 拡張機能のセットアップ

Zendesk の拡張機能をセットアップするには、以下の手順を実行します。

  1. Zendesk で、 Admin Center(例えば、 https://{server-domain}.zendesk.com/admin) を開きます。

  2. 「アプリと統合 (Apps and integrations)」 で、 「Zendesk API」 をクリックします。

  3. 「設定」 タブで、 「パスワード・アクセス」 を有効にします。

  4. OpenAPI 仕様ファイル zendesk-openapi.jsonをダウンロードします。

  5. アシスタントの 「統合 (Integrations)」 ページで 「カスタム拡張のビルド (Build custom extension)」 をクリックし、 OpenAPI 仕様ファイルを使用してカスタム拡張をビルドします。 カスタム拡張の作成に関する一般的な説明については、 カスタム拡張の作成 を参照してください。

  6. Zendesk 拡張機能を作成し、それが 「統合 (Integrations)」 ページに表示されたら、 「追加」 をクリックしてアシスタントに追加します。 Zendesk のユーザー名とパスワードを使用して認証します。 カスタム拡張を追加する一般的な手順については、 アシスタントへの拡張の追加 を参照してください。

  7. **「アクション」**ページを開きます。

  8. アクションがない場合は、 「新規アクションの作成」 を選択します。 既にいくつかのアクションがある場合は、 「新規アクション」 を選択します。

  9. 「アクションの作成」 で、 「テンプレートを使用したクイック・スタート」 を選択します。

  10. 「テンプレートを使用したクイック・スタート」 で、Zendesk スターター・キットを追加します。