设置客服人员的文件上传
将文件上传支持添加到客服人员,以便用户可以共享屏幕截图、收据和 PDF。客服人员可以解释单个文件或一组文件,根据一个或多个文件回答问题,并将文件添加到 Salesforce 记录。
所需的 Edition
| 适用于:Lightning Experience |
| 适用于:Enterprise、Performance、Unlimited 和 Developer Edition。所需的加载项许可证因客服人员类型而异。 |
| 所需用户权限 | |
|---|---|
| 要在 AI 客服人员中设置文件上传: | 管理 AI 客服人员以及客服人员类型所需的权限 |
在开始前,请查看将文件上载添加到客服人员的支持和要求。
| Agentforce 文件上传支持 | |
|---|---|
| 客服人员类型 | Agentforce 服务客服人员、Agentforce 员工客服人员 客服人员必须在 Agentforce Studio 中创建或升级到 Agent 脚本和 Agentforce Builder。 |
| 渠道 | 增强聊天 v1、增强聊天 v2、Lightning Experience 目前不支持移动设备。 在一些第三方消息传递客户端(Line、WeChat、WhatsApp)上,多个附件被拆分为单个消息,并由客服人员单独处理。 |
| 模型 | 仅限 OpenAI GPT 4.1。目前不支持 Azure OpenAI。LLM 多模式支持限制适用。 HyperClassifier 模型不支持图像。如果使用 HyperClassifier 模型进行子代理分类,则不能使用代理路由器根据文件上传的内容上传文件或路由对话。 |
| 文件 | PNG、JPEG、PDF 每个文件最大为 5 MB。 客服人员每条消息最多可以接受 5 个文件(因渠道而异),每次对话最多可以接受 10 个文件。如果用户上传的文件超过 10 个,客服人员会保存最近的 10 个。 |
- 从 Agentforce Studio 应用程序的客服人员列表中,打开要接收文件上传的客服人员。
-
或者,将
file_upload子块添加到客服人员的脚本中,并指定您希望客服人员用于处理文件上传的模式。使用此客服人员脚本设置定义客服人员如何使用和存储上传的文件。您也可以使用此设置为您的客服人员关闭文件上传。如果您未指定模式,并且客服人员可以接收文件上传,则自动模式默认适用。
- 如果您在画布视图中查看客服人员,请切换到脚本视图。
-
在客服人员的
config块中,添加file_upload字段并指定mode值。config: file_upload: mode: "auto" | "managed" | "disabled" | "error"可用模式:
auto— 文件被处理并保存到对话历史记录中。使用此模式,以允许客服人员自动管理文件的使用方式和时间。managed— 文件存储在 uploaded_files 系统变量 (@system_variables.uploaded_files) 中,您可以使用该变量来控制如何使用文件。文件不会保存到对话历史记录。使用此模式明确管理文件如何发送到 LLM、哪些子代理可以访问文件,以及其他操作如何发送和使用文件。要授予客服人员对上载文件的访问权限,请直接引用子客服人员指令中的变量,或将其分配到操作输入和输出。disabled— 文件上传会静默关闭。请参阅关闭客服人员文件上传。error— 文件上传关闭,客服人员发送错误消息。请参阅关闭客服人员文件上传。
-
自定义子客服人员和操作。
-
为客服人员提供文件处理说明。为了获得最佳结果,我们建议创建专用子代理来处理文件上传,以便您可以为您的业务个案提供详细的说明并控制子代理路由。例如,您可能想要提供如何处理 PDF 文件和图像文件的唯一说明。
备注 如果没有客服人员可以接受文件上传的明确指示,当您的客服人员收到文件时,您的客服人员可以将对话重定向到离开主题系统子客服人员。至少,在您想要用于文件处理的子代理中,告诉客服人员使用该子代理处理文件。以下是文件和图像分析子代理块的代理脚本示例。
subagent File_and_Image_Analysis: label: "File and Image Analysis" description: | Use this topic when the user uploads a PDF, document, or image file and asks to summarize, analyze, describe, extract text from, or answer questions about its contents. reasoning: instructions: -> | 1. Evaluate standard user requests involving uploaded attachments (PDFs, images, or documents). | 2. When a user asks to describe, summarize, or extract text from an uploaded PDF or image: | - Identify the primary topics, main takeaways, key data points, and structural highlights from the document or visual content. | - Provide a clear, structured summary using bullet points or concise paragraphs. | - Do not guess or fabricate information not present in the attached file. | 3. If the document content is unclear or incomplete, politely ask the user for clarification while describing what is currently visible. -
如果您使用
managed模式,请确保将uploaded_files系统变量添加到客服人员。要授予客服人员对上载文件的访问权限,请在客服人员说明中引用变量,将其分配到客服人员操作输入或输出,或两者。要了解有关使用uploaded_files系统变量的更多信息,请参阅Agentforce 开发人员指南:系统变量。要了解有关使用列表变量的更多信息,请参阅Agentforce 开发人员指南:使用列表变量。
-
为客服人员提供文件处理说明。为了获得最佳结果,我们建议创建专用子代理来处理文件上传,以便您可以为您的业务个案提供详细的说明并控制子代理路由。例如,您可能想要提供如何处理 PDF 文件和图像文件的唯一说明。
- 保存更改。
-
如果您将客服人员连接到增强聊天:
- 从“设置”中的消息传递设置页面,为最终用户打开文件共享。您也可以指定允许的文件类型和最大文件大小。请参阅在增强聊天中自定义文件共享体验。
-
请确保客服人员用户拥有所需的访问权限。
- 系统权限:Chatter 内部用户,访问对话条目
- 对象权限:消息传递会话
- 对象设置:消息传递会话,消息传递用户
备注 如果您在创建客服人员时创建了客服人员用户,默认情况下,客服人员用户会被授予所需的消息传递会话对象权限和设置。
-
如果您将客服人员连接到允许来宾用户的 Experience Cloud 站点,请授予他们上载文件的权限。只有当来宾用户共享规则到位时,来宾用户才能将文件上传到记录。
- 从“设置”中,在快速查找框中输入 Salesforce Files,然后选择通用设置。
- 选择允许站点来宾用户上传文件。
- 在部署客服人员之前,请测试客服人员的文件上传配置。在 Agentforce Builder 中开始预览对话并发送文件。可以端到端地测试文件上传。
- 关闭客服人员的文件上传
如果您不再希望客服人员能够接收文件,请在客服人员级别关闭文件上传功能。 - 示例:在 Agentforce 会话跟踪中查看上传的文件
使用此示例脚本将客服人员对话期间上传的资产与 Agentforce 会话跟踪 (STDM) 中的会话连接起来。
本文章是否解决您的问题?
请与我们共享您的想法,以便我们进行改进!
