Reactieschema's voor MCP-tools en agentontwerp

Ondersteunde JSON-responsen

Agentforce Builder biedt de beste ondersteuning voor primitieve waarden en ondiepe veldtoegang. Kies daarom MCP-servertools met eenvoudige gestructureerde JSON-responsen of pas uw responsen aan om belangrijke waarden zichtbaar te maken als primitieve velden of eenvoudige velden van topniveau, waar mogelijk. Ondersteunde JSON-responsen omvatten objecten van topniveau, objecteigenschappen van topniveau en arrays van objecten van topniveau. Complexere vormen worden momenteel niet van begin tot eind ondersteund, inclusief geneste eigenschappen, arrays van objecten en dynamische objectpayloads.

Net als andere agentacties kan de agent, als een actie-invoer of uitvoer van een MCP-tool meerdere niveaus van eigenschappen bevat (bijvoorbeeld geneste eigenschappen, arrays van objecten of dynamische objectpayloads), alleen het eerste niveau van eigenschappen gebruiken in actie-invoer, actie-uitvoer en variabeletoewijzingen.

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

Alle agentacties gebruiken Lightning typen voor het definiëren van de structuur van, valideren van en weergeven van de gegevens in invoer en uitvoer. De invoer- en uitvoerschema's van MCP-tools worden niet altijd toegewezen aan Lightning typen, omdat het gegevenstype wordt gedefinieerd door de server en het protocol een breed scala aan gegevenstypen ondersteunt. Bijvoorbeeld wanneer een gegevenstype een operator bevat, zoals any/or. Lees meer over standaard Lightning typen en hoe Lightning typen worden gebruikt in agentacties.

Wanneer gegevens niet kunnen worden opgelost naar een Lightning type, kunt u het invoer- en uitvoerschema voor de tool weergeven op de recordpagina voor de MCP-server in het Agentforce Register. Maar de invoer of uitvoer lijkt leeg voor de gekoppelde MCP-toolactie in de activumbibliotheek en in uw agent.

U kunt de MCP-toolactie nog steeds gebruiken met uw agent, maar de invoer of uitvoer kan niet worden opgeslagen in een variabele of worden gebruikt in logica of instructies verderop in de stroom.

• De actie kan niet deterministisch worden gekoppeld aan een andere actie in de volgorde. In redenering kan de agent echter relevante invoer en uitvoer kiezen.
• De actie kan niet deterministisch worden uitgevoerd in redeneerinstructies, omdat elke invoer en uitvoer moet worden toegewezen aan een variabele.
• U kunt geen uitvoer gebruiken die niet naar Lightning typen leidt in voorwaardelijke instructies of filters.

Plan voor de beste resultaten agentredenering in plaats van deterministisch gedrag in uw agentontwerp en configureer eenvoudige, natuurlijke taalinstructies voor subagenten.

Hier is een voorbeeld van een MCP-tool met een uitvoer die niet is toegewezen aan een Lightning type.

• Invoer- en uitvoerschema's op de recordpagina van de MCP-server:
  
• Een lege uitvoer voor de gekoppelde MCP-toolactie in de activumbibliotheek:
  
• Een lege uitvoer voor de gekoppelde MCP-toolactie in een agent: