Configurar uploads de arquivo para um agente

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

Modos disponíveis:

• auto – Os arquivos são processados e salvos no histórico da conversa. Use esse modo para permitir que o agente gerencie automaticamente como e quando os arquivos são usados.
• managed – Os arquivos são armazenados na variável do sistema uploaded_files (@system_variables.uploaded_files) e você usa a variável para controlar como os arquivos são usados. Os arquivos não são salvos no histórico da conversa. Use esse modo para gerenciar explicitamente como os arquivos são enviados ao LLM, quais subagentes podem acessar os arquivos e como os arquivos são enviados e usados por outras ações. Para dar ao agente acesso a arquivos carregados, referencie diretamente a variável nas instruções do subagente ou atribua-a a entradas e saídas de ação.
• disabled – Uploads de arquivo são desativados silenciosamente. Consulte Desativar uploads de arquivo para um agente.
• error – Uploads de arquivo são desativados e o agente envia uma mensagem de erro. Consulte Desativar uploads de arquivo para um agente.

Nota Sem instruções explícitas de que seu agente possa aceitar uploads de arquivo, quando seu agente receber um arquivo, seu agente poderá redirecionar a conversa para o subagente do sistema Fora do tópico. No mínimo, em um subagente que você deseja usar para processar arquivos, peça para seu agente usar o subagente para processar arquivos.

Aqui está um exemplo de script do agente para um bloco de subagente de Análise de arquivo e imagem.

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.

• Permissões do sistema: Usuário interno do Chatter, Acesse as entradas da conversa
• Permissões do objeto: Sessão do Messaging
• Configurações de objeto: Sessão do Messaging, Usuário do Messaging

Nota Se você tiver criado um usuário agente ao criar seu agente, seu usuário agente receberá as permissões e configurações necessárias do objeto Sessão do Messaging por padrão.