Configuration de chargements de fichiers pour un agent

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

Modes disponibles :

• auto: les fichiers sont traités et enregistrés dans l'historique des conversations. Utilisez ce mode pour permettre à l'agent de gérer automatiquement comment et quand les fichiers sont utilisés.
• managed: les fichiers sont stockés dans la variable système uploaded_files (@system_variables.uploaded_files), et vous utilisez la variable pour contrôler l'utilisation des fichiers. Les fichiers ne sont pas enregistrés dans l'historique des conversations. Utilisez ce mode pour gérer explicitement comment les fichiers sont envoyés au grand livre, quels agents secondaires peuvent accéder aux fichiers, et comment les fichiers sont envoyés et utilisés par d'autres actions. Pour accorder à l'agent l'accès aux fichiers chargés, référencez directement la variable dans les instructions du sous-agent ou attribuez-la à des entrées et des sorties d'action.
• disabled: les chargements de fichiers sont désactivés en silence. Consultez Désactivation du chargement de fichiers pour un agent.
• error: les chargements de fichiers sont désactivés et l'agent envoie un message d'erreur. Consultez Désactivation du chargement de fichiers pour un agent.

Remarque Sans instructions explicites indiquant que votre agent peut accepter les chargements de fichiers, lorsqu'il reçoit un fichier, il peut rediriger la conversation vers le sous-agent système Hors sujet. Au minimum, dans un sous-agent que vous souhaitez utiliser pour le traitement des fichiers, demandez à votre agent d'utiliser le sous-agent pour traiter les fichiers.

Voici un exemple de script Agent pour un bloc de sous-agents Analyse des fichiers et des images.

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.

• Autorisations système : Utilisateur interne Chatter, Accéder aux entrées de conversation
• Autorisations d'objet : Session de messagerie
• Paramètres d'objet : Session de messagerie, Utilisateur de Messagerie

Remarque Si vous avez créé un utilisateur agent en créant votre agent, il reçoit par défaut les autorisations et les paramètres d'objet Session de messagerie requis.