---
sourceDocument: オーストラリアの対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/conversational-interfaces
Release :
- australia
ft:locale :
- ja-JP
ft:publication_title :
- オーストラリアの対話型インターフェース
ft:clusterId :
- convint
bundleId :
- convint
workflow :
- Platform
---
# 仮想エージェント NLU のビルド済みトピックブロック
# 仮想エージェント NLU のビルド済みトピックブロック {#ariaid-title1}
* リリースバージョン: Australia
*
* 更新日 2026年03月12日
*
*  所要時間：12分
仮想エージェント は、トピック作成者またはアドミニストレーターがボットの会話で特定のプラットフォーム関連の機能またはタスクを実行するために使用できる、ビルド済みのトピックブロックを提供します。たとえば、特定のトピックブロックを使用すると、エージェントの可用性を確認したり、 AI 検索 結果を生成したりできます。
## ビルド済みトピックブロックの概要 {#va-platform-topicblocks__section_qvl_5nx_nnb}
特定のビルド済みトピックブロックは、Glide 仮想エージェント (com.glide.cs.chatbot) プラグインと 仮想エージェント Liteに自動的に含まれます。仮想エージェント Lite を使用している場合、トピックブロックへの読み取りアクセス権はありますが、トピックブロックを作成したり、呼び出し元トピックに追加したりすることはできません。
ビルド済みのトピックブロックを複製し、 仮想エージェントデザイナーを使用して複製を変更できます。トピックブロックの操作方法とトピックブロックを呼び出し元トピックに追加する方法については、「 [トピックブロックによるコードの再利用の最大化](https://servicenow-prod.fluidtopics.net/eOEMpcE9OyRH1eNfF2ybnw "トピックブロックは、 仮想エージェント 会話で共通のタスクと会話要素を実行するために作成できる再利用可能なコンポーネントです。トピックブロックは、会話トピック全体で標準的な手順またはアクションを再利用できるようにすることで、トピックの作成とメンテナンスのプロセスを簡素化します。") と [呼び出し元トピックまたはトピックブロックへの再利用可能なトピックブロックの追加](https://servicenow-prod.fluidtopics.net/ckeViHyRyK0yUwZG_GcVdA "再利用可能なトピックブロックを呼び出し元 (親) トピックまたはトピックブロックに追加して、呼び出し元トピックで特定の機能またはタスクを実行します。トピックブロックで使用される入力パラメーターを指定し、呼び出し元トピックで使用される出力パラメーターを指定します。")」を参照してください。
次のセクションでは、さまざまなタイプのプラットフォームトピックブロックを呼び出すための入力パラメーターと出力パラメーターについて説明します。トピックブロックの入力パラメーターは呼び出し元トピックから渡され、出力パラメーターはトピックブロックから呼び出し元トピックに返されます。
注:
デフォルトのトピックブロックへのアップグレードは、複製されたトピックブロックには適用されません。
## \[エージェントの可用性\] トピックブロック {#va-platform-topicblocks__section_sp4_c5h_rnb}
このトピックブロックを使用して、エージェントのハンドオフ会話で使用する、関連するライブエージェント情報を取得します。この情報には、エージェントの対応可能性、待機時間 (エージェントが利用可能になるまでの時間)、およびキュー情報が含まれます。エージェントの長い待ち時間などの返された情報を使用して、ケースまたは顧客のコールバックを開始できます。
このトピックブロックには、高度な作業アサイン を含む エージェントチャット (com.glide.interaction.awa) プラグインが必要です。
次の表に、このトピックブロックの出力パラメーターを示します。
{#va-platform-topicblocks__table_owp_3hn_wnb__entry__2}
| パラメーター | 説明 |
|-|-|
| エージェント対応可能 | エージェントの可用性。このキューでエージェントが対応可能な場合、値は true です。それ以外の場合、値は false です。 |
| サポートキュー | 会話に関連付けられているキューのsys_id。エージェントが利用できない場合、または関連付けられたキューがない場合、値は null です。 |
| 待機時間 | キューの待機時間の平均数値。エージェントが利用できない場合、値は null です。 |
[表 : 1. エージェントの可用性出力パラメーター]
{#va-platform-topicblocks__table_owp_3hn_wnb}
## 転送トピックブロック {#va-platform-topicblocks__section_srk_1lb_lpb}
仮想エージェント会話トピックで転送トピックブロックを使用して、ユーザーにとって解決に役立った問題または実際に解決した問題仮想エージェント追跡します。
たとえば、ビルド済みの自動解決 仮想エージェント トピックは、転送トピックブロックを使用して転送を追跡します。詳細については、「[仮想エージェント で転送トピックブロックを使用して転送を追跡する](https://servicenow-prod.fluidtopics.net/2__FsLkNhDXe_Dco_zRWQg "ServiceNow 仮想エージェント でビルド済みの転送トピックブロックを使用して、仮想エージェントが解決に役立った、または実際に解決したユーザーの問題を追跡します。インシデント回避パターンとメトリクスは、 仮想エージェントの有効性を最適化および分析するのに役立ちます。")」を参照してください。
次の表に、このトピックブロックの入力パラメーターを示します。
{#va-platform-topicblocks__table_pzw_vlb_lpb__entry__2}
| パラメーター | 説明 |
|-|-|
| 転送構成 | 転送パターンのグループ。 |
| 転送パターン | 選択した転送構成の転送パターン。 |
| アクティビティテーブル | 転送アクティビティが発生するテーブル。このテーブルは、プライマリアクティビティテーブルに関連付けられています。詳細については、「[転送の構成とパターンの作成](https://servicenow-prod.fluidtopics.net/N7HsQTUEu4gL~SxGqMqNwg "転送設定を設定して、 仮想エージェント 会話トピックの転送トピックブロックにマッピングできる転送構成と転送パターンを作成します。これらの回避は、ユーザーにとって解決に役立った問題や実際に解決した問題を追跡 仮想エージェント 役立ちます。")」を参照してください。 |
| アクティビティ ID | カンマ区切りのアクティビティシステム 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=australia&pubname=australia-servicenow-platform&ft:locale=en-US) を使用するか、 [スプレッドシート](https://www.servicenow.com/docs/access?context=t_TranslateTheInterface&version=australia&pubname=australia-platform-administration§ion=t_ImportATranslationFromExcel&ft:locale=en-US)などのソースからインポートされた Q\&A データを使用して、トピック作成者が簡単な会話を構築できるようになります。
FAQ 会話ビルダートピックブロックは、 [コンテキスト検索](https://www.servicenow.com/docs/access?context=configuring-contextual-search&version=australia&pubname=australia-platform-administration&ft:locale=en-US) を使用して、FAQ コンテンツ内の適切な一致を検索します。FAQ コンテンツは、要求者ロール、アクセス権、およびコンテキストに基づいてアクセス制御されます。
FAQ ナレッジテンプレートを使用するには、 [高度なナレッジ管理](https://www.servicenow.com/docs/access?context=activate-knowledge-advanced-plugin&version=australia&pubname=australia-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/tedrwj1SIz0zhYMqCsAT2w "スマートリンクを作成して、URL を開く場所を指定します。たとえば、新しいブラウザーウィンドウ、新しいブラウザータブ、チャットウィンドウ、またはポップアップウィンドウで URL を開くことができます。")」を参照してください。
{#va-platform-topicblocks__table_qcj_5pv_cxb__entry__2}
| パラメーター | 説明 |
|-|-|
| sysId | tableパラメーターで指定されたテーブルから表示するレコードの Sys ID。特定のレコードが必要ない場合は、「 -1」を入力して新しいレコードを作成します。 |
| テーブル | レコードを照会または作成するテーブルの名前。 |
| 表示 | テーブル用に作成したビューの名前。指定しない場合は、デフォルトのビューが使用されます。 |
[表 : 5. フォームコンテンツポップアップトピックブロックの入力パラメーター]
{#va-platform-topicblocks__table_qcj_5pv_cxb}
## 位置情報管理トピックブロック {#va-platform-topicblocks__geolocation-topic-block-properties}
ユーザーが同意する場合は、このトピックブロックを使用して、ユーザーの場所に関する情報を取得します。会話でトピックブロックが呼び出される前に、ユーザーは自分の場所を知らせるかどうかを尋ねられます。たとえば、ユーザーには次のようなプロンプトが表示されます。図 : 1. ユーザー権限を確認するプロンプト
ユーザーは、要求をブロックするか、自分の場所を知らせることを許可するかを選択できます。ユーザーが \[許可\] をクリックすると、後で自分の場所を共有するかどうかを尋ねられます。
次の表に、このトピックブロックの入力パラメーターと出力パラメーターを示します。
{#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 | エラーがある場合にエラーに関連付けられたメッセージ。 |
| エラータイプ | トピックブロックから返される変数。エラーのタイプは次のとおりです。 * PERMISSION_DENIED * POSITION_UNAVAILABLE * TIMED_OUT * UNKNOWN_ERROR {#va-platform-topicblocks__ul_uxg_tms_x4b} |
| ステータス | トピックブロックから返される変数。ステータスは次のようになります。 * OK:位置座標が正常に取得されました。 * エラー:取得に失敗しました。 {#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/E3XN90BKKGP0JXwfGjjt~w "エンドユーザーが仮想エージェントとの会話を開始するコンテキストに基づいて、さまざまなチャットエクスペリエンスを作成します。")で設定されたデフォルトの 仮想エージェント Search アプリケーションと EVAM 構成は、AI 検索結果が会話でどのように表示されるかを制御します。
仮想エージェント でのAI 検索の使用方法については、「[AI 検索によるユーザーエクスペリエンスの向上](https://servicenow-prod.fluidtopics.net/QnAJWvI0HxyuIHBAQt062g "仮想エージェント は、エンドユーザーに表示する関連トピックがない場合に、 ServiceNow AI Platform AI 検索 アプリケーションを使用して代替としてボット会話の検索結果を返します。 仮想エージェント は、トピック作成者がトピック内の検索結果を生成するために使用できる [実行 AI 検索 トピックブロック] も提供します。")」を参照してください。仮想エージェントチャットエクスペリエンスとその構成方法の詳細については、「[仮想エージェントチャットエクスペリエンスのカスタマイズ](https://servicenow-prod.fluidtopics.net/E3XN90BKKGP0JXwfGjjt~w "エンドユーザーが仮想エージェントとの会話を開始するコンテキストに基づいて、さまざまなチャットエクスペリエンスを作成します。")」を参照してください。
\[実行 AI 検索 \] トピックブロックの特定の側面を制御できます。
* オプションで AI 検索 エクスペリエンスをカスタマイズ - デフォルトの 仮想エージェント Search アプリケーション構成ではなく、トピックブロックで使用するカスタム Search アプリケーション構成を作成することで、検索エクスペリエンスをカスタマイズできます。Search アプリケーション構成は、会話で返される検索結果を定義します。トピックブロックでのカスタム Search アプリケーション構成の使用の詳細については、「 [仮想エージェントの会話のカスタム AI 検索 エクスペリエンスの作成](https://servicenow-prod.fluidtopics.net/glmcLpV0gdAaEZsOlFz73Q "AI 検索 トピックブロックを使用して、会話でカスタム AI 検索 エクスペリエンスを定義します。会話で返される AI 検索 結果を制御するために、トピックブロックで使用される Search アプリケーション構成を作成します。または、Search アプリケーション構成を使用して、カスタムチャットエクスペリエンスで AI 検索 結果を制御することもできます。")」を参照してください。
AI 検索のデフォルトの仮想エージェント構成を使用するには、\[実行AI 検索トピック\] トピックブロックをトピックに追加するときに、\[トピックブロックのプロパティ\] シートの \[検索アプリケーション構成\] フィールドを空のままにします。
* AI 検索フローアクションのタイムアウト値を指定する - トピックブロック内のAI 検索フローアクションは、10 秒で自動的にタイムアウトします。このフローアクションがタイムアウトするまでの時間を変更するには、 [システムプロパティを追加](https://www.servicenow.com/docs/access?context=t_AddAPropertyUsingSysPropsList&version=australia&pubname=australia-platform-administration&ft:locale=en-US) com.glide.cs.fdih.atlassearch.timeout し、次のフィールドを設定してタイムアウト値を変更します。 {#va-platform-topicblocks__table_xdm_ryb_dxb__entry__2}
| フィールド | 値 |
|-|-|
| 名前 | システムプロパティ名を入力します: com.glide.cs.fdih.atlassearch.timeout |
| 説明 | このプロパティの説明を入力します: AI 検索アクションのタイムアウト (秒) |
| タイプ | 整 数を選択します。 |
| 値 | 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}
このトピックブロックを使用して、会話中にユーザーの言語を検出し、その言語が ServiceNow AI Platformでサポートされている場合は会話の途中でその言語に切り替えます。
たとえば、ゲストユーザーが現在の会話言語とは異なる言語でボットとやり取りしている会話では、このトピックブロックを使用して言語を適宜変更できます。このトピックブロックにより、ボットは次のことができます。
* サポートされているすべての 仮想エージェント チャネルで会話の言語を検出します。
* 言語が ServiceNow AI 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}