fsm-sidebar-summarization

サイドバーの要約

概要

このスキルは、ServiceNow Field Service Management を利用するフィールド技術者向けに、簡潔でモバイル端末に最適化されたサイドバー要約を生成します。サイドバー要約により、技術者は複数のレコードを開かなくても、現場で必要な情報をすばやく確認できます。

主な機能：

• 現在の作業オーダーまたはタスクのコンテキストを簡潔に要約します
• 重要な顧客情報、現場へのアクセス手順、連絡先を強調します
• 対象機器の資産サービス履歴と既知の問題を表示します
• SLA の残り時間と優先度をひと目で確認できる形式で表示します
• 安全上の注意事項、必要なツール、前提条件のチェックリスト項目を含めます
• 関連レコードやナレッジ記事へのクイックリンクを提供します

使用する状況： フィールド技術者がモバイル端末で作業オーダータスクを開き、作業を開始する前に、ジョブ、顧客、資産、安全面や作業上の注意事項に関する情報をすぐに確認したい場合。

前提条件

• ロール： wm_agent、wm_dispatcher、または wm_admin
• アクセス権： wm_order、wm_task、alm_asset、cmdb_ci、sys_journal_field、core_company、task_sla テーブルへの読み取りアクセス
• プラグイン： Field Service Management (com.snc.work_management) が有効であること
• コンテキスト： サイドバーの生成に使用する有効な作業オーダータスクの sys_id または番号

手順

ステップ 1：現在の作業オーダータスクを取得する

技術者が現在表示しているタスクレコードを取得します。

MCP を使用する場合：

Tool: SN-Get-Record
Parameters:
  table_name: wm_task
  sys_id: [TASK_SYS_ID]
  fields: sys_id,number,short_description,description,state,priority,urgency,work_order,assigned_to,assignment_group,location,cmdb_ci,asset,scheduled_start,scheduled_end,estimated_work_duration,estimated_travel_duration,sequence,work_notes_list,contact_type

REST API を使用する場合：

GET /api/now/table/wm_task/{TASK_SYS_ID}?sysparm_fields=sys_id,number,short_description,description,state,priority,urgency,work_order,assigned_to,assignment_group,location,cmdb_ci,asset,scheduled_start,scheduled_end,estimated_work_duration,estimated_travel_duration,sequence,contact_type&sysparm_display_value=true

ステップ 2：親作業オーダーのコンテキストを取得する

より広いコンテキストを確認するため、親作業オーダーを取得します。

MCP を使用する場合：

Tool: SN-Get-Record
Parameters:
  table_name: wm_order
  sys_id: [WORK_ORDER_SYS_ID]
  fields: sys_id,number,short_description,state,priority,category,subcategory,caller_id,company,location,opened_at,sla_due,cmdb_ci,asset,contact_type,follow_up

REST API を使用する場合：

GET /api/now/table/wm_order/{WORK_ORDER_SYS_ID}?sysparm_fields=sys_id,number,short_description,state,priority,category,subcategory,caller_id,company,location,opened_at,sla_due,cmdb_ci,asset,contact_type,follow_up&sysparm_display_value=true

ステップ 3：顧客と現場の情報を取得する

会社の詳細と現場固有の指示を取得します。

MCP を使用する場合：

Tool: SN-Query-Table
Parameters:
  table_name: core_company
  query: sys_id=[COMPANY_SYS_ID]
  fields: sys_id,name,street,city,state,zip,country,phone,notes,latitude,longitude
  limit: 1

場所固有の詳細を取得する場合：

Tool: SN-Query-Table
Parameters:
  table_name: cmn_location
  query: sys_id=[LOCATION_SYS_ID]
  fields: sys_id,name,full_name,street,city,state,zip,phone,contact,latitude,longitude,stock_room
  limit: 1

REST API を使用する場合：

GET /api/now/table/core_company/{COMPANY_SYS_ID}?sysparm_fields=sys_id,name,street,city,state,zip,phone,notes&sysparm_display_value=true

GET /api/now/table/cmn_location/{LOCATION_SYS_ID}?sysparm_fields=sys_id,name,full_name,street,city,state,zip,phone,contact,latitude,longitude,stock_room&sysparm_display_value=true

ステップ 4：資産のサービス履歴を取得する

対象の資産と最近のメンテナンス履歴を取得します。

MCP を使用する場合：

Tool: SN-Query-Table
Parameters:
  table_name: alm_asset
  query: sys_id=[ASSET_SYS_ID]
  fields: sys_id,display_name,asset_tag,serial_number,model,model_category,install_status,warranty_expiration,purchase_date,vendor,assigned_to,location
  limit: 1

資産の最近の作業履歴を取得します：

Tool: SN-Query-Table
Parameters:
  table_name: wm_order
  query: asset=[ASSET_SYS_ID]^sys_id!=[CURRENT_WO_SYS_ID]^ORDERBYDESCopened_at
  fields: number,short_description,state,category,opened_at,closed_at,resolution_code
  limit: 5

REST API を使用する場合：

GET /api/now/table/alm_asset/{ASSET_SYS_ID}?sysparm_fields=sys_id,display_name,asset_tag,serial_number,model,model_category,install_status,warranty_expiration,vendor&sysparm_display_value=true

GET /api/now/table/wm_order?sysparm_query=asset=[ASSET_SYS_ID]^sys_id!=[CURRENT_WO_SYS_ID]^ORDERBYDESCopened_at&sysparm_fields=number,short_description,state,category,opened_at,closed_at&sysparm_limit=5&sysparm_display_value=true

ステップ 5：SLA の状況を確認する

緊急度を把握するため、SLA 情報を取得します。

MCP を使用する場合：

Tool: SN-Query-Table
Parameters:
  table_name: task_sla
  query: task=[WORK_ORDER_SYS_ID]
  fields: sys_id,sla,stage,has_breached,planned_end_time,percentage,business_percentage
  limit: 5

REST API を使用する場合：

GET /api/now/table/task_sla?sysparm_query=task=[WORK_ORDER_SYS_ID]&sysparm_fields=sys_id,sla,stage,has_breached,planned_end_time,percentage,business_percentage&sysparm_limit=5&sysparm_display_value=true

ステップ 6：最近の作業メモを取得する

すぐに状況を把握できるよう、直近の作業メモを取得します。

MCP を使用する場合：

Tool: SN-Query-Table
Parameters:
  table_name: sys_journal_field
  query: element_id=[TASK_SYS_ID]^element=work_notes^ORDERBYDESCsys_created_on
  fields: value,sys_created_on,sys_created_by
  limit: 5

REST API を使用する場合：

GET /api/now/table/sys_journal_field?sysparm_query=element_id=[TASK_SYS_ID]^element=work_notes^ORDERBYDESCsys_created_on&sysparm_fields=value,sys_created_on,sys_created_by&sysparm_limit=5

ステップ 7：サイドバー要約を作成する

簡潔でひと目で確認できるサイドバー要約を作成します。

=== TASK SIDEBAR ===
[Task Number] - [Priority Badge]
[Short Description]
Status: [state] | ETA: [estimated_work_duration]

CUSTOMER:
[company_name]
[location_address]
Contact: [caller_name] | [phone]

ASSET:
[asset_name] | S/N: [serial_number]
Model: [model] | Warranty: [status]
Prior Service: [count] visits ([last_visit_date])

SLA: [time_remaining] remaining
[progress_bar_indicator]

LATEST NOTES:
- [most_recent_note_summary]
- [second_most_recent_summary]

CHECKLIST:
[ ] Verify site access
[ ] Confirm customer contact
[ ] Check parts inventory
[ ] Review safety requirements

ツールの使用方法

MCP ツールのリファレンス

ツール	使用する状況
SN-Natural-Language-Search	自然言語で検索する場合（例：「今日割り当てられた自分のタスクを検索」）
SN-Query-Table	タスク、資産、会社、SLA データを構造化クエリで取得する場合
SN-Get-Record	sys_id を指定してタスクまたは作業オーダーのレコードを直接取得する場合

REST API のリファレンス

エンドポイント	メソッド	目的
/api/now/table/wm_task	GET	現在のタスクの詳細
/api/now/table/wm_order	GET	親作業オーダーのコンテキスト
/api/now/table/alm_asset	GET	資産の詳細と保証
/api/now/table/cmdb_ci	GET	構成アイテムのデータ
/api/now/table/core_company	GET	顧客企業の詳細
/api/now/table/cmn_location	GET	現場の場所と住所
/api/now/table/task_sla	GET	SLA の遵守状況
/api/now/table/sys_journal_field	GET	最近の作業メモ

ベストプラクティス

• 簡潔にまとめる: サイドバーの概要は、モバイルデバイスで過度にスクロールせずに読めるようにします
• 行動に役立つ情報を優先する: 技術者がすぐに対応するために必要な情報を最初に示します
• 安全に関する警告を最初に表示する: 安全に関する注意事項はサイドバーの上部に表示します
• 資産の履歴を表示する: 過去のサービス訪問履歴があれば、技術者は再発する問題を予測しやすくなります
• 連絡先情報を含める: 技術者が顧客の連絡先情報をすぐに確認できるようにします
• SLAを視覚的に表示する: 生のタイムスタンプではなく、割合や残り時間のインジケーターを使います
• 可能であればキャッシュする: モバイル回線が遅い場合の遅延を防ぐため、サイドバーのデータを事前に取得します
• 不要な詳細は省く: 内部のエスカレーション履歴や管理者専用のフィールドは除外します

トラブルシューティング

「タスクレコードが見つかりません」

原因: タスクのsys_idが無効か、タスクが削除されています。 解決策: sys_idの形式を確認します。利用できる場合は、代わりに番号でwm_taskを検索します。タスクが別のレコードに統合されていないか確認します。

「タスクに資産がリンクされていません」

原因: 資産フィールドがタスク自体ではなく、親の作業指示にある可能性があります。 解決策: 親の作業指示のassetフィールドとcmdb_ciフィールドを確認します。一部の構成では、資産の参照が作業指示レベルにのみ保存されています。

「位置情報の座標がありません」

原因: 位置レコードに緯度と経度が入力されていません。 解決策: ナビゲーションには住所を使用します。地図連携に備えて位置レコードをジオコーディングするよう、FSM管理者に提案します。

「サービス履歴のレコードが多すぎます」

原因: 保守頻度の高い資産には、過去の作業指示が数百件ある場合があります。 解決策: 結果を直近5件の作業指示に絞り、件数を添えて要約します。日付フィルターを使って、最近の履歴（例：直近12か月）のみを表示します。

例

例1：HVAC保守タスクのサイドバー

シナリオ: 技術者が現場へ向かう途中、モバイルデバイスでタスクWMT0034521を開きます。

ステップ1 - タスクを取得:

Tool: SN-Get-Record
Parameters:
  table_name: wm_task
  sys_id: abc123def456
  fields: sys_id,number,short_description,state,priority,work_order,location,asset,scheduled_start,estimated_work_duration,estimated_travel_duration

生成されたサイドバー:

WMT0034521 - P3
Quarterly HVAC filter replacement and inspection
Status: Assigned | Work Est: 1.5 hrs

CUSTOMER:
Meridian Office Park
2100 Commerce Drive, Suite 400, Austin TX 78701
Contact: Robert Chen | (512) 555-0147

ASSET:
Carrier 50XC Rooftop Unit | S/N: CRR-2022-4401
Model: 50XC-A12 | Warranty: Active (exp Dec 2027)
Prior Service: 3 visits (last: Jan 15, 2026)

SLA: 6 hours remaining [=========>    ] 65%

LATEST NOTES:
- Mar 18: Filters pre-ordered, in tech's vehicle
- Mar 17: Customer confirmed 8 AM access available

CHECKLIST:
[ ] Badge required - check in at front desk
[ ] Roof access key from facilities manager
[ ] 2x MERV-13 filters loaded in van

例2：緊急の電気修理サイドバー

シナリオ: 技術者が製造施設で発生した緊急の電気系統の故障に対応するため、派遣されます。

WMT0034598 - P1 URGENT
Main distribution panel fault - partial power loss
Status: Accepted | Work Est: 3 hrs

CUSTOMER:
GlobalTech Manufacturing
8500 Industrial Blvd, Building C, Dallas TX 75247
Contact: Maria Santos (Plant Mgr) | (214) 555-0298

SAFETY WARNING:
High voltage equipment - PPE required
Lockout/tagout procedures mandatory

ASSET:
Eaton PRL4 Panel | S/N: ETN-2019-7782
Model: PRL4-Main-480V | Warranty: EXPIRED (Jun 2024)
Prior Service: 7 visits (last: Feb 28, 2026 - breaker trip)

SLA: 1.5 hours remaining [===============> ] 82%
RISK: SLA breach imminent

LATEST NOTES:
- Mar 19 09:15: Phase B showing intermittent faults
- Mar 19 08:45: Customer isolated affected circuits
- Mar 19 08:30: Dispatched as P1 emergency

CHECKLIST:
[ ] Arc flash PPE and insulated tools
[ ] Verify LOTO procedures with plant manager
[ ] Confirm backup power status
[ ] Multimeter and thermal imaging camera

関連スキル

• fsm/work-order-summarization - タスクと部品の詳細を含む、作業指示の完全な概要
• itsm/incident-lifecycle - 故障修理に関連するインシデント管理
• cmdb/impact-analysis - CIの保守による下流への影響を評価
• reporting/sla-analysis - SLAの追跡とコンプライアンスレポート