---
sourceDocument: Yokohama 対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama 対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# 仮想エージェント ビルド済みトピックブロック

# 仮想エージェント ビルド済みトピックブロック {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：13分

仮想エージェントは、トピック作成者またはアドミニストレーターがボットの会話で特定のプラットフォーム関連の機能またはタスクを実行するために使用できる、ビルド済みのトピックブロックを提供します。たとえば、特定のトピックブロックを使用すると、エージェントの可用性を確認したり、AI 検索 結果を生成したりできます。

## ビルド済みトピックブロックの概要 {#va-platform-topicblocks__section_qvl_5nx_nnb}

特定のビルド済みトピックブロックは、Glide 仮想エージェント (com.glide.cs.chatbot) プラグインおよび仮想エージェント Lite に自動的に含まれます。仮想エージェント Lite を使用している場合、トピックブロックへの読み取りアクセス権はありますが、トピックブロックを作成したり、呼び出し元トピックに追加したりすることはできません。

仮想エージェントデザイナーを使用してビルド済みトピックブロックを複製し、複製を変更することができます。トピックブロックの操作と、トピックブロックを呼び出し元トピックに追加する方法の詳細については、「[トピックブロックによるコードの再利用の最大化](https://servicenow-prod.fluidtopics.net/~vyK2Mi978JFAC~XK02cOg "トピックブロックは、仮想エージェント 会話で共通タスクと会話要素を実行するために作成できる再利用可能なコンポーネントです。トピックブロックは、トピックの作成およびメンテナンスのプロセスを簡素化するために、会話トピック内で標準的な手順やアクションを再利用できるようにします。")」および「[呼び出し元トピックまたはトピックブロックへの再利用可能なトピックブロックの追加](https://servicenow-prod.fluidtopics.net/z~izsY18VraNu69n3aySuA "呼び出し元トピックで特定の機能またはタスクを実行するために、再利用可能なトピックブロックをその呼び出し元 (親) トピックまたはトピックブロックに追加します。トピックブロックで使用される入力パラメーターを指定し、呼び出し元トピックで使用される出力パラメーターを指定します。")」を参照してください。  
次の各セクションでは、さまざまなタイプのプラットフォームトピックブロックを呼び出すための入力パラメーターと出力パラメーターについて説明します。トピックブロックの入力パラメーターは呼び出し元トピックから渡され、出力パラメーターはトピックブロックから呼び出し元トピックに返されます。  
注:  
デフォルトのトピックブロックへのアップグレードは、複製されたトピックブロックには適用されません。

## エージェントの可用性トピックブロック {#va-platform-topicblocks__section_sp4_c5h_rnb}

このトピックブロックを使用して、エージェントのハンドオフ会話で使用する、関連するライブエージェント情報を取得します。この情報には、エージェントの可用性、待機時間 (エージェントが利用可能になるまでの時間)、およびキュー情報が含まれます。エージェントの長い待機時間などの返された情報を使用して、ケースまたは顧客のコールバックを開始できます。

このトピックブロックには、高度な作業アサイン を含むエージェントチャット (com.glide.interaction.awa) プラグインが必要です。

次の表に、このトピックブロックの出力パラメーターを示します。  
{#va-platform-topicblocks__table_owp_3hn_wnb__entry__2}

| パラメーター | 説明 |
|-|-|
| agentAvailable | エージェントの可用性。このキューでエージェントが対応可能な場合、値は true です。それ以外の場合、値は false です。 |
| supportQueue | 会話に関連付けられたキューの sys_id。エージェントが対応できない場合、または関連するキューがない場合、値は null です。 |
| waitingTime | キューの待機時間の平均数値。エージェントが対応できない場合、値は null です。 |
[表 : 1. エージェントの可用性の出力パラメーター]

{#va-platform-topicblocks__table_owp_3hn_wnb}

## 転送トピックブロック {#va-platform-topicblocks__section_srk_1lb_lpb}

仮想エージェントの会話トピックで転送トピックブロックを使用して、仮想エージェントが解決に役立った、または実際に解決したユーザーの問題を追跡します。

たとえば、ビルド済みの自動解決仮想エージェントトピックは、転送トピックブロックを使用して転送を追跡します。詳細については、「[転送トピックブロックを使用した 仮想エージェント での転送のトラッキング](https://servicenow-prod.fluidtopics.net/mhUhXMzyT5b2pNXz0R0bWQ "ServiceNow 仮想エージェント でビルド済みの転送トピックブロックを使用して、仮想エージェントが解決に役立った、または実際に解決したユーザーの問題を追跡します。インシデント回避パターンとメトリクスは、 仮想エージェントの有効性を最適化および分析するのに役立ちます。")」を参照してください。

次の表に、このトピックブロックの入力パラメーターを示します。  
{#va-platform-topicblocks__table_pzw_vlb_lpb__entry__2}

| パラメーター | 説明 |
|-|-|
| 転送構成 | 転送パターンのグループ。 |
| 転送パターン | 選択した転送構成の転送パターン。 |
| アクティビティテーブル | 転送アクティビティが発生するテーブル。このテーブルは、プライマリアクティビティテーブルに関連付けられています。詳細については、「[転送の構成とパターンの作成](https://servicenow-prod.fluidtopics.net/cIqqpDRXemlw75KODCeHmA "転送設定を設定して、仮想エージェントの会話トピックの転送トピックブロックにマップできる転送構成と転送パターンを作成します。これらの転送は、仮想エージェントが解決に役立った、または実際に解決したユーザーの問題の追跡に役立ちます。")」を参照してください。 |
| アクティビティ ID | カンマ区切りのアクティビティSys ID のリスト。たとえば、インシデント ID やタスク ID などです。AI 検索 またはコンテキスト検索トピックブロックからの出力を追加して、転送の発生および同じ転送の原因となったコンテンツの間にリンクを作成することもできます。 |
[表 : 2. 転送入力パラメーター]

{#va-platform-topicblocks__table_pzw_vlb_lpb}

## 「FAQ 会話ビルダー」トピックブロック {#va-platform-topicblocks__section_z21_rr3_rnb}

このトピックブロックを使用して、既存の FAQ コンテンツを使用するボット会話をビルドします。このトピックブロックを利用すると、FAQ テンプレートで公開されている既存の[ナレッジ記事](https://www.servicenow.com/docs/access?context=knowledge-article-templates&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)を使用するか、[スプレッドシート](https://www.servicenow.com/docs/access?context=t_TranslateTheInterface&version=yokohama&pubname=yokohama-platform-administration&section=t_ImportATranslationFromExcel&ft:locale=en-US)などのソースからインポートされた Q\&A データを使用して、トピック作成者による簡単な会話のビルドを可能にできます。

FAQ 会話ビルダートピックブロックでは、[コンテキスト検索](https://www.servicenow.com/docs/access?context=configuring-contextual-search&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)を使用して、FAQ コンテンツ内の適切な一致を検索します。FAQ コンテンツは、要求者ロール、アクセス権、およびコンテキストに基づいてアクセス制御されます。

FAQ ナレッジテンプレートを使用するには、[高度なナレッジ管理](https://www.servicenow.com/docs/access?context=activate-knowledge-advanced-plugin&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US) プラグインをアクティブ化します。  
注:  
会話で返される FAQ スニペットのデフォルトの長さは 400 文字です。スニペットの長さには、スニペットで使用される HTML タグとリンクが含まれます。スニペットの長さを変更するには、com.glide.cs.faq.display_size システムプロパティの値を変更します。指定された長さが適用されるだけでなく、スニペット内の単語やリンクが任意に切り捨てられるのを防ぐワードラップロジックが適用されます。

次の表に、このトピックブロックの入力パラメーターと出力パラメーターを示します。  
{#va-platform-topicblocks__table_w2b_vpq_wnb__entry__2}

| パラメーター | 説明 |
|-|-|
| クエリ | トピックブロックに渡される検索用語またはフレーズ。\[入力変数\] または \[スクリプト変数\] を選択します。 |
| portal | 検索のコンテキスト。\[入力変数\] または \[スクリプト変数\] を選択します。 |
| kb_knowledge | 検索用のナレッジベース。\[入力変数\] または \[スクリプト変数\] を選択します。 |
[表 : 3. FAQ 会話ビルダーの入力パラメーター]

{#va-platform-topicblocks__table_w2b_vpq_wnb}  
{#va-platform-topicblocks__table_pwq_5rq_wnb__entry__2}

| パラメーター | 説明 |
|-|-|
| Results_Returned | クエリから結果が返されたかどうかを示すブール値。 |
| Results_Helpful | 結果が役に立ったとユーザーが判断したかどうかを示すブール値。 |
[表 : 4. FAQ 会話ビルダーの出力パラメーター]

{#va-platform-topicblocks__table_pwq_5rq_wnb}

## 「フォームコンテンツポップアップ」トピックブロック {#va-platform-topicblocks__section_wkv_gjv_cxb}

このトピックブロックを使用して、チャットウィジェットからポップアップウィンドウでフォームを開きます。ユーザーが必要な情報を送信すると、レコードが仮想エージェントチャットウィンドウにカードとして表示されます。新しいレコードが作成されると、そのレコードの Sys ID がサーバーに送信され、仮想エージェントトピックにその情報が含まれるようになります。リンクからポップアップウィンドウを作成する方法については、「[スマートリンク設定を作成する](https://servicenow-prod.fluidtopics.net/ZuI5G0kXLg9hrHsdlyDtNQ "スマートリンクを作成して、URL を開く場所を指定します。たとえば、新しいブラウザーウィンドウ、新しいブラウザータブ、チャットウィンドウ、またはポップアップウィンドウで URL を開くことができます。")」を参照してください。  
{#va-platform-topicblocks__table_qcj_5pv_cxb__entry__2}

| パラメーター | 説明 |
|-|-|
| sysId | table パラメーターで指定されたテーブルから表示するレコードの Sys ID。特定のレコードが必要ない場合は、「<kbd class="ph userinput">-1</kbd>」と入力して新しいレコードを作成します。 |
| テーブル | クエリを実行するか、レコードを作成するテーブルの名前。 |
| 表示 | テーブル用に作成したビューの名前。指定しない場合は、デフォルトのビューが使用されます。 |
[表 : 5. 「フォームコンテンツポップアップ」トピックブロックの入力パラメーター]

{#va-platform-topicblocks__table_qcj_5pv_cxb}

## 「位置情報管理」トピックブロック {#va-platform-topicblocks__geolocation-topic-block-properties}

ユーザーが同意する場合は、このトピックブロックを使用して、ユーザーの場所に関する情報を取得します。会話でトピックブロックが呼び出される前に、ユーザーは自分の場所を知らせるかどうかを尋ねられます。たとえば、ユーザーには次のようなプロンプトが表示されます。図 : 1. ユーザー権限を確認するプロンプト  
ユーザーは、要求をブロックするか、自分の場所を知らせることを許可するよう選択できます。ユーザーが \[許可\] をクリックすると、次の例に示すように、後で自分の場所を共有するかどうかを尋ねられます。図 : 2. チャットでの位置情報管理の使用

次の表に、このトピックブロックの入力パラメーターと出力パラメーターを示します。  
{#va-platform-topicblocks__table_mtq_dsk_x4b__entry__2}

| パラメーター | 説明 |
|-|-|
| permissionPrompt (文字列) | ユーザーの場所を使用する許可を求めるテキスト。このテキストはユーザーに表示されます。 |
| isGeoPermissionGrantedForNextUse | 会話中にこの要求が複数回求められた場合に、ユーザーが位置座標を取得する許可を与えたかどうかを判別するブール値。変数は次のように設定できます。 * True：ユーザーがこのデバイスに対して許可を与えたため、許可のプロンプトを再度表示しません。 * False：ユーザーが許可を拒否したか、座標の取得を 1 回だけ許可したため、許可のプロンプトを表示します。 {#va-platform-topicblocks__ul_gpc_nks_x4b} |
[表 : 6. 位置情報管理入力パラメーター]

{#va-platform-topicblocks__table_mtq_dsk_x4b}  
{#va-platform-topicblocks__table_ycq_ksk_x4b__entry__2}

| パラメーター | 説明 |
|-|-|
| 緯度 | 緯度座標。 |
| 経度 | 経度座標。 |
| errormessage | エラーがある場合にエラーに関連付けられたメッセージ。 |
| errortype | トピックブロックから返される変数。エラーのタイプには次のようなものがあります。 * PERMISSION_DENIED * POSITION_UNAVAILABLE * TIMED_OUT * UNKNOWN_ERROR {#va-platform-topicblocks__ul_uxg_tms_x4b} |
| ステータス | トピックブロックから返される変数。ステータスは次のようになります。 * OK：場所の座標が正常に取得されました。 * ERROR：取得に失敗しました。 {#va-platform-topicblocks__ul_omx_cns_x4b} |
[表 : 7. 位置情報管理出力パラメーター]

{#va-platform-topicblocks__table_ycq_ksk_x4b}

## 「一時停止」トピックブロック {#va-platform-topicblocks__section_byv_5th_dpb}

このトピックブロックを使用して一時停止を作成し、会話のペースを制御します。エンドユーザーにとって、このフィードバックはシームレスであり、入力インジケーターとして表示されます。

たとえば、チャットでナレッジベースリンクのリストが生成された場合、エンドユーザーが情報を読む時間を確保できるように、会話の続行を遅らせたい場合があります。

簡単にアクセスできるように、一時停止トピックブロックがパレットの \[ユーティリティ\] セクションに表示されます。

次の表に、このトピックブロックの入力パラメーターを示します。  
{#va-platform-topicblocks__table_f5k_c5h_dpb__entry__2}

| パラメーター | 説明 |
|-|-|
| 秒 | チャットを続行するまでの待機秒数。許容最大値は 60 秒です。 入力した値が 30 秒 (デフォルト値) 以下の場合、ブロックはほぼリアルタイムで一時停止を解除します。入力した値が 30 秒を超える場合は、+30 秒の最大レイテンシーで一時停止が解除されることを想定しています。たとえば、値を 31 秒に設定した場合、一時停止を解除するのに (最大で) 61 秒かかることがあります。 |
[表 : 8. 一時停止入力パラメーター]

{#va-platform-topicblocks__table_f5k_c5h_dpb}

## AI 検索 トピックブロックの実行 {#va-platform-topicblocks__section_vdm_ryb_dxb}

注:  
Rome またはそれ以前のリリースからアップグレードする場合は、従来の AI 検索 トピックブロックを AI 検索 実行トピックブロックに置き換える必要があります。

このトピックブロックを使用して、会話で AI 検索 結果を生成します。このブロックは、仮想エージェントの AI 検索 アプリケーションによって制御されるため、呼び出し元トピックからの特定の入力パラメーターを必要としません。[チャットエクスペリエンス](https://servicenow-prod.fluidtopics.net/Zq_9XK9sMA3AUQPygCDAgQ "エンドユーザーが仮想エージェントとの会話を開始するコンテキストに基づいて、さまざまなチャットエクスペリエンスを作成します。")で設定されたデフォルトの 仮想エージェント Search アプリケーションと EVAM 構成は、AI 検索 結果が会話でどのように表示されるかを制御します。

仮想エージェントによる AI 検索 の使用方法の詳細については、「[AI 検索 によるユーザーエクスペリエンスの向上](https://servicenow-prod.fluidtopics.net/i83i747sefy8Y001vCk4Og "仮想エージェント は Now Platform AI 検索 アプリケーションを使用して、エンドユーザーに表示する関連トピックがない場合の代替としてボット会話で検索結果を返します。仮想エージェント は、トピック作成者がトピックの検索結果を生成するために使用できる AI 検索 実行トピックブロックも提供します。")」を参照してください。仮想エージェントのチャットエクスペリエンスとその設定方法の詳細については、「[仮想エージェントユーザーのチャットエクスペリエンスの設定](https://servicenow-prod.fluidtopics.net/Zq_9XK9sMA3AUQPygCDAgQ "エンドユーザーが仮想エージェントとの会話を開始するコンテキストに基づいて、さまざまなチャットエクスペリエンスを作成します。")」を参照してください。  
AI 検索 実行トピックブロックの特定の要素を制御できます。

* オプションで AI 検索 エクスペリエンスをカスタマイズ - デフォルトの 仮想エージェント Search アプリケーション構成ではなく、トピックブロックで使用するカスタム Search アプリケーション構成を作成することで、検索エクスペリエンスをカスタマイズできます。Search アプリケーション構成は、会話で返される検索結果を定義します。トピックブロックでのカスタム Search アプリケーション構成の使用の詳細については、「[仮想エージェントの会話のカスタム AI 検索 エクスペリエンスの作成](https://servicenow-prod.fluidtopics.net/UaETrYrZkXgm89sXYO0Ryw "AI 検索 トピックブロックを使用して、会話でカスタム AI 検索 エクスペリエンスを定義します。会話で返される AI 検索 結果を制御するためにトピックブロックで使用される Search アプリケーション構成を作成できます。または、Search アプリケーション構成を使用して、カスタムチャットエクスペリエンスで AI 検索 結果を制御することもできます。")」を参照してください。

  AI 検索 にデフォルトの 仮想エージェント 構成を使用するには、AI 検索 実行トピックブロックをトピックに追加するときに、\[トピックブロックのプロパティ\] シートで \[Search アプリケーションの構成\] フィールドを空のままにします。
* AI 検索 フローアクションタイムアウト値を指定 - トピックブロックの AI 検索 フローアクションは、10 秒で自動的にタイムアウトします。このフローアクションがタイムアウトするまでの時間の長さを変更するには、[システムプロパティを追加](https://www.servicenow.com/docs/access?context=t_AddAPropertyUsingSysPropsList&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US) com.glide.cs.fdih.atlassearch.timeoutし、次のフィールドを設定してタイムアウト値を変更します。 {#va-platform-topicblocks__table_xdm_ryb_dxb__entry__2}

  | フィールド | 値 |
  |-|-|
  | 名前 | システムプロパティ名を入力します：<kbd class="ph userinput">com.glide.cs.fdih.atlassearch.timeout</kbd> |
  | 説明 | このプロパティの説明を入力します：<kbd class="ph userinput">AI 検索アクションのタイムアウト (秒)</kbd> |
  | タイプ | <kbd class="ph userinput">[整数]</kbd> を選択します。 |
  | 値 | AI 検索 アクションがタイムアウトするまでの秒数を入力します。デフォルト値は 10 秒です。 |
  [表 : 9. com.glide.cs.fdih.atlassearch.timeout のシステムプロパティフィールド]

  {#va-platform-topicblocks__table_xdm_ryb_dxb}
{#va-platform-topicblocks__ul_wdm_ryb_dxb}

次の表に、このトピックブロックの入力パラメーターと出力パラメーターを示します。出力パラメーターには、トピックブロックによって返された変数を非アクティブにするオプションがあります。  
{#va-platform-topicblocks__table_ydm_ryb_dxb__entry__2}

| パラメーター | 説明 |
|-|-|
| search_term | 会話中にユーザーが入力したフレーズ。 |
[表 : 10. AI 検索 入力パラメーターの実行]

{#va-platform-topicblocks__table_ydm_ryb_dxb}  
{#va-platform-topicblocks__table_zdm_ryb_dxb__entry__2}

| パラメーター | 説明 |
|-|-|
| genius_results | 返される Genius 結果を識別する変数。 |
| 検索結果 (ページ) | 返される通常の検索結果 (マルチリスト出力) を識別する変数。 |
| search_metadata | 会話型アナリティクスでクリックのメトリクスに使用される検索結果メタデータ (使用する検索用語、クエリ言語など) を識別する変数。 |
[表 : 11. AI 検索出力パラメーターの実行]

{#va-platform-topicblocks__table_zdm_ryb_dxb}

## ランタイム言語検出トピックブロック {#va-platform-topicblocks__section_hvr_wnw_dsb}

このトピックブロックを使用して、会話中にユーザーの言語を検出し、言語が Now Platform でサポートされている場合は、会話の途中でその言語に切り替えます。  
たとえば、ゲストユーザーが現在の会話言語とは異なる言語でボットとやり取りしている会話では、このトピックブロックを使用して、言語を適宜変更できます。このトピックブロックにより、ボットは次のことができます。

* サポートされているすべての仮想エージェントチャネルで会話の言語を検出します。
* 言語が Now Platform でサポートされているかどうかを判断し、サポートされている場合は、検出された言語に切り替えるかどうかをユーザーに確認します。
* ユーザーが切り替えに同意した場合は、会話中に検出された言語に切り替えます。
{#va-platform-topicblocks__ul_lk5_c4w_dsb}

このトピックブロックを使用するには、仮想エージェント言語検出および翻訳プラグイン \[com.glide.cs.runtime_language_detection_translation\] をアクティブ化します。

次の表に、このトピックブロックの入力パラメーターを示します。  
{#va-platform-topicblocks__table_gbz_hpw_dsb__entry__2}

| パラメーター | 説明 |
|-|-|
| utterance (文字列) | ユーザーが入力したテキスト。 |
| 言語を変更 (ブール) | 次のことを行うメッセージをユーザーに表示するオプション： * ユーザーが別の言語で入力していることをボットが検出したことを示します。 * サポートされている言語で会話を続行するかどうかを尋ねます。ユーザーが「はい」と応答すると、会話はサポートされている言語に変わります。 {#va-platform-topicblocks__ul_uyk_5pw_dsb} |
[表 : 12. ランタイム言語検出入力パラメーター]

{#va-platform-topicblocks__table_gbz_hpw_dsb}