エージェントのファイルアップロードの設定

config:
    file_upload:
        mode: "auto" | "managed" | "disabled" | "error"
            

使用可能なモード:

• auto—ファイルが処理され、会話履歴に保存されます。このモードを使用して、エージェントがファイルを使用する方法とタイミングを自動的に管理できるようにします。
• managed：ファイルは uploaded＿files システム変数（@system＿variables.uploaded＿files）に保存され、この変数を使用してファイルの使用方法を制御します。ファイルは会話履歴に保存されません。このモードを使用して、LLM へのファイルの送信方法、ファイルにアクセスできるサブエージェント、および他のアクションによるファイルの送信方法と使用方法を明示的に管理します。アップロードされたファイルへのアクセス権をエージェントに付与するには、サブエージェントの指示で変数を直接参照するか、アクションの入力と出力に割り当てます。
• disabled—ファイルのアップロードは通知なしで無効になります。「エージェントのファイルアップロードの無効化」を参照してください。
• error—ファイルのアップロードが無効になり、エージェントがエラー メッセージを送信します。「エージェントのファイルアップロードの無効化」を参照してください。

メモ エージェントがファイルのアップロードを受け入れることができるという明示的な指示がない場合、エージェントがファイルを受信すると、会話を [トピック外] システムサブエージェントにリダイレクトできます。少なくとも、ファイル処理に使用するサブエージェントで、サブエージェントを使用してファイルを処理するようにエージェントに指示します。

ファイルと画像の分析サブエージェントブロックのエージェントスクリプトの例を次に示します。

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.

• システム権限: Chatter 内部ユーザー、会話エントリへのアクセス
• オブジェクト権限: メッセージングセッション
• オブジェクト設定: メッセージングセッション、メッセージングユーザー

メモ エージェントの作成時にエージェントユーザーを作成した場合、エージェントユーザーにはデフォルトで必要なメッセージングセッションオブジェクト権限と設定が付与されます。