再利用可能な ITSM 仮想エージェントビルド済みトピックブロック
トピックブロックを再利用して、インシデントの作成や検索の実行など、ITSM 仮想エージェント Conversations の一般的な機能を実行します。
仮想エージェントデザイナー の [トピック] ページの [タイプ] リストを使用して、[トピックブロック] でソートします。トピックブロックの詳細については、「トピックブロックによるコードの再利用の最大化」を参照してください。
コンテキスト検索
| 名前 | 説明 |
|---|---|
| 入力パラメーター | |
| context | 検索コンテキスト (cxs_context_config) レコードの sys_id。検索に含まれるソースを定義します。たとえば、ソースにはナレッジベースまたはコミュニティを含めることができます。 |
| クエリ | 仮想エージェントの会話中にユーザーによって入力された検索キーワード。 |
| portal | サービスポータルやヒューマンリソース (HR) ポータルなど、会話が開始されたポータル。 このポータルは sp、esc、csm、および hr などの URL サフィックスで、ここから検索結果が開きます。 |
| kb_knowledge_base | ナレッジベース (kb_knowledge_base) レコードの sys_id。 コンテキスト内では、これらのナレッジベース記事のみを検索します。 |
| 出力パラメーター | |
| results_returned | 検索結果が見つかった場合は [True]、それ以外の場合は [False]。 |
| results_helpful | 検索結果が役に立ったとユーザーが回答した場合は [True]、それ以外の場合は [False]。 |
インシデントの作成
このトピックブロックは、[IT チケットのオープン] 会話トピックを開始します。
| 名前 | 説明 |
|---|---|
| 入力パラメーター | |
| caller | インシデント (incident) レコードを作成しているユーザーの名前。 |
| short_description | インシデント (incident) レコードに入力された簡単な説明。 |
| urgency | インシデント (incident) レコードに示されている緊急度レベル。 |
| 説明 | インシデント (incident) レコードに入力された説明。 |
| cmdb_ci | CMDB 構成アイテム |
| 出力パラメーター | |
| created_incident_sys_id | 新しく作成されたインシデントの返される sys_id。 |
MS Teams 会議リンクを作成 (廃止)
このトピックブロックは廃止されました。代わりに [MS Teams 会議リンクを取得] を使用してください。
ユーザーは 仮想エージェント を使用して Microsoft Teams 会議リンクを要求できます。このトピックブロックは、他のトピックに含めることができます。デフォルトでは、このトピックブロックはサイレントモードで実行し、出力メッセージは表示されません。
要件：Microsoft Teams Communication spoke (sn_msteams_com_spk) プラグイン
Zoom 会議リンクを作成
その他のアクションについては、[Zoom 会議のアクション] トピックブロックも使用できます。
ユーザーは 仮想エージェント を使用して Zoom 会議リンクを要求できます。このトピックブロックは、他のトピックに含めることができます。デフォルトでは、このトピックブロックはサイレントモードで実行し、出力メッセージは表示されません。
要件：Zoom spoke(com.sn.zoom.spoke) プラグイン
仮想マシンの説明
ユーザーは、仮想エージェントで [仮想マシンの管理] トピックを使用して、割り当てられた仮想マシン (VM) インスタンスの詳細を取得できます。詳細には、プロバイダー、リージョン、インスタンス ID などが含まれます。
- 説明する VM をユーザーが指定するか、ユーザーが選択できる利用可能な VM インスタンスのリストが仮想エージェントによって提供されます。
- 仮想エージェント は要求された VM の詳細を提供します。
- 追加の詳細を取得するには、提供されたリンクを選択します。このリンクからクラウドユーザーポータルにリダイレクトされます。
| 名前 | 説明 |
|---|---|
| 入力パラメーター： vm_name |
仮想マシンインスタンスの名前。 |
| 入力パラメーター： vm_sys_id |
cmdb_ci_vm_instance テーブルの仮想マシンインスタンスの Sys ID |
| 出力パラメーター： incident_short_description |
インシデントレコードの簡単な説明 (記録されている場合) |
パスワードリセット URL を表示
仮想エージェントでパスワードリセットが有効になっており、ユーザーが認証されている場合、このトピックブロックはパスワードリセットのリンクを返します。パスワードリセットが有効になっていない場合、ユーザーはサービスデスクに誘導されます。
このトピックブロックは 1 つの入力パラメーター unlock_account です。ユーザーが認証されている場合、値は true です。それ以外の場合、値は false です。
詳細については、「仮想エージェントのパスワードリセット」を参照してください。
このトピックブロックは 1 つの入力パラメーター unlock_account です。ユーザーが認証されている場合、値は true です。それ以外の場合、値は false です。
カタログアイテムを要求する
トピックブロックの詳細については、「仮想エージェントのサービスカタログ トピックブロック」を参照してください。
カタログアイテムの検索
トピックブロックの詳細については、「仮想エージェントの サービスカタログ トピックブロック」を参照してください。
仮想マシンを起動する
ユーザーは、[仮想マシンの管理] トピックを使用して、割り当てられた VM インスタンスを起動できます。VM が既に起動しているか、起動できない状態である場合、仮想エージェントはユーザーにその旨を通知します。
- 起動する VM をユーザーが指定するか、ユーザーが選択できる利用可能な VM インスタンスのリストが仮想エージェントによって提供されます。
- 仮想エージェントは要求された VM の起動時に、ユーザーに対してアクション可能通知を送信します。
仮想エージェントは、操作が失敗した場合にもユーザーに通知を送信します。
- ユーザーは、詳細を表示するか、仮想マシンにログインするための追加の指示を要求するか、通知をスキップするかを選択できます。
- ユーザーが追加のログイン指示を要求した場合、 仮想エージェント は指示を提供し、ユーザーはログインが成功したかどうかを確認できます。
| 名前 | 説明 |
|---|---|
| 入力パラメーター： vm_name |
仮想マシンインスタンスの名前。 |
| 出力パラメーター： incident_short_description |
インシデントレコードの簡単な説明 (記録されている場合) |
仮想マシンを停止する
ユーザーは、[仮想マシンの管理] トピックを使用して、割り当てられた VM インスタンスを停止できます。VM が既に停止しているか、停止できない状態である場合、 仮想エージェント はユーザーにその旨を通知します。
- 停止する VM をユーザーが指定するか、ユーザーが選択できる利用可能な VM インスタンスのリストが仮想エージェントによって提供されます。
- 仮想エージェントは要求された VM の停止時に、ユーザーに対してアクション可能通知を送信します。
仮想エージェントは、操作が失敗した場合にもユーザーに通知を送信します。
- ユーザーは、詳細を表示するか、通知をスキップするかを選択できます。
| 名前 | 説明 |
|---|---|
| 入力パラメーター： vm_name |
仮想マシンインスタンスの名前。 |
| 出力パラメーター： incident_short_description |
インシデントレコードの簡単な説明 (記録されている場合) |
仮想マシンを終了する
ユーザーは、[仮想マシンの管理] トピックを使用して、割り当てられた仮想マシン (VM) インスタンスを終了できます。VM が既に終了しているか、終了できない状態である場合、 仮想エージェント はユーザーにその旨を通知します。
- 終了する VM をユーザーが指定するか、ユーザーが選択できる利用可能な VM インスタンスのリストが仮想エージェントによって提供されます。
- 仮想エージェント は終了が要求された VM の詳細を提供します。
- 仮想マシンの終了は永続的なアクションであるため、ユーザーは操作を続行することを確認する必要があります。
- 要求された仮想マシンが終了すると、仮想エージェントはアクション可能通知をユーザーに送信します。
| 名前 | 説明 |
|---|---|
| 入力パラメーター： vm_name |
仮想マシンインスタンスの名前。 |
| 出力パラメーター： incident_short_description |
インシデントレコードの簡単な説明 (記録されている場合) |
Cisco Webex のトラブルシューティング
ユーザーは、一般的な Webex の問題に対する解決策を見つけることができます。このトピックブロックは、[コラボレーションアプリケーション] トピックで使用されます。
ユーザーが、問題についての静的ヘルプコンテンツに満足できない場合、AI 検索またはコンテキスト検索が代替になります。検索のタイプは、システムのプロパティ sn_itsm_va.fallback_search_option によって指定されます。
| 名前 | 説明 |
|---|---|
| 入力パラメーター | |
| issue | ユーザーアプリケーションの問題 |
| 出力パラメーター | |
| user_query | 代替検索に使用される問題の文字列 |
Microsoft Teams のトラブルシューティング
ユーザーは、一般的な Microsoft Teams の問題に対する解決策を見つけることができます。このトピックブロックは、[コラボレーションアプリケーション] トピックで使用されます。
ユーザーが、問題についての静的ヘルプコンテンツに満足できない場合、AI 検索またはコンテキスト検索が代替になります。検索のタイプは、システムのプロパティ sn_itsm_va.fallback_search_option によって指定されます。
| 名前 | 説明 |
|---|---|
| 入力パラメーター | |
| issue | ユーザーアプリケーションの問題 |
| 出力パラメーター | |
| user_query | 代替検索に使用される問題の文字列 |
Zoom のトラブルシューティング
ユーザーは、一般的な Zoom の問題に対する解決策を見つけることができます。このトピックブロックは、[コラボレーションアプリケーション] トピックで使用されます。
ユーザーが、問題についての静的ヘルプコンテンツに満足できない場合、AI 検索またはコンテキスト検索が代替になります。検索のタイプは、システムのプロパティ sn_itsm_va.fallback_search_option によって指定されます。
| 名前 | 説明 |
|---|---|
| 入力パラメーター | |
| issue | ユーザーアプリケーションの問題 |
| 出力パラメーター | |
| user_query | 代替検索に使用される問題の文字列 |
| ticket_description | IT チケットの作成に使用される問題の文字列 |
仮想マシン操作 AWS
ユーザーは Cloud Access Interface を使用して、Amazon AWS でプロビジョニングされた仮想マシンでアクションを実行できます。ユーザーに sn_managevm_va.cai_vm_user ロールが必要です。
このトピックブロックは、[仮想マシン管理 CAI] ビルド済みトピックで使用されます。使用可能なアクションには、停止、開始、終了、または 仮想マシンの説明があります。
仮想マシン操作 Azure
ユーザーは Cloud Access Interface を使用して、Microsoft Azure でプロビジョニングされた仮想マシンでアクションを実行できます。ユーザーに sn_managevm_va.cai_vm_user ロールが必要です。
このトピックブロックは、[仮想マシン管理 CAI] ビルド済みトピックで使用されます。使用可能なアクションには、停止、開始、終了、または 仮想マシンの説明があります。