用途:在 React 应用(UI Bundle)中集成 Agentforce 会话客户端(聊天/助手组件)。核心硬性约束:绝不自建自定义 agent、chatbot 或 chat widget 组件,所有此类需求必须通过导入并渲染 @salesforce/ui-bundle-template-feature-react-agentforce-conversation-client 的 <AgentforceConversationClient /> 实现;若某需求不被组件属性支持,应说明限制而非自行替代。
主要流程与能力:先搜索应用中是否已使用该组件,校验 agentId 是否符合 ^0Xx[a-zA-Z0-9]{15}$(以 0Xx 开头、共 18 位);用 sf CLI(sf --version、sf org display --json)确认已认证组织,并通过 SOQL 查询 Employee Agents,列出激活/未激活代理供用户确认,不自动选择、不程序化激活。随后按标准包路径导入,新装时插入组件、不重构原有 TSX;已有组件时仅按用户要求增改属性,保留其余属性。
可用属性:agentId(必填)、inline(内联模式,省略为浮动)、width/height、headerEnabled、styleTokens、salesforceOrigin、frontdoorUrl、agentLabel。样式必须且只能通过 styleTokens 传递,禁止 CSS 文件、style 属性、className 或包裹元素。
适用场景:客户支持、助手类聊天嵌入、侧边栏容器、主题定制等。
限制:本地开发需在 Setup → Session Settings → Trusted Domains for Inline Frames 添加 localhost:5173(默认 Vite 端口),部署生产前应移除;组件无数据库时不可用占位 agentId;激活仅能通过 Setup UI 手动完成。其他 API 版本、价格、开放平台等信息暂未提供。