Svarsscheman för MCP-verktyg och agentdesign

JSON-svar som stöds

Agentforce Builder-stödet är starkast för primitiva värden och grund fältåtkomst, så välj MCP-serververktyg med enkla strukturerade JSON-svar eller justera dina svar för att visa viktiga värden som primitiva fält eller enkla toppnivåfält, där så är möjligt. JSON-svar som stöds inkluderar toppnivåobjekt, toppnivåobjektegenskaper och toppnivåmatriser av objekt. Mer komplexa former stöds för närvarande inte från början till slut, inklusive kapslade egenskaper, matriser av objekt och dynamiska objektbelastningar.

Precis som andra agentåtgärder, om ett MCP-verktygs indata eller utdata innehåller flera nivåer av egenskaper (till exempel kapslade egenskaper, matriser av objekt eller dynamiska objektbelastningar), kan agenten endast använda den första nivån av egenskaper i åtgärdsindata, åtgärdsutdata och variabelmappningar.

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

Alla agentåtgärder använder Lightning för att definiera strukturen på, validera och visa data i indata och utdata. Indata- och utdatascheman för MCP-verktyg mappar inte alltid till Lightning eftersom datatypen definieras av servern och protokollet har stöd för ett brett spektrum av datatyper. Till exempel när en datatyp innehåller en operator, som någon/eller. Få reda på mer om standard Lightning typer och hur Lightning typer används i agentåtgärder.

Om data inte kan lösas till en Lightning kan du se indata- och utdataschemat för verktyget på postsidan för MCP-servern i Agentforce. Men indata eller utdata visas tomma för den associerade MCP-verktygsåtgärden i tillgångsbiblioteket och i din agent.

Du kan fortfarande använda MCP-verktygsåtgärden med din agent, men indata eller utdata kan inte lagras i en variabel eller användas i logik eller instruktioner längre ner.

• Åtgärden kan inte kedjas till en annan åtgärd i sekvens deterministiskt. Agenten kan dock välja relevanta indata och utdata i resonemanget.
• Åtgärden kan inte köras deterministiskt i resonemangsinstruktioner eftersom varje indata och utdata måste mappas till en variabel.
• Det går inte att använda utdata som inte löses till Lightning i villkorliga uttryck eller filter.

För bästa resultat, planera agenters resonemang över deterministiskt beteende i din agentdesign och konfigurera enkla instruktioner för underagenter på naturligt språk.

Här är ett exempel på ett MCP-verktyg med en utdata som inte mappar till en Lightning.

• Indata- och utdatascheman på postsidan för MCP-servern:
  
• En tom utdata för den associerade MCP-verktygsåtgärden i tillgångsbiblioteket:
  
• En tom utdata för den associerade MCP-verktygsåtgärden i en agent: