MCP-Tool-Antwortschemata und Agentendesign

Unterstützte JSON-Antworten

Die Agentforce Builder-Unterstützung ist für primitive Werte und flachen Feldzugriff am stärksten. Wählen Sie daher MCP-Servertools mit einfachen strukturierten JSON-Antworten aus oder passen Sie Ihre Antworten an, um wichtige Werte nach Möglichkeit als primitive Felder oder einfache Felder der obersten Ebene anzuzeigen. Zu den unterstützten JSON-Antworten zählen Objekte der obersten Ebene, Objekteigenschaften der obersten Ebene und Arrays von Objekten der obersten Ebene. Komplexere Formen werden derzeit nicht durchgängig unterstützt, einschließlich verschachtelter Eigenschaften, Arrays von Objekten und dynamischer Objektnutzlasten.

Wie andere Agentenaktionen kann der Agent, wenn eine MCP-Tool-Aktionseingabe oder -Ausgabe mehrere Ebenen von Eigenschaften enthält (beispielsweise verschachtelte Eigenschaften, Arrays von Objekten oder dynamische Objektnutzlasten), nur die erste Ebene von Eigenschaften in Aktioneningaben, Aktionen und Variablenzuordnungen verwenden.

{"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-Typen

Für alle Agentenaktionen werden Lightning-Typen verwendet, um die Struktur der Ein- und Ausgaben zu definieren, zu validieren und anzuzeigen. Die Eingabe- und Ausgabeschemata von MCP-Tools werden nicht immer Lightning-Typen zugeordnet, da der Datentyp vom Server definiert wird und das Protokoll eine Vielzahl von Datentypen unterstützt. Wenn ein Datentyp beispielsweise einen Operator wie any/or enthält. Erfahren Sie mehr über standardmäßige Lightning Typen und darüber, wie Lightning Typen in Agentenaktionen verwendet werden.

Wenn Daten nicht in einen Lightning Typ aufgelöst werden können, können Sie das Eingabe- und Ausgabeschema für das Tool auf der Datensatzseite für den MCP Server in der Agentforce Registry anzeigen. Die Eingabe oder Ausgabe wird jedoch für die zugeordnete MCP-Tool-Aktion in der Datenbestandsbibliothek und in Ihrem Agenten leer angezeigt.

Sie können die MCP-Tool-Aktion weiterhin mit Ihrem Agenten verwenden. Die Eingabe oder Ausgabe kann jedoch nicht in einer Variablen gespeichert oder in nachgelagerten Logiken oder Anweisungen verwendet werden.

• Die Aktion kann nicht deterministisch mit einer anderen Aktion verknüpft werden. Bei der Argumentation kann der Agent jedoch relevante Eingaben und Ausgaben auswählen.
• Die Aktion kann nicht deterministisch in Argumentationsanweisungen ausgeführt werden, da jede Eingabe und Ausgabe einer Variablen zugeordnet werden muss.
• In bedingten Anweisungen oder Filtern können keine Ausgaben verwendet werden, die nicht in Lightning-Typen aufgelöst werden.

Planen Sie für optimale Ergebnisse die Argumentation von Agenten über deterministisches Verhalten in Ihrem Agentendesign ein und konfigurieren Sie einfache Anweisungen für Unteragenten mit natürlicher Sprache.

Im Folgenden finden Sie ein Beispiel für ein MCP-Tool mit einer Ausgabe, die keinem Lightning Typ zugeordnet ist.

• Eingabe- und Ausgabeschemas auf der MCP-Server-Datensatzseite:
  
• Eine leere Ausgabe für die zugeordnete MCP-Tool-Aktion in der Datenbestandsbibliothek:
  
• Eine leere Ausgabe für die zugeordnete MCP-Tool-Aktion in einem Agenten: