Рекомендации по MCP для Agentforce

Серверы MCP и регистрации

• MCP for Agentforce поддерживает серверы, использующие транспортный протокол Streamable HTTP. HTTP+SSE и другие протоколы не поддерживаются.
• MCP для Agentforce не поддерживает проверку подлинности и поддерживает только регистрационные данные клиента OAuth 2.0. Другие потоки OAuth не поддерживаются, включая код авторизации, CIMD, DCR, носитель JWT и PKCE. Некоторые расширенные схемы проверки подлинности доступны с дополнительной конфигурацией, включительно с регистрационными данными клиента OAuth 2.1.
• Проверка подлинности на уровне пользователя не поддерживается. В настоящее время мы не поддерживаем сценарии использования, требующие отдельных кодов пользователей или персонализированных ответов. Например, вы не можете использовать MCP для Agentforce, чтобы предоставить отдельному пользователю возмещение, но вы можете использовать его для получения всех счетов клиентов.
• MCP для Agentforce поддерживает только серверные инструменты. Приложения, напоминания и ресурсы сервера MCP не поддерживаются.
• Имена инструментов могут содержать не более 128 символов и поддерживают следующие символы: ^a-zA-Z0-9./-{1,128}$
• Если сервер MCP не синхронизирован или недоступен, списковое представление «Регистрации» и страница записи сервера в настоящее время отображают сервер подключенным. Устранение скоро будет.
• Изменения, внесенные в регистрацию сервера или сам сервер, могут нарушить связанные действия инструмента MCP в агенте. Прежде чем вносить изменения, включая удаление регистрации, удалите связанные действия из агента, удалите связанные действия агента из библиотеки активов, а потом удалите регистрацию сервера. Потом можно повторно зарегистрировать сервер и добавить новые действия инструмента MCP к агенту.

Пакетирование и развертывание

Чтобы обеспечить безопасность, Salesforce поддерживает пакетирование или развертывание агентов, содержащих действия инструмента MCP, но метаданные регистрации сервера MCP не пакетируются. Любые действия с инструментом MCP, добавленные к агенту, не работают стандартно.

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

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

Поддержка платформы Agentforce и конструктора

• Действия агента, ссылающиеся на действия сервера MCP (действия инструмента MCP), выставляются с той же скоростью, что и другие действия агента. Отчетность по использованию доступна в Digital Wallet. См. раздел «Ис пользование Agentforce и генерирующий искусственный интеллект и выставление счетов».
• Поддержка Agentforce Builder наиболее эффективна для примитивных значений и мелкого доступа к полям. Поэтому выберите инструменты сервера MCP с простыми структурированными ответами JSON или настройте ответы, где возможно. Поддерживаются объекты верхнего уровня, свойства объектов верхнего уровня и массивы объектов верхнего уровня. Более сложные формы в настоящее время не поддерживаются из конца в конец, включительно с вложенными свойствами, массивами объектов и полезными нагрузками динамических объектов. Узнай больше.
• Agentforce Builder использует типы Lightning для отображения вводных и выводных данных действий. Не все схемы ввода и вывода инструмента MCP соотносятся с типами Lightning. Если данные действия инструмента MCP не могут быть разрешены в типе Lightning, вы можете использовать действие с агентом. Однако, ввод или вывод не может быть сохранен в переменной. Узнай больше.
• При добавлении действия инструмента MCP к агенту:
  • Метки ввода и вывода для некоторых типов данных (например, числа) могут быть заменены меткой «строка». Это не влияет на логику или аргументацию агента. Однако, для удобства использования, рекомендуем заменить метки исходными значениями из действия инструмента MCP в библиотеке активов или схемы ввода или вывода инструмента MCP. Устранение скоро будет.
  • Поле «Ссылочный тип действия» отображается пустым. Действие может выполняться без типа действия ссылки, даже если оно определено как обязательное поле, поскольку действие ссылки заполнено. При нажатии или изменении поля «Ссылочный тип действия» ссылочное действие сбрасывается и не может быть сброшено вручную к инструменту MCP. В этом случае удалите действие из агента и добавьте его повторно из библиотеки активов. Устранение скоро будет.
  • Для серверов и инструментов MCP свойства должны быть не больше 255 символов. Свойство, превышающее 255 символов, в данный момент не поддерживается.
• Ответы сервера MCP подчиняются следующим окнам ожидания. При возможности настройте ответы в соответствии с данными ограничениями.
  • Ограничение времени ожидания клиента MCP составляет 60 секунд. Например, если сервер недоступен или ответ занимает более 60 секунд.
  • Время ожидания механизма рассуждения Atlas составляет 120 секунд. Например, при вызове нескольких серверов, общий ответ на которые занимает более 120 секунд.
• В представлении сценария не изменяйте имя разработчика действия MCP в субагенте. В данном примере сценария агента имя разработчика (UUID) a4ace7b43ff031459019d3f5c350629a.

     actions:
        a4ace7b43ff031459019d3f5c350629a:
           description:
              Retrieves a list of customer support cases for a given customer Id.
           label: "custom_cases_by_id"
           require_user_confirmation: False
           include_in_progress_indicator: False
           source: "a4ace7b43ff031459019d3f5c350629a"
           target: "mcpTool://mcptoolx5xf5customerxfcasesxfbyxfid"

  Однако, вы можете изменить псевдоним действия MCP и ссылаться на этот псевдоним в инструкциях. В данном примере get_cases_from_id является псевдонимом действия MCP, на которое ссылается раздел instructions и которое определено в разделе actions.

  Get customer support cases and answer questions
     reason:
        instructions:
           Get customer cases by customer id by calling {{actions.get_cases_from_id}}.
           If customer provides only email, call {{actions.customer_id_from_email}}
           to get the customer id first.
        actions:
           get_cases_from_id: @actions.a4ace7b43ff031459019d3f5c350629a
              with customer_id = ...
           customer_id_from_email: @actions.a365abc?3dabf237b28ce87f636204384
              with email = ...