MCP-værktøjssvarskemaer og agentdesign

Understøttede JSON-svar

Agentforce Builder-understøttelse er stærkest for primitive værdier og fladfeltadgang, så vælg MCP-serverværktøjer med enkle strukturerede JSON-svar eller juster dine svar for at vise vigtige værdier som primitive felter eller enkle felter på topniveau, hvor det er muligt. Understøttede JSON-svar inkluderer objekter på topniveau, objektegenskaber på topniveau og matrikser på topniveau af objekter. Mere komplekse figurer understøttes aktuelt ikke end-til-end, herunder indlejrede egenskaber, matrikser af objekter og dynamiske objektdata.

Ligesom andre agenthandlinger kan agenten kun bruge det første niveau af egenskaber i handlingsinput, handlingsoutput og variabeltilknytninger, hvis et MCP-værktøjshandlingsinput eller -output indeholder flere niveauer af egenskaber (f.eks. indlejrede egenskaber, matrikser af objekter eller dynamiske objektdata).

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

Alle agenthandlinger bruger Lightning til at definere strukturen af, validere og vise data i input og output. Input- og outputskemaerne for MCP-værktøjer tilknyttes ikke altid til Lightning, da datatypen er defineret af serveren, og protokollen understøtter en lang række datatyper. Når f.eks. en datatype indeholder en operator, f.eks. ethvert/eller. Få mere at vide om standard Lightning-typer og hvordan Lightning-typer bruges i agenthandlinger.

Når data ikke kan løses til en Lightning, kan du få vist input- og outputskemaet for værktøjet på registreringssiden for MCP-serveren i Agentforce. Men inputtet eller outputtet vises tomt for den tilknyttede MCP-værktøjshandling i aktivbiblioteket og i din agent.

Du kan stadig bruge MCP-værktøjshandlingen med din agent, men inputtet eller outputtet kan ikke lagres i en variabel eller bruges i downstreamlogik eller instruktioner.

• Handlingen kan ikke kædes til en anden handling i rækkefølge deterministisk. Men i årsagssammenhæng kan agenten vælge relevante input og output.
• Handlingen kan ikke køres deterministisk i argumenteringsinstruktioner, da hver input og output skal tilknyttes en variabel.
• Du kan ikke bruge output, der ikke passer til Lightning-typer i betingede erklæringer eller filtre.

Du opnår de bedste resultater ved at planlægge agentovervejelser over deterministisk adfærd i dit agentdesign og konfigurere enkle, naturlige sprogunderagentinstruktioner.

Her er et eksempel på et MCP-værktøj med et output, der ikke er tilknyttet en Lightning.

• Input- og outputskemaer på MCP-serverregistreringssiden:
  
• Et tomt output for den tilknyttede MCP-værktøjshandling i aktivbiblioteket:
  
• Et tomt output for den tilknyttede MCP-værktøjshandling i en agent: