Loading
Agentforce и Einstein Generative AI
Настройка загрузки файлов для агента

Вы находитесь здесь:

  1. Справка Salesforce
  2. Документы
  3. Быстрый запуск генеративного решения на основе искусственного интеллекта Einstein

Настройка загрузки файлов для агента

Добавьте поддержку загрузки файлов агенту, чтобы пользователи могли делиться снимками экрана, квитанциями и PDF-документами. Ваш агент может интерпретировать отдельные файлы или группы файлов, отвечать на вопросы на основе одного или нескольких файлов и добавлять файлы в запись Salesforce.

Требуемые версии

Доступно в версиях: Lightning Experience
Доступно в версиях: Enterprise Edition, Performance Edition, Unlimited Edition и Developer Edition. Требуемые дополнительные лицензии определяются типом агента.
Требуемые полномочия пользователя
Для настройки загрузки файлов в агенте на основе искусственного интеллекта: Управление агентами на основе искусственного интеллекта И необходимые полномочия для типа агента

Прежде чем начать работу, просмотрите поддержку и требования для добавления загрузок файлов агенту.

Поддержка загрузки файлов Agentforce
Типы агентов

Агенты Agentforce Service, агенты Agentforce Employee

Агенты должны быть созданы в сценарии Agent Script и Agentforce Builder в Agentforce Studio или обновлены до них.
Каналы

Расширенный чат v1, Расширенный чат v2, Lightning Experience

Mobile в данный момент не поддерживается.

В некоторых клиентах сторонних сообщений (Line, WeChat, WhatsApp) несколько вложений разделены на отдельные сообщения и обрабатываются агентом отдельно.
Модели

Только OpenAI GPT 4.1. Azure OpenAI в данный момент не поддерживается. Применяются ограничения мультимодальной поддержки LLM.

Модель HyperClassifier не поддерживает изображения. Если вы используете модель HyperClassifier для классификации субагентов, маршрутизатор агентов не может использоваться для отправки файлов или маршрутизации разговоров на основе содержимого загрузок файлов.
Файлы

PNG, JPEG, PDF

Размер каждого файла не должен превышать 5 Мб.

Агент может принять не более 5 файлов на сообщение (в зависимости от канала) и не более 10 файлов на разговор. Если пользователь загружает более 10 файлов, агент сохраняет последние 10.
  1. В списке «Агенты» приложения Agentforce Studio откройте агента, которого хотите получать для загрузки файлов.
  2. По желанию, добавьте file_upload подблок к сценарию агента и укажите режим, который должен использоваться агентом для обработки загрузок файлов.

    Используйте этот параметр сценария агента для определения способа использования и хранения загруженных файлов агентом. Этот параметр можно также использовать для выключения загрузки файлов для агента. Если вы не укажете режим и ваш агент сможет получать загрузки файлов, автоматический режим применяется по умолчанию.

    1. Если вы просматриваете агента в представлении холста, переключитесь на представление сценария.
    2. В блоке config агента добавьте поле file_upload и укажите значение mode. 
      config:
    file_upload:
        mode: "auto" | "managed" | "disabled" | "error"

      Доступные режимы:

      • auto: файлы обрабатываются и сохраняются в журнале разговора. Данный режим позволяет агенту автоматически управлять способом и временем использования файлов.
      • managed—Файлы хранятся в системной переменной uploaded_files (@system_variables.uploaded_files), и вы используете переменную для управления использованием файлов. Файлы не сохраняются в журнал разговора. Используйте этот режим для четкого управления способом отправки файлов в LLM, доступом субагентов к файлам и способом отправки и использования файлов другими действиями. Чтобы предоставить агенту доступ к загруженным файлам, напрямую ссылайтесь на переменную в инструкциях субагента или назначьте ее вводам и выводам действий.
      • disabled —Загрузка файлов выключена молча. См. Выключение загрузки файлов для агента.
      • error — Загрузка файлов выключена, и агент отправляет сообщение об ошибке. См. Выключение загрузки файлов для агента.
  3. Настройте субагентов и действия.
    1. Предоставьте агенту инструкции по обработке файлов. Для достижения лучших результатов рекомендуем создать специального субагента для обработки загрузок файлов, чтобы вы могли предоставить подробные инструкции и управлять маршрутизацией субагента для вашего бизнес-обращения. Например, вам может понадобиться предоставить уникальные инструкции по обработке PDF-файлов в сравнении с файлами изображений.
      Примечание
      Примечание Без четких инструкций о том, что агент может принимать загрузки файлов, при получении файла агент может перенаправить разговор системному подагенту «Не по теме». Как минимум, в субагенте, который вы хотите использовать для обработки файлов, скажите агенту использовать субагент для обработки файлов.

      Ниже указан пример блока субагента «Сценарий агента для анализа файлов и изображений».

      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. Если вы используете режим managed, убедитесь, что системная переменная uploaded_files добавлена к агенту. Чтобы предоставить агенту доступ к загруженным файлам, ссылайтесь на переменную в инструкциях агента, назначьте ее вводам или выводам действий агента или обоим параметрам.
      Чтобы узнать больше об использовании системной переменной uploaded_files, см. Руководство разработчика Agentforce: Системные переменные. Чтобы узнать больше о работе с переменными списка, см. Руководство разработчика Agentforce: Использование переменных списка.
  4. Сохраните внесенные изменения.
  5. Если вы подключаете агента к расширенному чату:
    1. На странице параметров службы сообщений в настройках включите общий доступ к файлам для конечных пользователей. Можно также указать разрешенные типы файлов и максимальный размер файла. См. Настройка взаимодействия общего доступа к файлам в расширенном чате.
    2. Убедитесь, что пользователю-агенту требуется доступ.
      • Полномочия системы: Внутренний пользователь Chatter, доступ к записям разговора
      • Полномочия объекта: Сеанс обмена сообщениями
      • Параметры объекта: Сеанс службы сообщений, пользователь службы сообщений
      Примечание
      Примечание Если вы создали пользователя-агента при создании агента, пользователю-агенту предоставляются обязательные полномочия и параметры объекта «Сеанс службы сообщений» по умолчанию.
  6. Если вы подключаете агента к сайту Experience Cloud, позволяющему пользователям-гостям, предоставьте им полномочие на загрузку файлов. Пользователи-гости могут загружать файлы в запись только при наличии правил общего доступа пользователей-гостей.
    1. Введите строку «Salesforce Files» в поле «Быстрый поиск» меню «Настройка» и выберите пункт «Общие параметры».
    2. Выберите «Разрешить пользователям-гостям сайта загружать файлы».
  7. Прежде чем развертывать агента, протестируйте конфигурацию загрузки файлов агента. Начните диалог предварительного просмотра в Agentforce Builder и отправьте файл. Загрузку файлов можно тестировать от начала до конца.
 
Загрузка
Salesforce Help | Article