Схемы ответа инструмента MCP и дизайн агента

Поддерживаемые ответы JSON

Поддержка Agentforce Builder наиболее эффективна для простых значений и мелкого доступа к полям, поэтому выберите инструменты сервера MCP с простыми структурированными ответами JSON или настройте ответы, чтобы открыть важные значения в виде простых полей или простых полей верхнего уровня, где возможно. Поддерживаемые ответы JSON включают объекты верхнего уровня, свойства объектов верхнего уровня и массивы объектов верхнего уровня. Более сложные формы в настоящее время не поддерживаются из конца в конец, включительно с вложенными свойствами, массивами объектов и полезными нагрузками динамических объектов.

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

{"type": "object"} 

{"type": "object", "properties": {}}

{
  "type": "object",
  "properties": {
    "prop1": {
      "type": "object"
    }
  }
} 

{
  "type": "object",
  "properties": {
    "prop1": {
      "type": "object",
      "properties": {}
    }
  }
}

{
  "type": "object",
  "properties": {
    "prop1": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  }
}

{
  "type": "object",
  "properties": {
    "prop1": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {}
      }
    }
  }
}

Типы Lightning

Все действия агента используют типы Lightning для определения структуры, проверки и отображения данных на вводах и выводах. Схемы ввода и вывода инструментов MCP не всегда соотносятся с типами Lightning, поскольку тип данных определяется сервером, а протокол поддерживает широкий диапазон типов данных. Например, если тип данных содержит оператор (например, any/or). Узнайте больше о стандартных типах Lightning и об использовании типов Lightning в действиях агента.

Если данные не могут быть разрешены посредством типа Lightning, схему ввода и вывода для инструмента можно просмотреть на странице записи для сервера MCP в реестре Agentforce. Но ввод или вывод отображается пустым для связанного действия инструмента MCP в библиотеке активов и в вашем агенте.

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

• Действие не может быть связано с другим действием детерминистски. Однако, в рассуждениях агент может выбрать соответствующие вводные и выходные данные.
• Действие не может быть выполнено детерминистски в инструкциях, поскольку каждый ввод и вывод должны быть соотнесены с переменной.
• Выводы, не соответствующие типам Lightning, не могут использоваться в условных операторах или фильтрах.

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

Ниже указан пример инструмента MCP с выводом, который не соотносится с типом Lightning.

• Схемы ввода и вывода на странице записи сервера MCP:
  
• Пустой вывод для связанного действия инструмента MCP в библиотеке активов:
  
• Пустой вывод для связанного действия инструмента MCP в агенте: