設定工作人員的檔案上載
將檔案上載支援新增至工作人員,讓您的使用者可以共用螢幕快照、回條和 PDF。您的工作人員可以解譯個別檔案或檔案群組、根據一或多個檔案回答問題,並將檔案新增至 Salesforce 記錄。
必要版本
| 提供版本:Lightning Experience |
| 提供版本:Enterprise、Performance、Unlimited 及 Developer Edition。所需附加元件授權會因工作人員類型而有所不同。 |
| 所需的使用者權限 | |
|---|---|
| 若要在 AI 工作人員中設定檔案上載: | 管理 AI 工作人員和工作人員類型的必要權限 |
在開始之前,請先檢閱將檔案上載新增至工作人員的支援與需求。
| Agentforce 檔案上載支援 | |
|---|---|
| 工作人員類型 | Agentforce 服務工作人員、Agentforce 員工工作人員 工作人員必須在 Agentforce Studio 中的「工作人員指令檔」和 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系統變數新增至工作人員。若要將已上載檔案的存取權授與工作人員,請參照工作人員指示中的變數、將其指派給工作人員動作輸入或輸出,或兩者。
-
為工作人員提供檔案處理指示。為獲得最佳結果,我們建議建立專屬的子代理程式來處理檔案上載,讓您可以為業務個案提供詳細指示並控制子代理程式路由。例如,您可能想要提供如何處理 PDF 檔案和影像檔案的唯一指示。
- 儲存您的變更。
-
如果您要將工作人員連線至「增強型聊天」:
- 從「設定」的「傳訊設定」頁面中,為一般使用者開啟檔案共用。您也可以指定允許的檔案類型與檔案大小上限。請參閱在增強型聊天中自訂檔案共用體驗。
-
請確認您的工作人員使用者擁有必要的存取權。
- 系統權限:Chatter 內部使用者、存取對話項目
- 物件權限:傳訊工作階段
- 物件設定:傳訊工作階段、傳訊使用者
備註 如果您在建立工作人員時建立工作人員使用者,則依預設會將必要的「傳訊工作階段」物件權限與設定授與您的工作人員使用者。
-
如果您將工作人員連線至允許來賓使用者的 Experience Cloud 網站,請授與其上載檔案的權限。只有在來賓使用者共用規則就緒時,來賓使用者才能將檔案上載至記錄。
- 進入「設定」,在「快速尋找」方塊中輸入 Salesforce 檔案,然後選取「一般設定」。
- 選取「允許網站來賓使用者上載檔案」。
- 在您部署工作人員之前,請先測試工作人員的檔案上載組態。在 Agentforce Builder 中開始預覽對話,然後傳送檔案。檔案上載可逐層測試。
- 關閉工作人員的檔案上載
如果您不想讓工作人員能夠再接收檔案,請關閉工作人員層級的檔案上載功能。 - 範例:在 Agentforce 工作階段追蹤中檢視上載的檔案
使用此範例指令檔可將工作人員對話期間上載的資產與 Agentforce 工作階段追蹤 (STDM) 中的工作階段連線。
此文章是否解決您的問題?
請讓我們知道,以便我們改進!
