Loading
Agentforce y IA generativa de Einstein
Configurar cargas de archivos para un agente

Usted está aquí:

  1. Ayuda de Salesforce
  2. Documentos
  3. Inicio rápido de su solución de IA generativa Einstein

Configurar cargas de archivos para un agente

Agregue compatibilidad de carga de archivos a su agente, de modo que sus usuarios puedan compartir capturas de pantalla, recibos y PDF. Su agente puede interpretar archivos individuales o un grupo de archivos, responder a preguntas basadas en uno o más archivos y agregar archivos a un registro de Salesforce.

Ediciones necesarias

Disponible en: Lightning Experience
Disponible en: Enterprise Edition, Performance Edition, Unlimited Edition y Developer Edition. Las licencias complementarias requeridas varían por tipo de agente.
Permisos de usuario necesarios
Para configurar cargas de archivos en un agente de IA: Gestionar agentes de IA Y los permisos requeridos para su tipo de agente

Antes de empezar, revise la asistencia y los requisitos para agregar cargas de archivos a su agente.

Compatibilidad de carga de archivos Agentforce
Tipos de agentes

Agentes de Servicio Agentforce, Agentforce Agentes empleados

Los agentes deben crearse o actualizarse a Script de agente y Agentforce Builder en Agentforce Studio.
Canales

Chat mejorado v1, Chat mejorado v2, Lightning Experience

Mobile no es compatible actualmente.

En algunos clientes de mensajería externos (Línea, WeChat, WhatsApp), múltiples archivos adjuntos se dividen en mensajes individuales y los procesa el agente de forma individual.
Modelos

Solo OpenAI GPT 4.1. OpenAI de Azure no es compatible actualmente. Se aplican los límites de compatibilidad multimodal de LLM.

El modelo HyperClassifier no admite imágenes. Si utiliza el modelo HyperClassifier para la clasificación de subagente, no puede utilizar el Enrutador de agente para cargar archivos o enrutar pláticas basándose en el contenido de las cargas de archivos.
Archivos

PNG, JPEG, PDF

Los archivos pueden tener hasta 5 MB cada uno.

Un agente puede aceptar hasta 5 archivos por mensaje (varía por canal) y hasta 10 archivos por plática. Si un usuario carga más de 10 archivos, el agente guarda los 10 más recientes.
  1. Desde la lista Agentes en la aplicación Agentforce Studio, abra el agente que desea que reciba cargas de archivos.
  2. Opcionalmente, agregue el file_upload subbloque a la secuencia de comandos de su agente y especifique el modo que desea que su agente utilice para gestionar las cargas de archivos.

    Utilice esta configuración de secuencia de comandos de agente para definir cómo utiliza y almacena su agente los archivos cargados. También puede utilizar este parámetro para desactivar las cargas de archivos para su agente. Si no especifica un modo y su agente puede recibir cargas de archivos, el modo automático se aplica de forma predeterminada.

    1. Si está visualizando el agente en la vista Lienzo, cambie a la vista Script.
    2. En el bloque de config de su agente, agregue el campo file_upload y especifique un valor de mode. 
      config:
    file_upload:
        mode: "auto" | "managed" | "disabled" | "error"

      Modos disponibles:

      • auto: Los archivos se procesan y se guardan en el historial de pláticas. Utilice este modo para permitir al agente gestionar automáticamente cómo y cuándo se utilizan los archivos.
      • managed: Los archivos se almacenan en la variable del sistema uploaded_files (@system_variables.uploaded_files) y utiliza la variable para controlar cómo se utilizan los archivos. Los archivos no se guardan en el historial de pláticas. Utilice este modo para gestionar de forma explícita cómo se envían los archivos al LLM, qué subagentes pueden acceder a los archivos y cómo se envían y se utilizan los archivos por otras acciones. Para proporcionar al agente acceso a archivos cargados, haga referencia directamente a la variable en instrucciones de subagente o asígnela a entradas y salidas de acciones.
      • disabled: Las cargas de archivos se desactivan de forma silenciosa. Consulte Desactivar cargas de archivos para un agente.
      • error: Las cargas de archivos están desactivadas y el agente envía un mensaje de error. Consulte Desactivar cargas de archivos para un agente.
  3. Personalice sus subagentes y acciones.
    1. Proporcione a su agente instrucciones de tratamiento de archivos. Para obtener mejores resultados, recomendamos crear un subagente exclusivo para gestionar cargas de archivos, de modo que pueda proporcionar instrucciones detalladas y controlar el enrutamiento de subagente para su caso de negocio. Por ejemplo, es posible que desee proporcionar instrucciones exclusivas sobre cómo gestionar archivos PDF frente a archivos de imagen.
      Nota
      Nota Sin instrucciones explícitas de que su agente puede aceptar cargas de archivos, cuando su agente recibe un archivo, su agente puede redirigir la plática al subagente del sistema Off Topic. Como mínimo, en un subagente que desea utilizar para la gestión de archivos, indique a su agente que utilice el subagente para procesar archivos.

      Este es un ejemplo de secuencia de comandos de agente para un bloque de subagente Análisis de archivos e imágenes.

      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.
    2. Si utiliza el modo managed, asegúrese de que la variable del sistema de uploaded_files se agrega a su agente. Para proporcionar a su agente acceso a archivos cargados, haga referencia a la variable en instrucciones de agente, asígnela a entradas o salidas de acciones de agentes, o ambas.
      Para obtener más información acerca del uso de la variable del sistema de uploaded_files, consulte Guía del desarrollador Agentforce: Variables del sistema. Para obtener más información acerca del trabajo con variables de lista, consulte Guía del desarrollador Agentforce: Uso de variables de lista.
  4. Guarde sus cambios.
  5. Si está conectando un agente con Chat mejorado:
    1. Desde la página Configuración de Mensajería en Configuración, active la colaboración de archivos para usuarios finales. También puede especificar tipos de archivo permitidos y tamaño máximo de archivo. Consulte Personalizar la experiencia de colaboración de archivos en Chat mejorado.
    2. Asegúrese de que su usuario agente tiene acceso requerido.
      • Permisos del sistema: Usuario interno Chatter, Acceder a entradas de plática
      • Permisos de objeto: Sesión de mensajería
      • Configuración de objetos: Sesión de mensajería, Usuario de mensajería
      Nota
      Nota Si creó un usuario agente cuando creó su agente, se otorga a su usuario agente los permisos y la configuración de objeto Sesión de mensajería requeridos de forma predeterminada.
  6. Si está conectando su agente a un sitio de Experience Cloud que permite a los usuarios invitados, asígneles permiso para cargar archivos. Los usuarios invitados solo pueden cargar archivos en un registro cuando existen reglas de colaboración de usuario invitado.
    1. Desde Configuración, en el cuadro Búsqueda rápida, ingrese Archivos de Salesforce y seleccione Configuración general.
    2. Seleccione Permitir a usuarios invitados del sitio cargar archivos.
  7. Antes de implementar su agente, pruebe la configuración de carga de archivos de su agente. Inicie una plática de vista previa en Agentforce Builder y envíe un archivo. Las cargas de archivos se pueden probar de extremo a extremo.
 
Cargando
Salesforce Help | Article