用途
agent-workspace 用于构建 ServiceNow Agent Workspace 配置。Agent Workspace 为履行方(fulfiller)提供现代化、可配置的工作界面,本技能围绕该界面的各类配置对象展开,包括工作区、列表、表单、关联列表、UI 操作以及上下文侧边面板等。
架构与核心表
资料给出的工作区结构为:
- Workspace(sys_aw_workspace)
- Lists(sys_aw_list)
- Forms(sys_aw_form)
- Related Lists
- UI Actions
- Contextual Side Panel
- Agent Assist
- Related Records
- Activity Stream
关键表及其用途:
| 表 | 用途 |
|---|---|
| sys_aw_workspace | 工作区定义 |
| sys_aw_list | 列表配置 |
| sys_aw_form | 表单配置 |
| sys_aw_related_list | 关联列表配置 |
| sys_aw_action | 工作区 UI 操作 |
主要能力
创建工作区
使用 GlideRecord 对 sys_aw_workspace 初始化并设置名称、标题、描述、主表(primary_table)、URL 路径、图标、颜色、默认列表,以及 agent_assist_enabled、contextual_side_panel_enabled、activity_stream_enabled 等开关。资料标注此类脚本仅支持 ES5。
列表配置
针对 sys_aw_list 设置名称、表、所属工作区、过滤条件(filter)、列(columns)、排序(order_by、order_by_desc)、行操作(show_row_actions)以及可选分组(group_by)。
表单配置
针对 sys_aw_form 设置名称、表、工作区;以 JSON 数组定义分节(sections),每个分节可含 name、columns、fields 和 condition;同时可设置关联列表(related_lists)并启用 Agent Assist。
上下文侧边面板
针对 sys_aw_contextual_side_panel 设置工作区、表、名称,以 tabs 数组定义标签页(id、label、icon、component),并设置 default_tab。还给出自定义面板组件的服务端脚本示例:根据 input 中的 sys_id 与 table 读取记录,组装调用者信息 data.caller 与其未关闭工单 data.openIncidents。
Agent Assist
针对 sys_aw_agent_assist_config 设置工作区、表、名称、是否激活,以及推荐来源开关(show_knowledge、show_similar_incidents、show_solutions、show_macros)和知识搜索配置(knowledge_bases、knowledge_search_fields)。
相似记录查找
资料提供 SimilarIncidentFinder 脚本类示例,通过关键字提取、类别/子类别/CI 匹配计算相似度,筛选已解决或已关闭工单并按分数排序,返回前 5 条。相似度权重为:类别匹配 0.3、子类别匹配 0.2、CI 匹配 0.3、关键字重叠最多 0.2。
工作区 UI 操作
针对 sys_aw_action 设置名称、标签、工作区、表、action_type(form、list、both)、order、condition,以及客户端脚本(示例为打开模态框并回填解决代码与关闭备注)、图标和按钮样式。
使用方式
配置主要通过 GlideRecord 脚本写入相应 sys_aw_* 表完成。资料附带 MCP 工具集成说明:
| 工具 | 用途 |
|---|---|
| snow_artifact_manage | 查找工作区组件(action: "find") |
| snow_query_table | 查询工作区表 |
| snow_artifact_manage | 部署工作区组件(action: "create") |
| snow_execute_script | 测试工作区脚本 |
示例工作流包括:查询 sys_aw_workspace 获取工作区、查询 sys_aw_list 获取列表配置、通过 snow_execute_script 测试 SimilarIncidentFinder。
适用场景
- 为特定角色(如 IT 服务台坐席)配置专用工作区
- 定制列表过滤、列与排序
- 定制表单分节与关联列表
- 配置上下文侧边面板及自定义面板组件
- 启用并配置 Agent Assist 的知识与相似记录推荐
- 编写相似工单查找逻辑
- 添加工作区专用 UI 操作以简化常见任务
限制与注意事项
- 资料明确要求仅使用 ES5,不使用现代 JavaScript 语法。
- 最佳实践包括:按角色设计、优化列表过滤与列、侧边面板提供相关信息、启用 Agent Assist、用操作简化任务、延迟加载组件以优化性能、测试响应式布局以适配移动端。
- 资料未提供收费、价格、平台版本要求、性能数据或效果保证等信息。