Impostazione dei caricamenti di file per un agente

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

Modalità disponibili:

• auto: i file vengono elaborati e salvati nella cronologia della conversazione. Utilizzare questa modalità per consentire all'agente di gestire automaticamente come e quando vengono utilizzati i file.
• managed: i file vengono memorizzati nella variabile di sistema uploaded_files (@system_variables.uploaded_files) e la variabile viene utilizzata per controllare come vengono utilizzati i file. I file non vengono salvati nella cronologia delle conversazioni. Utilizzare questa modalità per gestire in modo esplicito le modalità di invio dei file a LLM, i subagenti che possono accedere ai file e le modalità di invio e utilizzo dei file da parte di altre azioni. Per concedere all'agente l'accesso ai file caricati, fare riferimento direttamente alla variabile nelle istruzioni per i subagenti o assegnarla agli input e agli output delle azioni.
• disabled: i caricamenti di file vengono disattivati in modo silenzioso. Vedere Disattivazione dei caricamenti di file per un agente.
• error: i caricamenti di file sono disattivati e l'agente invia un messaggio di errore. Vedere Disattivazione dei caricamenti di file per un agente.

Nota Senza istruzioni esplicite che indichino che l'agente può accettare caricamenti di file, quando l'agente riceve un file, l'agente può reindirizzare la conversazione al sottoagente di sistema Off Topic. Come minimo, in un subagente che si desidera utilizzare per la gestione dei file, indicare all'agente di utilizzare il subagente per elaborare i file.

Di seguito è riportato un esempio di script agente per un blocco subagente Analisi file e immagini.

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.

• Autorizzazioni di sistema: Utente Chatter interno, Accesso alle voci della conversazione
• Autorizzazioni oggetto: Sessione di messaggistica
• Impostazioni oggetti: Sessione di Messaggistica, Utente Messaggistica

Nota Se è stato creato un utente agente quando è stato creato l'agente, all'utente agente vengono concesse le autorizzazioni e le impostazioni oggetto Sessione di Messaggistica richieste per impostazione predefinita.