SuperAPI AI 工具集

experience-ui-bundle-agentforce-client-generate

智能体与模型

查看项目

更新于 10-15 21:43

技能介绍

用途:在 React 或 Angular 的 UI Bundle 应用中添加、集成、配置、设置样式或移除 Agentforce 会话客户端(聊天/助手组件)。

主要能力:框架无关,同时支持 React 与 Angular。React 使用包 @salesforce/ui-bundle-template-feature-react-agentforce-conversation-client 的 <AgentforceConversationClient />;Angular 使用包 @salesforce/ui-bundle-template-feature-angular-agentforce-conversation-client 的 <app-agentforce-conversation-client>。硬性约束:不得自建聊天组件,必须导入并渲染上述现成组件;若需求超出其属性支持,说明限制而非自行实现。

使用方式:先运行框架检测脚本 bash "<skill_dir>/scripts/detect-framework.sh" "<app-or-uiBundle-root>",据输出 react/angular 决定;ambiguous 或 unknown 时问用户。再查找是否已存在组件,校验 agentId 格式 ^0Xx[a-zA-Z0-9]{15}$。用 sf --version、sf org display --json 检查 Salesforce CLI 与组织连接,可用 npm install -g @salesforce/cli 安装;通过 SOQL 查询 Employee Agents 并让用户确认选择,不做自动选择或程序化激活。随后按框架导入组件并插入元素,可用属性:agentId(必填)、inline、width、height、headerEnabled、styleTokens、salesforceOrigin、frontdoorUrl、agentLabel。所有视觉定制必须通过 styleTokens,不得用 CSS、style 属性、class 或包裹元素。Angular 需在宿主 @Component({ imports: [...] }) 注册组件,布尔/数字/对象输入必须用 [prop] 绑定,例如 [inline]="true"、[styleTokens]="{ ... }"。

适用场景:需要在 Salesforce UI Bundle 应用中嵌入 Agentforce 对话客户端时的添加、更新属性、换 agent、改样式或移除操作。

限制:本地开发需在 Setup → Session Settings → Trusted Domains for Inline Frames 添加域名(React Vite 默认 localhost:5173,Angular 可能不同),部署生产前须移除;无连接组织时 agentId 无法运行;不支持自动激活、不支持未列出的 style token;资料未提供收费、价格或效果说明。