mcpField
S
service-omni-agent-work-sharing-configure

service-omni-agent-work-sharing-configure

github.com/forcedotcom安全1.1k82 次安装1 天前更新
代码仓库

关于 service-omni-agent-work-sharing-configure

用于检查并按需更改 Salesforce AgentWork 内部组织范围默认共享设置的技能。它仅将 Private 改为 Read，保留外部共享设置，并通过重新读取元数据验证部署。

主要功能

  1. 01检查 AgentWork 当前共享模型
  2. 02以计划模式预览而不部署
  3. 03经确认后将 Private 改为 Read
  4. 04保留外部共享设置
  5. 05重新读取元数据验证部署

适用场景

  1. 01变更前评估 AgentWork 的内部可见性
  2. 02不写入组织即可规划共享设置调整
  3. 03在测试组织授予内部读取权限

安装

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

$npx skills add https://github.com/forcedotcom/sf-skills --skill service-omni-agent-work-sharing-configure

安装后在 Claude Code 中输入/service-omni-agent-work-sharing-configure确认已加载。

包含的文件

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

references/
api-notes.md
scripts/
configure-and-report.sh
scripts/tests/
_bootstrap.py
test_agent_work_sharing_contracts.py

详细介绍

service-omni-agent-work-sharing-configure

检测并可选择配置标准 AgentWork 对象的组织范围内部默认值。支持的无头契约是 CustomObject:AgentWork 元数据：检索当前元数据，保留 externalSharingModel，部署内部 sharingModel=Read，然后再次检索以验证结果。

此设置可让已拥有对象访问权限的内部用户广泛获得读取可见性。它不能替代 OmniSupervisorConfig：该配置会筛选主管可见的代表、队列、技能、操作和选项卡，但不会授予记录访问权限。

输入

bash scripts/configure-and-report.sh <org-alias> --plan
bash scripts/configure-and-report.sh <org-alias> --confirm-org-wide-visibility
  • org-alias 为必填项，且必须已通过 sf 完成身份验证。
  • --plan 会检索并报告当前模型和目标模型，但不会部署。
  • 仅当运行需要将 Private 更改为 Read 时，才必须提供 --confirm-org-wide-visibility。省略该参数会在部署前阻止操作。

安全契约

  • 运行会拒绝生产客户组织。计划模式保持只读。
  • externalSharingModel 会原样保留。
  • Read 和 ReadWrite 已提供内部读取可见性，会直接复用。该技能绝不会将 ReadWrite 收窄为 Read。
  • 唯一支持的更改是将 Private 改为 Read；该技能绝不会授予内部编辑权限。
  • 分类、检索、部署或回读失败都会阻止操作。对于无法确定的响应，绝不会报告成功。
  • 请使用专用沙盒或测试组织，因为更改 OWD 可能会启动共享重新计算。

工作流

  1. 对目标组织进行分类，并执行生产环境写入保护。
  2. 通过 Metadata API 检索 CustomObject:AgentWork。
  3. 读取内部和外部共享模型。
  4. 如果当前模型为 Read 或 ReadWrite，则直接复用，不进行部署。
  5. 在计划模式下，报告拟议的 Private 到 Read 更改，然后以黄色状态退出。
  6. 在运行模式下，要求明确确认影响范围。
  7. 仅部署保留外部共享设置且内部模型为 Read 的标准对象元数据。
  8. 再次检索，并要求内部模型为 Read 且外部模型未更改。

输出

包含 status、previous_sharing_model、sharing_model、external_sharing_model、changed、dry_run、deploy_id 和 blocking_issue 的单个 JSON 对象。

  • configured：已确认的 Private 到 Read 部署成功，且回读结果匹配。
  • reused：当前的 Read 或 ReadWrite 已提供可见性。
  • action_needed：计划模式发现当前为 Private；未执行写入。
  • blocked：安全保护或受支持 API 验证失败。

限制

  • 此技能会更改可见性，而非主管范围。筛选功能请使用主管配置技能。
  • 此技能不会创建共享规则或逐条记录的 AgentWorkShare 行。
  • 此技能无法证明特定主管在 UI 中拥有完整访问权限；配置完成后，请使用目标主管用户验证端到端的 Command Center 工作流。

参考资料

文件阅读时机
references/api-notes.md批准组织范围更改或诊断检索／部署失败之前

评论

支持 Markdown