Schemi di risposta dello strumento MCP e progettazione degli agenti

Risposte JSON supportate

Poiché il supporto di Agentforce Builder è più forte per i valori primitivi e l'accesso a campi poco profondi, scegliere strumenti server MCP con risposte JSON strutturate semplici o modificare le risposte in modo che espongano valori importanti come campi primitivi o semplici campi di livello superiore, ove possibile. Le risposte JSON supportate includono oggetti di livello massimo, proprietà degli oggetti di livello massimo e matrici di oggetti di livello massimo. Le forme più complesse non sono attualmente supportate end-to-end, incluse le proprietà nidificate, le matrici di oggetti e i payload di oggetti dinamici.

Come le altre azioni agente, se un input o un output di un'azione strumento MCP contiene più livelli di proprietà (ad esempio proprietà nidificate, matrici di oggetti o payload di oggetti dinamici), l'agente può utilizzare solo il primo livello di proprietà negli input di azioni, negli output di azioni e nelle mappature delle variabili.

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

Tipi Lightning

Tutte le azioni degli agenti utilizzano i tipi Lightning per definire la struttura, convalidare e visualizzare i dati in input e output. Gli schemi di input e output degli strumenti MCP non vengono sempre mappati ai tipi Lightning, poiché il tipo di dati è definito dal server e il protocollo supporta un'ampia gamma di tipi di dati. Ad esempio, quando un tipo di dati contiene un operatore, ad esempio any/or. Ulteriori informazioni sui tipi Lightning standard e su come Lightning viene utilizzato.

Quando i dati non possono essere risolti in un tipo Lightning, è possibile visualizzare lo schema di input e output dello strumento nella pagina di record del server MCP nel Registro Agentforce. Tuttavia, l'input o l'output appare vuoto per l'azione strumento MCP associata nella libreria di asset e nell'agente.

È comunque possibile utilizzare l'azione dello strumento MCP con l'agente, ma l'input o l'output non possono essere memorizzati in una variabile né utilizzati nella logica o nelle istruzioni a valle.

• L'azione non può essere concatenata a un'altra azione in sequenza in modo deterministico. Tuttavia, nel ragionamento, l'agente può scegliere input e output pertinenti.
• L'azione non può essere eseguita deterministicamente nelle istruzioni di ragionamento, poiché ogni input e output devono essere mappati a una variabile.
• Non è possibile utilizzare output che non si risolvono in tipi Lightning in istruzioni condizionali o filtri.

Per risultati ottimali, pianificare il ragionamento degli agenti rispetto al comportamento deterministico nella progettazione dell'agente e configurare istruzioni semplici per i subagenti in linguaggio naturale.

Di seguito è riportato un esempio di strumento MCP con un output che non viene mappato a un tipo Lightning.

• Schemi di input e output nella pagina del record del server MCP:
  
• Un output vuoto per l'azione strumento MCP associata nella libreria di asset:
  
• Un output vuoto per l'azione strumento MCP associata in un agente: