Esquemas de resposta da ferramenta MCP e design do agente

Respostas JSON com suporte

O Suporte do Agentforce Builder é mais forte para valores primitivos e acesso a campos superficiais, portanto, escolha ferramentas do servidor MCP com respostas JSON estruturadas simples ou ajuste suas respostas para expor valores importantes como campos primitivos ou campos simples de nível superior, quando possível. As respostas JSON com suporte incluem objetos de nível superior, propriedades de objeto de nível superior e matrizes de objetos de nível superior. No momento, não há suporte para formas mais complexas de ponta a ponta, incluindo propriedades aninhadas, matrizes de objetos e cargas úteis de objetos dinâmicos.

Como outras ações do agente, se uma entrada ou saída de ação da ferramenta MCP contiver vários níveis de propriedades (por exemplo, propriedades aninhadas, matrizes de objetos ou cargas úteis de objeto dinâmico), o agente poderá usar apenas o primeiro nível de propriedades em entradas de ação, saídas de ação e mapeamentos de variável.

{"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 do Lightning

Todas as ações do agente usam tipos do Lightning para definir a estrutura, validar e exibir os dados em entradas e saídas. Os esquemas de entrada e saída das ferramentas MCP nem sempre mapeiam para tipos do Lightning, pois o tipo de dados é definido pelo servidor e o protocolo suporta uma ampla variedade de tipos de dados. Por exemplo, quando um tipo de dados contém um operador, como any/or. Saiba mais sobre os tipos Lightning padrão e como os tipos Lightning são usados em ações do agente.

Quando os dados não podem ser resolvidos para um tipo do Lightning, você pode visualizar o esquema de entrada e saída para a ferramenta na página de registro para o servidor MCP no Registro Agentforce. Porém, a entrada ou a saída aparece vazia para a ação da ferramenta MCP associada na biblioteca de ativos e em seu agente.

Você ainda pode usar a ação da ferramenta MCP com seu agente, mas a entrada ou a saída não podem ser armazenadas em uma variável nem usadas em lógica ou instruções downstream.

• A ação não pode ser encadeada a outra ação em sequência deterministicamente. No entanto, no raciocínio, o agente pode escolher entradas e saídas relevantes.
• A ação não pode ser executada deterministicamente nas instruções de raciocínio, pois cada entrada e saída deve ser mapeada para uma variável.
• Não é possível usar saídas que não sejam resolvidas para tipos do Lightning em instruções condicionais ou filtros.

Para obter melhores resultados, planeje o raciocínio do agente sobre o comportamento determinístico em seu design de agente e configure instruções simples de subagente de linguagem natural.

Aqui está um exemplo de uma ferramenta de MCP com uma saída que não é mapeada para um tipo do Lightning.

• Esquemas de entrada e saída na página de registro do servidor MCP:
  
• Uma saída vazia para a ação da ferramenta MCP associada na biblioteca de ativos:
  
• Uma saída vazia para a ação da ferramenta MCP associada em um agente: