SuperAPI AI 工具集

agent-workspace

办公与效率

查看项目

更新于 10-16 01:57

技能介绍

用途

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、用操作简化任务、延迟加载组件以优化性能、测试响应式布局以适配移动端。
  • 资料未提供收费、价格、平台版本要求、性能数据或效果保证等信息。