MCP-työkalun vastausskeemat ja agenttien suunnittelu

Tuetut JSON-vastaukset

Agentforce Builder tukee tehokkaimmin primitiivisiä arvoja ja epätarkkoja kenttien käyttöoikeuksia, joten valitse MCP-palvelinkoneet, joilla on yksinkertaisia rakenteellisia JSON-vastauksia, tai säädä vastauksiasi näyttämään tärkeitä arvoja primitiivisina kenttinä tai yksinkertaisina ylimmän tason kenttinä, jos se on mahdollista. Tuettuihin JSON-vastauksiin sisältyy ylätason objekteja, ylätason objektien ominaisuuksia ja objektien ylätason array-taulukoita. Monimutkaisempia muotoja ei tueta tällä hetkellä loppuun asti, mukaan lukien sisäkkäiset ominaisuudet, objektien array-taulukot ja dynaamisten objektien tietosisällöt.

Muiden agenttitoimintojen tapaan, jos MCP-työkalun toiminnon input- tai output-arvo sisältää useita ominaisuustasoja (esimerkiksi sisäkkäisiä ominaisuuksia, objektien arrayja tai dynaamisia objektien tietosisältöjä), agentti voi käyttää vain ensimmäistä ominaisuustasoa toimintojen input-arvoissa, toimintojen output-arvoissa ja muuttujien kartoituksissa.

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

Kaikki agenttitoiminnot käyttävät Lightning datan rakenteen määrittämiseen, vahvistamiseen ja näyttämiseen syötteissä ja tuloksissa. MCP-työkalujen input- ja output-skeemat eivät aina kartoiteta Lightning, koska datatyyppi määritetään palvelimella ja protokolla tukee useita eri datatyyppejä. Kun datatyyppi sisältää esimerkiksi operaattorin, kuten mikä tahansa/tai. Lue lisää vakiomuotoisista Lightning-tyypeistä ja miten Lightning-tyyppejä käytetään agenttien toiminnoissa.

Kun tietoja ei voi ratkaista Lightning, voit tarkastella työkalun input- ja output-skeemaa MCP-palvelimen tietuesivulta Agentforce. Input- tai output-arvo näytetään kuitenkin tyhjänä asiaan liittyvälle MCP-työkalun toiminnolle omaisuuskirjastossa ja agenteissasi.

Voit edelleen käyttää MCP-työkalun toimintoa agenttisi kanssa, mutta input- tai output-arvoa ei voi tallentaa muuttujaan tai käyttää downstream-logiikassa tai ohjeissa.

• Toimintoa ei voi ketjuttaa toiseen toimintoon järjestyksessä deterministisesti. Agentti voi kuitenkin valita asiaankuuluvia syötteitä ja tuloksia.
• Toimintoa ei voi suorittaa deterministisesti päättelyohjeissa, koska jokainen input- ja output-arvo täytyy kartoittaa muuttujaan.
• Et voi käyttää tuloksia, jotka eivät renderöidä Lightning-tyyppejä, ehdoissa lausekkeissa tai suodattimissa.

Suunnittele agenteillesi deterministisiä toimintatapoja koskevat perustelut agenttien suunnittelussa ja määritä yksinkertaisia, luonnollisen kielen alaisten agenttien ohjeita parhaiden tulosten aikaansaamiseksi.

Alla on esimerkki MCP-työkalusta, jonka output-arvo ei ole kartoitettu Lightning.

• MCP-palvelimen tietuesivulla olevat syöttö- ja lähtöskeemat:
  
• Omaisuuskirjaston asiaan liittyvän MCP-työkalun toiminnon tyhjä tulos:
  
• Agenttiin liittyvän MCP-työkalun toiminnon tyhjä tulos: