mcpField
S
service-omni-channel-limits-analyze

service-omni-channel-limits-analyze

github.com/forcedotcom其他1.1k57 次安装1 天前更新
代码仓库

关于 service-omni-channel-limits-analyze

此 Salesforce 技能通过受支持的客户组织 API 分析 Pending Service Routing 用量，适用于需要只读检查 Omni-Channel 限额的管理员。它报告实时计数，并明确标注无法通过 API 验证的值。

主要功能

  1. 01查询实时 Pending Service Routing 数量
  2. 02标注不可验证的比较值
  3. 03输出结构化 JSON 结果
  4. 04说明阻止分析的原因
  5. 05只读检查，不修改配置

适用场景

  1. 01检查组织当前的待处理服务路由数量
  2. 02区分实时数据与参考上限
  3. 03排查查询权限或对象不可用问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/forcedotcom/sf-skills --skill service-omni-channel-limits-analyze

安装后在 Claude Code 中输入/service-omni-channel-limits-analyze确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api-notes.md
scripts/
analyze.sh
scripts/tests/
_bootstrap.py
test_limits_analyze_contracts.py

详细介绍

service-omni-channel-limits-analyze

报告通过受支持的客户组织 API 可以安全获取的待处理服务路由使用情况。Salesforce 设置 → 全渠道 → 限制页面为只读页面，并且会显示无法通过 REST、Tooling、Metadata 或 Connect API 公开的内部值。此技能报告实时 PSR 数量，并明确标注所有无法通过 API 验证的值。

输入

bash scripts/analyze.sh <org-alias> [--routing-model enhanced|legacy] [--max-psrs <integer>]
  • org-alias 为必填项，且必须已通过 Salesforce CLI 完成身份验证。
  • --routing-model 默认为 enhanced。仅当未提供 --max-psrs 时，它才用于选择参考最大值。
  • --max-psrs 接受管理员提供的 1 到 1,000,000 之间的最大值。该值仍会标注为未经 API 验证。

运行

针对目标组织调用 scripts/analyze.sh，并使用其 JSON 结果获取实时数量、带标签的比较值、不可用的每小时值以及阻塞详情。脚本会在内部调用 sf org display 和 sf data query；不要在脚本之外重现其查询或计算逻辑。

更改后，如需验证随附脚本的约定，请运行 python3 scripts/tests/test_limits_analyze_contracts.py；测试模块会自动加载本地的 scripts/tests/_bootstrap.py fixture。

输出约定

脚本会输出一个 JSON 对象：

  • skill：service-omni-channel-limits-analyze
  • status：analyzed 或 blocked
  • routing_model：enhanced 或 legacy
  • metrics.current_pending_service_routings：实时数量、比较最大值、近似百分比及来源标签
  • metrics.pending_service_routing_rate_per_hour：不可用的实时值、参考最大值及来源标签
  • caveats：必须说明的准确性边界
  • blocking_issue：可采取行动的失败原因，或 null

如果无法查询 PendingServiceRouting，则返回 status: blocked。不要将对象不可用、功能缺失或权限失败解释为零使用量。

边界

  • 绝不抓取、重放或提交 Visualforce 设置页面。其会话状态和控制器不是受支持的客户 API。
  • 绝不将参考默认值描述为组织配置的最大值。
  • 绝不捏造实时每小时速率，或计算其利用率百分比。
  • 绝不修改路由、队列、Agent、限制或元数据。
  • 将 PSR 数量视为某一时刻的快照；路由工作期间该数量可能发生变化。
  • 如需完整的渠道和路由清单，请使用 service-omni-channel-inventory-analyze。
  • 如需由用户批准的端到端 Omni 设置，请移交给 service-omni-channel-setup-coordinate；此限制分析器仍为只读。

参考

解释报告为何无法准确复现设置页面上的所有值时，请阅读 references/api-notes.md。

评论

支持 Markdown