SuperAPI AI 工具集

service-omni-queue-members-assign

办公与效率

查看项目

更新于 10-16 08:47

技能介绍

用途:把 N 个智能体用户绑定进 Salesforce 队列。若队列没有成员,Omni-Channel 路由会看到空池,永远不会分配工作。该技能先检测再写入,只创建缺失的成员关系,因此可安全重复运行。

主要能力:先用 SOQL 解析队列的 Group.Id(按 DeveloperName + Type='Queue'),再查询现有 GroupMember,只为未绑定的用户逐个发起 POST,最后重新查询确认成员关系并输出报告。队列成员来自 service-omni-agent-users-create,队列来自 service-omni-queue-deploy,Omni 权限来自 service-omni-permission-set-assign。

使用方式: bash scripts/verify-and-bind.sh <org-alias> [queue-developer-name=CaseQueue] [count=3] [explicit-members-csv] 例如默认演示代理:bash scripts/verify-and-bind.sh myorg CaseQueue 3;按用户名或 Id 指定真实代理:bash scripts/verify-and-bind.sh myorg VoiceQueue "" "jdoe@acme.com,005XX000001abcd"。org-alias 必填;queue-developer-name 可选,默认 CaseQueue;count 可选,默认 3,范围 1..10,须与代理用户数一致,显式模式下忽略;第四个位置参数或 MEMBER_USERNAMES_CSV / MEMBER_USER_IDS_CSV 为显式成员列表,计数由列表推导。

前置条件:目标组织已通过 sf CLI 认证(My Domain URL)、Service Cloud 许可、sf CLI ≥ 2.139.6;执行用户需 PermissionsModifyAllData(系统管理员默认具备);智能体用户与队列必须已存在(队列无法通过 Data API 创建)。生产环境受 safe_to_write 三重保护,添加成员到生产队列会误路由真实客户工作,因此会被阻止且无覆盖选项。

输出与限制:输出单个 JSON 对象,status 为 bound | reused | partial | blocked,包含队列、org_suffix、member_source、requested_count、前后快照、bound_this_run/bound_count、reused_count、manual_actions 与 blocking_issue。生成模式与显式模式每次运行互斥;仅创建,不删除或重新分配成员;不创建队列或用户,也不分配权限集或状态配置。