Esquemas de respuesta de herramientas MCP y diseño de agentes

Respuestas JSON admitidas

La compatibilidad de Agentforce Builder es más sólida para valores primitivos y acceso a campos superficiales, de modo que seleccione herramientas de servidor MCP con respuestas JSON estructuradas sencillas o ajuste sus respuestas para exponer valores importantes como campos primitivos o campos de nivel superior sencillos, donde sea posible. Las respuestas JSON compatibles incluyen objetos de nivel superior, propiedades de objetos de nivel superior y matrices de objetos de nivel superior. Las formas más complejas no son compatibles actualmente de extremo a extremo, incluyendo propiedades anidadas, matrices de objetos y cargas de objetos dinámicas.

Al igual que otras acciones de agentes, si una entrada o salida de acción de herramienta MCP contiene múltiples niveles de propiedades (por ejemplo, propiedades anidadas, matrices de objetos o cargas de objeto dinámicas), el agente solo puede utilizar el primer nivel de propiedades en entradas de acción, salidas de acción y asignaciones de variables.

{"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": {}
      }
    }
  }
}

Tipos Lightning

Todas las acciones de agentes utilizan tipos Lightning para definir la estructura, validar y mostrar los datos en entradas y salidas. Los esquemas de entrada y salida de herramientas MCP no siempre se asignan a tipos Lightning, porque el tipo de datos está definido por el servidor y el protocolo admite una amplia gama de tipos de datos. Por ejemplo, cuando un tipo de datos contiene un operador, como any/or. Obtenga más información acerca de tipos Lightning estándar y cómo se utilizan los tipos Lightning en acciones de agentes.

Cuando los datos no se pueden resolver en un tipo Lightning, puede ver el esquema de entrada y salida para la herramienta en la página de registro para el servidor MCP en Agentforce Registry. Pero la entrada o salida aparece vacía para la acción de herramienta MCP asociada en la biblioteca de activos y en su agente.

Puede seguir utilizando la acción de la herramienta MCP con su agente, pero la entrada o la salida no se pueden almacenar en una variable ni utilizar en instrucciones o lógica descendente.

• La acción no se puede encadenar a otra acción en secuencia de forma determinista. Sin embargo, en el razonamiento, el agente puede elegir entradas y salidas relevantes.
• La acción no se puede ejecutar de forma determinante en instrucciones de razonamiento, porque cada entrada y salida se deben asignar a una variable.
• No puede utilizar salidas que no se resuelven en tipos Lightning en filtros o declaraciones condicionales.

Para obtener los mejores resultados, planifique el razonamiento de los agentes sobre el comportamiento determinista en el diseño de su agente y configure instrucciones de subagentes de lenguaje natural sencillas.

Este es un ejemplo de una herramienta MCP con un resultado que no se asigna a un tipo Lightning.

• Esquemas de entrada y salida en la página de registro del servidor MCP:
  
• Un resultado vacío para la acción de herramienta MCP asociada en la biblioteca de activos:
  
• Un resultado vacío para la acción de herramienta MCP asociada en un agente: