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ä.
Sisällysluettelo
- 1Agent-integraation laajuus ja valmistumiskriteerit
- 2Nopea yhteyden muodostus ja ominaisuuksien löytäminen
- 3OAuth-löytäminen, rekisteröinti ja valtuutus
- 4Scopen resurssirajat ja reaaliaikaiset oikeudet
- 5HTTP- ja modernit MCP-viestit
- 6Yhteensopivuus vanhan protokollan asiakasohjelmien kanssa
- 7Valitse oikea työkalu ja todistekanava
- 8Ontologian resurssit ja ID-tyypit
- 9Doris-taulukkokyselyt ja rakennesopimukset
- 10Moniulotteinen Top3 ja katkaisujen käsittely
- 11Tietämyshaku: täydellinen alkuteksti ja todisteiden kelpoisuus
- 12Natiivit Search-mallit ja istunnot
- 13Kieli- ja aluekäytännöt
- 14Yhdistetty analyysi ja interaktiiviset tulokset
- 15Pysyvät visualisointiraportit ja MCP Apps -sovellukset
- 16Artefaktin luonnos, esikatselu, suunnitelma ja käyttöönotto
- 17Ontologian ehdokkaan luonti- ja julkaisusopimus
- 18Julkaistu malli, ehdokaskyselyt ja viittaussulkeuma
- 19Ontologia-agentin tehtävien delegointi
- 20Liiketoimintatyötilan MCP
- 21Liiketoimintatietämyksen syöttö ja vahvistusta odottavat kysymykset
- 22Vastaukset, virheet ja turvallinen uudelleenyritys
- 23Integraation turvallisuus ja ominaisuuksien rajat
- 24Ylläpitäjän kytkennät ja ehdolliset kytkimet
- 25Ajettava asiakasohjelma ja kutsuesimerkit
- 26Ontologiakeskustelukäyttöliittymän upottaminen
- 27Integraation hyväksymislista
- 28Määrittelyresurssit ja ylläpito
- 29Työkaluparametrien viite: perusteet ja natiivi Search
- 30Työkaluparametrien viite: taulukko, graafi ja tietämys
- 31Työkaluparametrien viite: analyysi ja raportti
- 32Työkaluparametrien viite: mallinnus ja alkuperäiset tehtävät
- 33Työkaluparametrien viite: tietämyksen syöttö ja laajuus
- 34Työkaluparametrien viite: liiketoimintatyötila
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.
| Sisääntulopiste | Käyttötarkoitus | Rajaus |
|---|---|---|
| /mcp | Ontologia, datataulukot, dokumenttitietämys, natiivi Search sekä ehdollisesti avoimet analyysi- ja mallinnusominaisuudet | Nykyisen käyttäjän oikeuksien ja tämän valtuutuksen resurssien leikkaus |
| /mcp/business | Liiketoimintajärjestelmien löytäminen, kyselyt, toimenpidesuunnitelmat, tilat ja suoritus | Erillinen liiketoimintajärjestelmän valtuutus ja julkaisusopimus |
| Ontologia-agentin upotettu sivu | Ontologiakeskustelun 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.
Nopea yhteyden muodostus ja ominaisuuksien löytäminen
Aloita instanssin virallisella verkkotunnuksella ja selvitä todelliset käytettävissä olevat työkalut vähimmäisoikeuksin.
- 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.
- Määritä MCP-palvelinosoite arvoksi https://flash.example.com/mcp; liiketoimintatyötila käyttää saman verkkotunnuksen polkua /mcp/business.
- 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.
- Käytä kyseisen protokollasukupolven löytämis- tai initialize-mekanismia ja lue sen jälkeen tools/list ja resurssikuvaukset.
- Tee ensin pieni vain luku -pyyntö ja tarkista strukturoitu tulos ja virheet, ennen kuin suoritat käyttäjän tavoitteen.
Asiakasohjelman määrityskatkelma
{
"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
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.
OAuth-löytäminen, rekisteröinti ja valtuutus
Käytä valtuutuskoodia ja PKCE-mekanismia äläkä paljasta Agentille tuotteen kirjautumistietoja.
| Päätepiste | Metodi | Tarkoitus |
|---|---|---|
| /.well-known/oauth-protected-resource | GET | Ontologian MCP-resurssin löytäminen |
| /.well-known/oauth-protected-resource/mcp | GET | Ontologiaresurssin löytäminen yhteensopivalla polulla |
| /.well-known/oauth-protected-resource/mcp/business | GET | Liiketoiminnan MCP-resurssin löytäminen |
| /.well-known/oauth-authorization-server | GET | Valtuutuspalvelimen metatiedot |
| /oauth/register | POST JSON | Public clientin dynaaminen rekisteröinti |
| /oauth/authorize | GET tai POST-lomake | Kirjautuminen, resurssin valinta ja valtuutuksen vahvistus |
| /oauth/token | POST-lomake | Valtuutuskoodin vaihto ja refresh-tokenin kierrätys |
| /oauth/revoke | POST-lomake | Tokenin mitätöinti |
| /oauth/grants | GET | Kirjautuneen käyttäjän näkymä valtuutettuihin yhteyksiin |
| /oauth/grants/revoke | POST-lomake | Yhteyden peruuttaminen alkuperäisen sivukulun mukaisesti |
Valtuutusjärjestys
- Lue suojatun resurssin metatiedot ja valtuutuspalvelimen metatiedot. Ilman Tokenia saatava 401-vastaus ja WWW-Authenticate-otsikko osoittavat resurssin löytämisosoitteeseen.
- 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.
- Luo satunnaiset state- ja code_verifier-arvot ja laske code_challenge S256-menetelmällä.
- 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.
- 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ä.
- Vastaanota takaisinkutsu, varmista state ja issuer ja vaihda valtuutuskoodi alkuperäisellä code_verifier-arvolla.
- 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
{
"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.
Scopen resurssirajat ja reaaliaikaiset oikeudet
Valtuutuksen scope delegoi olemassa olevia oikeuksia; se ei myönnä roolikorotuksia eikä jaa liiketoimintatilaa Grantien välillä.
| Scope | Tyypilliset ominaisuudet | Tärkeät rajoitukset |
|---|---|---|
| ontology.metadata:read | Ontologia, resurssit, taulukoiden rakenteet | Ontologian ja taulukoiden on oltava valtuutus- ja nykyisen lukuoikeuden piirissä |
| ontology.graph:read | Graafihaku ja naapurit | Palauttaa paikannustietoja, ei faktien todisteita |
| ontology.knowledge:read | Tietämyksen paikannus ja täydellinen alkuteksti | Tietämyskannan ja dokumenttien alkuperäiset oikeudet säilyvät |
| ontology.table:query | Ontologiataulukon SQL sekä julkaistujen mallien kysely | Taulukkokysely vaatii lisäksi metadata-scopen; todellinen lähde ja sarakkeiden oikeudet pysyvät voimassa |
| search:operate | Natiivit avainsanamallit ja istunnot | Erillinen nimenomainen delegointi; suoritetaan alkuperäisen mallin sekä käyttäjän taulukko- ja sarakeoikeuksien mukaisesti |
| etl:operate | Flash ETL capabilities | Heavy ETL -toimintoa ei avata |
| authoring.contract:read | Ehdollisesti avoin mallinnussopimus | Vaatii lisäksi ominaisuuskytkimen ja asianomaiset resurssit |
| authoring.artifact:read | Ehdokkaiden, suunnitelmien ym. lukeminen nykyisen valtuutuksen puitteissa | Sidotaan alkuperäisen subjektin Grantiin ja resursseihin |
| authoring.artifact:draft | Ehdokkaan lähettäminen, esikatselu jne. | Ei myönnä suoritus- tai julkaisuoikeutta |
| authoring.artifact:apply | Hallittu suunnittelu ja käyttöönotto | Vaatii edelleen alkuperäisen liiketoimintaroolin, käytännöt ja hyväksynnän |
| execution.script:draft | Tietyt komentosarjaluonnokset | Ei myönnä oikeutta komentosarjojen todelliseen suorittamiseen |
| datasource.http:read / draft / test / import | Ehdollisesti avoimet HTTP-datalähteiden artefaktiominaisuudet | Jokaisella on oma kytkimensä, ja alkuperäiset oikeudet pätevät |
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.
HTTP- ja modernit MCP-viestit
Lähetä pyyntökohtaiset metatiedot ja vastaavat reititysotsikot oikein ja käsittele HTTP-tulokset ja työkalutulokset erikseen.
| Kohta | r56-käyttäytyminen |
|---|---|
| Siirtotapa | Tilaton Streamable HTTP, POST JSON-RPC |
| Tuetut tunnisteet | 2026-07-28 sekä 2025-11-25 2025-06-18 2025-03-26 |
| Modernit metodit | server/discover tools/list tools/call resources/list resources/read, käytettävissä todellisten ominaisuuksien mukaan |
| Istunto-otsikko | Mcp-Session-Id-tunnistetta ei anneta |
| GET ja DELETE | /mcp ja /mcp/business palauttavat 405 |
| Palvelimen SSE-ilmoitukset | Nämä kaksi julkista MCP-sisääntuloa eivät tarjoa niitä |
| Hakemistovälimuisti | Moderni löytäminen ja listaus palauttavat ttlMs=60000 ja cacheScope=private |
| Tavallinen tulos | Moderni 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
{
"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.
Yhteensopivuus vanhan protokollan asiakasohjelmien kanssa
Pidä protokollasukupolvi yhtenäisenä asiakasohjelmissa, jotka käyttävät edelleen alustuskättelyä.
{
"jsonrpc": "2.0", "id": 1, "method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {"name": "flash-legacy-client", "version": "1.0.0"}
}
}- Lähetä initialize ja lue palvelimen neuvottelema protokollaversio sekä capabilities.
- Lähetä asiakasohjelman protokollan edellyttämä alustuksen valmistumisilmoitus; ilmoituksella ei ole tavallista työkalutulosta.
- Lue tools/list-kutsulla nykyiset valtuutetut työkalut ja lähetä sitten tools/call.
- 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
| Tilanne | Tyypillinen tulos | Toimenpide |
|---|---|---|
| Modernit otsikot ja viesti eivät täsmää | HTTP 400 JSON-RPC -32020 | Korjaa otsikot, metatiedot ja työkalunimet |
| Versioa ei tueta | -32022 ja luettelo tuetuista versioista | Valitse todellisuudessa tuettu protokolla |
| Tuntematon metodi | JSON-RPC -32601, moderni pyyntö voi palauttaa HTTP 404 | Tarkista protokollasukupolvi ja metodi |
| Parametrit puuttuvat tai ovat virheelliset | JSON-RPC-parametrivirhe tai työkalun isError | Korjaa todellisen inputSchema-määrityksen mukaan |
Valitse oikea työkalu ja todistekanava
Reititä ratkaisemattoman liiketoimintakysymyksen mukaan äläkä toista todisteiden keräämistä kiinteällä kutsuketjulla.
| Tehtävä | Ensisijainen työkalu | Valmistumiseen tarvittavat todisteet |
|---|---|---|
| Valtuutettujen aiheiden ja resurssien löytäminen | dfc_ontologies dfc_ontology_resources | Todelliset resurssien ID-tyypit ja nykyinen näkyvyysalue |
| Taulukkotilastot ja TopN | dfc_table query | Onnistuneen suorituksen kuittaus ja täydellinen evidenceRows |
| Sääntöjen, sopimusten tai raporttien haku | dfc_ontology_query tai knowledge search/detail | Täydellinen, valtuutettu, faktoina käytettävä alkuteksti |
| Graafiobjektien paikantaminen | dfc_ontology_graph search/neighbors | Paikanna todellinen lähde ja hae sitten vastaavat faktat |
| Natiivi avainsanavuorovaikutus | dfc_manual ja sen jälkeen dfc_search | Todelliset tulokset alkuperäisessä mallissa ja liiketoimintakehyksessä |
| Yhdistetty analyysi ja raportit | dfc_analysis_* tai dfc_report_* | Kunkin strukturoidun haaran ja dokumenttitodisteen todellinen tila |
| Esitysten tai ontologiamallin muokkaaminen | dfc_authoring_* ja artifact-työkalut | Ehdokas, 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.
Ontologian resurssit ja ID-tyypit
Hanki ensin todelliset resurssikoordinaatit, jotta tallennusnimet, dokumentti-ID:t ja tietämyskanta-ID:t eivät sekoitu.
- Kutsu dfc_ontologies ja selaa page- ja pageSize-parametreilla ontologiat, jotka tämä valtuutus kattaa ja jotka ovat edelleen luettavissa.
- Kutsu dfc_ontology_resources todellisella ontologyId:lla; valitse tarpeen mukaan tables, answers, pinboards, documents ja knowledgeBindings.
- Käsittele sivutus erikseen kullekin resurssityypille. pageSize on enintään 100; älä päättele koko resurssijoukkoa ensimmäisen sivun perusteella.
- Tallenna resurssin ilmoitettu tyyppi ja alkuperäinen ID ja käytä niitä myöhemmissä kutsuissa sellaisenaan.
{"name":"dfc_ontology_resources","arguments":{
"ontologyId":"<ONTOLOGY_ID>",
"resourceTypes":["tables","documents","knowledgeBindings"],
"page":1,"pageSize":100
}}| Koordinaatti | Lähde | Ei saa korvata tällä |
|---|---|---|
| ontologyId | Valtuutettujen ontologioiden luettelo tai nykyinen voimassa oleva konteksti | Toisen ontologian ID |
| Taulukkoresurssin id | tables-luettelo tai luotettava konteksti | physicalName tai taulukon näyttönimi |
| tblDisplayName colDisplayName | Nykyisen taulukon ja sarakkeiden metatiedot | Arvattu fyysinen SQL-tunniste |
| knowledgeId | knowledgeBindings tai todellinen tietämyshaun kuittaus | Dokumenttiresurssin id |
| assetId documentId chunkId evidenceId | Sama todellinen paikannuskuittaus | Eri paikannustuloksista yhdistetyt kentät |
| rid revisionId releaseId | Julkaistu malli tai palvelimen ehdokaskonteksti | Itse 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.
Doris-taulukkokyselyt ja rakennesopimukset
Suorita vain luku -SQL valtuutetuilla taulukoilla säilyttäen tulosten semantiikan, tarkat arvot ja täydellisyyden.
Rakenteen lukeminen
{"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
{
"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 kohde | Muoto | Huomio |
|---|---|---|
| DATE | CAST('2026-09-01' AS DATE) ja CURRENT_DATE | Tekstiliteraalin ei voi suoraan olettaa olevan päivämäärätyyppiä |
| DATETIME | CAST('2026-09-01 00:00:00' AS DATETIME) ja CURRENT_TIMESTAMP | Tarkista lähteen aikavyöhyke ja istunnon aikavyöhyke |
| Suhteellinen aika | DATE_SUB(CURRENT_DATE, INTERVAL 1 YEAR) | Käytä päivämäärille ja aikaleimoille niitä vastaavaa nykyhetken funktiota |
| Aikaryhmittely | YEAR(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.
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.
- Selvitä todellinen rakenne ja nykyinen laskentaperuste: määrittele 币种, kausi, 订单状态 ja tasatilanteiden säännöt.
- Lähetä palvelinpuolen aggregointi- ja sijoitus-SQL. Älä hae ensin pelkkää 区域-kokonaissummaa ja käytä sitä sitten 类别产品-sijoituksena.
- Tarkista tulostesarakkeiden sopimus ja todellinen evidenceRows; varmista, että palautus kattaa kaikki tarvittavat ryhmät.
- Jos katkaisu havaitaan, tee rajattuja osakyselyitä palvelimen tukemien rajojen mukaan, esimerkiksi hae täydellinen Top3 erikseen kullekin 区域-arvolle; pidä jokaisella kyselykerralla sama liiketoiminnallinen laskentaperuste.
- Jos lähdekausi muuttuu, tee uusi kysely ja merkitse selkeästi uusi versio; älä sekoita eri dataversioita tai vanhentuneita kursoreita.
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.
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
| Polku | Käyttötarkoitus | Keskeiset asiat |
|---|---|---|
| dfc_ontology_query | Haku ontologiaan sidotusta tietämyksestä, tarvittaessa yhdistettynä graafireititykseen | Tarkista täydellinen kanoninen answerContextItems ja todisteiden kelpoisuus |
| dfc_knowledge_search → dfc_knowledge_detail-osio (chunk) | Paikanna eksplisiittisellä haulla ja lue sitten valitut osiot | Haun esikatselua ei käytetä faktana; lue saman paikannuksen täydellinen alkuteksti |
{"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.
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.
Natiivit Search-mallit ja istunnot
Käytä Rust Searchin avainsanaprotokollaa dfc_search-työkalun kautta ja odota alkuperäisen liiketoimintakehyksen lopputilaa.
Lue ohjeet ennen ominaisuuksien löytämistä
{"name":"dfc_manual","arguments":{
"action":"read","uri":"datafocus://manuals/search-keyword-queries/v1"
}}
{"name":"dfc_search","arguments":{"action":"capabilities"}}dfc_search vaatii nimenomaisesti myönnetyn scopen search:operate. Se käärii alkuperäisen avainsana-WebSocketin eikä muunna avainsanoja SQL- tai LLM-pyynnöiksi. Istunto sidotaan nykyiseen vuokralaiseen, käyttäjään, Grantiin, asiakasohjelmaan ja malliin, ja alkuperäiset taulukko- ja sarakeoikeudet tarkistetaan uudelleen jokaisen toiminnon yhteydessä.
Istunnon vähimmäiskulku
{"name":"dfc_search","arguments":{
"action":"model_create","data":{"tableIds":["<ACTUAL_TABLE_ID>"]}
}}
{"name":"dfc_search","arguments":{
"action":"open","data":{"sourceToken":"<MODEL_SOURCE_TOKEN>","language":"en-US"}
}}
{"name":"dfc_search","arguments":{
"action":"poll","data":{"sessionId":"<SEARCH_SESSION_ID>","waitMillis":10000}
}}
{"name":"dfc_search","arguments":{
"action":"request","data":{"sessionId":"<SEARCH_SESSION_ID>",
"message":{"type":"assist","datas":{}}}
}}
{"name":"dfc_search","arguments":{
"action":"request","data":{"sessionId":"<SEARCH_SESSION_ID>",
"message":{"type":"search","datas":{"search":"<QUERY_USING_ACTUAL_COLUMNS>","ambiguities":[]}}}
}}- model_create käyttää 1–100 todellista taulukkotunnusta, joihin käyttäjällä on oikeus, tai model_read lukee käyttäjän oman, jo olemassa olevan sourceToken-arvon.
- open palauttaa vain initializationSent:n; tee ensin poll, lue alkuperäinen init-liiketoimintavastaus ja varmista onnistuminen.
- Lue assist- ja ehdotustiedot ja lähetä sitten tuettu alkuperäinen message. Kääre asettaa query-viestin datas-osion kentän isNl aina arvoon false.
- Lue kehyksiä (frames) jatkuvasti ja erottele ehdotukset, jäsentäminen, vastaanotto ja lopullinen liiketoimintatulos.
- Sulje lopuksi close-toiminnolla; tarvittaessa peruuta cancel-toiminnolla ja varmista lopetus todellisen tehtävän tilan perusteella.
| action | data | Merkitys |
|---|---|---|
| capabilities | Pois jätetty tai tyhjä objekti | Lue toiminnot, komennot, TTL ja siirtotiedot |
| model_create | tableIds-luettelo | Luo malli nykyisen käyttäjän käyttöoikeuksilla |
| model_read | sourceToken | Lue malli; sarakkeet, joihin ei ole oikeutta, ja arkaluonteiset lähdeasetukset suodatetaan pois |
| open | sourceToken ja valinnainen language | Luo natiivi istunto ja lähetä init |
| request | sessionId ja message | Lähetä alkuperäinen type/datas-protokollaviesti |
| poll | sessionId ja waitMillis välillä 0–30 000 | Nouda puskurissa olevat kehykset; valinnaisesti rajattu odotus |
| cancel close | sessionId | Sulje tämä natiivi istunto; tästä ei voi päätellä BI:n lopputilaa |
Tuetut alkuperäiset komennot
search associateSearch guide assist exportContext reInit
putFormula modifyFormula deleteFormula fnamecheck
disambiguite reDisambiguite clearDisambiguiteKomentojen kirjainkoko ja datas-rakenne noudattavat nykyistä capabilities-vastausta ja alkuperäistä istuntoprotokollaa. Olemattomia toimintoja ei saa lisätä request-toimintoon; esimerkiksi disambiguite-kirjoitusasu on säilytettävä protokollan mukaisena. Viesti saa olla enintään 256 Ki merkkiä.
Istunnot ja täydellisyys
Istunnon TTL on 10 minuuttia, ja istunto säilyy vain nykyisen prosessin elinkaaren ajan; kyseessä ei ole pysyvästi palautettava tehtävä. Puskuriin mahtuu enintään 256 kehystä ja muistiraja rajoittaa sitä; kun bufferOverflow=true, jo noudettuja kehyksiä ei saa pitää täydellisenä tuloksena. Siirtovirheen jälkeen tee ensin poll alkuperäiselle istunnolle äläkä lähetä sokeasti uudelleen mahdollisesti jo suoritettua kyselyä.
Nykyinen kääre ei tarjoa vastausten tai pinboardien tallennusta, historian lukemista ja kirjoittamista eikä mielivaltaisen kontekstin palautusta. exportContext:n olemassaolo ei tarkoita, että mitä tahansa kontekstia voi palauttaa itse. Jos tuloksia on tallennettava, käytä instanssissa todella avattuja alkuperäisiä resurssiominaisuuksia; action-arvoja ei saa keksiä.
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 alue | Kyselyn locale | Selitys |
|---|---|---|
| Yksinkertaistettu ja perinteinen kiina | zh-CN zh-Hant | Alkuperäiset kiinan säännöt ja perinteisen kiinan luettelo eroavat |
| Yhdysvaltain, Britannian, Australian ja Kanadan englanti | en-US en-GB en-AU en-CA | UI-/avainsanapaketit voivat olla yhteisiä, aluemetatiedot säilytetään |
| Saksa, italia ja venäjä | de-DE it-IT ru-RU | Käytetään nykyisen istunnon ehdotusten mukaan |
| Espanjan ja Latinalaisen Amerikan espanja | es-ES es-US | Tuotteen alue-ID on es-US. |
| Ranskan ja Kanadan ranska | fr-FR fr-CA | Alueiden tunnuksia ei yhdistetä |
| Portugalin ja Brasilian portugali | pt-PT pt-BR | Luettelo- ja aluekäytännöt säilytetään erikseen |
| Hollanti, tanska, norja, suomi ja ruotsi | nl-NL da-DK nb-NO fi-FI sv-SE | Norjasta käytetään bokmålia |
| Japani ja korea | ja-JP ko-KR | Sanoja ei jaeta itse englannin välilyöntisääntöjen mukaan |
| Saudi-Arabian ja Yhdistyneiden arabiemiirikuntien arabia | ar-SA ar-AE | Käyttöliittymän ohjetekstit tukevat RTL-suuntaa; protokollatunnisteiden kirjoitussuuntaa ei käännetä |
Avainsanaluettelon käyttäminen
{"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.
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ökalu | Käyttötarkoitus | Välttämättömät koordinaatit |
|---|---|---|
| dfc_analysis_ask | Esitä luonnollisen kielen analyysikysymys | ontologyId question; valinnaiset: language, sessionId |
| dfc_analysis_result_get | Lue aiemmin palautettu tulos | ontologyId sessionId resultId |
| dfc_analysis_refine | Esitä jatkokysymys tai muutos uusimman täyden tuloksen pohjalta | Alkuperäinen tulos, expectedRevision ja vakaa idempotenssiavain |
| dfc_analysis_page | Hae yksi sivu palvelinpuolen haarasta | Alkuperäinen haara ja tulosversio, pageNo pageSize |
| dfc_analysis_cancel | Peruuta tulos, jonka käsittely on yhä kesken | Alkuperäinen istunto ja tulos |
| dfc_analysis_close | Vapauta istunto, jossa ei ole käynnissä olevaa työtä | Alkuperäinen istunto |
Analyysin aloittaminen
{"name":"dfc_analysis_ask","arguments":{
"ontologyId":"<ONTOLOGY_ID>",
"question":"按区域分析已完成订单销售金额,并引用退货统计口径",
"language":"zh-CN"
}}- Lue palautettu sessionId, resultId, tila ja revisio; lue tarvittaessa alkuperäistä tulosta uudelleen.
- 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.
- Tarkista dokumenttitodisteet, faktakirjanpito, viittauskelpoisuus ja rajoitukset. Mallin tuottama kerronta ei voi itsenäisesti nostaa todisteiden kelpoisuutta.
- Jos tarvitset jatkokysymyksen, perusta se uusimpaan täydelliseen tulokseen ja välitä expectedRevision; käytä saman muutoksen uudelleenyrityksessä samaa idempotenssiavainta.
- 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.
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.
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.
{"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
- Käytä luonnissa vakaata idempotencyKey-arvoa, jonka pituus on 8–128 tuettua merkkiä.
- Tallenna reportId, kysele status-tilaa pollaamalla ja tarkista todellinen tila: valmis, epäonnistunut, osittain valmis tai peruutettu.
- Tarkista tuloksia luettaessa strukturoidut haarat, visualisoinnit, faktalähteet, dokumenttiviitteet ja täydellisyys.
- Peruuta keskeneräinen raportti alkuperäisellä reportId-arvolla; älä luo toista raporttia peruutuksen sijaan.
- 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.
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.
- dfc_authoring_capabilities lukee nykyisen Grantin käytettävissä olevat sopimukset ja toiminnot.
- dfc_artifact_context hakee rajatun kontekstin, contractVersion-, contextHash-, baseArtifactHash- ja baseArtifactVersion-tiedot.
- Asiakasohjelma luo ehdokkaan todellisen sopimuksen perusteella eikä suorita ehdokkaan sisältämää koodia.
- dfc_artifact_submit lähettää alkuperäisen kontekstin ja ehdokkaan, säilyttää instruction-kentän muuttumattomana ja käyttää vakaata clientRequestId-avainta.
- Lue proposalId, candidateHash, validoinnin tulos ja esikatselu; jos todellisia virheitä ilmenee, korjaa ehdokas äläkä väärennä palvelimen läpäisytilaa.
- Kun esikatselu on tehtävä uudelleen, käytä dfc_artifact_preview-työkalua ja samaa ehdokkaan tiivistettä.
- dfc_artifact_plan luo muuttumattoman suunnitelman todellisen ehdokkaan, kohdeversion ja idempotenssiavaimen avulla.
- 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ö
{"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.
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ä.
{"name":"dfc_ontology_table_schema","arguments":{
"ontologyId":"<ONTOLOGY_ID>","sourceAssetRef":"table:<ACTUAL_TABLE_ID>",
"fields":[{"sourceField":"区域"},{"sourceField":"销售金额"}]
}}Ehdokas- ja julkaisuasetukset
| Sopimus | Käyttötarkoitus | Keskeiset rajat |
|---|---|---|
| ontology-workspace-create-mcp-submit-v1 | Ehdokkaan luonti paikallisista deklaraatioista | Todelliset valtuutetut lähteet; palvelin kääntää, valmistumistodisteita ei hyväksytä |
| ontology-workspace-create-mcp-submit-v2 | Paikallisten ja tarkkojen julkaistujen viittausten yhdistelmä | Anna tarkka releaseSelections ja sulkeuman riippuvuudet |
| ontology-publication-mcp-submit-v1–v3 | Olemassa olevan ehdokkaan sitominen julkaisusuunnitelmapyyntöön | Eksplisiittiset koordinaatit; palvelin muodostaa kohteen, lähteen, hyväksynnän ja validoinnin uudelleen |
| ontology-publication-mcp-submit-v4–v6 | Erikseen käyttöön otettavat automaattisen julkaisun määritykset | Käytetään vain, kun capabilities ja todellinen schema ilmoittavat ne |
| ontology-initial-activation-retirement-submit-v1 | Hallitut alkuaktivoinnin ja käytöstä poiston toiminnot | Erillinen suunnitelma, uusi manuaalinen hyväksyntä ja tarkka laajuus |
Julkaisujärjestys
- Hae nykyisen ehdokkaan workspaceId, workspaceRevision, candidateHash ja todellinen lähde.
- 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”.
- Säilytä submit-toiminnon palauttama proposalId ja alkuperäinen idempotencyKey. Submit ja MODEL_PLAN ovat saman pyynnön eri vaiheita.
- Kutsu dfc_artifact_plan-työkalua alkuperäisellä ehdokkaalla, kohdeversiolla ja samalla idempotenssiavaimella.
- 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.
- Kun suunnitelma on onnistunut, jatka HUMAN_REQUIRED- tai POLICY_AUTO-arvon mukaan käyttäen alkuperäisiä hyväksyntä- ja julkaisuominaisuuksia.
- 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ä.
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
- Kun työkalun action-luettelossa on todellisuudessa published_model, lähetä todellinen, committed-tilassa oleva releaseId.
- v1 palauttaa valtuutetut kyselypohjat; v2 lisää tarkat PERSISTED-viittaukset ja releaseSelections-tiedon; v3 lisää riippuvuusviittaukset, tarkat domainRef-tiedot ja tiiviit sidontapohjat.
- Valitse objektit, attribuutit, Binding, scope ja versiot todellisista palautusarvoista; älä generoi RID-tunnisteita äläkä käytä latest-arvoa.
- 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.
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.
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.
{"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
- Säilytä alkuperäinen runId, Grant, mode ja idempotenssiavain.
- 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.
- status kysyy alkuperäisen tehtävän tilan. Valmistumisen jälkeen on edelleen tarkistettava sen taulukkokyselyt, todisteet tai julkaisukuittaus.
- 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.
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.
| Scope | Työkalu | Rajaus |
|---|---|---|
| business-system:discover | dfb_systems dfb_system_describe | Löytää vain tämän valtuutuksen kattamat ja tällä hetkellä kutsuttavissa olevat järjestelmät |
| business-system:read | dfb_query dfb_record dfb_work_items dfb_action_status | Nykyisen käyttäjän luettavissa olevat tietueet ja omat suunnitelmat |
| business-system:plan | dfb_action_plan | Luo vain muuttumattoman suunnitelman; ei suoritusta |
| business-system:execute | dfb_action_execute | Erillinen eksplisiittinen valtuutus; suoritus riskin ja hyväksynnän mukaan |
- dfb_systems löytää valtuutetut järjestelmät.
- dfb_system_describe lukee nykyisen julkaisusopimuksen, releaseId-arvon sekä kaikki tiivisteet, kyselyt ja komennot.
- dfb_query käyttää julkaistua queryKey-arvoa ja määrittää tarvittaessa objectKey-, state-, page- ja pageSize-parametrit. Se ei ole mielivaltainen SQL.
- dfb_record ja dfb_work_items lukevat tällä hetkellä sallitut tietueet ja avoimet tehtävät.
- Anna ennen suoritusta dfb_action_plan-työkalulle todelliset releaseId, releaseHash, canonicalIrHash, agentManifestHash, commandType, planIdempotencyKey ja sopimuksen payload.
- Tarkista riskClass, requiresApproval ja status; jos toiminto koskee kohdetietuetta, säilytä expectedRecordVersion.
- dfb_action_execute suorittaa vain nykyisen yhteyden omistamia ja valmiita suunnitelmia; manuaalisen hyväksynnän edellyttämät hyväksyntätokenit myöntää DataFocus.
- Selvitä epäonnistumisen tai aikakatkaisun jälkeen alkuperäisen suunnitelman tila dfb_action_status-työkalulla; uudelleenyrityksessä on säilytettävä alkuperäinen idempotenssisemantiikka.
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.
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ökalu | Käyttötarkoitus | Oikeudet tai vaikutukset, joita ei synny |
|---|---|---|
| dfc_ontology_knowledge_input_propose | Olemassa olevan työtilan liiketoimintasyötteen rekisteröinti | Ei luo vahvistuskysymyksiä, ei hyväksy, ei julkaise |
| dfc_ontology_knowledge_input_preview | Kysymysluonnosten väliaikainen esikatselu alkuperäisestä syötteestä | Ei tallenna, ei vahvista, ei muodosta tuotantokuittausta |
| dfc_ontology_knowledge_question_submit | Tallentaa authored-tilassa olevat, vahvistamattomat kysymykset | Ei yhdistä vastauksia automaattisesti, ei anna vastuu- tai julkaisuoikeuksia |
| dfc_ontology_business_scope_initialize | Alustaa eksplisiittisesti yhden liiketoimintajärjestelmän kuluttajalaajuuden | Ei julkaise, ei aktivoi, ei myönnä lähdeoikeuksia |
Syöte ja esikatselu
- Hae workspaceId, workspaceRevision, localRef ja preparationDigest todellisesta valmistelutyöstä.
- propose rekisteröi liiketoimintasyötteen alkuperäisellä input-sopimuksella ja vakaalla idempotencyKey-avaimella; sama avain voi vastata vain samaa syötettä.
- 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.
- 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.
Vastaukset, virheet ja turvallinen uudelleenyritys
Selitä virheet kerroksittain ja säilytä tehtävien koordinaatit ja idempotenssisemantiikka.
| Taso | Tarkistettava sisältö | Käsittelyperiaate |
|---|---|---|
| Verkko ja HTTP | Yhteys, TLS, 401, 403, 400, 404, 405 jne. | Älä käsittele epäonnistunutta vastausta tavallisena kyselytuloksena |
| JSON-RPC | error.code message data | Erota toisistaan protokolla-, metodi-, parametri- ja valtuutusongelmat |
| MCP-työkalu | result.isError ja structuredContent | HTTP 200 voi silti epäonnistua |
| Liiketoiminnan tulos | Todellinen tila, täydellisyys, epäonnistumisen syy, nextAction | Vastaanotto tai valmius ei ole sama kuin valmistuminen |
| Faktakelpoisuus | executionReceipt citationEligible contentComplete | Sisä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).
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.
Integraation turvallisuus ja ominaisuuksien rajat
Säilytä identiteetin, resurssien, suorituksen ja todisteiden alkuperäiset rajat ja käsittele epäluotettavia asiakirjoja turvallisesti.
- Muodosta yhteys vain ylläpitäjän antamiin virallisiin verkkotunnuksiin; tarkista TLS ja OAuth issuer äläkä poista varmenteen tarkistusta käytöstä.
- 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.
- 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.
- Rajoita automaattisia uudelleenyrityksiä, rinnakkaisuutta ja tulosten laajuutta; älä rakenna alkuperäisiä liiketoimintaoikeuksia uudelleen asiakaspuolella.
- Lokeihin kirjataan vain tarpeelliset korrelaatiotiedot, ei Bearer-tunnuksia, refresh tokeneita, hyväksyntätokeneita eikä arkaluonteista liiketoimintasisältöä kokonaisuudessaan.
- 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.
Ylläpitäjän kytkennät ja ehdolliset kytkimet
Tarkista ennen laajennusominaisuuksien kytkemistä päälle todelliset komponentit, julkiset osoitteet ja alkuperäiset oikeusasetukset.
| Konfiguraatio | Käyttötarkoitus | Edellytykset |
|---|---|---|
| datafocus.mcp.public-base-url | Virallinen ulkoinen juuriosoite | OAuth-löytäminen, issuer, takaisinkutsu ja käänteinen välityspalvelin ovat yhdenmukaisia |
| datafocus.mcp.allowed-origins | Erikseen hyväksytyt selaimen lähteet (origin) | Määritä täsmällisesti; älä laajenna koskemaan mitä tahansa lähdettä |
| datafocus.mcp.oauth.route-proof-secret | Graafireitityksen todisteille varattu palvelimen salaisuus | Tallennetaan erikseen, ei käytetä Beareria avaimena |
| datafocus.mcp.analysis.tools.enabled | Vuorovaikutteiset analyysityökalut | Tarvittavat data-, tietämys- ja oikeuspalvelut ovat todella käytettävissä |
| datafocus.mcp.analysis.report-tools.enabled | Pysyvät raportointityökalut | Tarvittava tallennus, worker ja palautumisketju ovat käytettävissä |
| datafocus.mcp.analysis.apps.enabled | MCP Apps -esitys | Asiakasohjelma ilmoittaa tuesta ja tarkistaa palautetut _meta-tiedot |
| datafocus.mcp.authoring.enabled | Luonnosten ja mallinnuksen sopimukset | Alkuperäiset ylläpitäjän ja resurssien oikeudet säilyvät |
| datafocus.mcp.authoring.apply-enabled | Artefaktien käyttöönotto | Muuttumattomat suunnitelmat, alkuperäiset hyväksynnät ja nykyisen tilan uudelleentarkistus |
| datafocus.mcp.ontology-published-query-enabled | Julkaistut mallit ja kyselyt | Todelliset vahvistetut (committed) versiot ja lähdevaltuutus |
| datafocus.mcp.ontology-candidate-query-enabled | Ehdokkaiden strukturoidut kyselyt | Ehdokkaan omistajuus, täsmällinen versio ja lukuoikeus |
| datafocus.mcp.authoring.ontology-auto-publication-enabled | Automaattisen julkaisun delegointiin liittyvät valtuutukset | Voimassa 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.
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.
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_TOKENLukeminen ja kyselyt
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.jsonKorvaa 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.
Ontologiakeskustelukäyttöliittymän upottaminen
Upota ihmiskäyttäjille tarkoitettu keskustelusivu liiketoimintasovelluksen käyttöliittymään säilyttäen kirjautumisen ja selaimen turvallisuusrajat.
<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
| Tapa | Käyttäjä | Identiteetti ja tulos |
|---|---|---|
| Remote MCP | Ulkoinen Agent- tai palveluintegraatio | OAuth-Grant ja strukturoidut työkalukuittaukset |
| Ontologiakeskustelun iframe | Loppukäyttäjä (ihminen) | Alkuperäinen kirjautumistila ja keskustelukäyttöliittymä |
| MCP Apps | Laajennuksia tukeva MCP-asiakasohjelma | Hallitut resurssit ja nykyiset työkalutulokset, ei julkinen iframe-kirjautumisen korvike |
Integraation hyväksymislista
Osoita täydellinen liiketoimintaketju todellisessa instanssissa sen sijaan, että vain vahvistaisit rajapinnan palauttavan 200.
- Löytäminen: hanki todelliset tuetut versiot, nykyinen työkaluluettelo ja sisäänrakennetut resurssit.
- 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.
- Taulukkorakenne: todelliset näyttönimet, sarakkeet, tyypit ja käyttöoikeudet ovat täydelliset.
- SQL: yksi- ja moniulotteiset kyselyt, JOIN, päivämäärät, TopN ja katkaisutarkistukset vastaavat todellista liiketoiminnallista laskentaperustetta.
- Tietämys: paikannuksen, täydellisen alkutekstin ja faktaviittauskelpoisuuden on oltava yhdenmukaisia; yhdistetyissä kysymyksissä on sekä data- että dokumenttiperuste.
- Search: mallin, initin, ehdotusten, tulosten, sulkemisen ja puskurin täydellisyyden tarkistukset menevät läpi.
- Valinnainen analyysi ja raportit: useiden haarojen todelliset tilat, sivutus, käyttöoikeusmuutokset ja peruutus toimivat alkuperäisellä tavalla.
- Valinnainen mallinnus: ehdokas, suunnitelma, alkuperäinen hyväksyntä, todellinen käyttöönotto ja versiokysely tarkistetaan vaihe vaiheelta.
- Liiketoimintatoiminnot: julkaisun tiiviste, kohdeversio, hyväksyntä, idempotenssi ja Grantien välinen eristys tarkistetaan.
- 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.
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.
| Resurssit | Sisältö |
|---|---|
| reference/mcp-tool-catalog.json | 32 ontologiapuolen ja 8 liiketoimintapuolen ilmoitettua syöte-Schemaa; osalla työkaluista myös alkuperäinen tuloste-Schema |
| reference/locales.json | 21 valittavaa ja 24 yhteensopivaa localea sekä UI-termit |
| reference/search-keywords.json | Staattinen avainsanaluettelo 17 nimenomaisesti määritellylle localelle |
| reference/analysis-contract-manifest.json | Analyysiin, 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
datafocus://manuals/etl-formulas/v1
datafocus://manuals/search-keyword-queries/v1
datafocus://manuals/etl-functions/v1
datafocus://manuals/search-keywords/v1resources/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.
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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| names | array | Valinnainen tai ehdollisesti pakollinen | Etsittävät nimenomaiset nimet, enintään 32 kerralla. maxItems: 32 |
| action | string | Valinnainen tai ehdollisesti pakollinen | Toimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: list, read, keywords, functions, etl_requests |
| locale | string | Valinnainen tai ehdollisesti pakollinen | Nimenomainen staattisen viiteluettelon locale, ei kyselyn oletuskieli. |
| uri | string | Valinnainen tai ehdollisesti pakollinen | Nykyisen 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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| data | object | Valinnainen tai ehdollisesti pakollinen | Alkuperäisen toimenpiteen hyötykuorma; katso ominaisuuksien löytäminen ja toimenpidekenttien taulukot. |
| action | string | Pakollinen | Toimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: capabilities, model_create, model_read, open, request, poll, cancel, close |
dfc_etl
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| data | object | Valinnainen tai ehdollisesti pakollinen | Alkuperäisen toimenpiteen hyötykuorma; katso ominaisuuksien löytäminen ja toimenpidekenttien taulukot. |
| action | string | Pakollinen | Toimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: capabilities |
dfc_ontologies
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| pageSize | integer | Valinnainen tai ehdollisesti pakollinen | Rivimäärä sivua kohden; noudata Scheman ylärajaa. minimum: 1; maximum: 100 |
| page | integer | Valinnainen tai ehdollisesti pakollinen | Sivunumero, alkaen 1:stä. minimum: 1 |
dfc_ontology_resources
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| resourceTypes | array | Valinnainen tai ehdollisesti pakollinen | Palautettavien resurssityyppien joukko. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| pageSize | integer | Valinnainen tai ehdollisesti pakollinen | Rivimäärä sivua kohden; noudata Scheman ylärajaa. minimum: 1; maximum: 100 |
| page | integer | Valinnainen tai ehdollisesti pakollinen | Sivunumero, alkaen 1:stä. minimum: 1 |
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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| relationTypes | array | Valinnainen tai ehdollisesti pakollinen | Relaatiotyypin suodatin. |
| depth | integer | Valinnainen tai ehdollisesti pakollinen | Naapurisolmujen läpikäynnin syvyys. minimum: 1; maximum: 3 |
| sourceTypes | array | Valinnainen tai ehdollisesti pakollinen | Lähdetyypin suodatin. |
| query | object | Valinnainen tai ehdollisesti pakollinen | Kyselyteksti tai action-parametria vastaava tarkka versioitu kyselyobjekti. |
| limit | integer | Valinnainen tai ehdollisesti pakollinen | Palautettavien tulosten enimmäismäärä. minimum: 1; maximum: 100 |
| action | string | Pakollinen | Toimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: search, neighbors, published_model, published_query, candidate_query |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| nodeKey | string | Valinnainen tai ehdollisesti pakollinen | Solmun avain, kopioitu todellisista graafituloksista. |
| keyword | string | Valinnainen tai ehdollisesti pakollinen | Graafin paikannusavainsanat, eivät avainsanakyselyjen syntaksi. |
| nodeTypes | array | Valinnainen tai ehdollisesti pakollinen | Solmutyypin suodatin. |
dfc_ontology_query
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| routeLocators | array | Valinnainen tai ehdollisesti pakollinen | Palvelimen myöntämä täydellinen, tyypitetty reitityspaikannus, kopioitava sellaisenaan. maxItems: 20 |
| topK | integer | Valinnainen tai ehdollisesti pakollinen | Haettavien ehdokkaiden enimmäismäärä; ei todista, että kattavuus on täydellinen. minimum: 1; maximum: 20 |
| queryMode | string | Valinnainen tai ehdollisesti pakollinen | Todisteiden kyselytila työkalun enum-arvojen mukaan. enum: vector, hybrid, graph |
| fanoutPlan | object | Valinnainen tai ehdollisesti pakollinen | Rajoitettu haarahakusuunnitelma, sisäkkäisen Scheman mukainen. |
| structuredPlan | object | Valinnainen tai ehdollisesti pakollinen | Palvelinsopimukseen sidottu suunnitelma täydelliselle dokumenttitaulukolle; ei SQL:ää. |
| knowledgeIds | array | Valinnainen tai ehdollisesti pakollinen | Tietämyskannan tunnus todellisesta knowledgeBindings-luettelosta. |
| query | string | Pakollinen | Kyselyteksti tai action-parametria vastaava tarkka versioitu kyselyobjekti. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
dfc_knowledge_search
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| topK | integer | Valinnainen tai ehdollisesti pakollinen | Haettavien ehdokkaiden enimmäismäärä; ei todista, että kattavuus on täydellinen. minimum: 1; maximum: 20 |
| minScore | number | Valinnainen tai ehdollisesti pakollinen | Vähimmäisvastaavuuspistemäärä. minimum: 0; maximum: 1 |
| knowledgeIds | array | Valinnainen tai ehdollisesti pakollinen | Tietämyskannan tunnus todellisesta knowledgeBindings-luettelosta. |
| query | string | Pakollinen | Kyselyteksti tai action-parametria vastaava tarkka versioitu kyselyobjekti. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| assetIds | array | Valinnainen tai ehdollisesti pakollinen | Tällä hetkellä sallittujen dokumenttiresurssien (asset) tunnukset. |
| retrievalStrategy | string | Valinnainen tai ehdollisesti pakollinen | Todellisuudessa tuettu hakustrategia. enum: auto, hybrid_stage2 |
dfc_knowledge_detail
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| qdrantId | string / integer | Valinnainen tai ehdollisesti pakollinen | Todellisesta paikannuksesta palautettu indeksitunniste. |
| pageNo | integer | Valinnainen tai ehdollisesti pakollinen | Todellinen sivu- tai sivutusnumero. |
| evidenceId | string | Valinnainen tai ehdollisesti pakollinen | Saman tietämyspaikannuksen palauttama todisteen tunnus. |
| action | string | Pakollinen | Toimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: chunk, document, page_context |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| documentId | string / integer | Valinnainen tai ehdollisesti pakollinen | Saman paikannuksen asiakirjatunnus. |
| radius | integer | Valinnainen tai ehdollisesti pakollinen | Viereisten sivujen alue. minimum: 0; maximum: 3 |
| chunkId | string | Valinnainen tai ehdollisesti pakollinen | Saman paikannuksen todellinen osion (chunk) tunnus. |
dfc_table
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| maxRows | integer | Valinnainen tai ehdollisesti pakollinen | Palautettavien rivien enimmäismäärä; ei asiakaspuolen sijoitusalue. minimum: 1; maximum: 200 |
| action | string | Pakollinen | Toimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: detail, query |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| id | string | Valinnainen tai ehdollisesti pakollinen | Todellinen taulukkoresurssin tunnus, ei fyysinen nimi eikä näyttönimi. |
| sql | string | Valinnainen tai ehdollisesti pakollinen | Yksi ontologian rajauksen sisäinen, vain lukeva Doris-SQL-lause eksplisiittisin tulostesarakkein. |
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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| question | string | Pakollinen | Luonnollisen kielen kysymys tai yhteensopiva jatkokysymys. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| language | string | Valinnainen tai ehdollisesti pakollinen | Nimenomainen vastaus- tai kyselylocale; jos jätetään pois, noudatetaan kyseisen työkalun sääntöjä. |
| sessionId | string | Valinnainen tai ehdollisesti pakollinen | Todellinen istuntoviite saman Grantin piirissä. |
dfc_analysis_refine
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| branchId | string | Valinnainen tai ehdollisesti pakollinen | Palvelimen myöntämä strukturoidun haaran viite. |
| resultId | string | Pakollinen | Alun perin palautetun analyysituloksen viite. |
| question | string | Valinnainen tai ehdollisesti pakollinen | Luonnollisen kielen kysymys tai yhteensopiva jatkokysymys. |
| idempotencyKey | string | Pakollinen | Idempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. |
| change | object | Valinnainen tai ehdollisesti pakollinen | Luonnollisen kielen muutos tai tyypitetty filter_patch. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| language | string | Valinnainen tai ehdollisesti pakollinen | Nimenomainen vastaus- tai kyselylocale; jos jätetään pois, noudatetaan kyseisen työkalun sääntöjä. |
| sessionId | string | Pakollinen | Todellinen istuntoviite saman Grantin piirissä. |
| expectedRevision | integer | Pakollinen | Alkuperäisen tuloksen tai liiketoimintaotsikon versioedellytys; voi olla null kysymystä luotaessa. minimum: 1 |
| visualId | string | Valinnainen tai ehdollisesti pakollinen | Haaraan sidottu visualisoinnin viite. |
dfc_analysis_page
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| branchId | string | Pakollinen | Palvelimen myöntämä strukturoidun haaran viite. |
| resultId | string | Pakollinen | Alun perin palautetun analyysituloksen viite. |
| pageNo | integer | Pakollinen | Todellinen sivu- tai sivutusnumero. minimum: 1; maximum: 10000 |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| pageSize | integer | Pakollinen | Rivimäärä sivua kohden; noudata Scheman ylärajaa. minimum: 1; maximum: 100 |
| sessionId | string | Pakollinen | Todellinen istuntoviite saman Grantin piirissä. |
| expectedRevision | integer | Pakollinen | Alkuperäisen tuloksen tai liiketoimintaotsikon versioedellytys; voi olla null kysymystä luotaessa. minimum: 1 |
dfc_analysis_result_get
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| resultId | string | Pakollinen | Alun perin palautetun analyysituloksen viite. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| sessionId | string | Pakollinen | Todellinen istuntoviite saman Grantin piirissä. |
dfc_analysis_cancel
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| resultId | string | Pakollinen | Alun perin palautetun analyysituloksen viite. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| sessionId | string | Pakollinen | Todellinen istuntoviite saman Grantin piirissä. |
dfc_analysis_close
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| sessionId | string | Pakollinen | Todellinen istuntoviite saman Grantin piirissä. |
dfc_report_create
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| goal | string | Pakollinen | Raportin analyysikohde. |
| idempotencyKey | string | Pakollinen | Idempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| language | string | Valinnainen tai ehdollisesti pakollinen | Nimenomainen vastaus- tai kyselylocale; jos jätetään pois, noudatetaan kyseisen työkalun sääntöjä. |
| title | string | Valinnainen tai ehdollisesti pakollinen | Valinnainen raportin otsikko. |
dfc_report_status
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| reportId | string | Pakollinen | Nykyisen Grantin pysyvä raporttiviite. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
dfc_report_cancel
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| reportId | string | Pakollinen | Nykyisen Grantin pysyvä raporttiviite. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| mode | string | Valinnainen tai ehdollisesti pakollinen | QUERY tai AUTHORING, ominaisuudet valtuutetaan erikseen. enum: QUERY, AUTHORING |
| instruction | string | Valinnainen tai ehdollisesti pakollinen | Käyttäjän vaatimusteksti; kontekstin ja lähetyksen on oltava yhdenmukaiset. maxLength: 16000 |
| idempotencyKey | string | Valinnainen tai ehdollisesti pakollinen | Idempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. maxLength: 128 |
| action | string | Pakollinen | Toimenpiteen nimi. Käytä nykyisen enum-luettelon ja toimenpiteen mukaisia parametreja. enum: start, status, cancel |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| runId | string | Valinnainen tai ehdollisesti pakollinen | Saman ontologian ja Grantin alkuperäisen tehtävän tunnus. |
| contractVersion | string | Pakollinen | On 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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| artifactType | string | Pakollinen | Todellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: CONTROL_PANEL_SPEC, VIEW_SPEC |
| scopeType | string | Valinnainen tai ehdollisesti pakollinen | Resurssirajauksen tyyppi todellisessa artefaktisopimuksessa. |
| ontologyId | string | Valinnainen tai ehdollisesti pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| projectId | string | Valinnainen tai ehdollisesti pakollinen | Nykyisen valtuutetun projektin ID. |
| artifactId | string | Valinnainen tai ehdollisesti pakollinen | Muokattavan olemassa olevan artefaktin todellinen ID. |
| instruction | string | Pakollinen | Käyttäjän vaatimusteksti; kontekstin ja lähetyksen on oltava yhdenmukaiset. |
| variables | object | Valinnainen tai ehdollisesti pakollinen | Palautetun sopimuksen mukainen muuttujaobjekti. |
| previewInput | object | Valinnainen tai ehdollisesti pakollinen | Sopimuksen mukainen rajattu esikatselusyöte. |
| viewport | object | Valinnainen tai ehdollisesti pakollinen | Alkuperäisen sopimuksen edellyttämä näkymäalue (viewport). |
dfc_ontology_table_schema
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| sourceAssetRef | string | Pakollinen | Rekisteröity strukturoitu resurssiviittaus, esim. table:123. |
| fields | array | Pakollinen | Nykyisen lähteen kentät ja valinnainen eksplisiittinen tyyppimäärittely. minItems: 1; maxItems: 64 |
dfc_artifact_preview
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| proposalId | string | Pakollinen | Nykyisen Grantin luoman alkuperäisen ehdokkaan ID. |
| candidateHash | string | Pakollinen | Palvelimen alkuperäisen ehdokkaan tarkka tiiviste. |
| previewInput | object | Pakollinen | Sopimuksen mukainen rajattu esikatselusyöte. |
dfc_artifact_status
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| proposalId | string | Valinnainen tai ehdollisesti pakollinen | Nykyisen Grantin luoman alkuperäisen ehdokkaan ID. |
| planId | string | Valinnainen tai ehdollisesti pakollinen | Muuttumattoman käyttöönottosuunnitelman ID. |
dfc_artifact_plan
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| proposalId | string | Pakollinen | Nykyisen Grantin luoman alkuperäisen ehdokkaan ID. |
| candidateHash | string | Pakollinen | Palvelimen alkuperäisen ehdokkaan tarkka tiiviste. |
| expectedTargetVersion | integer | Pakollinen | Nykyisen todellisen kohdeversion edellytys. minimum: 0 |
| idempotencyKey | string | Pakollinen | Idempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. |
dfc_artifact_apply
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| planId | string | Pakollinen | Muuttumattoman käyttöönottosuunnitelman ID. |
| planHash | string | Pakollinen | Alkuperäisen suunnitelman palauttama tiiviste. |
| approvalToken | string | Pakollinen | Alkuperäisen palvelimen myöntämä hyväksyntämateriaali; ei saa luoda itse. |
| idempotencyKey | string | Pakollinen | Idempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. |
dfc_artifact_submit
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| Konfiguraatio 1 / artifactType | string | Pakollinen | Todellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: CONTROL_PANEL_SPEC, VIEW_SPEC |
| Konfiguraatio 1 / scopeType | string | Valinnainen tai ehdollisesti pakollinen | Resurssirajauksen tyyppi todellisessa artefaktisopimuksessa. |
| Konfiguraatio 1 / ontologyId | string | Valinnainen tai ehdollisesti pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| Konfiguraatio 1 / projectId | string | Valinnainen tai ehdollisesti pakollinen | Nykyisen valtuutetun projektin ID. |
| Konfiguraatio 1 / artifactId | string | Valinnainen tai ehdollisesti pakollinen | Muokattavan olemassa olevan artefaktin todellinen ID. |
| Konfiguraatio 1 / instruction | string | Pakollinen | Käyttäjän vaatimusteksti; kontekstin ja lähetyksen on oltava yhdenmukaiset. |
| Konfiguraatio 1 / variables | object | Valinnainen tai ehdollisesti pakollinen | Palautetun sopimuksen mukainen muuttujaobjekti. |
| Konfiguraatio 1 / previewInput | object | Valinnainen tai ehdollisesti pakollinen | Sopimuksen mukainen rajattu esikatselusyöte. |
| Konfiguraatio 1 / viewport | object | Valinnainen tai ehdollisesti pakollinen | Alkuperäisen sopimuksen edellyttämä näkymäalue (viewport). |
| Konfiguraatio 1 / contractVersion | string | Pakollinen | On käytettävä täsmällistä, todellisuudessa tuettua sopimusversiota. |
| Konfiguraatio 1 / contextHash | string | Pakollinen | context-kutsun palauttama täysi kontekstitiiviste. |
| Konfiguraatio 1 / baseArtifactHash | string | Pakollinen | context-kutsun palauttama perusartefaktin tiiviste. |
| Konfiguraatio 1 / baseArtifactVersion | integer | Pakollinen | context-kutsun palauttama perusversio. minimum: 0 |
| Konfiguraatio 1 / candidate | object | Pakollinen | Nykyisen palautetun sopimuksen mukainen ehdokasobjekti. |
| Konfiguraatio 1 / clientRequestId | string | Pakollinen | Nykyisen ehdokaspyynnön vakaasti käyttämä asiakasohjelman idempotenssiavain. |
| Konfiguraatio 2 / artifactType | string | Pakollinen | Todellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: ONTOLOGY_RELEASE |
| Konfiguraatio 2 / contractVersion | string | Pakollinen | On 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 / ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| Konfiguraatio 2 / candidateHash | string | Pakollinen | Palvelimen alkuperäisen ehdokkaan tarkka tiiviste. |
| Konfiguraatio 2 / workspaceId | string | Pakollinen | Todelliset ehdokkaan työtilakoordinaatit. |
| Konfiguraatio 2 / workspaceRevision | string | Pakollinen | Tarkka ehdokasversio; ei latest-arvoa. |
| Konfiguraatio 2 / releases | object | Pakollinen | Ontologian julkaisusopimuksen mukainen tarkka versiovalinta. |
| Konfiguraatio 2 / selection | object | Pakollinen | Vain eksplisiittiset liiketoiminnan valintakoordinaatit; ei oikeuksia eikä valmistumistodistetta. |
| Konfiguraatio 2 / idempotencyKey | string | Pakollinen | Idempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. |
| Konfiguraatio 3 / Konfiguraatio 1 / artifactType | string | Pakollinen | Todellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: ONTOLOGY_RELEASE |
| Konfiguraatio 3 / Konfiguraatio 1 / contractVersion | string | Pakollinen | On käytettävä täsmällistä, todellisuudessa tuettua sopimusversiota. enum: ontology-workspace-create-mcp-submit-v1 |
| Konfiguraatio 3 / Konfiguraatio 1 / ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| Konfiguraatio 3 / Konfiguraatio 1 / workspaceId | string | Pakollinen | Todelliset ehdokkaan työtilakoordinaatit. |
| Konfiguraatio 3 / Konfiguraatio 1 / resources | array | Pakollinen | Palvelimen kääntämä alkuperäinen mallideklaraatio. minItems: 1 |
| Konfiguraatio 3 / Konfiguraatio 1 / idempotencyKey | string | Pakollinen | Idempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. |
| Konfiguraatio 3 / Konfiguraatio 2 / artifactType | string | Pakollinen | Todellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: ONTOLOGY_RELEASE |
| Konfiguraatio 3 / Konfiguraatio 2 / contractVersion | string | Pakollinen | On käytettävä täsmällistä, todellisuudessa tuettua sopimusversiota. enum: ontology-workspace-create-mcp-submit-v2 |
| Konfiguraatio 3 / Konfiguraatio 2 / ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| Konfiguraatio 3 / Konfiguraatio 2 / workspaceId | string | Pakollinen | Todelliset ehdokkaan työtilakoordinaatit. |
| Konfiguraatio 3 / Konfiguraatio 2 / resources | array | Pakollinen | Palvelimen kääntämä alkuperäinen mallideklaraatio. minItems: 1 |
| Konfiguraatio 3 / Konfiguraatio 2 / idempotencyKey | string | Pakollinen | Idempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. |
| Konfiguraatio 3 / Konfiguraatio 2 / releaseSelections | object | Pakollinen | Jokaisen julkaistun viittauksen tarkka releaseId ja riippuvuuksien sulkeuma. |
| Konfiguraatio 4 / artifactType | string | Pakollinen | Todellisuudessa käyttöön kytketty artefakti- tai ontologiajulkaisutyyppi. enum: ONTOLOGY_RELEASE |
| Konfiguraatio 4 / contractVersion | string | Pakollinen | On käytettävä täsmällistä, todellisuudessa tuettua sopimusversiota. enum: ontology-initial-activation-retirement-submit-v1 |
| Konfiguraatio 4 / ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| Konfiguraatio 4 / domainRid | string | Pakollinen | Todellinen liiketoiminta-alueen RID. |
| Konfiguraatio 4 / consumerScopes | array | Pakollinen | Palvelimen sallimat tarkat kuluttajalaajuudet. minItems: 1; maxItems: 256 |
| Konfiguraatio 4 / idempotencyKey | string | Pakollinen | Idempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. |
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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| request | object | Pakollinen | Alkuperäinen liiketoiminnan syötepyyntö; täydellisen sisäkkäisen Scheman mukaisesti. |
| idempotencyKey | string | Pakollinen | Saman 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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| idempotencyKey | string | Pakollinen | Saman loogisen operaation vakaa, uudelleenkäytettävä idempotenssiavain. minLength: 1; maxLength: 128 |
| ontologyId | string | Pakollinen | Todellinen 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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| questionRevision | $ref | Pakollinen | Tämän vahvistusta odottavan kysymyksen eksplisiittinen versio. |
| idempotencyKey | $ref | Pakollinen | Idempotenssiavain, jota sama looginen toiminto käyttää vakaasti uudelleen. |
| originalInputKey | $ref | Pakollinen | Alkuperäistä tietämyssyötettä vastaava idempotenssiavain. |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. |
| validUntil | $ref | Pakollinen | Kysymyksen voimassaoloikkunan loppuhetki UTC-aikana. |
| expectedRevision | oneOf | Pakollinen | Alkuperäisen tuloksen tai liiketoimintaotsikon versioedellytys; voi olla null kysymystä luotaessa. |
| validFrom | $ref | Pakollinen | Kysymyksen 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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| domainRevisionId | string | Pakollinen | Tarkka liiketoiminta-alueen versio. minLength: 1; maxLength: 128 |
| idempotencyKey | string | Pakollinen | Saman loogisen operaation vakaa, uudelleenkäytettävä idempotenssiavain. minLength: 1; maxLength: 128 |
| businessSystemId | string | Pakollinen | Todellinen liiketoimintajärjestelmän ID. minLength: 1 |
| ontologyId | string | Pakollinen | Todellinen ontologian tunnus tämän valtuutuksen piirissä; säilytä merkkijonona. minLength: 1 |
| domainRid | string | Pakollinen | Todellinen 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.
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
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| systemId | string / integer | Pakollinen | Tämän liiketoiminta-Grantin sallimat järjestelmä-ID:t. |
dfb_query
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| systemId | string / integer | Pakollinen | Tämän liiketoiminta-Grantin sallimat järjestelmä-ID:t. |
| queryKey | string | Pakollinen | describe-kutsun palauttama julkaistu kyselyavain. |
| objectKey | string | Valinnainen tai ehdollisesti pakollinen | Julkaistun objektin avain. |
| pageSize | integer | Valinnainen tai ehdollisesti pakollinen | Rivimäärä sivua kohden; noudata Scheman ylärajaa. minimum: 1; maximum: 100 |
| page | integer | Valinnainen tai ehdollisesti pakollinen | Sivunumero, alkaen 1:stä. minimum: 1 |
| state | string | Valinnainen tai ehdollisesti pakollinen | Liiketoimintatilan suodatin tai palvelintila. |
dfb_record
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| recordId | string / integer | Pakollinen | Sellaisen liiketoimintatietueen ID, jonka lukeminen on tällä hetkellä sallittu. |
| systemId | string / integer | Pakollinen | Tämän liiketoiminta-Grantin sallimat järjestelmä-ID:t. |
dfb_work_items
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| systemId | string / integer | Pakollinen | Tämän liiketoiminta-Grantin sallimat järjestelmä-ID:t. |
dfb_action_plan
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| expectedRecordVersion | integer | Valinnainen tai ehdollisesti pakollinen | Kohdetietueen nykyinen optimistisen lukituksen versio. minimum: 1 |
| systemId | string / integer | Pakollinen | Tämän liiketoiminta-Grantin sallimat järjestelmä-ID:t. |
| commandType | string | Pakollinen | Julkaistun sopimuksen komentotyyppi. |
| canonicalIrHash | string | Pakollinen | Nykyisen julkaisun kanoninen IR-tiiviste. |
| releaseId | string / integer | Pakollinen | Todellisen julkaisusopimuksen versio-ID. |
| payload | object | Pakollinen | describe-kutsun nykyisen komentosopimuksen mukainen hyötykuorma. |
| releaseHash | string | Pakollinen | Todellisen julkaisusopimuksen tiiviste. |
| targetRecordId | string / integer | Valinnainen tai ehdollisesti pakollinen | Todellinen kohdetietue, johon toiminto kohdistuu. |
| agentManifestHash | string | Pakollinen | Todellisen Agent-ominaisuusmanifestin tiiviste. |
| planIdempotencyKey | string | Pakollinen | Liiketoimintasuunnitelman vakaa idempotenssiavain. |
dfb_action_status
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| actionPlanId | string / integer | Pakollinen | Nykyisen liiketoiminta-Grantin omistaman toimenpidesuunnitelman ID. |
dfb_action_execute
| Parametri | Tyyppi | Vaatimus | Merkitys ja laajuus |
|---|---|---|---|
| approvalToken | string | Valinnainen tai ehdollisesti pakollinen | Alkuperäisen palvelimen myöntämä hyväksyntämateriaali; ei saa luoda itse. |
| actionPlanId | string / integer | Pakollinen | Nykyisen liiketoiminta-Grantin omistaman toimenpidesuunnitelman ID. |