MCP 工具响应模式和客服人员设计

支持的 JSON 响应

Agentforce Builder 对原始值和浅层字段访问权限的支持最强，因此选择具有简单结构 JSON 响应的 MCP 服务器工具，或者调整您的响应，以尽可能将重要值公开为原始字段或简单顶级字段。支持的 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 类型时，您可以在 Agentforce 注册表的 MCP 服务器的记录页面上查看该工具的输入和输出模式。但对于资产库和客服人员中的关联 MCP 工具操作，输入或输出显示为空。

您仍然可以与客服人员一起使用 MCP 工具操作，但输入或输出不能存储在变量中，也不能用于下游逻辑或指令中。

• 该操作不能确定性地顺序链接到另一个操作。但在推理中，客服人员可以选择相关的输入和输出。
• 操作无法在推理指令中确定性运行，因为每个输入和输出必须映射到变量。
• 在条件语句或筛选器中，不能使用解析为 Lightning 类型的输出。

为了获得最佳结果，请在客服人员设计中为客服人员推理而不是确定性行为制定计划，并配置简单的自然语言子客服人员指令。

以下是输出未映射到 Lightning 类型的 MCP 工具示例。

• MCP 服务器记录页面上的输入和输出模式：
  
• 资产库中关联 MCP 工具操作的空输出：
  
• 客服人员中关联 MCP 工具操作的空输出：