MCP-verktøyresponsskjemaer og agentutforming

Støttede JSON-svar

Agentforce Builder-støtte er sterkest for primitive verdier og grunnet felttilgang, så velg MCP-serverververktøy med enkle strukturerte JSON-svar eller juster svarene slik at viktige verdier vises som primitive felt eller enkle felt på øverste nivå, der det er mulig. Støttede JSON-svar inkluderer objekter på øverste nivå, objektegenskaper på øverste nivå og objekter på øverste nivå. Mer komplekse former støttes for øyeblikket ikke fra ende til ende, inkludert nestede egenskaper, arrayer av objekter og dynamiske objektbelastninger.

Hvis inndata eller utdata for en MCP-verktøyhandling inneholder flere nivåer av egenskaper (for eksempel nestede egenskaper, arrayer av objekter eller dynamiske objektbelastninger), kan agenten bare bruke det første nivået av egenskaper i handlingsinndata, handlingsutdata og variabeltilordninger.

{"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 bruker Lightning til å definere strukturen av, validere og vise dataene i inndata og utdata. Inndata- og utdataskjemaene for MCP-verktøy tilordnes ikke alltid til Lightning fordi datatypen er definert av serveren, og protokollen støtter et bredt spekter av datatyper. For eksempel når en datatype inneholder en operator, for eksempel hvilken som helst/eller. Finn ut mer om standard Lightning-typer og hvordan Lightning-typer brukes i agenthandlinger.

Når data ikke kan løses til en Lightning, kan du vise inndata- og utdataskjemaet for verktøyet på postsiden for MCP-serveren i Agentforce. Men inndataene eller utdataene vises tomme for den tilknyttede MCP-verktøyhandlingen i aktivumbiblioteket og i agenten.

Du kan fremdeles bruke MCP-verktøyet med agenten, men inndata eller utdata kan ikke lagres i en variabel eller brukes i nedstrøms logikk eller instruksjoner.

• Handlingen kan ikke kjedes til en annen handling i sekvens deterministisk. I vurderingen kan imidlertid agenten velge relevante inndata og utdata.
• Handlingen kan ikke kjøres deterministisk i begrunnelsesinstruksjoner, fordi hver inndata og utdata må tilordnes til en variabel.
• Du kan ikke bruke utdata som ikke løses til Lightning-typer, i betingede setninger eller filtre.

For å få best mulig resultat kan du planlegge agentenes vurdering av deterministisk virkemåte i agentutformingen og konfigurere enkle underagentinstruksjoner på naturlig språk.

Her er et eksempel på et MCP-verktøy med utdata som ikke tilordnes til en Lightning.

• Inndata- og utdataskjemaer på MCP-serverpostsiden:
  
• En tom utdata for den tilknyttede MCP-verktøyhandlingen i aktivumbiblioteket:
  
• En tom utdata for den tilknyttede MCP-verktøyhandlingen i en agent: