DATAFOCUS · OT FLASH · R56

OT Flashin Agent- ja MCP-integraatiokäsikirja

Protokolla, valtuutus, työkalusopimukset ja täydellinen kutsukulku

Rakenna jäljitettäviä data- ja tietämyssovelluksia OT Flash r56:n julkisen Remote MCP -rajapinnan avulla. Tämä käsikirja kattaa OAuthin, protokollaviestit, kaikkien ilmoitettujen työkalujen parametriviitteen, todistesäännöt, ehdolliset ominaisuudet ja palautumiskulut sekä sisältää ajettavan asiakasohjelman ja synteettistä dataa käyttäviä esimerkkejä.

Agent-kehittäjät, integraatioinsinöörit ja ylläpitäjät

Mukana toimitettavissa esimerkeissä säilytetään kiinankieliset näyttökenttien nimet. Käyttöliittymän kieli ja ohjetekstin käännös eivät muuta todellisia taulukoiden nimiä, sarakkeiden nimiä, enum-arvoja, työkalujen nimiä tai protokollakenttiä.

Luku 1

Agent-integraation laajuus ja valmistumiskriteerit

Valitse valtuutuksen sisääntulopiste ja vie kyselyt, todisteiden keruu tai hallitut kirjoitukset loppuun palvelimen kuittausten perusteella.

OT Flash r56 tarjoaa ulkoisille Agenteille ontologiarajauksen mukaiset data- ja tietämysominaisuudet Remote MCP -rajapinnan kautta sekä erillisen liiketoimintatyötilan sisääntulon. Agentin on päätettävä suoritettavissa oleva työ todellisten tools/list-, inputSchema- ja OAuth-scope-tietojen sekä nykyisten resurssioikeuksien perusteella. Staattisen käsikirjan perusteella ei saa päätellä, että jossakin asennuksessa olisi otettu käyttöön kaikki valinnaiset ominaisuudet.

Kuva A1: Ulkoinen Agent käyttää alkuperäisiä kysely-, tietämys- ja liiketoimintaominaisuuksia OAuth- ja MCP-rajapintojen kautta. Rajapintasuhteiden kaavio.
SisääntulopisteKäyttötarkoitusRajaus
/mcpOntologia, datataulukot, dokumenttitietämys, natiivi Search sekä ehdollisesti avoimet analyysi- ja mallinnusominaisuudetNykyisen käyttäjän oikeuksien ja tämän valtuutuksen resurssien leikkaus
/mcp/businessLiiketoimintajärjestelmien löytäminen, kyselyt, toimenpidesuunnitelmat, tilat ja suoritusErillinen liiketoimintajärjestelmän valtuutus ja julkaisusopimus
Ontologia-agentin upotettu sivuOntologiakeskustelun käyttäminen ihmiselle suunnatussa käyttöliittymässäEdellyttää todellista kirjautumisistuntoa; ei ole ilman kirjautumista toimiva MCP Tokenin vaihtopiste

Ominaisuusluokittelu

  • Peruslukeminen: ontologia ja resurssit, graafin paikannus, tietämyshaku ja täydellinen alkuteksti, valtuutettujen taulukoiden tiedot ja Doris SQL.
  • Erillinen delegointi: dfc_search vaatii scopen search:operate ja käyttää edelleen alkuperäisiä käyttäjä- ja mallioikeuksia.
  • Ehdollisesti avoimet ominaisuudet: analyysi, pysyvät raportit, artefaktiluonnokset ja niiden käyttöönotto, ontologiamallikyselyt sekä delegoidut Agent-tehtävät.
  • Ominaisuudet, jotka eivät ole käytettävissä: Flashin dfc_etl raportoi vain capabilities-tiedot eikä tarjoa Heavy ETL -suoritusta. AutoML ja sisäisen FocusCode-työtilan sisääntulot eivät kuulu tämän käsikirjan kattamaan julkiseen Flash API -rajapintaan.

Valmistumiskriteerit

Faktojen lukeminen edellyttää todellista, käyttökelpoista kysely- tai koko alkutekstin kuittausta; ehdokasta luotaessa on ilmoitettava, ettei sitä ole vielä otettu käyttöön; julkaisu edellyttää todellista APPLIED-kuittausta; peruutuksessa on erotettava pyyntö ja vahvistus. Vastausteksti, HTTP 200, työkalun vastaanottoilmoitus tai mallin ilmoitus ”valmis” eivät yksinään todista liiketoimintatoiminnon onnistumista.

Mukana tuleva reference/mcp-tool-catalog.json on r56:n offline-ilmoitusviite. Se sisältää myös ehdollisesti käyttöön otettavat määritelmät, eikä se ole minkään käyttäjän reaaliaikainen tools/list-luettelo. Koko luettelo käsittää 28 ontologiaydintyökalua, 4 ohjaimen ehdollista laajennusta ja 8 liiketoimintapuolen työkalua, eikä se tarkoita, että kaikki olisivat oletuksena avoimia.

Luku 2

Nopea yhteyden muodostus ja ominaisuuksien löytäminen

Aloita instanssin virallisella verkkotunnuksella ja selvitä todelliset käytettävissä olevat työkalut vähimmäisoikeuksin.

  1. Hanki ylläpitäjältä virallinen HTTPS-juuriosoite sekä se ontologia tai liiketoimintajärjestelmä, johon tarvitset pääsyn. Älä käytä dokumentaation esimerkkiverkkotunnuksia oikeisiin liiketoimintakutsuihin.
  2. Määritä MCP-palvelinosoite arvoksi https://flash.example.com/mcp; liiketoimintatyötila käyttää saman verkkotunnuksen polkua /mcp/business.
  3. Käynnistä OAuth-kirjautuminen ja valtuutus asiakasohjelman tuen mukaisesti ja tarkista resurssit ja scope; älä lähetä käyttäjänimeä ja salasanaa MCP:lle.
  4. Käytä kyseisen protokollasukupolven löytämis- tai initialize-mekanismia ja lue sen jälkeen tools/list ja resurssikuvaukset.
  5. Tee ensin pieni vain luku -pyyntö ja tarkista strukturoitu tulos ja virheet, ennen kuin suoritat käyttäjän tavoitteen.

Asiakasohjelman määrityskatkelma

json
{
  "mcpServers": {
    "ot-flash": {
      "url": "https://flash.example.com/mcp"
    }
  }
}

Katkelma havainnollistaa palvelinosoitteen määrittämistä; tarkka määritystiedoston rakenne ja OAuth-tuki riippuvat asiakasohjelmasta. Älä kirjoita julkisiin tiedostoihin todellisia access_token-, refresh_token- tai Cookie-arvoja tai ylläpitäjän salasanoja.

Modernin protokollan löytäminen

http
POST /mcp HTTP/1.1
Host: flash.example.com
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2026-07-28
Mcp-Method: server/discover

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "server/discover",
  "params": {
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {"name": "flash-client", "version": "1.0.0"},
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

Tarkistukset ennen integraatiota

  • Resurssin juuriosoite, OAuth issuer ja käänteisvälityspalvelimen julkinen osoite vastaavat toisiaan.
  • Asiakasohjelma tukee kyseistä protokollasukupolvea sen sijaan, että lähettäisi initialize-viestin kiinteästi uuden protokollan päätepisteeseen.
  • Nykyinen valtuutus sisältää tarvittavan ontologian tai liiketoimintajärjestelmän.
  • Token on voimassa, ja uudet valinnaiset scopet on nimenomaisesti valtuutettu.
Luku 3

OAuth-löytäminen, rekisteröinti ja valtuutus

Käytä valtuutuskoodia ja PKCE-mekanismia äläkä paljasta Agentille tuotteen kirjautumistietoja.

Kuva A2: OAuthin valtuutuskoodi- ja PKCE-kulku. Sekvenssikaavio.
PäätepisteMetodiTarkoitus
/.well-known/oauth-protected-resourceGETOntologian MCP-resurssin löytäminen
/.well-known/oauth-protected-resource/mcpGETOntologiaresurssin löytäminen yhteensopivalla polulla
/.well-known/oauth-protected-resource/mcp/businessGETLiiketoiminnan MCP-resurssin löytäminen
/.well-known/oauth-authorization-serverGETValtuutuspalvelimen metatiedot
/oauth/registerPOST JSONPublic clientin dynaaminen rekisteröinti
/oauth/authorizeGET tai POST-lomakeKirjautuminen, resurssin valinta ja valtuutuksen vahvistus
/oauth/tokenPOST-lomakeValtuutuskoodin vaihto ja refresh-tokenin kierrätys
/oauth/revokePOST-lomakeTokenin mitätöinti
/oauth/grantsGETKirjautuneen käyttäjän näkymä valtuutettuihin yhteyksiin
/oauth/grants/revokePOST-lomakeYhteyden peruuttaminen alkuperäisen sivukulun mukaisesti

Valtuutusjärjestys

  1. Lue suojatun resurssin metatiedot ja valtuutuspalvelimen metatiedot. Ilman Tokenia saatava 401-vastaus ja WWW-Authenticate-otsikko osoittavat resurssin löytämisosoitteeseen.
  2. Rekisteröi asiakasidentiteetti tai käytä olemassa olevaa. r56:n dynaamisesti rekisteröity public client käyttää arvoa token_endpoint_auth_method=none; client secretillä ei voi korvata PKCE-mekanismia.
  3. Luo satunnaiset state- ja code_verifier-arvot ja laske code_challenge S256-menetelmällä.
  4. Avaa metatietojen osoittama authorize-osoite ja välitä response_type=code, client_id, tarkka redirect_uri, scope, resource, state, code_challenge ja code_challenge_method=S256.
  5. Käyttäjä kirjautuu DataFocusiin ja valitsee ontologian tai liiketoimintajärjestelmän. Asiakasohjelma ei saa etukäteen valita resursseja, joihin käyttäjällä ei ole pääsyä.
  6. Vastaanota takaisinkutsu, varmista state ja issuer ja vaihda valtuutuskoodi alkuperäisellä code_verifier-arvolla.
  7. Käytä access_tokenia vain MCP:n Bearer-todennukseen. Päivitä tokenit alkuperäisellä OAuth-kululla ja tallenna kierrätetty refresh_token turvallisesti.

Rekisteröintiesimerkki

json
{
  "client_name": "OT Flash Knowledge Client",
  "redirect_uris": ["http://127.0.0.1:8765/callback"],
  "application_type": "native",
  "token_endpoint_auth_method": "none",
  "grant_types": ["authorization_code", "refresh_token"],
  "response_types": ["code"]
}

Web-asiakasohjelman takaisinkutsussa käytetään protokollaa HTTPS; natiivi asiakasohjelma voi käyttää tuettua loopback-osoitetta. Sekä valtuutus että Tokenin vaihto täsmäytetään tarkasti rekisteröityyn takaisinkutsuun. Yksi Grant kohdistuu yhteen suojattuun resurssiin (protected resource); ontologian scopea ja liiketoimintatyötilan scopea ei yhdistetä samaan yhteyteen.

Tokenin elinkaari

r56-palvelimen oletusarvot ovat: access token 3600 sekuntia, refresh token 2 592 000 sekuntia ja valtuutuskoodi 300 sekuntia; asennuskohtainen määritys voi korvata nämä arvot. Asiakasohjelman on perustettava päätelmänsä Token-vastauksen expires_in-arvoon ja todellisiin virheisiin, eikä se saa kovakoodata oletusarvoja. Päivitä tallennettu Token päivityksen jälkeen; roolin, resurssioikeuden tai Grantin peruuttamisen jälkeen myöhemmät kutsut hylätään.

Luku 4

Scopen resurssirajat ja reaaliaikaiset oikeudet

Valtuutuksen scope delegoi olemassa olevia oikeuksia; se ei myönnä roolikorotuksia eikä jaa liiketoimintatilaa Grantien välillä.

ScopeTyypilliset ominaisuudetTärkeät rajoitukset
ontology.metadata:readOntologia, resurssit, taulukoiden rakenteetOntologian ja taulukoiden on oltava valtuutus- ja nykyisen lukuoikeuden piirissä
ontology.graph:readGraafihaku ja naapuritPalauttaa paikannustietoja, ei faktien todisteita
ontology.knowledge:readTietämyksen paikannus ja täydellinen alkutekstiTietämyskannan ja dokumenttien alkuperäiset oikeudet säilyvät
ontology.table:queryOntologiataulukon SQL sekä julkaistujen mallien kyselyTaulukkokysely vaatii lisäksi metadata-scopen; todellinen lähde ja sarakkeiden oikeudet pysyvät voimassa
search:operateNatiivit avainsanamallit ja istunnotErillinen nimenomainen delegointi; suoritetaan alkuperäisen mallin sekä käyttäjän taulukko- ja sarakeoikeuksien mukaisesti
etl:operateFlash ETL capabilitiesHeavy ETL -toimintoa ei avata
authoring.contract:readEhdollisesti avoin mallinnussopimusVaatii lisäksi ominaisuuskytkimen ja asianomaiset resurssit
authoring.artifact:readEhdokkaiden, suunnitelmien ym. lukeminen nykyisen valtuutuksen puitteissaSidotaan alkuperäisen subjektin Grantiin ja resursseihin
authoring.artifact:draftEhdokkaan lähettäminen, esikatselu jne.Ei myönnä suoritus- tai julkaisuoikeutta
authoring.artifact:applyHallittu suunnittelu ja käyttöönottoVaatii edelleen alkuperäisen liiketoimintaroolin, käytännöt ja hyväksynnän
execution.script:draftTietyt komentosarjaluonnoksetEi myönnä oikeutta komentosarjojen todelliseen suorittamiseen
datasource.http:read / draft / test / importEhdollisesti avoimet HTTP-datalähteiden artefaktiominaisuudetJokaisella on oma kytkimensä, ja alkuperäiset oikeudet pätevät
Kuva A3: Käyttäjän oikeudet, Grant, valitut resurssit ja ominaisuusmääritykset ratkaisevat yhdessä käytettävissä olevat ominaisuudet. Havainnollistava kuva.

Lukuoperaatioiden scope-yhdistelmät

dfc_table detail vaatii ontology.metadata:read; query vaatii lisäksi ontology.table:query. dfc_ontology_query vaatii kaksi lukuscopea: graph ja knowledge. dfc_knowledge_search/detail vaatii knowledge. published_model/published_query käyttää scopea table:query; candidate_query vaatii lisäksi authoring.artifact:read. Analyysityökalut tarkistavat lisäksi sallitut todiste-scopet; pysyvät raportit vaativat metadata- ja table query -scopet.

Älä kovakoodaa oletusvaltuutuksia

r56:n ontologian oletusscope-joukko sisältää table queryn; Search ja ETL ovat nimenomaisia delegointeja. Lopullisesti ratkaisevia ovat kuitenkin löytämismetatiedot, valtuutussivu, Tokenin todellinen scope ja tools/list. Vanhojen dokumenttien väitteitä ”ontologialla ei oletuksena koskaan ole SQL:ää” tai ”työkaluja on vain kuusi” ei voi käyttää nykyisen toteutuksen perusteena.

Tilojen eristys

Istunnoilla, raporteilla, ehdokkailla ja toimenpidesuunnitelmilla on omat omistajansa ja laajuutensa. Access tokenin päivitys ei siirrä alkuperäisen Grantin työtä toiselle Grantille. Älä yhdistä nykyiseen yhteyteen toisesta yhteydestä saatuja sessionId-, reportId-, planId-, hyväksyntätunnisteita tai lähde-Tokeneja.

Luku 5

HTTP- ja modernit MCP-viestit

Lähetä pyyntökohtaiset metatiedot ja vastaavat reititysotsikot oikein ja käsittele HTTP-tulokset ja työkalutulokset erikseen.

Kohtar56-käyttäytyminen
SiirtotapaTilaton Streamable HTTP, POST JSON-RPC
Tuetut tunnisteet2026-07-28 sekä 2025-11-25 2025-06-18 2025-03-26
Modernit metoditserver/discover tools/list tools/call resources/list resources/read, käytettävissä todellisten ominaisuuksien mukaan
Istunto-otsikkoMcp-Session-Id-tunnistetta ei anneta
GET ja DELETE/mcp ja /mcp/business palauttavat 405
Palvelimen SSE-ilmoituksetNämä kaksi julkista MCP-sisääntuloa eivät tarjoa niitä
HakemistovälimuistiModerni löytäminen ja listaus palauttavat ttlMs=60000 ja cacheScope=private
Tavallinen tulosModerni tulos sisältää resultType=complete ja palvelun identiteettimetatiedot

Arvot, joiden on vastattava toisiaan

  • MCP-Protocol-Version vastaa params._meta-kentän io.modelcontextprotocol/protocolVersion-arvoa.
  • Mcp-Method vastaa JSON-RPC-metodia.
  • tools/call-kutsun Mcp-Name vastaa params.name-arvoa; resources/read-kutsun nimiotsikko vastaa URI-arvoa.
  • Jokainen moderni pyyntö sisältää io.modelcontextprotocol/clientCapabilities-objektin; mukana toimitetaan myös vakio-clientInfo asiakasohjelman tunnistamista varten.

Kutsuesimerkki

json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "dfc_ontologies",
    "arguments": {"page": 1, "pageSize": 20},
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {"name": "flash-client", "version": "1.0.0"},
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

Vastaavat HTTP-otsikot ovat Mcp-Method: tools/call ja Mcp-Name: dfc_ontologies. Kaikissa esimerkeissä ACCESS_TOKEN on paikkamerkki. Älä sijoita Bearer Tokenia URL-osoitteeseen, JSON-parametreihin tai välimuistiavaimiin.

Tulosten lukeminen

Käsittele ensin HTTP-tila, tarkista sitten JSON-RPC-virhe; jos result on olemassa, tarkista vielä isError. Onnistunut työkalutulos sisältää yleensä structuredContent-kentän sekä text-sisällön, jossa on sama liiketoiminnallinen JSON; lue ensisijaisesti strukturoitu kanava äläkä summaa text-sisältöä ja structuredContent-kenttää kahtena erillisenä faktana. HTTP 200 voi sisältää työkalun epäonnistumisen.

Julkiset resurssit ja käyttöliittymä

Sisäänrakennetut kuvausresurssit eivät riipu MCP Apps -sovelluksista. Liiketoimintatyötilan sisääntulo ei tämän vuoksi saa ontologian kuvausresursseja. Visualisointia tukevien asiakasohjelmien on löydettävä vastaava käyttöliittymä todellisten ominaisuuksien ja työkalun _meta-tietojen kautta eikä arvata palauttamattomia resurssien URI-arvoja.

Luku 6

Yhteensopivuus vanhan protokollan asiakasohjelmien kanssa

Pidä protokollasukupolvi yhtenäisenä asiakasohjelmissa, jotka käyttävät edelleen alustuskättelyä.

json
{
  "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {"name": "flash-legacy-client", "version": "1.0.0"}
  }
}
  1. Lähetä initialize ja lue palvelimen neuvottelema protokollaversio sekä capabilities.
  2. Lähetä asiakasohjelman protokollan edellyttämä alustuksen valmistumisilmoitus; ilmoituksella ei ole tavallista työkalutulosta.
  3. Lue tools/list-kutsulla nykyiset valtuutetut työkalut ja lähetä sitten tools/call.
  4. Pidä nykyisen pyynnön protokollasukupolven otsikot ja viestit yhdenmukaisina; älä käytä vanhaa initialize- tai ping-kulkua 2026-07-28-viestien kanssa.

Vanha protokolla käyttää edelleen samaa Bearer/OAuth-todennusta, samoja oikeuksia ja samoja työkalusopimuksia. Se ei tarkoita, että palvelin välttämättä tarjoaisi vanhan tyylin pysyvää SSE-yhteyttä tai Mcp-Session-Id-tunnistetta; r56:n julkiset palvelut pysyvät tilattomina.

Protokollavirheet

TilanneTyypillinen tulosToimenpide
Modernit otsikot ja viesti eivät täsmääHTTP 400 JSON-RPC -32020Korjaa otsikot, metatiedot ja työkalunimet
Versioa ei tueta-32022 ja luettelo tuetuista versioistaValitse todellisuudessa tuettu protokolla
Tuntematon metodiJSON-RPC -32601, moderni pyyntö voi palauttaa HTTP 404Tarkista protokollasukupolvi ja metodi
Parametrit puuttuvat tai ovat virheellisetJSON-RPC-parametrivirhe tai työkalun isErrorKorjaa todellisen inputSchema-määrityksen mukaan
Luku 7

Valitse oikea työkalu ja todistekanava

Reititä ratkaisemattoman liiketoimintakysymyksen mukaan äläkä toista todisteiden keräämistä kiinteällä kutsuketjulla.

Kuva A4: valitse tehtävän mukaan taulukko-SQL, tietämystodisteet, Search, analyysi tai liiketoimintatoiminto. Reitityskaavio.
TehtäväEnsisijainen työkaluValmistumiseen tarvittavat todisteet
Valtuutettujen aiheiden ja resurssien löytäminendfc_ontologies dfc_ontology_resourcesTodelliset resurssien ID-tyypit ja nykyinen näkyvyysalue
Taulukkotilastot ja TopNdfc_table queryOnnistuneen suorituksen kuittaus ja täydellinen evidenceRows
Sääntöjen, sopimusten tai raporttien hakudfc_ontology_query tai knowledge search/detailTäydellinen, valtuutettu, faktoina käytettävä alkuteksti
Graafiobjektien paikantaminendfc_ontology_graph search/neighborsPaikanna todellinen lähde ja hae sitten vastaavat faktat
Natiivi avainsanavuorovaikutusdfc_manual ja sen jälkeen dfc_searchTodelliset tulokset alkuperäisessä mallissa ja liiketoimintakehyksessä
Yhdistetty analyysi ja raportitdfc_analysis_* tai dfc_report_*Kunkin strukturoidun haaran ja dokumenttitodisteen todellinen tila
Esitysten tai ontologiamallin muokkaaminendfc_authoring_* ja artifact-työkalutEhdokas, suunnitelma, hyväksyntä ja todellinen käyttöönotto tarkistetaan erikseen
Liiketoimintakomentojen suorittaminen/mcp/business:n dfb_*Julkaistut sopimukset ja alkuperäinen ActionPlan-kuittaus

Vältä tarpeettomia kutsuja

Jos sinulla on jo ajantasainen, täydellinen ja valtuutettu taulukkorakenne, älä vaadi uutta detail-kutsua joka kyselyllä; jos sinulla on jo luotettava paikannus ja todisteet, älä toista samaa hakua. Jos jokin puuttuva ulottuvuus tarvitaan, tee rajattu lisäkysely. Kun epäonnistunutta kutsua ei selvästi voi yrittää uudelleen, ratkaise puute ensin; älä korvaa harkintaa toteamalla ”yritetään uudelleen”.

Flashista rajatut ominaisuudet

dfc_etl capabilities voi palauttaa available=false ja arvon ETL_NOT_INCLUDED_IN_OT_FLASH. Sisäänrakennettujen ETL-funktioiden staattiset kuvaukset ovat tuotteiden välistä viitetietoa; ne eivät todista, että Flashiin on asennettu ETL, eivätkä ne salli Agentin siirtää suoritusta automaattisesti Heavyyn tai toiselle vuokralaiselle.

Luku 8

Ontologian resurssit ja ID-tyypit

Hanki ensin todelliset resurssikoordinaatit, jotta tallennusnimet, dokumentti-ID:t ja tietämyskanta-ID:t eivät sekoitu.

  1. Kutsu dfc_ontologies ja selaa page- ja pageSize-parametreilla ontologiat, jotka tämä valtuutus kattaa ja jotka ovat edelleen luettavissa.
  2. Kutsu dfc_ontology_resources todellisella ontologyId:lla; valitse tarpeen mukaan tables, answers, pinboards, documents ja knowledgeBindings.
  3. Käsittele sivutus erikseen kullekin resurssityypille. pageSize on enintään 100; älä päättele koko resurssijoukkoa ensimmäisen sivun perusteella.
  4. Tallenna resurssin ilmoitettu tyyppi ja alkuperäinen ID ja käytä niitä myöhemmissä kutsuissa sellaisenaan.
json
{"name":"dfc_ontology_resources","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "resourceTypes":["tables","documents","knowledgeBindings"],
  "page":1,"pageSize":100
}}
KoordinaattiLähdeEi saa korvata tällä
ontologyIdValtuutettujen ontologioiden luettelo tai nykyinen voimassa oleva kontekstiToisen ontologian ID
Taulukkoresurssin idtables-luettelo tai luotettava kontekstiphysicalName tai taulukon näyttönimi
tblDisplayName colDisplayNameNykyisen taulukon ja sarakkeiden metatiedotArvattu fyysinen SQL-tunniste
knowledgeIdknowledgeBindings tai todellinen tietämyshaun kuittausDokumenttiresurssin id
assetId documentId chunkId evidenceIdSama todellinen paikannuskuittausEri paikannustuloksista yhdistetyt kentät
rid revisionId releaseIdJulkaistu malli tai palvelimen ehdokaskontekstiItse luotu ID tai latest

Tarkkuuskäytännöt

Kaikissa 64-bittisissä resurssitunnuksissa käytetään ensisijaisesti desimaalimerkkijonoja, eikä JavaScriptissä niitä muunneta Number-tyypin kautta. Osa liiketoiminta-Schemoista sallii string- tai integer-tyypin, mikä ei tarkoita, että kokonaislukutarkkuudesta voi luopua. Myös opaque locator -arvot, UUID:t, tiivisteet ja kertakäyttöiset tokenit tallennetaan sellaisenaan.

Luku 9

Doris-taulukkokyselyt ja rakennesopimukset

Suorita vain luku -SQL valtuutetuilla taulukoilla säilyttäen tulosten semantiikan, tarkat arvot ja täydellisyyden.

Rakenteen lukeminen

json
{"name":"dfc_table","arguments":{
  "action":"detail","ontologyId":"<ONTOLOGY_ID>","id":"<TABLE_RESOURCE_ID>"
}}

detail käyttää todellista taulukkoresurssin ID:tä. Tarkista schemaComplete, tblDisplayName, columns-kohdan colDisplayName ja auktoritatiivinen sqlDataType sekä palautettu queryContract. dataType on vain yhteensopivuuskartoitus; fyysinen tallennusnimi ei ole SQL-kutsussa käytettävä taulukkonimi.

Kyselyn suorittaminen

json
{
  "name": "dfc_table",
  "arguments": {
    "action": "query",
    "ontologyId": "<ONTOLOGY_ID>",
    "sql": "SELECT \"区域\", SUM(\"销售金额\") AS \"销售金额合计\" FROM \"电商销售数据\" WHERE \"订单状态\" = '已完成' GROUP BY \"区域\" ORDER BY \"销售金额合计\" DESC",
    "maxRows": 100
  }
}

SQL-rajoitukset

  • Käytä taulukon ja sarakkeiden näyttönimiä ja lainaa tunnisteet kaksinkertaisilla lainausmerkeillä. Pyyntö on yksi ontologian rajauksen sisäinen, vain lukeva Doris-kysely.
  • Luettele tulosteet eksplisiittisesti; SELECT * ja table.* on kielletty; niiden avulla ei voi kiertää rekisteröityjen sarakkeiden oikeuksia fyysisten sarakkeiden kautta.
  • Käytä liitoksissa eksplisiittistä JOIN ... ON -syntaksia; NATURAL JOIN ja JOIN USING hylätään.
  • Sallittuja ovat kelvolliset moniulotteiset aggregoinnit, CTE:t, ikkunafunktiot, CASE, COUNT(DISTINCT ...) ja muut vain luku -lausekkeet; se, ettei semanttinen validointi kata jotakin lauseketta, ei tarkoita, että sen suorittaminen olisi yleisesti kielletty.
  • Tee aggregointi, järjestäminen ja sijoitus ensin SQL:ssä ja rajaa tulosrivien määrä vasta sen jälkeen. maxRows:n oletusarvo on 100 ja enimmäisarvo 200.

Päivämäärät ja aikavyöhykkeet

Tyyppi tai kohdeMuotoHuomio
DATECAST('2026-09-01' AS DATE) ja CURRENT_DATETekstiliteraalin ei voi suoraan olettaa olevan päivämäärätyyppiä
DATETIMECAST('2026-09-01 00:00:00' AS DATETIME) ja CURRENT_TIMESTAMPTarkista lähteen aikavyöhyke ja istunnon aikavyöhyke
Suhteellinen aikaDATE_SUB(CURRENT_DATE, INTERVAL 1 YEAR)Käytä päivämäärille ja aikaleimoille niitä vastaavaa nykyhetken funktiota
AikaryhmittelyYEAR(column) tai DATE_TRUNC(column, 'month')Käytä kullekin tulosteelle yksilöllistä aliasta; queryContract on määräävä

SQLite:n DATE('now', ...) ei kuulu tämän sisääntulon Doris-päivämääräsopimukseen. Älä vie dokumentaation esimerkkien SQLite-pohjaista offline-tarkistustapaa tuotannon SQL-kyselyihin.

v8-kyselykuittauksen lukeminen

evidenceRows on Agentin ainoa kanava rividataan; raakadataa ei avata Agentille. SQL-luvut koodataan tarkkoina desimaali-JSON-merkkijonoina; määritä niiden numeerinen tyyppi ja liiketoimintatyyppi resultColumnContracts-kentän perusteella äläkä tulkitse JSON-arvoa VARCHAR:nä vain siksi, että se on merkkijono. Lue executionReceipt-, täydellisyys- ja katkaisutiedot sekä säilytä lähdetiedot kuten evidenceRowsSha256.

Kyselytulosteita, joissa on viitattavissa oleva suorituskuittaus, saa lainata sellaisenaan; vain palvelinpuolella vahvistettu semantiikka oikeuttaa myöhemmät deterministiset jatkolaskennat. Älä päättele kenttien nimien perusteella merkityksiä kuten ”kumulatiivinen saldo”, ”loppuarvo” tai ”币种” äläkä keksi yksiköitä itse. Nollarivisiä tuloksia, epäonnistumisia tai katkaisuja ei saa esittää täydellisinä tilastoina.

Luku 10

Moniulotteinen Top3 ja katkaisujen käsittely

Vastaa sijoituskysymyksiin palvelinpuolen aggregoinnilla ja ikkunafunktioilla; älä tee jatkolaskentaa epätäydellisten tulosten pohjalta.

Mukana tuleva examples/top3.sql käyttää esimerkkitaulukkoa: se aggregoi ensin sarakkeiden 区域, 类别 ja 产品 mukaan, suorittaa sitten ROW_NUMBER-funktion kunkin 区域- ja 类别-ryhmän sisällä ja käyttää 产品-nimeä vakaana järjestyksenä, kun summat ovat tasan. Pyyntö maxRows=100 riittää esimerkin 36 riville; muun liiketoimintadatan osalta tarve on arvioitava todellisen ryhmämäärän mukaan.

  1. Selvitä todellinen rakenne ja nykyinen laskentaperuste: määrittele 币种, kausi, 订单状态 ja tasatilanteiden säännöt.
  2. Lähetä palvelinpuolen aggregointi- ja sijoitus-SQL. Älä hae ensin pelkkää 区域-kokonaissummaa ja käytä sitä sitten 类别产品-sijoituksena.
  3. Tarkista tulostesarakkeiden sopimus ja todellinen evidenceRows; varmista, että palautus kattaa kaikki tarvittavat ryhmät.
  4. Jos katkaisu havaitaan, tee rajattuja osakyselyitä palvelimen tukemien rajojen mukaan, esimerkiksi hae täydellinen Top3 erikseen kullekin 区域-arvolle; pidä jokaisella kyselykerralla sama liiketoiminnallinen laskentaperuste.
  5. Jos lähdekausi muuttuu, tee uusi kysely ja merkitse selkeästi uusi versio; älä sekoita eri dataversioita tai vanhentuneita kursoreita.
Kuva A5: rivitason suodatuksen, ryhmittäisen summauksen, ryhmän sisäisen sijoituksen ja lopullisen palautuksen järjestys. Havainnollistava kuva.

Virheistä palautuminen

TABLE_SCHEMA_INCOMPLETE on korjattava tai rakenne on haettava kokonaisuudessaan; epäonnistumiset kuten ONTOLOGY_SQL_FAILURE_CONTRACT_INVALID käsitellään palautettujen errorCode-, retryable- ja remediation-tietojen mukaan. Älä väitä, että ”kaikki moniulotteiset GROUP BY- tai ikkunafunktiot on kielletty”, äläkä keksi sijoituksia ilman kyselytuloksia.

Luku 11

Tietämyshaku: täydellinen alkuteksti ja todisteiden kelpoisuus

Erottele paikannus, lukeminen ja faktaviittaus toisistaan ja säilytä lähteet sekä täydellisyys.

Kaksi yleistä polkua

PolkuKäyttötarkoitusKeskeiset asiat
dfc_ontology_queryHaku ontologiaan sidotusta tietämyksestä, tarvittaessa yhdistettynä graafireititykseenTarkista täydellinen kanoninen answerContextItems ja todisteiden kelpoisuus
dfc_knowledge_search → dfc_knowledge_detail-osio (chunk)Paikanna eksplisiittisellä haulla ja lue sitten valitut osiotHaun esikatselua ei käytetä faktana; lue saman paikannuksen täydellinen alkuteksti
json
{"name":"dfc_knowledge_search","arguments":{
  "ontologyId":"<ONTOLOGY_ID>","query":"销售金额是否排除退货", "topK":5
}}

{"name":"dfc_knowledge_detail","arguments":{
  "action":"chunk","ontologyId":"<ONTOLOGY_ID>",
  "evidenceId":"<EVIDENCE_ID_FROM_THE_SAME_SEARCH_RESULT>"
}}

Edellytykset faktana käyttämiselle

  • Tarkista nykyinen ACL, sisällön täydellisyys sekä palvelimen canonicalFactEligible-, citationEligible-arvot tai vastaava suoritussopimus.
  • Täydellinen sisältö on sidottu contentSha256-arvoon. Katkaisut, budjettipohjaiset poissulkemiset tai heikkolaatuinen sisältö käsitellään todellisten kenttien mukaan.
  • Dokumentin metatiedot, page_context, graafipaikannus, hakuyhteenveto ja esikatselu eivät korvaa kanonista alkutekstiä.
  • Kopioi ensisijaisesti evidenceId; tarvittaessa chunkId ja documentId on saatava samasta paikannustuloksesta, ei yhdistämällä tai arvaamalla.

Graafireititys

search/neighbors-tulos on paikannustietoa. Syötä ontologian query-toimintoon vain palvelimen täysimääräisesti palauttama routeLocator-objekti, mukaan lukien sidonta-, versio- ja todistuskentät. Älä paketoi yksittäistä assetId- tai knowledgeId-arvoa itse palvelimen myöntämän locatorin näköiseksi äläkä lähetä takaisin mallin väittämää lähdetodistetta.

Strukturoitu palautus dokumenteista

dfc_ontology_query:n structuredPlan on tarkoitettu yksinomaan epäsäännöllisten dokumenttitaulukoiden rajattuun palauttamiseen ja deterministiseen tarkistukseen. Käytä palvelimen ilmoittamaa suunnitelmaa vasta, kun vastauksessa on palautettu nykyinen executionContractSha256, tableIndex, sarakkeet ja täydellinen taulukko. Tavalliset jo tuodut liiketoimintataulukot käsitellään dfc_table-SQL:n kautta; älä käytä Markdown-taulukoiden palautusta keinona kiertää taulukkokyselyjen valtuutusta.

Kuva A6: paikannustulos ja viitattavan alkutekstin todisteketju. Havainnollistava kuva.

Hakustrategia

knowledgeIds jätetään yleensä pois, jolloin kattavuus ulottuu kaikkiin tällä hetkellä käytössä oleviin sidontoihin; annettaessa käytä vain knowledgeBindings:n todellista tietämyskannan (knowledge base) tunnusta. Älä käytä dokumenttiresurssin tunnusta tietämyskannan tunnuksena. Tee uusi rajattu haku ratkaisemattoman kysymyksen perusteella ja vältä täsmälleen samoja toistohakuja, jotka eivät tuo uusia todisteita.

Luku 13

Kieli- ja aluekäytännöt

Pidä erillään UI-locale, kyselysanakirja, vastauskieli ja alkuperäiset kenttänimet.

Etusijajärjestys on: nimenomaisesti pyydetty kieli, sovellusjärjestelmän kieli ja tehtävän todellisen suoritussolmun locale. Puuttuva arvo, null, tyhjä merkkijono tai pelkät välilyönnit eivät palauta kieleksi automaattisesti kiinaa. languageRegistry-rekisterin aluekohtaiset arvot on säilytettävä täsmällisinä. Arvoja en-GB, fr-CA, pt-BR, es-US ja ar-AE ei saa mielivaltaisesti yhdistää toiseen alueeseen.

Kieli tai alueKyselyn localeSelitys
Yksinkertaistettu ja perinteinen kiinazh-CN zh-HantAlkuperäiset kiinan säännöt ja perinteisen kiinan luettelo eroavat
Yhdysvaltain, Britannian, Australian ja Kanadan englantien-US en-GB en-AU en-CAUI-/avainsanapaketit voivat olla yhteisiä, aluemetatiedot säilytetään
Saksa, italia ja venäjäde-DE it-IT ru-RUKäytetään nykyisen istunnon ehdotusten mukaan
Espanjan ja Latinalaisen Amerikan espanjaes-ES es-USTuotteen alue-ID on es-US.
Ranskan ja Kanadan ranskafr-FR fr-CAAlueiden tunnuksia ei yhdistetä
Portugalin ja Brasilian portugalipt-PT pt-BRLuettelo- ja aluekäytännöt säilytetään erikseen
Hollanti, tanska, norja, suomi ja ruotsinl-NL da-DK nb-NO fi-FI sv-SENorjasta käytetään bokmålia
Japani ja koreaja-JP ko-KRSanoja ei jaeta itse englannin välilyöntisääntöjen mukaan
Saudi-Arabian ja Yhdistyneiden arabiemiirikuntien arabiaar-SA ar-AEKäyttöliittymän ohjetekstit tukevat RTL-suuntaa; protokollatunnisteiden kirjoitussuuntaa ei käännetä

Avainsanaluettelon käyttäminen

json
{"name":"dfc_manual","arguments":{
  "action":"keywords","locale":"de-DE","names":["<ACTUAL_KEYWORD_ID>"]
}}

dfc_manual:n staattinen avainsanaluettelo kattaa vain nimenomaisesti luetellut localet; jos locale jätetään pois, käytetään englanninkielistä viitettä. Kyseessä on viitteen oletusarvo, ei kyselykielen tulkintasääntö. Jos aluevariantille ei ole staattista luetteloa, hae todelliset ehdotukset nykyisen istunnon assist-funktiolla äläkä keksi aliaksia tai varatuloksia. Yhdessä kutsussa names-luettelossa saa olla enintään 32 kohdetta.

Mitä ei käännetä

  • Taulukko- ja sarakenimet, enum-arvot, asiakkaiden nimet, kaavojen nimet ja muut todelliset mallimerkkijonot.
  • Työkalujen nimet, action, scope, Schema-kentät, virhekoodit ja tila-arvot.
  • Resurssitunnukset, tiivistelmät, opaque locator -arvot ja palvelimen myöntämät viittaukset.

Esimerkiksi saksankielinen kysymys voi viitata kiinankieliseen näyttösarakkeeseen ”销售金额”. Sen muuttaminen saksankieliseksi sarakkeenimeksi tuottaisi toisen tunnisteen, ei käyttöliittymäkäännöksen. Alusta tai päivitä istunto alkuperäisen protokollan mukaisesti kielen vaihtamisen jälkeen ja hae ehdotukset sekä monitulkintaisuusehdokkaat uudelleen.

Luku 14

Yhdistetty analyysi ja interaktiiviset tulokset

Säilytä ehdollisesti avattavissa analyysityökaluissa valtuutukset, versiot, haarat ja todisteiden tila.

dfc_analysis_*-työkaluja ohjaa asetus datafocus.mcp.analysis.tools.enabled. Strukturoitu osa kulkee edelleen Searchin auktoritatiivisten kyselyjen ja nykyisen rivikäytännön kautta; dokumenttiosa hakee täydellisen alkutekstin uudelleen nykyisen ACL:n mukaisesti. Ne eivät ole avoimia SQL-sisääntuloja eivätkä kanavia mielivaltaisten ohjeiden tai suodattimien syöttämiseen.

TyökaluKäyttötarkoitusVälttämättömät koordinaatit
dfc_analysis_askEsitä luonnollisen kielen analyysikysymysontologyId question; valinnaiset: language, sessionId
dfc_analysis_result_getLue aiemmin palautettu tulosontologyId sessionId resultId
dfc_analysis_refineEsitä jatkokysymys tai muutos uusimman täyden tuloksen pohjaltaAlkuperäinen tulos, expectedRevision ja vakaa idempotenssiavain
dfc_analysis_pageHae yksi sivu palvelinpuolen haarastaAlkuperäinen haara ja tulosversio, pageNo pageSize
dfc_analysis_cancelPeruuta tulos, jonka käsittely on yhä keskenAlkuperäinen istunto ja tulos
dfc_analysis_closeVapauta istunto, jossa ei ole käynnissä olevaa työtäAlkuperäinen istunto

Analyysin aloittaminen

json
{"name":"dfc_analysis_ask","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "question":"按区域分析已完成订单销售金额,并引用退货统计口径",
  "language":"zh-CN"
}}
  1. Lue palautettu sessionId, resultId, tila ja revisio; lue tarvittaessa alkuperäistä tulosta uudelleen.
  2. Tarkista jokainen strukturoitu haara erikseen: tila, täydellisyys, rivikäytäntö ja lähde; yhden haaran valmistuminen ei tarkoita, että koko analyysi olisi täydellinen.
  3. Tarkista dokumenttitodisteet, faktakirjanpito, viittauskelpoisuus ja rajoitukset. Mallin tuottama kerronta ei voi itsenäisesti nostaa todisteiden kelpoisuutta.
  4. Jos tarvitset jatkokysymyksen, perusta se uusimpaan täydelliseen tulokseen ja välitä expectedRevision; käytä saman muutoksen uudelleenyrityksessä samaa idempotenssiavainta.
  5. Varmista ennen sulkemista, ettei istunnossa ole enää käynnissä olevaa työtä; peruutus ja sulkeminen ovat eri toimenpiteitä.

Hallittu suodatus ja sivutus

filter_patch käyttää palvelimen antamia branchId-, fieldRef- ja valueRef-arvoja sekä sallittuja operaattoreita; nykyinen tyypitetty suodatus ilmoittaa vain EQ-operaattorin. Raakojen SQL-, tableId- tai columnId-arvojen tai asiakasohjelman itse luoman suodatinpuun käyttäminen opaque-viittausten korvikkeena on kiellettyä. Sivutusparametrin pageNo arvo alkaa luvusta 1 ja on enintään 10 000; pageSize on enintään 100.

Kuva A7: haarat, versiot ja sivutus sidotaan; lähteen tai version muuttuessa suoritetaan uusi kysely uuden paikannuksen saamiseksi. Havainnollistava kuva.

Työkaluvihjeet ja käyttäytyminen

Työkalujen annotations ovat asiakasohjelman vihjeitä, eivätkä turvallisuusvaltuutuksia. Osa yleisistä pohjista käyttää readOnlyHint-arvoa, joka ei korvaa todellisen toiminnon arviointia; peruutus, sulkeminen ja raportin luominen muuttavat vastaavaa työn tilaa. Toimi aina työkalun semantiikan, käyttäjän tavoitteen ja palvelimen käyttöoikeuksien mukaisesti.

Luku 15

Pysyvät visualisointiraportit ja MCP Apps -sovellukset

Luo palautettavissa oleva raportti ja lue sen tulokset ja käyttöliittymä nykyisten käyttöoikeuksien mukaisesti.

dfc_report_*-työkaluja ohjaa asetus datafocus.mcp.analysis.report-tools.enabled, ja ne edellyttävät metadata- ja table query -scopet. Ne eroavat prosessin sisäisestä Search-istunnosta; raportti käyttää pysyvää reportId-arvoa. Pysyvyys ei tarkoita, ettei käyttöoikeuksia enää tarkisteta.

json
{"name":"dfc_report_create","arguments":{
  "ontologyId":"<ONTOLOGY_ID>","goal":"比较区域与类别销售表现并核对口径",
  "title":"零售经营分析","language":"zh-CN",
  "idempotencyKey":"retail-report-20261019-01"
}}
{"name":"dfc_report_status","arguments":{
  "ontologyId":"<ONTOLOGY_ID>","reportId":"<REPORT_ID>"
}}

Työnkulku

  1. Käytä luonnissa vakaata idempotencyKey-arvoa, jonka pituus on 8–128 tuettua merkkiä.
  2. Tallenna reportId, kysele status-tilaa pollaamalla ja tarkista todellinen tila: valmis, epäonnistunut, osittain valmis tai peruutettu.
  3. Tarkista tuloksia luettaessa strukturoidut haarat, visualisoinnit, faktalähteet, dokumenttiviitteet ja täydellisyys.
  4. Peruuta keskeneräinen raportti alkuperäisellä reportId-arvolla; älä luo toista raporttia peruutuksen sijaan.
  5. Lue verkon aikakatkaisun jälkeen ensin alkuperäisen raportin tila; kun alkuperäinen idempotenssiavain toistetaan, liiketoimintatarkoituksen on pysyttävä samana.

MCP Apps

Käyttöliittymälaajennuksia tukevat asiakasohjelmat lukevat raporttisivun työkalun _meta-tietojen ja todellisen resurssien löytämisen kautta. r56:n pysyvä raporttisivu on ui://datafocus/analysis-report/v16/index.html, ja vuorovaikutteisessa analyysissä käytetään asianmukaisia palvelinresurssiviittauksia; asiakasohjelma ei saa korvata työkalun palauttamia arvoja kovakoodatuilla arvoilla. Ilman käyttöliittymälaajennusta strukturoituja tuloksia voi silti lukea.

Lähteen sidonta

Raporttia luettaessa tarkistetaan uudelleen Grant, ontologia, pyynnön Origin-sidonta ja nykyiset taulukoiden käyttöoikeudet. Selaimen eri lähteiden välisessä (cross-origin) integraatiossa on käytettävä hyväksyttyä todellista lähdettä; asiakasohjelma ei saa kiertää sidontaa väärennetyn Origin-arvon avulla. Vanha reportId ei ole pitkäaikainen julkinen linkki eikä käyttäjien välillä kelpaava pääsytunniste.

Luku 16

Artefaktin luonnos, esikatselu, suunnitelma ja käyttöönotto

Anna generoitu sisältö alkuperäisen palvelimen normalisoitavaksi, validoitavaksi ja hyväksyttäväksi; älä anna mallin muuttaa tuotantoresursseja suoraan.

Artefaktityökalut edellyttävät, että authoring-ominaisuus on kytketty päälle, sekä todellista artifact-tyyppiä, asianomaisia scopeja ja alkuperäisen ylläpitäjän kirjoitusoikeutta. Oletuksena määritetyt tyypit ovat CONTROL_PANEL_SPEC ja VIEW_SPEC; muita lomake-, HTTP-lähde- ja skriptityyppejä ohjataan lisäksi erillisillä asetuksilla. Flashissa ei ole AutoML:ää, joten siihen liittyviä tyyppejä ei luetella tämän version käytettävissä oleviksi artefakteiksi.

Kuva A8: hallittu järjestys kontekstin, ehdokkaan, esikatselun, suunnitelman, hyväksynnän ja käyttöönoton välillä. Havainnollistava kuva.
  1. dfc_authoring_capabilities lukee nykyisen Grantin käytettävissä olevat sopimukset ja toiminnot.
  2. dfc_artifact_context hakee rajatun kontekstin, contractVersion-, contextHash-, baseArtifactHash- ja baseArtifactVersion-tiedot.
  3. Asiakasohjelma luo ehdokkaan todellisen sopimuksen perusteella eikä suorita ehdokkaan sisältämää koodia.
  4. dfc_artifact_submit lähettää alkuperäisen kontekstin ja ehdokkaan, säilyttää instruction-kentän muuttumattomana ja käyttää vakaata clientRequestId-avainta.
  5. Lue proposalId, candidateHash, validoinnin tulos ja esikatselu; jos todellisia virheitä ilmenee, korjaa ehdokas äläkä väärennä palvelimen läpäisytilaa.
  6. Kun esikatselu on tehtävä uudelleen, käytä dfc_artifact_preview-työkalua ja samaa ehdokkaan tiivistettä.
  7. dfc_artifact_plan luo muuttumattoman suunnitelman todellisen ehdokkaan, kohdeversion ja idempotenssiavaimen avulla.
  8. Hyväksyntä käsitellään alkuperäisen vuorovaikutuksen tai jo valtuutetun käytännön mukaisesti, minkä jälkeen suoritetaan dfc_artifact_apply; vain APPLIED-kuittaus merkitsee todellista käyttöönottoa.

Kontekstin vähimmäispyyntö

json
{"name":"dfc_artifact_context","arguments":{
  "artifactType":"CONTROL_PANEL_SPEC",
  "ontologyId":"<ONTOLOGY_ID>",
  "instruction":"为当前授权销售指标建立区域比较面板"
}}

VIEW_SPEC käyttää nykyistä valtuutettua projectId-arvoa; olemassa olevaa artefaktia muokattaessa käytetään todellista artifactId-arvoa. Kentät kuten variables, previewInput ja viewport annetaan palautetun sopimuksen mukaisesti; ehdokkaan sisäistä rakennetta ei arvailla.

Rinnakkaisuus ja uudelleenyritykset

Suunnitelma on sidottu kohdeversioon, ehdokkaan tiivisteeseen ja idempotenssiavaimeen. Kohteen muuttuessa vanhaa suunnitelmaa ei voi enää ottaa käyttöön; konteksti luetaan uudelleen ja todelliset konfliktit käsitellään. Siirtotason aikakatkaisu (transport timeout) ei todista epäonnistumista; alkuperäinen proposalId tai planId kysytään ensin dfc_artifact_status-työkalulla. READY ei ole sama kuin APPLIED.

Hyväksyntä ja automaattinen käytäntö

Yleiset artefaktisuunnitelmat vaativat alkuperäisen manuaalisen hyväksynnän. Ontologian automaattisen julkaisukäytännön täyttävät suunnitelmat käsitellään approvalMode-parametrin mukaisesti, eikä käyttäjältä vaadita erillistä, Agentin keksimää hyväksyntää. approvalToken on palvelimen myöntämä aineisto, eikä Agent voi korvata sitä kirjoittamalla merkkijonon; todellinen inputSchema ja suunnitelman kuittaus määrittävät pakolliset kentät.

Luku 17

Ontologian ehdokkaan luonti- ja julkaisusopimus

Käytä ontologian deklaraatioille ja julkaisumäärityksille omia, erikseen versioituja sopimuksia; tavallisten esitysartefaktien sopimuksia ei sovelleta mallin julkaisuun.

Ehdokkaan luonti

Ontologiasäiliön on oltava jo olemassa ja Grantin piirissä. Tarkista nykyisen strukturoidun lähteen kentät ja v4 Binding -sormenjälki dfc_ontology_table_schema-työkalulla. Kentälle voi antaa pelkän sourceField-arvon, jolloin tyyppi tunnistetaan automaattisesti. Eksplisiittinen DECIMAL-deklaraatio edellyttää nykyistä tarkkuutta ja desimaalien määrää; muiden tyyppien mukana näitä kenttiä ei lähetetä.

json
{"name":"dfc_ontology_table_schema","arguments":{
  "ontologyId":"<ONTOLOGY_ID>","sourceAssetRef":"table:<ACTUAL_TABLE_ID>",
  "fields":[{"sourceField":"区域"},{"sourceField":"销售金额"}]
}}

Ehdokas- ja julkaisuasetukset

SopimusKäyttötarkoitusKeskeiset rajat
ontology-workspace-create-mcp-submit-v1Ehdokkaan luonti paikallisista deklaraatioistaTodelliset valtuutetut lähteet; palvelin kääntää, valmistumistodisteita ei hyväksytä
ontology-workspace-create-mcp-submit-v2Paikallisten ja tarkkojen julkaistujen viittausten yhdistelmäAnna tarkka releaseSelections ja sulkeuman riippuvuudet
ontology-publication-mcp-submit-v1–v3Olemassa olevan ehdokkaan sitominen julkaisusuunnitelmapyyntöönEksplisiittiset koordinaatit; palvelin muodostaa kohteen, lähteen, hyväksynnän ja validoinnin uudelleen
ontology-publication-mcp-submit-v4–v6Erikseen käyttöön otettavat automaattisen julkaisun määrityksetKäytetään vain, kun capabilities ja todellinen schema ilmoittavat ne
ontology-initial-activation-retirement-submit-v1Hallitut alkuaktivoinnin ja käytöstä poiston toiminnotErillinen suunnitelma, uusi manuaalinen hyväksyntä ja tarkka laajuus

Julkaisujärjestys

  1. Hae nykyisen ehdokkaan workspaceId, workspaceRevision, candidateHash ja todellinen lähde.
  2. Valitse sopimusversio palvelimen ominaisuuksien mukaan; lähetä koordinaatit, kuten releases ja selection, äläkä liitä mukaan kenttiä, jotka itse väittävät ”hyväksytty” tai ”läpäisty”.
  3. Säilytä submit-toiminnon palauttama proposalId ja alkuperäinen idempotencyKey. Submit ja MODEL_PLAN ovat saman pyynnön eri vaiheita.
  4. Kutsu dfc_artifact_plan-työkalua alkuperäisellä ehdokkaalla, kohdeversiolla ja samalla idempotenssiavaimella.
  5. PLANNING_INCOMPLETE merkitsee vain, ettei kelvollista suunnitelmaa ole vielä muodostunut; VALIDATION_UNSATISFIED merkitsee, että nykyisessä validoinnissa on edelleen puutteita; käsittele ne nextAction-kentän mukaisesti.
  6. Kun suunnitelma on onnistunut, jatka HUMAN_REQUIRED- tai POLICY_AUTO-arvon mukaan käyttäen alkuperäisiä hyväksyntä- ja julkaisuominaisuuksia.
  7. Vahvista tulos APPLIED-kuittauksella sekä sen jälkeen tehtävillä todellisilla julkaistun mallin lukemisilla ja valtuutetuilla kyselyillä.

Aikakatkaisut ja palautuminen

PLAN-aikakatkaisun jälkeen lue alkuperäinen proposalId. MODEL_PLAN_SUBMITTED on keskeneräinen pyyntö; MODEL_PLAN_COMPLETED merkitsee, että alkuperäinen kuittaus on haettava alkuperäisillä koordinaateilla ja avaimella; se ei tarkoita, että asiakasohjelman pitäisi luoda uusi pyyntö. Lopputilan validointipuutteita ei voi muuttaa hyväksytyksi julkaisuksi vaihtamalla avainta tai lähettämällä pyyntöä uudelleen.

Ihmisen liiketoimintaoikeudet

Agentin antamat instruction-tiedot ja deklaraatiot ovat Agentin syötettä, eivät ihmisen allekirjoittamia käytäntöjä. MODEL_AUTHOR, MODEL_PUBLISH, automaattisen julkaisun delegointi, liiketoiminnan vahvistukset, julkisten avainten luottamus, budjetit ja lähteen ACL:t määräytyvät edelleen alkuperäisten mekanismien mukaan. Näitä tosiasioita ei saa korvata asiakasohjelman kentillä.

Luku 18

Julkaistu malli, ehdokaskyselyt ja viittaussulkeuma

Käytä julkaistua liiketoimintatietämystä tarkkojen versioiden mukaan ja säilytä julkaisemattomien ehdokkaiden väliaikaisuus.

dfc_ontology_graph-työkalun published_model, published_query ja candidate_query ovat ehdollisesti avattavia strukturoituja määrityksiä eivätkä tavallisten search/neighbors-toimintojen synonyymejä. Ne valtuutetaan table query -scopen ja tarvittavien mallinnuksen lukuoikeuksien perusteella; graafin näkyvyys ei korvaa taulukoiden käyttöoikeuksia.

Julkaistun mallin lukeminen

  1. Kun työkalun action-luettelossa on todellisuudessa published_model, lähetä todellinen, committed-tilassa oleva releaseId.
  2. v1 palauttaa valtuutetut kyselypohjat; v2 lisää tarkat PERSISTED-viittaukset ja releaseSelections-tiedon; v3 lisää riippuvuusviittaukset, tarkat domainRef-tiedot ja tiiviit sidontapohjat.
  3. Valitse objektit, attribuutit, Binding, scope ja versiot todellisista palautusarvoista; älä generoi RID-tunnisteita äläkä käytä latest-arvoa.
  4. Lähetä published_queryn kiinteästi tyypitetty kysely; tuloksen on edelleen läpäistävä nykyisen lähteen ja kenttien valtuutus.

Ehdokaskyselyt

candidate_query käyttää todellisia arvoja workspaceId, revisio, candidateHash sekä ehdokasdeklaraatioita. Julkaistuja viittauksia yhdistettäessä käytetään vastaavia v2-tyypitettyjä LOCAL-/PERSISTED-koordinaatteja ja tarkkoja valintoja. Ehdokastulokset ovat aina julkaisemattomia ja väliaikaisia, eikä niitä käsitellä yrityksen vahvistamana tietämyksenä.

Osittainen ylläpito ja sulkeuma

Valitse vain ehdokasjuuren tarvitsemat transitiiviset riippuvuudet ja varmista, että jokaisella julkaistulla viittauksella on tarkka releaseSelections. Julkaisun sisällön kopioiminen, vain yhden ID-joukon lähettäminen tai laajentaminen kaikkiin historiallisiin resursseihin ei korvaa nykyisten riippuvuuksien ja lähteiden tarkistusta.

Kuva A9: ehdokasjuuri, tarkat julkaistut riippuvuudet ja lähdevaltuutus. Viittaussulkeuman havainnollistava kuva.

Näiden toimintojen query on versioitu tyypitetty objekti, eikä sen liiketoimintaviittauksia voi korvata SQL:llä, fyysisellä taulukko-ID:llä tai lähdetaulukon nimellä. Metadatapohjat ja graafitulokset eivät sinänsä ole faktaviittauskelpoisia.

Luku 19

Ontologia-agentin tehtävien delegointi

Jatka työtä pysyvien tehtävien ja alkuperäisen Grantin avulla; älä käsittele Agentin ohjeita ihmisen hyväksyntänä.

dfc_ontology_agent näkyy vain, kun todellinen Pi Runtime ja tarvittavat käyttöoikeudet ovat käytettävissä. QUERY käyttää lukuominaisuuksia; AUTHORING edellyttää lisäksi mallinnusroolia ja vastaavaa authoring-scopea. Se ei avaa toista, rajoittamatonta suoritusmoottoria.

json
{"name":"dfc_ontology_agent","arguments":{
  "contractVersion":"ontology-agent-task-v1","action":"start",
  "ontologyId":"<ONTOLOGY_ID>","mode":"QUERY",
  "instruction":"列出当前可查询的表,并说明各表用途",
  "idempotencyKey":"retail-discovery-01"
}}
{"name":"dfc_ontology_agent","arguments":{
  "contractVersion":"ontology-agent-task-v1","action":"status",
  "ontologyId":"<ONTOLOGY_ID>","runId":"<RUN_ID>"
}}

Tiukka parametrijoukko

start käyttää contractVersion-, action-, ontologyId-, mode-, instruction- ja idempotencyKey-parametreja; status/cancel käyttää contractVersion-, action-, ontologyId- ja runId-parametreja. Palvelin tarkistaa tarkat kenttäjoukot action-parametrin perusteella. instruction saa olla enintään 16 000 merkkiä; avaimen pituus on 1–128 tuettua merkkiä, ja sen ensimmäisen merkin on oltava kirjain tai numero.

Palautuminen ja peruutus

  1. Säilytä alkuperäinen runId, Grant, mode ja idempotenssiavain.
  2. Sama avain ja sama instruction jatkavat samaa run-ajoa, eikä uutta tehtävää lähetetä; jos samalla avaimella lähetetään eri ohje, pyyntö hylätään.
  3. status kysyy alkuperäisen tehtävän tilan. Valmistumisen jälkeen on edelleen tarkistettava sen taulukkokyselyt, todisteet tai julkaisukuittaus.
  4. Peruuta alkuperäisellä runId-arvolla; vahvista tulos tehtävän todellisen tilan perusteella.

Run-ajon valmistuminen ei ole mallijulkaisun kuittaus. Julkaisutehtävä vahvistetaan edelleen alkuperäisen artifact-tilan ja lähdetarkistusten kautta; QUERY ei sisällä implisiittisiä kirjoitus- tai julkaisuoikeuksia.

Luku 20

Liiketoimintatyötilan MCP

Kysele tietueita julkaistujen liiketoimintasopimusten perusteella ja suorita komennot alkuperäisen ActionPlanin kautta.

/mcp/business käyttää erillistä suojattua resurssia (protected resource) ja liiketoimintajärjestelmän valintaa; ontologian Grantia ei voi käyttää uudelleen liiketoimintavaltuutuksen tilalla. Liiketoimintajärjestelmän on oltava julkaistu, Agentin kutsuttavissa ja alkuperäisten turvallisuuskäytäntöjen mukainen, ja nykyisellä käyttäjällä on oltava todelliset ajonaikaiset roolit ja ominaisuudet.

ScopeTyökaluRajaus
business-system:discoverdfb_systems dfb_system_describeLöytää vain tämän valtuutuksen kattamat ja tällä hetkellä kutsuttavissa olevat järjestelmät
business-system:readdfb_query dfb_record dfb_work_items dfb_action_statusNykyisen käyttäjän luettavissa olevat tietueet ja omat suunnitelmat
business-system:plandfb_action_planLuo vain muuttumattoman suunnitelman; ei suoritusta
business-system:executedfb_action_executeErillinen eksplisiittinen valtuutus; suoritus riskin ja hyväksynnän mukaan
  1. dfb_systems löytää valtuutetut järjestelmät.
  2. dfb_system_describe lukee nykyisen julkaisusopimuksen, releaseId-arvon sekä kaikki tiivisteet, kyselyt ja komennot.
  3. dfb_query käyttää julkaistua queryKey-arvoa ja määrittää tarvittaessa objectKey-, state-, page- ja pageSize-parametrit. Se ei ole mielivaltainen SQL.
  4. dfb_record ja dfb_work_items lukevat tällä hetkellä sallitut tietueet ja avoimet tehtävät.
  5. Anna ennen suoritusta dfb_action_plan-työkalulle todelliset releaseId, releaseHash, canonicalIrHash, agentManifestHash, commandType, planIdempotencyKey ja sopimuksen payload.
  6. Tarkista riskClass, requiresApproval ja status; jos toiminto koskee kohdetietuetta, säilytä expectedRecordVersion.
  7. dfb_action_execute suorittaa vain nykyisen yhteyden omistamia ja valmiita suunnitelmia; manuaalisen hyväksynnän edellyttämät hyväksyntätokenit myöntää DataFocus.
  8. Selvitä epäonnistumisen tai aikakatkaisun jälkeen alkuperäisen suunnitelman tila dfb_action_status-työkalulla; uudelleenyrityksessä on säilytettävä alkuperäinen idempotenssisemantiikka.
Kuva A10: julkaistut sopimukset, suunnitelmat, hyväksynnät ja toimintojen suoritus. Havainnollistava kuva.

Yhteyden ja version sidonta

Suunnitelma on sidottu nykyisen Grantin vakaaseen eristystunnisteeseen. Access Tokenin päivityksen jälkeen samaa yhteyttä koskevia suunnitelmia voidaan edelleen käsitellä, eikä toinen OAuth-yhteys voi ottaa niitä haltuunsa. Suorituksen yhteydessä tarkistetaan uudelleen julkaistu versio, IR-/manifest-hash, kohdetietueen versio, suunnitelman vanheneminen, idempotenssi ja hyväksyntä. OAuthin sallittujen luettelo (allowlist) ei ohita liiketoiminnan hallintamekanismeja.

Luku 21

Liiketoimintatietämyksen syöttö ja vahvistusta odottavat kysymykset

Rekisteröi liiketoimintasyötteet, kun vastaava tuotantokäsittelijä on käytössä, ja säilytä ihmisen tekemän vahvistuksen raja.

Seuraavat neljä työkalua lisää julkinen MCP-ohjain ehdollisesti asennettujen käsittelijöiden ja nykyisten scopejen perusteella. Ne eivät aina näy perusluettelossa. Ilmoitetun Scheman olemassaolo ei tarkoita, että instanssissa olisi käsittelijät, budjetti tai oikeudet valmiina; tarkista ensin tools/list.

TyökaluKäyttötarkoitusOikeudet tai vaikutukset, joita ei synny
dfc_ontology_knowledge_input_proposeOlemassa olevan työtilan liiketoimintasyötteen rekisteröintiEi luo vahvistuskysymyksiä, ei hyväksy, ei julkaise
dfc_ontology_knowledge_input_previewKysymysluonnosten väliaikainen esikatselu alkuperäisestä syötteestäEi tallenna, ei vahvista, ei muodosta tuotantokuittausta
dfc_ontology_knowledge_question_submitTallentaa authored-tilassa olevat, vahvistamattomat kysymyksetEi yhdistä vastauksia automaattisesti, ei anna vastuu- tai julkaisuoikeuksia
dfc_ontology_business_scope_initializeAlustaa eksplisiittisesti yhden liiketoimintajärjestelmän kuluttajalaajuudenEi julkaise, ei aktivoi, ei myönnä lähdeoikeuksia

Syöte ja esikatselu

  1. Hae workspaceId, workspaceRevision, localRef ja preparationDigest todellisesta valmistelutyöstä.
  2. propose rekisteröi liiketoimintasyötteen alkuperäisellä input-sopimuksella ja vakaalla idempotencyKey-avaimella; sama avain voi vastata vain samaa syötettä.
  3. preview käyttää alkuperäisen syötteen idempotenssiavainta ja ontologyId-arvoa; se palauttaa joka kerta palvelimen revision ja 60 sekunnin aikaikkunan; kyseessä ei ole idempotentti tuotannon valmistumiskuittaus.
  4. Kun kysymys on tallennettava, question_submit käyttää uutta komentoavainta, alkuperäistä originalInputKey-arvoa sekä täsmällisiä questionRevision-, validFrom-, validUntil- ja expectedRevision-arvoja; luonnissa expectedRevision on null.

Ihmisen vahvistuksen sisääntulo

question_submitin palauttama knowledgeConfirmationPage on vain suhteellinen viittaus alkuperäiseen, kirjautumista edellyttävään sivuun, jolle tietty kysymys on esitäytetty. Se ei sisällä Bearer-tunnusta, ei avaa sivua automaattisesti eikä vahvista tietämystä. QUESTION_STORED_UNCONFIRMED osoittaa selvästi, että vahvistusta ei ole tehty, eikä vastauksessa saa esittää tilannetta muodossa ”tietämys on julkaistu”.

Kuluttajalaajuuden alustus

business scope initialize vaatii sekä ontologian julkaisuoikeuden että täsmällisen liiketoimintajärjestelmän luoja- tai SourceManager-hallintaoikeuden. Se käyttää domainRid-, domainRevisionId- ja businessSystemId-arvojen todellisia koordinaatteja, eikä asiakasohjelma voi antaa mielivaltaista consumerScope-arvoa tai valmistumistodistetta. Myös palautetut INITIALIZED ja COMPLETED ilmoittavat edelleen selkeästi published=false ja activationAuthorized=false.

Nämä pyynnöt kulkevat myös tiukan JSON-validoinnin sekä kenttäjoukon, tavumäärän ja syvyyden tarkistuksen kautta. Syötepyyntöjen enimmäiskoko on 1 MiB; osalla yksittäisistä toiminnoista on pienempi raja. Täydelliset syöte- ja tuloste-Schemat toimitetaan työkaluviitteessä; näihin tiukkoihin sopimuksiin ei sovelleta yleisen MCP-kääreen löyhää parametrilogiikkaa.

Luku 22

Vastaukset, virheet ja turvallinen uudelleenyritys

Selitä virheet kerroksittain ja säilytä tehtävien koordinaatit ja idempotenssisemantiikka.

TasoTarkistettava sisältöKäsittelyperiaate
Verkko ja HTTPYhteys, TLS, 401, 403, 400, 404, 405 jne.Älä käsittele epäonnistunutta vastausta tavallisena kyselytuloksena
JSON-RPCerror.code message dataErota toisistaan protokolla-, metodi-, parametri- ja valtuutusongelmat
MCP-työkaluresult.isError ja structuredContentHTTP 200 voi silti epäonnistua
Liiketoiminnan tulosTodellinen tila, täydellisyys, epäonnistumisen syy, nextActionVastaanotto tai valmius ei ole sama kuin valmistuminen
FaktakelpoisuusexecutionReceipt citationEligible contentCompleteSisältöä, jolla ei ole kelpoisuutta, saa käyttää vain paikantamiseen tai puutteiden selittämiseen

Yleiset HTTP-tilanteet

  • 401: Bearer puuttuu tai on vanhentunut; päivitä token tai valtuuta uudelleen nykyisen OAuth-kulun mukaisesti.
  • 403: Grant, rooli, valittu resurssi, lähdeoikeudet, Origin tai konfiguraatio ei täytä vaatimuksia; älä yritä kiertää estoa toistamalla pyyntöä.
  • 400: Viesti tai versioitu sopimus on virheellinen, mukaan lukien modernien otsikoiden ja metatietojen ristiriita.
  • 404: Tarkista tarkka palvelupolku, protokollametodi ja ajonaikaiset ominaisuudet; älä vaihda ontologian tunnistetta satunnaisesti.
  • 405: Julkisen /mcp-pisteen GET ja DELETE eivät ole lainkaan käytettävissä; käytä oikeaa POST-pyyntöä äläkä muodosta pysyvää SSE-yhteyttä.

Kirjoitusoperaatiot, joiden tulos on epäselvä

MCP_OPERATION_OUTCOME_UNKNOWN voi sisältää kentät outcome=UNKNOWN, retryable=false, nextAction=READ_ORIGINAL_STATUS sekä recoveryTool ja alkuperäiset paikannusparametrit. Tarkista ensin alkuperäinen tila ja jatka sitten alkuperäisen pyynnön käsittelyä. Älä lähetä ehdokasta uudelleen, älä vaihda idempotenssiavainta äläkä tulkitse aikakatkaisua transaktion peruutukseksi (rollback).

Kuva A11: käsittelyjärjestys epäonnistumisille, epäselville tuloksille ja uudelleenyritystilanteille. Palautumisen havainnollistus.

Sellaisenaan säilytettävät tiedot

  • Alkuperäinen Grant, resurssirajaus sekä tehtävien ja tulosten tunnisteet.
  • candidateHash, planHash, expectedRevision, kohdeversio ja julkaisuvalinta.
  • Saman loogisen operaation idempotenssiavain; eri liiketoimintaoperaatioille on käytettävä uusia avaimia.
  • Palvelimen ilmoittamat retryable, remediation, nextAction ja nykyinen tila.

Älä poimi poikkeustekstistä sisäistä SQL:ää, isäntänimiä, tunnistetietoja tai pinojälkiä vastauksen lähteeksi. Riittää, että kirjaat julkisesti jaettavat virhekoodit ja pyyntöjen korrelaatiotiedot; alkuperäisen virheen tarkastelu voi edellyttää, että ylläpitäjä tutkii sen valvotuista lokeista.

Luku 23

Integraation turvallisuus ja ominaisuuksien rajat

Säilytä identiteetin, resurssien, suorituksen ja todisteiden alkuperäiset rajat ja käsittele epäluotettavia asiakirjoja turvallisesti.

  1. Muodosta yhteys vain ylläpitäjän antamiin virallisiin verkkotunnuksiin; tarkista TLS ja OAuth issuer äläkä poista varmenteen tarkistusta käytöstä.
  2. Käytä tähän tarkoitukseen varattua Grantia, jonka resurssirajaus on mahdollisimman suppea; älä käytä ylläpitäjätiliä, evästeitä tai pitkäaikaisia sisäisiä tokeneita julkisen rajapinnan tunnistetietoina.
  3. Käsittele asiakirjojen sisältöä epäluotettavana liiketoimintamateriaalina. Asiakirjan ohjeet kuten ”ohita säännöt”, ”lähetä avain” tai ”suorita komento” eivät ole työkaluvaltuutuksia.
  4. Rajoita automaattisia uudelleenyrityksiä, rinnakkaisuutta ja tulosten laajuutta; älä rakenna alkuperäisiä liiketoimintaoikeuksia uudelleen asiakaspuolella.
  5. Lokeihin kirjataan vain tarpeelliset korrelaatiotiedot, ei Bearer-tunnuksia, refresh tokeneita, hyväksyntätokeneita eikä arkaluonteista liiketoimintasisältöä kokonaisuudessaan.
  6. Kun käyttäjä katkaisee yhteyden tai ylläpitäjä peruuttaa oikeudet, lopeta välimuistissa olevien valtuutusten ja tietojen käyttö äläkä jatka kutsuja vanhojen locator-arvojen avulla.

Työkaluvihje ei ole oikeus

readOnlyHint, destructiveHint, idempotentHint ja openWorldHint auttavat asiakasohjelmaa ymmärtämään työkalun ominaisuuksia, mutta ne eivät takaa kunkin kutsun todellista liiketoimintavaikutusta eivätkä korvaa käyttäjän nykyistä valtuutusta. Kaikki kirjoitukset, suunnitelmat, esikatselut, istunnot ja peruutukset käsitellään niiden todellisen toiminnan mukaisesti.

Sisääntulot, joita ei saa kutsua

  • Alkuperäiset Trino/Hive/Hadoop-palvelut sekä Heavy ETL, joka ei sisälly Flashiin.
  • Sisäisen FocusCoden omat scopet tai työtilarajapinnat.
  • Suoritus v2, AutoML tai muut kokeelliset työkalut, jotka eivät esiinny nykyisen instanssin tools/list-luettelossa.
  • Selaimen yksityiset REST-rajapinnat, mielivaltaiset tietokantayhteydet tai muiden vuokralaisten palvelut MCP:n hylkäysten kiertämiseksi.

Datan semantiikka

Noudata palvelimen täsmällisiä desimaali-, tyyppi-, 币种-, yksikkö-, aika- ja todistesopimuksia. Älä pyöristä lukuja uudelleen tai muunna 币种-arvoja vain siksi, että tulosteksti näyttää luvulta, äläkä laske näkyvistä riveistä kokonaissijoitusta, kun tulos on katkaistu.

Luku 24

Ylläpitäjän kytkennät ja ehdolliset kytkimet

Tarkista ennen laajennusominaisuuksien kytkemistä päälle todelliset komponentit, julkiset osoitteet ja alkuperäiset oikeusasetukset.

KonfiguraatioKäyttötarkoitusEdellytykset
datafocus.mcp.public-base-urlVirallinen ulkoinen juuriosoiteOAuth-löytäminen, issuer, takaisinkutsu ja käänteinen välityspalvelin ovat yhdenmukaisia
datafocus.mcp.allowed-originsErikseen hyväksytyt selaimen lähteet (origin)Määritä täsmällisesti; älä laajenna koskemaan mitä tahansa lähdettä
datafocus.mcp.oauth.route-proof-secretGraafireitityksen todisteille varattu palvelimen salaisuusTallennetaan erikseen, ei käytetä Beareria avaimena
datafocus.mcp.analysis.tools.enabledVuorovaikutteiset analyysityökalutTarvittavat data-, tietämys- ja oikeuspalvelut ovat todella käytettävissä
datafocus.mcp.analysis.report-tools.enabledPysyvät raportointityökalutTarvittava tallennus, worker ja palautumisketju ovat käytettävissä
datafocus.mcp.analysis.apps.enabledMCP Apps -esitysAsiakasohjelma ilmoittaa tuesta ja tarkistaa palautetut _meta-tiedot
datafocus.mcp.authoring.enabledLuonnosten ja mallinnuksen sopimuksetAlkuperäiset ylläpitäjän ja resurssien oikeudet säilyvät
datafocus.mcp.authoring.apply-enabledArtefaktien käyttöönottoMuuttumattomat suunnitelmat, alkuperäiset hyväksynnät ja nykyisen tilan uudelleentarkistus
datafocus.mcp.ontology-published-query-enabledJulkaistut mallit ja kyselytTodelliset vahvistetut (committed) versiot ja lähdevaltuutus
datafocus.mcp.ontology-candidate-query-enabledEhdokkaiden strukturoidut kyselytEhdokkaan omistajuus, täsmällinen versio ja lukuoikeus
datafocus.mcp.authoring.ontology-auto-publication-enabledAutomaattisen julkaisun delegointiin liittyvät valtuutuksetVoimassa oleva alkuperäinen käytäntö, julkisen avaimen luottamus, budjetti ja julkaisuoikeus

Nämä nimet tulevat r56-konfiguraatiosta ja toteutuksesta; se, voiko asetuksen kytkeä päälle, riippuu tarvittavista palveluista ja alkuperäisistä tuotantoonoton porteista. Pelkkien totuusarvojen muuttaminen ei korvaa puuttuvia käsittelijöitä, tietokantoja, validointibudjetteja tai käytäntöjä. Tietämyssyötteen laajennusten ja Pi-tehtävien näkyvyys määräytyy asennettujen komponenttien perusteella.

Reunavälityspalvelin

Säilytä Authorization-, Content-Type-, MCP-Protocol-Version-, Mcp-Method-, Mcp-Name- ja hyväksytyt Origin-otsikot. Aseta pyynnön runko, aikakatkaisu ja TLS palvelun todellisten vaatimusten mukaan; älä välitä julkista /mcp-pistettä hallintaporttiin tai toiseen tuotteeseen.

Tuotantoonoton tarkistukset

  • Anonyymin löytämisen ja suojattujen kutsujen tilat ovat odotetut.
  • Tavalliset käyttäjät löytävät vain valtuutuksensa piiriin kuuluvat resurssit, ja oikeuksien peruutuksen jälkeen seuraavat pyynnöt hylätään.
  • Natiiveilla Search-istunnoilla, SQL:llä, alkutekstillä ja valinnaisilla raporteilla on kullakin todelliset tulokset.
  • Kirjoitusten ja julkaisujen hyväksynnät sekä idempotentti palautuminen säilyttävät alkuperäisen toiminnan.
  • Lokit ja julkinen dokumentaatio eivät sisällä yksityisiä avaimia, tokeneita, evästeitä, salasanoja tai sisäisiä asiakastietoja.
Luku 25

Ajettava asiakasohjelma ja kutsuesimerkit

Tarkista viestit mukana toimitetulla vähimmäisasiakasohjelmalla äläkä ohita OAuthia tai nykyistä valtuutusta.

examples/flash_mcp.py on minimaalinen protokolla-asiakasohjelma, joka riippuu vain Python-vakiokirjastosta. Se ei kirjaudu sisään, ei hyväksy mitään käyttäjän puolesta eikä kutsu automaattisesti näkymättömiä työkaluja. Se tukee moderneja ja vanhoja protokollia, ja sen lopetuskoodit erottelevat kerroksittain HTTP-, JSON-RPC- ja työkaluvirheet. Token annetaan prosessin ympäristömuuttujana, eikä sitä kirjoiteta skriptiin tai ohjetiedostoihin.

bash
export FLASH_BASE_URL='https://flash.example.com'
read -r -s -p 'Access token: ' FLASH_ACCESS_TOKEN
export FLASH_ACCESS_TOKEN

python3 examples/flash_mcp.py discover
python3 examples/flash_mcp.py tools
python3 examples/flash_mcp.py call dfc_ontologies --arguments '{"page":1,"pageSize":20}'

unset FLASH_ACCESS_TOKEN

Lukeminen ja kyselyt

bash
python3 examples/flash_mcp.py call dfc_ontology_resources \
  --arguments-file examples/requests/ontology-resources.json

python3 examples/flash_mcp.py call dfc_table \
  --arguments-file examples/requests/table-detail.json

python3 examples/flash_mcp.py call dfc_table \
  --arguments-file examples/requests/top3-query.json

Korvaa ensin pyyntötiedoston paikkamerkit kuten ONTOLOGY_ID ja TABLE_RESOURCE_ID nykyisen valtuutuksen palauttamilla todellisilla arvoilla. Asiakasohjelma hylkää suorituksen, jos paikkamerkkejä on jäljellä. SQL-esimerkki edellyttää, että mukana toimitettu CSV on tuotu alkuperäisillä sarakenimillä; ilman vastaavaa Schemaa sitä ei voi lähettää suoraan.

Muut tilanteet

  • Liiketoiminnan sisääntulo: käytä --endpoint business ja hanki uusi Grant /mcp/business-sisääntulolle.
  • Vanha asiakasohjelma: valitse --protocol 2025-11-25, suorita ensin initialize ja kutsu sitten samalla protokollalla.
  • Sisäänrakennetut ohjeet: lue todellinen URI resources- tai read-resource-komennolla.
  • Offline-itsetesti: --self-test tarkistaa modernien otsikoiden ja metatietojen muodostuksen, ei vaadi Tokenia eikä ota yhteyttä tuotepalvelimeen.

Esimerkin rajat

Asiakasohjelma on protokollaliitännän lähtöpiste; se ei automaattisesti luo mallinnusehdokkaita, tallenna kysymys–vastauspareja eikä suorita julkaisua. Se tulostaa alkuperäisen JSON-sisällön, jotta ylemmän tason Agent voi tarkistaa liiketoimintatilan; älä lupaa käyttäjälle kyselyn, raportin tai julkaisun valmistumista pelkän prosessin lopetuskoodin perusteella.

Luku 26

Ontologiakeskustelukäyttöliittymän upottaminen

Upota ihmiskäyttäjille tarkoitettu keskustelusivu liiketoimintasovelluksen käyttöliittymään säilyttäen kirjautumisen ja selaimen turvallisuusrajat.

html
<iframe
  title="OT Flash ontology agent"
  src="https://flash.example.com/10001/#/embed/ontology-agent/1001"
  style="width:100%;height:760px;border:0"
  referrerpolicy="strict-origin-when-cross-origin">
</iframe>

10001 on esimerkkivuokralaisen tunnus (tenant ID) ja 1001 esimerkki-ontologian tunnus; korvaa ne käytössä todellisilla koordinaateilla, joihin on oikeus. Yksittäinen ontologia voidaan määrittää polussa (path) tai tuetulla query-parametrilla; all-tila tarjoaa @-valinnan niille ontologioille, joita nykyinen käyttäjä voi käyttää. skillId välitetään vain läpi; älä sen perusteella väitä, että taitojen orkestrointi olisi suorituskelpoinen.

Todennus ja verkkotunnukset

Nykyinen upotettu sivu edellyttää todellista DataFocus-kirjautumisistuntoa ja tarkistaa /uc/status-pisteen. Sivustojen väliset evästeet, SSO, CSP frame-ancestors ja yhdyskäytäväasetukset vaikuttavat kaikki upotukseen. Se ei hyväksy MCP Bearer -tunnuksen sijoittamista URL-osoitteeseen kirjautumisen ohituskanavana; toteuttamatonta outside-ulkolinkkiä ei saa koota itse suunnitteluehdotusten perusteella.

MCP ja iframe: erot

TapaKäyttäjäIdentiteetti ja tulos
Remote MCPUlkoinen Agent- tai palveluintegraatioOAuth-Grant ja strukturoidut työkalukuittaukset
Ontologiakeskustelun iframeLoppukäyttäjä (ihminen)Alkuperäinen kirjautumistila ja keskustelukäyttöliittymä
MCP AppsLaajennuksia tukeva MCP-asiakasohjelmaHallitut resurssit ja nykyiset työkalutulokset, ei julkinen iframe-kirjautumisen korvike
Luku 27

Integraation hyväksymislista

Osoita täydellinen liiketoimintaketju todellisessa instanssissa sen sijaan, että vain vahvistaisit rajapinnan palauttavan 200.

  1. Löytäminen: hanki todelliset tuetut versiot, nykyinen työkaluluettelo ja sisäänrakennetut resurssit.
  2. Valtuutus: tavalliset käyttäjät näkevät vain itselleen hyväksytyt ontologiat ja liiketoimintajärjestelmät; toiminnot, joihin ei ole scopea, hylätään.
  3. Taulukkorakenne: todelliset näyttönimet, sarakkeet, tyypit ja käyttöoikeudet ovat täydelliset.
  4. SQL: yksi- ja moniulotteiset kyselyt, JOIN, päivämäärät, TopN ja katkaisutarkistukset vastaavat todellista liiketoiminnallista laskentaperustetta.
  5. Tietämys: paikannuksen, täydellisen alkutekstin ja faktaviittauskelpoisuuden on oltava yhdenmukaisia; yhdistetyissä kysymyksissä on sekä data- että dokumenttiperuste.
  6. Search: mallin, initin, ehdotusten, tulosten, sulkemisen ja puskurin täydellisyyden tarkistukset menevät läpi.
  7. Valinnainen analyysi ja raportit: useiden haarojen todelliset tilat, sivutus, käyttöoikeusmuutokset ja peruutus toimivat alkuperäisellä tavalla.
  8. Valinnainen mallinnus: ehdokas, suunnitelma, alkuperäinen hyväksyntä, todellinen käyttöönotto ja versiokysely tarkistetaan vaihe vaiheelta.
  9. Liiketoimintatoiminnot: julkaisun tiiviste, kohdeversio, hyväksyntä, idempotenssi ja Grantien välinen eristys tarkistetaan.
  10. Palautuminen: verkon aikakatkaisun jälkeen alkuperäinen tila selvitetään; lähteen päivityttyä vanha paikannus mitätöityy ja käytetään uutta kyselyä.

Tulosten kirjaaminen

Kirjaa instanssin versio, käyttäjän rooli, Grantin laajuus, konfiguraation versio, todelliset toimenpiteet ja tulokset. Merkitse erikseen protokolla-asiakasohjelman offline-itsetesti, esimerkki-CSV:n offline-odotusarvot, staattinen JSON-Schema-validointi ja todellinen verkossa tapahtuva toiminnallinen hyväksyntä. Älä yleistä yhden vaiheen läpimenoa koko tuotteen läpimenoksi.

Luku 28

Määrittelyresurssit ja ylläpito

Käytä käsikirjan mukana toimitettuja täydellisiä työkalu-Schemoja ja pidä ne synkronoituina instanssin todellisten löytämistulosten kanssa.

ResurssitSisältö
reference/mcp-tool-catalog.json32 ontologiapuolen ja 8 liiketoimintapuolen ilmoitettua syöte-Schemaa; osalla työkaluista myös alkuperäinen tuloste-Schema
reference/locales.json21 valittavaa ja 24 yhteensopivaa localea sekä UI-termit
reference/search-keywords.jsonStaattinen avainsanaluettelo 17 nimenomaisesti määritellylle localelle
reference/analysis-contract-manifest.jsonAnalyysiin, haaroihin, faktoihin, kuittauksiin ja raportteihin liittyvät versiorajoitteet
examples/Synteettinen CSV, laskentaperusteiden kuvaus, Top3-SQL, odotetut tulokset ja vähimmäisprotokolla-asiakasohjelma

Sisäänrakennetut kuvausresurssit

text
datafocus://manuals/etl-formulas/v1
datafocus://manuals/search-keyword-queries/v1
datafocus://manuals/etl-functions/v1
datafocus://manuals/search-keywords/v1

resources/list ja resources/read vaativat, että nykyisellä käyttäjällä on vähintään yksi vastaava lukuoikeus: metadata, search operate tai etl operate. ETL-dokumentaatio on staattista, tuotteiden välistä viitetietoa; Flashin todellisuudessa suoritettavat ominaisuudet rajoittuvat edelleen siihen, mitä se nimenomaisesti ilmoittaa.

Ulkoinen protokollaviite

MCP-protokollan ja valtuutuksen taustatiedot löytyvät virallisista määrityksistä: https://modelcontextprotocol.io/specification/2026-07-28/basic ja https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization.. Tämän tuotteen päätepisteet, työkalut ja ehdollinen käyttäytyminen määräytyvät r56-toteutuksen ja instanssin nykyisten löytämistulosten mukaan; yleistä protokollatukea ei saa pitää takeena siitä, että palvelin tarjoaa kaikki valinnaiset ominaisuudet.

Päivitys ja ylläpito

Päivityksen yhteydessä etsi työkalut ja versiot uudelleen ja vertaa syöte-Schemoja, tulossopimuksia ja konfiguraatiota; vanha Grant ei saa automaattisesti uutta scopea. Pidä viittaukset, välimuistit ja kuittaukset sidottuina lähdeversioon; hanki konteksti uudelleen yhteensopimattomien muutosten vahvistamisen jälkeen äläkä pakota vanhoja paikannuksia uusiin liiketoimintatiloihin.

Luku 29

Työkaluparametrien viite: perusteet ja natiivi Search

Täydelliset nimet ja syötekentät ryhmiteltynä työkalun mukaan.

Seuraavat taulukot ovat lukuviite nykyisten r56-työkalujen syötekentistä. Täydelliset sisäkkäiset tyypit, oneOf, ehdollisesti pakolliset kentät, pattern-rajoitteet ja osa tuloste-Schemoista ovat tiedostossa reference/mcp-tool-catalog.json; lue lisäksi nykyisen Grantin tools/list ennen lopullista lähetystä. Taulukon merkintä ”valinnainen” ei poista toimenpiteen sisäisiä validointivaatimuksia.

dfc_manual

ParametriTyyppiVaatimusMerkitys ja laajuus
namesarrayValinnainen tai ehdollisesti pakollinenEtsittävät nimenomaiset nimet, enintään 32 kerralla. maxItems: 32
actionstringValinnainen tai ehdollisesti pakollinenToimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: list, read, keywords, functions, etl_requests
localestringValinnainen tai ehdollisesti pakollinenNimenomainen staattisen viiteluettelon locale, ei kyselyn oletuskieli.
uristringValinnainen tai ehdollisesti pakollinenNykyisen työkalun luetteloimien sisäänrakennettujen resurssien URI. enum: datafocus://manuals/etl-formulas/v1, datafocus://manuals/search-keyword-queries/v1, datafocus://manuals/etl-functions/v1, datafocus://manuals/search-keywords/v1

dfc_search

ParametriTyyppiVaatimusMerkitys ja laajuus
dataobjectValinnainen tai ehdollisesti pakollinenAlkuperäisen toimenpiteen hyötykuorma; katso ominaisuuksien löytäminen ja toimenpidekenttien taulukot.
actionstringPakollinenToimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: capabilities, model_create, model_read, open, request, poll, cancel, close

dfc_etl

ParametriTyyppiVaatimusMerkitys ja laajuus
dataobjectValinnainen tai ehdollisesti pakollinenAlkuperäisen toimenpiteen hyötykuorma; katso ominaisuuksien löytäminen ja toimenpidekenttien taulukot.
actionstringPakollinenToimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: capabilities

dfc_ontologies

ParametriTyyppiVaatimusMerkitys ja laajuus
pageSizeintegerValinnainen tai ehdollisesti pakollinenRivimäärä sivua kohden; noudata Scheman ylärajaa. minimum: 1; maximum: 100
pageintegerValinnainen tai ehdollisesti pakollinenSivunumero, alkaen 1:stä. minimum: 1

dfc_ontology_resources

ParametriTyyppiVaatimusMerkitys ja laajuus
resourceTypesarrayValinnainen tai ehdollisesti pakollinenPalautettavien resurssityyppien joukko.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
pageSizeintegerValinnainen tai ehdollisesti pakollinenRivimäärä sivua kohden; noudata Scheman ylärajaa. minimum: 1; maximum: 100
pageintegerValinnainen tai ehdollisesti pakollinenSivunumero, alkaen 1:stä. minimum: 1
Luku 30

Työkaluparametrien viite: taulukko, graafi ja tietämys

Täydelliset nimet ja syötekentät ryhmiteltynä työkalun mukaan.

Seuraavat taulukot ovat lukuviite nykyisten r56-työkalujen syötekentistä. Täydelliset sisäkkäiset tyypit, oneOf, ehdollisesti pakolliset kentät, pattern-rajoitteet ja osa tuloste-Schemoista ovat tiedostossa reference/mcp-tool-catalog.json; lue lisäksi nykyisen Grantin tools/list ennen lopullista lähetystä. Taulukon merkintä ”valinnainen” ei poista toimenpiteen sisäisiä validointivaatimuksia.

dfc_ontology_graph

ParametriTyyppiVaatimusMerkitys ja laajuus
relationTypesarrayValinnainen tai ehdollisesti pakollinenRelaatiotyypin suodatin.
depthintegerValinnainen tai ehdollisesti pakollinenNaapurisolmujen läpikäynnin syvyys. minimum: 1; maximum: 3
sourceTypesarrayValinnainen tai ehdollisesti pakollinenLähdetyypin suodatin.
queryobjectValinnainen tai ehdollisesti pakollinenKyselyteksti tai action-parametria vastaava tarkka versioitu kyselyobjekti.
limitintegerValinnainen tai ehdollisesti pakollinenPalautettavien tulosten enimmäismäärä. minimum: 1; maximum: 100
actionstringPakollinenToimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: search, neighbors, published_model, published_query, candidate_query
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
nodeKeystringValinnainen tai ehdollisesti pakollinenSolmun avain, kopioitu todellisista graafituloksista.
keywordstringValinnainen tai ehdollisesti pakollinenGraafin paikannusavainsanat, eivät avainsanakyselyjen syntaksi.
nodeTypesarrayValinnainen tai ehdollisesti pakollinenSolmutyypin suodatin.

dfc_ontology_query

ParametriTyyppiVaatimusMerkitys ja laajuus
routeLocatorsarrayValinnainen tai ehdollisesti pakollinenPalvelimen myöntämä täydellinen, tyypitetty reitityspaikannus, kopioitava sellaisenaan. maxItems: 20
topKintegerValinnainen tai ehdollisesti pakollinenHaettavien ehdokkaiden enimmäismäärä; ei todista, että kattavuus on täydellinen. minimum: 1; maximum: 20
queryModestringValinnainen tai ehdollisesti pakollinenTodisteiden kyselytila työkalun enum-arvojen mukaan. enum: vector, hybrid, graph
fanoutPlanobjectValinnainen tai ehdollisesti pakollinenRajoitettu haarahakusuunnitelma, sisäkkäisen Scheman mukainen.
structuredPlanobjectValinnainen tai ehdollisesti pakollinenPalvelinsopimukseen sidottu suunnitelma täydelliselle dokumenttitaulukolle; ei SQL:ää.
knowledgeIdsarrayValinnainen tai ehdollisesti pakollinenTietämyskannan tunnus todellisesta knowledgeBindings-luettelosta.
querystringPakollinenKyselyteksti tai action-parametria vastaava tarkka versioitu kyselyobjekti.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.

dfc_knowledge_search

ParametriTyyppiVaatimusMerkitys ja laajuus
topKintegerValinnainen tai ehdollisesti pakollinenHaettavien ehdokkaiden enimmäismäärä; ei todista, että kattavuus on täydellinen. minimum: 1; maximum: 20
minScorenumberValinnainen tai ehdollisesti pakollinenVähimmäisvastaavuuspistemäärä. minimum: 0; maximum: 1
knowledgeIdsarrayValinnainen tai ehdollisesti pakollinenTietämyskannan tunnus todellisesta knowledgeBindings-luettelosta.
querystringPakollinenKyselyteksti tai action-parametria vastaava tarkka versioitu kyselyobjekti.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
assetIdsarrayValinnainen tai ehdollisesti pakollinenTällä hetkellä sallittujen dokumenttiresurssien (asset) tunnukset.
retrievalStrategystringValinnainen tai ehdollisesti pakollinenTodellisuudessa tuettu hakustrategia. enum: auto, hybrid_stage2

dfc_knowledge_detail

ParametriTyyppiVaatimusMerkitys ja laajuus
qdrantIdstring / integerValinnainen tai ehdollisesti pakollinenTodellisesta paikannuksesta palautettu indeksitunniste.
pageNointegerValinnainen tai ehdollisesti pakollinenTodellinen sivu- tai sivutusnumero.
evidenceIdstringValinnainen tai ehdollisesti pakollinenSaman tietämyspaikannuksen palauttama todisteen tunnus.
actionstringPakollinenToimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: chunk, document, page_context
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
documentIdstring / integerValinnainen tai ehdollisesti pakollinenSaman paikannuksen asiakirjatunnus.
radiusintegerValinnainen tai ehdollisesti pakollinenViereisten sivujen alue. minimum: 0; maximum: 3
chunkIdstringValinnainen tai ehdollisesti pakollinenSaman paikannuksen todellinen osion (chunk) tunnus.

dfc_table

ParametriTyyppiVaatimusMerkitys ja laajuus
maxRowsintegerValinnainen tai ehdollisesti pakollinenPalautettavien rivien enimmäismäärä; ei asiakaspuolen sijoitusalue. minimum: 1; maximum: 200
actionstringPakollinenToimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: detail, query
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
idstringValinnainen tai ehdollisesti pakollinenTodellinen taulukkoresurssin tunnus, ei fyysinen nimi eikä näyttönimi.
sqlstringValinnainen tai ehdollisesti pakollinenYksi ontologian rajauksen sisäinen, vain lukeva Doris-SQL-lause eksplisiittisin tulostesarakkein.
Luku 31

Työkaluparametrien viite: analyysi ja raportti

Täydelliset nimet ja syötekentät ryhmiteltynä työkalun mukaan.

Seuraavat taulukot ovat lukuviite nykyisten r56-työkalujen syötekentistä. Täydelliset sisäkkäiset tyypit, oneOf, ehdollisesti pakolliset kentät, pattern-rajoitteet ja osa tuloste-Schemoista ovat tiedostossa reference/mcp-tool-catalog.json; lue lisäksi nykyisen Grantin tools/list ennen lopullista lähetystä. Taulukon merkintä ”valinnainen” ei poista toimenpiteen sisäisiä validointivaatimuksia.

dfc_analysis_ask

ParametriTyyppiVaatimusMerkitys ja laajuus
questionstringPakollinenLuonnollisen kielen kysymys tai yhteensopiva jatkokysymys.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
languagestringValinnainen tai ehdollisesti pakollinenNimenomainen vastaus- tai kyselylocale; jos jätetään pois, noudatetaan kyseisen työkalun sääntöjä.
sessionIdstringValinnainen tai ehdollisesti pakollinenTodellinen istuntoviite saman Grantin piirissä.

dfc_analysis_refine

ParametriTyyppiVaatimusMerkitys ja laajuus
branchIdstringValinnainen tai ehdollisesti pakollinenPalvelimen myöntämä strukturoidun haaran viite.
resultIdstringPakollinenAlun perin palautetun analyysituloksen viite.
questionstringValinnainen tai ehdollisesti pakollinenLuonnollisen kielen kysymys tai yhteensopiva jatkokysymys.
idempotencyKeystringPakollinenIdempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen.
changeobjectValinnainen tai ehdollisesti pakollinenLuonnollisen kielen muutos tai tyypitetty filter_patch.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
languagestringValinnainen tai ehdollisesti pakollinenNimenomainen vastaus- tai kyselylocale; jos jätetään pois, noudatetaan kyseisen työkalun sääntöjä.
sessionIdstringPakollinenTodellinen istuntoviite saman Grantin piirissä.
expectedRevisionintegerPakollinenAlkuperäisen tuloksen tai liiketoimintaotsikon versioedellytys; voi olla null kysymystä luotaessa. minimum: 1
visualIdstringValinnainen tai ehdollisesti pakollinenHaaraan sidottu visualisoinnin viite.

dfc_analysis_page

ParametriTyyppiVaatimusMerkitys ja laajuus
branchIdstringPakollinenPalvelimen myöntämä strukturoidun haaran viite.
resultIdstringPakollinenAlun perin palautetun analyysituloksen viite.
pageNointegerPakollinenTodellinen sivu- tai sivutusnumero. minimum: 1; maximum: 10000
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
pageSizeintegerPakollinenRivimäärä sivua kohden; noudata Scheman ylärajaa. minimum: 1; maximum: 100
sessionIdstringPakollinenTodellinen istuntoviite saman Grantin piirissä.
expectedRevisionintegerPakollinenAlkuperäisen tuloksen tai liiketoimintaotsikon versioedellytys; voi olla null kysymystä luotaessa. minimum: 1

dfc_analysis_result_get

ParametriTyyppiVaatimusMerkitys ja laajuus
resultIdstringPakollinenAlun perin palautetun analyysituloksen viite.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
sessionIdstringPakollinenTodellinen istuntoviite saman Grantin piirissä.

dfc_analysis_cancel

ParametriTyyppiVaatimusMerkitys ja laajuus
resultIdstringPakollinenAlun perin palautetun analyysituloksen viite.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
sessionIdstringPakollinenTodellinen istuntoviite saman Grantin piirissä.

dfc_analysis_close

ParametriTyyppiVaatimusMerkitys ja laajuus
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
sessionIdstringPakollinenTodellinen istuntoviite saman Grantin piirissä.

dfc_report_create

ParametriTyyppiVaatimusMerkitys ja laajuus
goalstringPakollinenRaportin analyysikohde.
idempotencyKeystringPakollinenIdempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
languagestringValinnainen tai ehdollisesti pakollinenNimenomainen vastaus- tai kyselylocale; jos jätetään pois, noudatetaan kyseisen työkalun sääntöjä.
titlestringValinnainen tai ehdollisesti pakollinenValinnainen raportin otsikko.

dfc_report_status

ParametriTyyppiVaatimusMerkitys ja laajuus
reportIdstringPakollinenNykyisen Grantin pysyvä raporttiviite.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.

dfc_report_cancel

ParametriTyyppiVaatimusMerkitys ja laajuus
reportIdstringPakollinenNykyisen Grantin pysyvä raporttiviite.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
Luku 32

Työkaluparametrien viite: mallinnus ja alkuperäiset tehtävät

Täydelliset nimet ja syötekentät ryhmiteltynä työkalun mukaan.

Seuraavat taulukot ovat lukuviite nykyisten r56-työkalujen syötekentistä. Täydelliset sisäkkäiset tyypit, oneOf, ehdollisesti pakolliset kentät, pattern-rajoitteet ja osa tuloste-Schemoista ovat tiedostossa reference/mcp-tool-catalog.json; lue lisäksi nykyisen Grantin tools/list ennen lopullista lähetystä. Taulukon merkintä ”valinnainen” ei poista toimenpiteen sisäisiä validointivaatimuksia.

dfc_ontology_agent

ParametriTyyppiVaatimusMerkitys ja laajuus
modestringValinnainen tai ehdollisesti pakollinenQUERY tai AUTHORING, ominaisuudet valtuutetaan erikseen. enum: QUERY, AUTHORING
instructionstringValinnainen tai ehdollisesti pakollinenKäyttäjän vaatimusteksti; kontekstin ja lähetyksen on oltava yhdenmukaiset. maxLength: 16000
idempotencyKeystringValinnainen tai ehdollisesti pakollinenIdempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. maxLength: 128
actionstringPakollinenToimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: start, status, cancel
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
runIdstringValinnainen tai ehdollisesti pakollinenSaman ontologian ja Grantin alkuperäisen tehtävän tunnus.
contractVersionstringPakollinenOn käytettävä täsmällistä, todellisuudessa tuettua sopimusversiota. enum: ontology-agent-task-v1

dfc_authoring_capabilities

Tämän työkalun syötteen juuriobjektilla ei ole kenttiä; käytä tyhjää arguments-objektia.

dfc_artifact_context

ParametriTyyppiVaatimusMerkitys ja laajuus
artifactTypestringPakollinenTodellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: CONTROL_PANEL_SPEC, VIEW_SPEC
scopeTypestringValinnainen tai ehdollisesti pakollinenResurssirajauksen tyyppi todellisessa artefaktisopimuksessa.
ontologyIdstringValinnainen tai ehdollisesti pakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
projectIdstringValinnainen tai ehdollisesti pakollinenNykyisen valtuutetun projektin ID.
artifactIdstringValinnainen tai ehdollisesti pakollinenMuokattavan olemassa olevan artefaktin todellinen ID.
instructionstringPakollinenKäyttäjän vaatimusteksti; kontekstin ja lähetyksen on oltava yhdenmukaiset.
variablesobjectValinnainen tai ehdollisesti pakollinenPalautetun sopimuksen mukainen muuttujaobjekti.
previewInputobjectValinnainen tai ehdollisesti pakollinenSopimuksen mukainen rajattu esikatselusyöte.
viewportobjectValinnainen tai ehdollisesti pakollinenAlkuperäisen sopimuksen edellyttämä näkymäalue (viewport).

dfc_ontology_table_schema

ParametriTyyppiVaatimusMerkitys ja laajuus
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
sourceAssetRefstringPakollinenRekisteröity strukturoitu resurssiviittaus, esim. table:123.
fieldsarrayPakollinenNykyisen lähteen kentät ja valinnainen eksplisiittinen tyyppimäärittely. minItems: 1; maxItems: 64

dfc_artifact_preview

ParametriTyyppiVaatimusMerkitys ja laajuus
proposalIdstringPakollinenNykyisen Grantin luoman alkuperäisen ehdokkaan ID.
candidateHashstringPakollinenPalvelimen alkuperäisen ehdokkaan tarkka tiiviste.
previewInputobjectPakollinenSopimuksen mukainen rajattu esikatselusyöte.

dfc_artifact_status

ParametriTyyppiVaatimusMerkitys ja laajuus
proposalIdstringValinnainen tai ehdollisesti pakollinenNykyisen Grantin luoman alkuperäisen ehdokkaan ID.
planIdstringValinnainen tai ehdollisesti pakollinenMuuttumattoman käyttöönottosuunnitelman ID.

dfc_artifact_plan

ParametriTyyppiVaatimusMerkitys ja laajuus
proposalIdstringPakollinenNykyisen Grantin luoman alkuperäisen ehdokkaan ID.
candidateHashstringPakollinenPalvelimen alkuperäisen ehdokkaan tarkka tiiviste.
expectedTargetVersionintegerPakollinenNykyisen todellisen kohdeversion edellytys. minimum: 0
idempotencyKeystringPakollinenIdempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen.

dfc_artifact_apply

ParametriTyyppiVaatimusMerkitys ja laajuus
planIdstringPakollinenMuuttumattoman käyttöönottosuunnitelman ID.
planHashstringPakollinenAlkuperäisen suunnitelman palauttama tiiviste.
approvalTokenstringPakollinenAlkuperäisen palvelimen myöntämä hyväksyntämateriaali; ei saa luoda itse.
idempotencyKeystringPakollinenIdempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen.

dfc_artifact_submit

ParametriTyyppiVaatimusMerkitys ja laajuus
Konfiguraatio 1 / artifactTypestringPakollinenTodellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: CONTROL_PANEL_SPEC, VIEW_SPEC
Konfiguraatio 1 / scopeTypestringValinnainen tai ehdollisesti pakollinenResurssirajauksen tyyppi todellisessa artefaktisopimuksessa.
Konfiguraatio 1 / ontologyIdstringValinnainen tai ehdollisesti pakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
Konfiguraatio 1 / projectIdstringValinnainen tai ehdollisesti pakollinenNykyisen valtuutetun projektin ID.
Konfiguraatio 1 / artifactIdstringValinnainen tai ehdollisesti pakollinenMuokattavan olemassa olevan artefaktin todellinen ID.
Konfiguraatio 1 / instructionstringPakollinenKäyttäjän vaatimusteksti; kontekstin ja lähetyksen on oltava yhdenmukaiset.
Konfiguraatio 1 / variablesobjectValinnainen tai ehdollisesti pakollinenPalautetun sopimuksen mukainen muuttujaobjekti.
Konfiguraatio 1 / previewInputobjectValinnainen tai ehdollisesti pakollinenSopimuksen mukainen rajattu esikatselusyöte.
Konfiguraatio 1 / viewportobjectValinnainen tai ehdollisesti pakollinenAlkuperäisen sopimuksen edellyttämä näkymäalue (viewport).
Konfiguraatio 1 / contractVersionstringPakollinenOn käytettävä täsmällistä, todellisuudessa tuettua sopimusversiota.
Konfiguraatio 1 / contextHashstringPakollinencontext-kutsun palauttama täysi kontekstitiiviste.
Konfiguraatio 1 / baseArtifactHashstringPakollinencontext-kutsun palauttama perusartefaktin tiiviste.
Konfiguraatio 1 / baseArtifactVersionintegerPakollinencontext-kutsun palauttama perusversio. minimum: 0
Konfiguraatio 1 / candidateobjectPakollinenNykyisen palautetun sopimuksen mukainen ehdokasobjekti.
Konfiguraatio 1 / clientRequestIdstringPakollinenNykyisen ehdokaspyynnön vakaasti käyttämä asiakasohjelman idempotenssiavain.
Konfiguraatio 2 / artifactTypestringPakollinenTodellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: ONTOLOGY_RELEASE
Konfiguraatio 2 / contractVersionstringPakollinenOn käytettävä täsmällistä, todellisuudessa tuettua sopimusversiota. enum: ontology-publication-mcp-submit-v1, ontology-publication-mcp-submit-v2, ontology-publication-mcp-submit-v3, ontology-publication-mcp-submit-v4, ontology-publication-mcp-submit-v5, ontology-publication-mcp-submit-v6
Konfiguraatio 2 / ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
Konfiguraatio 2 / candidateHashstringPakollinenPalvelimen alkuperäisen ehdokkaan tarkka tiiviste.
Konfiguraatio 2 / workspaceIdstringPakollinenTodelliset ehdokkaan työtilakoordinaatit.
Konfiguraatio 2 / workspaceRevisionstringPakollinenTarkka ehdokasversio; ei latest-arvoa.
Konfiguraatio 2 / releasesobjectPakollinenOntologian julkaisusopimuksen mukainen tarkka versiovalinta.
Konfiguraatio 2 / selectionobjectPakollinenVain eksplisiittiset liiketoiminnan valintakoordinaatit; ei oikeuksia eikä valmistumistodistetta.
Konfiguraatio 2 / idempotencyKeystringPakollinenIdempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen.
Konfiguraatio 3 / Konfiguraatio 1 / artifactTypestringPakollinenTodellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: ONTOLOGY_RELEASE
Konfiguraatio 3 / Konfiguraatio 1 / contractVersionstringPakollinenOn käytettävä täsmällistä, todellisuudessa tuettua sopimusversiota. enum: ontology-workspace-create-mcp-submit-v1
Konfiguraatio 3 / Konfiguraatio 1 / ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
Konfiguraatio 3 / Konfiguraatio 1 / workspaceIdstringPakollinenTodelliset ehdokkaan työtilakoordinaatit.
Konfiguraatio 3 / Konfiguraatio 1 / resourcesarrayPakollinenPalvelimen kääntämä alkuperäinen mallideklaraatio. minItems: 1
Konfiguraatio 3 / Konfiguraatio 1 / idempotencyKeystringPakollinenIdempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen.
Konfiguraatio 3 / Konfiguraatio 2 / artifactTypestringPakollinenTodellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: ONTOLOGY_RELEASE
Konfiguraatio 3 / Konfiguraatio 2 / contractVersionstringPakollinenOn käytettävä täsmällistä, todellisuudessa tuettua sopimusversiota. enum: ontology-workspace-create-mcp-submit-v2
Konfiguraatio 3 / Konfiguraatio 2 / ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
Konfiguraatio 3 / Konfiguraatio 2 / workspaceIdstringPakollinenTodelliset ehdokkaan työtilakoordinaatit.
Konfiguraatio 3 / Konfiguraatio 2 / resourcesarrayPakollinenPalvelimen kääntämä alkuperäinen mallideklaraatio. minItems: 1
Konfiguraatio 3 / Konfiguraatio 2 / idempotencyKeystringPakollinenIdempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen.
Konfiguraatio 3 / Konfiguraatio 2 / releaseSelectionsobjectPakollinenJokaisen julkaistun viittauksen tarkka releaseId ja riippuvuuksien sulkeuma.
Konfiguraatio 4 / artifactTypestringPakollinenTodellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: ONTOLOGY_RELEASE
Konfiguraatio 4 / contractVersionstringPakollinenOn käytettävä täsmällistä, todellisuudessa tuettua sopimusversiota. enum: ontology-initial-activation-retirement-submit-v1
Konfiguraatio 4 / ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
Konfiguraatio 4 / domainRidstringPakollinenTodellinen liiketoiminta-alueen RID.
Konfiguraatio 4 / consumerScopesarrayPakollinenPalvelimen sallimat tarkat kuluttajalaajuudet. minItems: 1; maxItems: 256
Konfiguraatio 4 / idempotencyKeystringPakollinenIdempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen.
Luku 33

Työkaluparametrien viite: tietämyksen syöttö ja laajuus

Täydelliset nimet ja syötekentät ryhmiteltynä työkalun mukaan.

Seuraavat taulukot ovat lukuviite nykyisten r56-työkalujen syötekentistä. Täydelliset sisäkkäiset tyypit, oneOf, ehdollisesti pakolliset kentät, pattern-rajoitteet ja osa tuloste-Schemoista ovat tiedostossa reference/mcp-tool-catalog.json; lue lisäksi nykyisen Grantin tools/list ennen lopullista lähetystä. Taulukon merkintä ”valinnainen” ei poista toimenpiteen sisäisiä validointivaatimuksia.

dfc_ontology_knowledge_input_propose

ParametriTyyppiVaatimusMerkitys ja laajuus
requestobjectPakollinenAlkuperäinen liiketoiminnan syötepyyntö; täydellisen sisäkkäisen Scheman mukaisesti.
idempotencyKeystringPakollinenSaman loogisen operaation vakaa, uudelleenkäytettävä idempotenssiavain. minLength: 1; maxLength: 128

Tällä työkalulla on myös natiivi outputSchema. Tarkista tuloksen täydellisyys, tila ja ne valtuutuskentät, joiden arvo on eksplisiittisesti false; älä itse tulkitse tulosta valmiimmaksi kuin se on.

dfc_ontology_knowledge_input_preview

ParametriTyyppiVaatimusMerkitys ja laajuus
idempotencyKeystringPakollinenSaman loogisen operaation vakaa, uudelleenkäytettävä idempotenssiavain. minLength: 1; maxLength: 128
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.

Tällä työkalulla on myös natiivi outputSchema. Tarkista tuloksen täydellisyys, tila ja ne valtuutuskentät, joiden arvo on eksplisiittisesti false; älä itse tulkitse tulosta valmiimmaksi kuin se on.

dfc_ontology_knowledge_question_submit

ParametriTyyppiVaatimusMerkitys ja laajuus
questionRevision$refPakollinenTämän vahvistusta odottavan kysymyksen eksplisiittinen versio.
idempotencyKey$refPakollinenIdempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen.
originalInputKey$refPakollinenAlkuperäistä tietämyssyötettä vastaava idempotenssiavain.
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona.
validUntil$refPakollinenKysymyksen voimassaoloikkunan loppuhetki UTC-aikana.
expectedRevisiononeOfPakollinenAlkuperäisen tuloksen tai liiketoimintaotsikon versioedellytys; voi olla null kysymystä luotaessa.
validFrom$refPakollinenKysymyksen voimassaoloikkunan alkuhetki UTC-aikana.

Tällä työkalulla on myös natiivi outputSchema. Tarkista tuloksen täydellisyys, tila ja ne valtuutuskentät, joiden arvo on eksplisiittisesti false; älä itse tulkitse tulosta valmiimmaksi kuin se on.

dfc_ontology_business_scope_initialize

ParametriTyyppiVaatimusMerkitys ja laajuus
domainRevisionIdstringPakollinenTarkka liiketoiminta-alueen versio. minLength: 1; maxLength: 128
idempotencyKeystringPakollinenSaman loogisen operaation vakaa, uudelleenkäytettävä idempotenssiavain. minLength: 1; maxLength: 128
businessSystemIdstringPakollinenTodellinen liiketoimintajärjestelmän ID. minLength: 1
ontologyIdstringPakollinenTodellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. minLength: 1
domainRidstringPakollinenTodellinen liiketoiminta-alueen RID. minLength: 1; maxLength: 128

Tällä työkalulla on myös natiivi outputSchema. Tarkista tuloksen täydellisyys, tila ja ne valtuutuskentät, joiden arvo on eksplisiittisesti false; älä itse tulkitse tulosta valmiimmaksi kuin se on.

Luku 34

Työkaluparametrien viite: liiketoimintatyötila

Täydelliset nimet ja syötekentät ryhmiteltynä työkalun mukaan.

Seuraavat taulukot ovat lukuviite nykyisten r56-työkalujen syötekentistä. Täydelliset sisäkkäiset tyypit, oneOf, ehdollisesti pakolliset kentät, pattern-rajoitteet ja osa tuloste-Schemoista ovat tiedostossa reference/mcp-tool-catalog.json; lue lisäksi nykyisen Grantin tools/list ennen lopullista lähetystä. Taulukon merkintä ”valinnainen” ei poista toimenpiteen sisäisiä validointivaatimuksia.

dfb_systems

Tämän työkalun syötteen juuriobjektilla ei ole kenttiä; käytä tyhjää arguments-objektia.

dfb_system_describe

ParametriTyyppiVaatimusMerkitys ja laajuus
systemIdstring / integerPakollinenTämän liiketoiminta-Grantin sallimat järjestelmä-ID:t.

dfb_query

ParametriTyyppiVaatimusMerkitys ja laajuus
systemIdstring / integerPakollinenTämän liiketoiminta-Grantin sallimat järjestelmä-ID:t.
queryKeystringPakollinendescribe-kutsun palauttama julkaistu kyselyavain.
objectKeystringValinnainen tai ehdollisesti pakollinenJulkaistun objektin avain.
pageSizeintegerValinnainen tai ehdollisesti pakollinenRivimäärä sivua kohden; noudata Scheman ylärajaa. minimum: 1; maximum: 100
pageintegerValinnainen tai ehdollisesti pakollinenSivunumero, alkaen 1:stä. minimum: 1
statestringValinnainen tai ehdollisesti pakollinenLiiketoimintatilan suodatin tai palvelintila.

dfb_record

ParametriTyyppiVaatimusMerkitys ja laajuus
recordIdstring / integerPakollinenSellaisen liiketoimintatietueen ID, jonka lukeminen on tällä hetkellä sallittu.
systemIdstring / integerPakollinenTämän liiketoiminta-Grantin sallimat järjestelmä-ID:t.

dfb_work_items

ParametriTyyppiVaatimusMerkitys ja laajuus
systemIdstring / integerPakollinenTämän liiketoiminta-Grantin sallimat järjestelmä-ID:t.

dfb_action_plan

ParametriTyyppiVaatimusMerkitys ja laajuus
expectedRecordVersionintegerValinnainen tai ehdollisesti pakollinenKohdetietueen nykyinen optimistisen lukituksen versio. minimum: 1
systemIdstring / integerPakollinenTämän liiketoiminta-Grantin sallimat järjestelmä-ID:t.
commandTypestringPakollinenJulkaistun sopimuksen komentotyyppi.
canonicalIrHashstringPakollinenNykyisen julkaisun kanoninen IR-tiiviste.
releaseIdstring / integerPakollinenTodellisen julkaisusopimuksen versio-ID.
payloadobjectPakollinendescribe-kutsun nykyisen komentosopimuksen mukainen hyötykuorma.
releaseHashstringPakollinenTodellisen julkaisusopimuksen tiiviste.
targetRecordIdstring / integerValinnainen tai ehdollisesti pakollinenTodellinen kohdetietue, johon toiminto kohdistuu.
agentManifestHashstringPakollinenTodellisen Agent-ominaisuusmanifestin tiiviste.
planIdempotencyKeystringPakollinenLiiketoimintasuunnitelman vakaa idempotenssiavain.

dfb_action_status

ParametriTyyppiVaatimusMerkitys ja laajuus
actionPlanIdstring / integerPakollinenNykyisen liiketoiminta-Grantin omistaman toimenpidesuunnitelman ID.

dfb_action_execute

ParametriTyyppiVaatimusMerkitys ja laajuus
approvalTokenstringValinnainen tai ehdollisesti pakollinenAlkuperäisen palvelimen myöntämä hyväksyntämateriaali; ei saa luoda itse.
actionPlanIdstring / integerPakollinenNykyisen liiketoiminta-Grantin omistaman toimenpidesuunnitelman ID.