用途:让嵌入的 Agentforce Employee Agent(IT Service Employee Agent)在 Microsoft Teams 的 ITSM 自定义客户端(Salesforce Employee Assist → Ask AI Agent)中真正回复。Teams 客户端在运行时按 esDeveloperName 加载 MIAW 部署,该名称在 Core 配置与 Teams 应用清单中硬编码为 Teams_AgentForce,因此 Embedded Service Deployment 必须精确命名为 Teams_AgentForce,不能按组织改名。
主要能力:全程通过 API 构建 Teams 客户端加载的 MIAW 频道与部署,无需 Setup UI 点击。包括:创建 Web Enhanced 消息频道并开启 User Verification(authMode=Auth),关联 Enhanced Chat User Verification Key Set(PublicKeyCertificateSet,type=JWKS_URL,endpoint 为 <Org>/id/keys,issuer 为 Employee Site URL);创建 Teams_AgentForce 自定义客户端 ESD;创建 Omni-Flow 路由流,其 routeWork 指向真实且 Active 的 Agentforce Employee Agent;创建并分配 Agent Access 权限集,使门户用户可访问该 agent;通过 API 端到端验证 token/路由链,并诊断“加入后离开/无回复”症状。
使用方式:按顺序逐步执行,每步单独运行并确认成功后再继续,不要并行批量调用。顺序为 Key Set → 引用它的频道 → ESD。所有部署使用隔离的 sfdx-project.json,--api-version 67.0。频道需在发布 ESD 前激活(MessagingChannel.IsActive=true)。ESD 通过 POST /services/data/v67.0/connect/embeddedservice/embeddedserviceconfig/publish/<esdId> 发布。不要使用 POST /connect/service-itsm/createMessagingChannel,它强制自带默认值。重测需从全新 Teams 会话开始,旧会话仍绑定旧部署。
适用场景:Teams ITSM 功能已启用、员工门户站点已上线,且已存在真实 Active 的 Agentforce Employee Agent(可用 SELECT Id FROM BotDefinition WHERE Type='InternalCopilot' AND AgentType='AgentforceEmployeeAgent' 查询)。
限制:不负责启用 Teams 功能开关、Azure/SSO/Named Credential 配置,也不负责创建员工门户站点。若 auth ON + Key Set、Agent Access 已分配、ESD 已创建并发布后仍无回复,应先用 service-itsm-teams-debug 排查,最后才升级至 Agentforce Employee Agent 团队处理 agent 运行时问题。完整 XML、API 请求体与验证查询见 references/teams-embedded-employee-agent.md。