DATAFOCUS · OT FLASH · R56

OT Flash Agent- en MCP-integratiehandleiding

Protocollen, autorisatie, toolcontracten en het volledige aanroepproces

Bouw traceerbare data- en kennisapplicaties met de publieke Remote MCP van OT Flash r56. Dit handboek behandelt OAuth, protocolberichten, de parameterreferentie van alle gedeclareerde tools, bewijsregels, voorwaardelijke mogelijkheden en herstelprocedures, en bevat een uitvoerbare client en voorbeelden met synthetische data.

Agent-ontwikkelaars, integratie-engineers en beheerders

De bijbehorende voorbeelden behouden de Chinese weergavenamen van velden. De vertaling van de interface en de toelichtende tekst verandert niets aan de werkelijke tabelnamen, kolomnamen, enumwaarden, toolnamen of protocolvelden.

Hoofdstuk 1

Reikwijdte en voltooiingscriteria van de Agent-integratie

Kies het geautoriseerde toegangspunt en rond query's, bewijsvergaring of gecontroleerde schrijfacties af op basis van ontvangstbewijzen van de server.

OT Flash r56 biedt externe Agents via Remote MCP data- en kennisfuncties binnen het bereik van de ontologie, en biedt daarnaast een afzonderlijk toegangspunt voor de Business Workspace. Een Agent moet het uitvoerbare werk bepalen op basis van de werkelijke tools/list, inputSchema, OAuth scope en de huidige resourcerechten, en mag niet op grond van een statische handleiding aannemen dat een implementatie alle optionele functies heeft ingeschakeld.

Figuur A1 Externe Agents gebruiken de oorspronkelijke query-, kennis- en bedrijfsfuncties via OAuth en MCP. Schematische weergave van de interface-relaties.
ToegangspuntDoelGrenzen
/mcpOntologie, datatabellen, documentkennis, native Search en voorwaardelijk beschikbare analyse en modelleringHet snijpunt van de rechten van de huidige gebruiker en de resources die bij deze autorisatie zijn toegekend
/mcp/businessBedrijfssysteemdetectie, query's, actieplannen, status en uitvoeringAfzonderlijke autorisatie van bedrijfssystemen en gepubliceerde contracten
Ingebedde ontologie-agentpaginaOntologiechat gebruiken in de interface voor mensenVereist een echte ingelogde sessie; geen toegangspunt om zonder login MCP-tokens in te wisselen

Categorieën van mogelijkheden

  • Basisleesfuncties: ontologie en resources, lokalisatie in de graaf, kennis zoeken en volledige brontekst, details van geautoriseerde tabellen en Doris SQL.
  • Afzonderlijke delegatie: dfc_search vereist search:operate en blijft de oorspronkelijke gebruikers- en modelrechten gebruiken.
  • Voorwaardelijk beschikbaar: analyse, persistente rapporten, artefactconcepten en het toepassen ervan, ontologiemodelquery's en gedelegeerde Agent-taken.
  • Niet-beschikbare mogelijkheden: de dfc_etl van Flash rapporteert alleen capabilities en biedt geen Heavy ETL-uitvoering. AutoML en het interne toegangspunt van de FocusCode-werkruimte vallen niet onder de publieke Flash API van dit handboek.

Voltooiingscriteria

Voor het lezen van feiten is een daadwerkelijk bruikbaar ontvangstbewijs van een query of volledige brontekst nodig; bij het genereren van kandidaten moet worden vermeld dat ze nog niet zijn toegepast; publicatie vereist een echt APPLIED-ontvangstbewijs; bij annulering moet onderscheid worden gemaakt tussen verzoek en bevestiging. Antwoordtekst, HTTP 200, de melding dat een tool het verzoek heeft aangenomen of een modelomschrijving “voltooid” bewijzen op zichzelf niet dat een bedrijfsbewerking is geslaagd.

De bijbehorende reference/mcp-tool-catalog.json is een offline referentie van de declaraties in r56; het bevat ook voorwaardelijk ingeschakelde definities en is niet de realtime tools/list van welke gebruiker dan ook. De volledige catalogus omvat 28 kerntools voor de ontologie, 4 voorwaardelijke controlleruitbreidingen en 8 tools voor de Business Workspace; dat betekent niet dat ze standaard allemaal beschikbaar zijn.

Hoofdstuk 2

Snel verbinden en mogelijkheden ontdekken

Begin met het officiële domein van de instantie en ontdek met minimale rechten welke tools daadwerkelijk beschikbaar zijn.

  1. Vraag de beheerder om het officiële HTTPS-basisadres en de ontologie of het bedrijfssysteem waartoe toegang nodig is. Gebruik de voorbeelddomeinen uit de documentatie niet voor aanroepen naar echte bedrijfsfuncties.
  2. Configureer het MCP-serveradres als https://flash.example.com/mcp; de Business Workspace gebruikt /mcp/business op hetzelfde domein.
  3. Start de OAuth-login en -autorisatie op de manier die de client ondersteunt en controleer resources en scope; stuur nooit gebruikersnaam en wachtwoord naar MCP.
  4. Gebruik de discovery of initialisatie van de betreffende protocolgeneratie en lees vervolgens tools/list en de resourcebeschrijvingen.
  5. Voer eerst een beperkt alleen-lezenverzoek uit, controleer de gestructureerde resultaten en fouten, en werk pas daarna aan het doel van de gebruiker.

Configuratiefragment voor de client

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

Dit fragment toont de configuratie-intentie van het serveradres; de specifieke structuur van het configuratiebestand en OAuth-ondersteuning zijn afhankelijk van de client. Zet geen echte access_token, refresh_token, cookies of beheerderswachtwoorden in openbare bestanden.

Moderne protocoldiscovery

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

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

Controles vóór integratie

  • Het basisadres van de resource, de OAuth-issuer en het externe adres van de reverse proxy komen overeen.
  • De client ondersteunt de betreffende protocolgeneratie en stuurt niet standaard initialize naar het toegangspunt van het nieuwe protocol.
  • De huidige autorisatie is gekoppeld aan de benodigde ontologie of het benodigde bedrijfssysteem.
  • Het token is geldig en nieuwe optionele scopes zijn uitdrukkelijk geautoriseerd.
Hoofdstuk 3

OAuth discovery, registratie en autorisatie

Gebruik een autorisatiecode met PKCE en stel de inloggegevens van het product niet bloot aan de Agent.

Figuur A2 OAuth-flow met autorisatiecode en PKCE. Sequentiediagram.
EndpointMethodeFunctie
/.well-known/oauth-protected-resourceGETResourcediscovery voor de ontologie-MCP
/.well-known/oauth-protected-resource/mcpGETDiscovery via het compatibele ontologieresourcepad
/.well-known/oauth-protected-resource/mcp/businessGETResourcediscovery voor de Business Workspace-MCP
/.well-known/oauth-authorization-serverGETMetadata van de autorisatieserver
/oauth/registerPOST JSONDynamische registratie van een public client
/oauth/authorizeGET of POST formInloggen, resource selecteren en autorisatie bevestigen
/oauth/tokenPOST formAutorisatiecode inwisselen en vernieuwen met rotatie
/oauth/revokePOST formToken-intrekking
/oauth/grantsGETIngelogde gebruiker bekijkt geautoriseerde verbindingen
/oauth/grants/revokePOST formVerbinding intrekken volgens het oorspronkelijke paginaproces

Autorisatievolgorde

  1. Lees de metadata van de beveiligde resource en van de autorisatieserver. De 401 en de WWW-Authenticate-header die een verzoek zonder token terugkrijgt, verwijzen naar het adres voor resourcediscovery.
  2. Registreer of gebruik een clientidentiteit. Een public client die in r56 dynamisch wordt geregistreerd, gebruikt token_endpoint_auth_method=none; een clientgeheim is geen vervanging voor PKCE.
  3. Genereer een willekeurige state en code_verifier en bereken de S256 code_challenge.
  4. Open het authorize-adres uit de metadata en geef response_type=code, client_id, exacte redirect_uri, scope, resource, state, code_challenge en code_challenge_method=S256 mee.
  5. De gebruiker logt in bij DataFocus en selecteert een ontologie of bedrijfssysteem. De client mag geen resources vooraf selecteren waarop de gebruiker geen toegangsrecht heeft.
  6. Ontvang de callback, verifieer state en issuer; wissel de autorisatiecode in met de oorspronkelijke code_verifier.
  7. Gebruik het access_token uitsluitend voor MCP Bearer-authenticatie. Vernieuw via het oorspronkelijke OAuth-proces; sla het geroteerde refresh_token veilig op.

Registratievoorbeeld

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

De callback van een webclient gebruikt HTTPS; native clients kunnen een ondersteund loopback-adres gebruiken. Autorisatie en token-uitwisseling moeten exact overeenkomen met de geregistreerde callback. Eén Grant is gericht op één protected resource; ontologie-scope en Business Workspace-scope worden niet gemengd in dezelfde verbinding.

Tokenlevensduur

Standaard is op de r56-server een access token 3600 seconden geldig, een refresh token 2592000 seconden en een autorisatiecode 300 seconden; een implementatie kan deze waarden overschrijven. De client baseert zich op expires_in uit het tokenantwoord en op de werkelijke fouten, en mag de standaardwaarden niet hardcoderen. Werk het token bij na vernieuwing; het intrekken van rollen, resourcerechten of een Grant zorgt ervoor dat volgende aanroepen worden geweigerd.

Hoofdstuk 4

Scope, resourcegrenzen en realtime rechten

Het autorisatiebereik delegeert bestaande rechten, verleent geen rolverhoging en deelt geen bedrijfsstatus over Grants heen.

ScopeTypische mogelijkhedenBelangrijke beperkingen
ontology.metadata:readOntologie, resources, tabelstructuurOntologie en tabellen moeten binnen het geautoriseerde en huidige leesbare bereik vallen
ontology.graph:readZoeken in de graaf en buurknooppuntenRetourneert lokalisatie-informatie, geen feitelijk bewijs
ontology.knowledge:readKennislokalisatie en volledige brontekstBehoudt de oorspronkelijke rechten van kennisbank en document
ontology.table:querySQL op ontologietabellen en query's op gepubliceerde modellenTabelquery's vereisen bovendien de metadata-scope; werkelijke bron- en kolomrechten blijven gelden
search:operateNative trefwoordmodellen en sessiesAfzonderlijke, uitdrukkelijke delegatie; uitgevoerd met de oorspronkelijke modelrechten en de tabel- en kolomrechten van de gebruiker
etl:operateFlash ETL capabilitiesGeen toegang tot Heavy ETL
authoring.contract:readVoorwaardelijk beschikbare modelleercontractenVereisen bovendien functieschakelaars en de betreffende resources
authoring.artifact:readKandidaten, plannen e.d. lezen binnen de huidige autorisatieGebonden aan de Grant van de oorspronkelijke principal en aan de resources
authoring.artifact:draftKandidaten indienen, voorbeeldweergave e.d.Autoriseert geen uitvoering of publicatie
authoring.artifact:applyGecontroleerde plannen en toepassingVereisen nog steeds de oorspronkelijke bedrijfsrollen, beleid en goedkeuring
execution.script:draftSpecifieke scriptconceptenAutoriseert geen daadwerkelijke scriptuitvoering
datasource.http:read / draft / test / importVoorwaardelijk beschikbare artefactfuncties voor HTTP-databronnenElk onderdeel heeft een eigen schakelaar; de oorspronkelijke rechten blijven gelden
Figuur A3 Gebruikersrechten, Grant, geselecteerde resources en functieconfiguratie bepalen samen de beschikbare mogelijkheden. Schematische weergave.

Vereiste scopecombinaties voor lezen

dfc_table detail vereist ontology.metadata:read; query vereist bovendien ontology.table:query. dfc_ontology_query vereist de twee leesscopes graph en knowledge. dfc_knowledge_search/detail vereist knowledge. published_model/published_query gaat via table:query; candidate_query vereist bovendien authoring.artifact:read. Analysetools controleren bovendien de toegestane bewijsscopes; persistente rapporten vereisen metadata en table query.

Standaardautorisatie niet hardcoderen

De standaard ontologie-scopeverzameling van r56 bevat table query; Search en ETL zijn uitdrukkelijke delegaties. Uiteindelijk zijn de discovery-metadata, de autorisatiepagina, de werkelijke token-scope en tools/list doorslaggevend. Uitspraken in oudere documentatie zoals “de ontologie heeft standaard nooit SQL” of “slechts zes tools” kunnen niet als uitgangspunt voor de huidige implementatie dienen.

Statusisolatie

Sessies, rapporten, kandidaten en actieplannen hebben elk hun eigen eigenaar en bereik. Het vernieuwen van het access token draagt het werk van de oorspronkelijke Grant niet over aan een andere Grant. Neem geen sessionId, reportId, planId, goedkeuringstokens of brontokens die een andere verbinding heeft geretourneerd over in de huidige verbinding.

Hoofdstuk 5

HTTP- en moderne MCP-berichten

Stuur per verzoek de juiste metadata en bijpassende routingheaders en behandel HTTP en toolresultaten afzonderlijk.

Onderdeelr56-gedrag
TransportStateless Streamable HTTP, POST JSON-RPC
Ondersteunde protocolversies2026-07-28 en ook 2025-11-25, 2025-06-18 en 2025-03-26
Moderne methodesserver/discover tools/list tools/call resources/list resources/read, aangeboden volgens de werkelijke mogelijkheden
SessieheaderEr wordt geen Mcp-Session-Id toegekend
GET en DELETE/mcp en /mcp/business geven 405 terug
SSE-meldingen van de serverNiet beschikbaar op deze twee openbare MCP-toegangspunten
Cachen van de catalogusModerne discover- en list-aanroepen geven ttlMs=60000 en cacheScope=private terug
Normaal resultaatModerne resultaten bevatten resultType=complete en metadata met de identiteit van de service

Inhoud die overeen moet komen

  • MCP-Protocol-Version moet overeenkomen met io.modelcontextprotocol/protocolVersion in params._meta.
  • Mcp-Method moet overeenkomen met de method van JSON-RPC.
  • De Mcp-Name van tools/call moet overeenkomen met params.name; bij resources/read moet de naamheader overeenkomen met de URI.
  • Elk modern verzoek bevat het io.modelcontextprotocol/clientCapabilities-object; geef daarnaast de standaard clientInfo mee, zodat de client kan worden herkend.

Voorbeeld van een aanroep

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

De bijbehorende HTTP-headers zijn Mcp-Method: tools/call en Mcp-Name: dfc_ontologies. In alle voorbeelden is ACCESS_TOKEN een placeholder. Zet het Bearer-token niet in de URL, JSON-parameters of cachesleutels.

Resultaten lezen

Behandel eerst de HTTP-status en controleer vervolgens op een JSON-RPC-fout; is er een result, controleer dan isError. Een succesvol toolresultaat levert doorgaans structuredContent én text-inhoud met dezelfde bedrijfs-JSON. Lees bij voorkeur het gestructureerde kanaal en tel text en structuredContent niet dubbel op als twee onafhankelijke feiten. HTTP 200 kan een mislukte toolaanroep bevatten.

Openbare resources en UI

De ingebouwde instructieresources zijn niet afhankelijk van MCP Apps. Het toegangspunt van de Business Workspace krijgt hierdoor geen instructieresources van de ontologie. Clients die visualisatie ondersteunen, ontdekken de bijbehorende UI via de werkelijke mogelijkheden en de _meta van de tool, en raden niet naar resource-URI's die niet zijn teruggegeven.

Hoofdstuk 6

Compatibiliteit met clients van het oude protocol

Houd in clients die nog de initialisatie-handshake gebruiken één consistente protocolgeneratie aan.

json
{
  "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {"name": "flash-legacy-client", "version": "1.0.0"}
  }
}
  1. Stuur initialize en lees de door de server onderhandelde protocolversie en capabilities.
  2. Stuur volgens het protocol van de client de vereiste melding dat de initialisatie is voltooid; meldingen leveren geen normaal toolresultaat op.
  3. Lees met tools/list de momenteel geautoriseerde tools en verstuur daarna tools/call.
  4. Houd headers en berichten consistent binnen de protocolgeneratie van het huidige verzoek en gebruik geen oude initialize- of ping-procedure bij berichten volgens 2026-07-28.

Het oude protocol gebruikt nog steeds dezelfde Bearer/OAuth, rechten en toolcontracten. Dat betekent niet dat de server per se een langdurige SSE-verbinding in oude stijl of een Mcp-Session-Id aanbiedt; de openbare service van r56 blijft stateless.

Protocolfouten

SituatieTypisch resultaatOplossing
Moderne headers en berichten komen niet overeenHTTP 400 JSON-RPC -32020Corrigeer headers, metadata en toolnamen
Niet-ondersteunde versie-32022 met een lijst van ondersteunde versiesKies een daadwerkelijk ondersteund protocol
Onbekende methodeJSON-RPC -32601; bij moderne verzoeken mogelijk HTTP 404Controleer de protocolgeneratie en de methode
Ontbrekende of ongeldige parametersJSON-RPC parameterfout of tool-isErrorCorrigeer volgens de werkelijke inputSchema
Hoofdstuk 7

De juiste tool en het juiste bewijskanaal kiezen

Routeer op basis van de nog onbeantwoorde bedrijfsvraag en verzamel niet steeds opnieuw bewijs via een vaste aanroepketen.

Figuur A4 Kies per taak tabel-SQL, kennisbewijs, Search, analyse of een bedrijfsactie. Routeringsschema.
TaakVoorkeurstoolBenodigd bewijs voor afronding
Geautoriseerde onderwerpen en resources ontdekkendfc_ontologies dfc_ontology_resourcesWerkelijke typen resource-id's en het momenteel zichtbare bereik
Tabelstatistieken en TopNdfc_table queryOntvangstbewijs van een geslaagde uitvoering en volledige evidenceRows
Beleid, contracten of rapporten opzoekendfc_ontology_query of knowledge search/detailVolledige, geautoriseerde brontekst die als feit kan dienen
Graafobjecten lokaliserendfc_ontology_graph search/neighborsLokaliseer eerst de werkelijke bron en verkrijg daarna de bijbehorende feiten
Oorspronkelijke trefwoordinteractiedfc_manual en daarna dfc_searchDe werkelijke resultaten in het oorspronkelijke model en de bedrijfsframes
Geïntegreerde analyse en rapportendfc_analysis_* of dfc_report_*De werkelijke status van elke gestructureerde vertakking en van het documentbewijs
Weergave of ontologiemodel wijzigendfc_authoring_* en artefacttoolsControleer kandidaten, plannen, goedkeuringen en toepassing afzonderlijk
Bedrijfsopdrachten uitvoeren/mcp/business met dfb_*Gepubliceerde contracten en het oorspronkelijke ActionPlan-ontvangstbewijs

Onnodige aanroepen vermijden

Wanneer de actuele, volledige en geautoriseerde tabelstructuur al beschikbaar is, is het niet nodig om bij elke query opnieuw detail op te vragen; wanneer er al betrouwbare lokalisatie en bewijs voorhanden zijn, herhaal dan niet dezelfde zoekopdracht. Voer bij een ontbrekende dimensie een begrensde aanvullende query uit. Als een fout uitdrukkelijk niet opnieuw geprobeerd mag worden, dicht dan eerst het gat en vervang uw eigen afweging niet door “nog een keer proberen”.

Uitsluitingen van Flash

dfc_etl capabilities kan available=false en ETL_NOT_INCLUDED_IN_OT_FLASH teruggeven. De statische beschrijving van de ingebouwde ETL-functies dient als productoverstijgende referentie; ze bewijst niet dat ETL in Flash is geïnstalleerd en staat de Agent niet toe om voor de uitvoering automatisch over te schakelen naar Heavy of een andere tenant.

Hoofdstuk 8

Ontologieresources en id-typen

Verkrijg eerst de werkelijke resourcecoördinaten om opslagnamen, document-id's en kennisbank-id's niet door elkaar te halen.

  1. Roep dfc_ontologies aan en blader met page en pageSize door de ontologieën die bij deze autorisatie zijn toegekend en momenteel nog leesbaar zijn.
  2. Roep dfc_ontology_resources aan met een werkelijke ontologyId; kies naar behoefte tables, answers, pinboards, documents en knowledgeBindings.
  3. Behandel paginering per resourcetype. pageSize is maximaal 100; leid de volledige omvang van de resource niet af uit de eerste pagina.
  4. Sla het door de resource gedeclareerde type en de oorspronkelijke id op en gebruik deze bij volgende aanroepen ongewijzigd.
json
{"name":"dfc_ontology_resources","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "resourceTypes":["tables","documents","knowledgeBindings"],
  "page":1,"pageSize":100
}}
CoördinatenBronVervangt niet
ontologyIdLijst van geautoriseerde ontologieën of de momenteel geldige contextId van een andere ontologie
id van een tabelresourcetables-lijst of betrouwbare contextphysicalName of weergegeven tabelnaam
tblDisplayName colDisplayNameMetadata van de huidige tabel en kolommenGeraden fysieke SQL-identificatoren
knowledgeIdknowledgeBindings of een werkelijk ontvangstbewijs van een kenniszoekopdrachtid van een documentresource
assetId documentId chunkId evidenceIdHetzelfde werkelijke ontvangstbewijs van de lokalisatieVelden samengevoegd uit verschillende lokalisatieresultaten
rid revisionId releaseIdGepubliceerd model of kandidaatcontext aan serverzijdeZelfgegenereerde id of latest

Afspraken over precisie

Geef bij alle 64-bits resource-id's de voorkeur aan decimale tekenreeksen en converteer ze niet via Number in JavaScript. Sommige bedrijfsschema's accepteren string of integer, maar dat betekent niet dat de precisie van gehele getallen mag worden opgegeven. Opaque locators, UUID, hashes en eenmalige tokens worden eveneens ongewijzigd bewaard.

Hoofdstuk 9

Doris-tabelquery- en structuurcontract

Voer alleen-lezen SQL uit op geautoriseerde tabellen en behoud de semantiek van de uitvoer, exacte waarden en volledigheid.

Structuur lezen

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

Gebruik detail met een werkelijke tabelresource-id. Controleer schemaComplete, tblDisplayName, colDisplayName in columns en de gezaghebbende sqlDataType, evenals het geretourneerde queryContract. dataType is slechts een compatibiliteitsmapping; de fysieke opslagnaam is niet de tabelnaam die u in ingediende SQL gebruikt.

Query uitvoeren

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

SQL-beperkingen

  • Gebruik de weergavenamen van tabellen en kolommen en zet identificatoren tussen dubbele aanhalingstekens. Het verzoek is één alleen-lezen Doris-query binnen het bereik van de ontologie.
  • Som de uitvoerkolommen expliciet op; SELECT * en table.* zijn verboden; zo kunnen de rechten op geregistreerde kolommen niet via fysieke kolommen worden omzeild.
  • Gebruik bij joins expliciete JOIN ... ON; NATURAL JOIN en JOIN USING worden geweigerd.
  • Geldige multidimensionale aggregaties, CTE's, vensterfuncties, CASE, COUNT(DISTINCT ...) en andere alleen-lezen expressies zijn toegestaan; dat de semantische validatie een expressie niet afdekt, betekent niet dat de uitvoering ervan altijd verboden is.
  • Voltooi aggregatie, sortering en rangschikking eerst in SQL en pas daarna de resultaatlimiet toe. maxRows is standaard 100, maximaal 200.

Datum en tijdzone

Type of doelVormLet op
DATECAST('2026-09-01' AS DATE) en CURRENT_DATENeem niet automatisch aan dat een tekstliteral een datumtype is
DATETIMECAST('2026-09-01 00:00:00' AS DATETIME) en CURRENT_TIMESTAMPControleer de brontijdzone en de sessietijdzone
Relatieve tijdDATE_SUB(CURRENT_DATE, INTERVAL 1 YEAR)Gebruik voor datums en tijdstempels de overeenkomstige huidige functies
TijdgroeperingYEAR(column) of DATE_TRUNC(column, 'month')Gebruik voor elke uitvoer een unieke alias; queryContract is leidend

De DATE('now', ...)-functie van SQLite is niet het Doris-datumcontract van dit toegangspunt. Neem de SQLite-offlineverificatiemethode uit documentatievoorbeelden niet over in de online SQL.

Het v8-queryontvangstbewijs lezen

evidenceRows is het enige kanaal waarmee de Agent rijgegevens benadert; raw data is niet toegankelijk voor de Agent. SQL-getallen worden gecodeerd als exacte decimale JSON-tekenreeksen; bepaal de numerieke waarde en het bedrijfstype aan de hand van resultColumnContracts en interpreteer een waarde in JSON niet als VARCHAR alleen omdat ze een tekenreeks is. Lees de informatie over executionReceipt, volledigheid en afkapping en bewaar broninformatie zoals evidenceRowsSha256.

Query-uitvoer met een citeerbaar ontvangstbewijs mag letterlijk worden geciteerd; alleen semantiek die door de server is geverifieerd, geeft toestemming voor daaropvolgende deterministische herberekeningen. Leid uit veldnamen niet zelf “cumulatief saldo”, “eindwaarde” of “valuta” af en vul geen eenheden zelf aan. Resultaten zonder rijen, fouten of afkapping mogen niet als volledige statistiek worden beschreven.

Hoofdstuk 10

Multidimensionale Top3 en omgang met afkapping

Beantwoord rangvragen met aggregatie en vensterfuncties aan serverzijde; voer geen tweede berekening uit op onvolledige resultaten.

Het bijbehorende examples/top3.sql gebruikt de voorbeeldtabel: het aggregeert eerst op 区域, 类别 en 产品, voert daarna binnen elke combinatie van 区域 en 类别 een ROW_NUMBER uit en gebruikt de productnaam als stabiele volgorde bij gelijke bedragen. Een verzoek met maxRows=100 volstaat voor de 36 rijen van het voorbeeld; voor andere bedrijfsgegevens gaat u uit van het werkelijke aantal groepen.

  1. Haal de werkelijke structuur en de geldende definities op en leg valuta, periode, orderstatus (订单状态) en de regel voor gelijke waarden vast.
  2. Dien SQL in die de aggregatie en rangschikking aan serverzijde uitvoert. Vraag niet eerst alleen de totalen per 区域 op om die vervolgens als productranglijst per 类别 te gebruiken.
  3. Controleer het uitvoerkolomcontract en de werkelijke evidenceRows en bevestig dat de geretourneerde resultaten alle benodigde groepen dekken.
  4. Bij afkapping voert u begrensde partitiequery's uit binnen de door de server ondersteunde grenzen, bijvoorbeeld per 区域 telkens de volledige Top3 ophalen; hanteer telkens dezelfde bedrijfsdefinitie.
  5. Als de bronperiode verandert, voert u de query opnieuw uit en vermeldt u expliciet de nieuwe versie; meng geen verschillende dataversies of verlopen cursors.
Figuur A5 Volgorde van detailfiltering, groepsaggregatie, rangschikking binnen de groep en definitieve teruggave. Schematische weergave.

Foutherstel

TABLE_SCHEMA_INCOMPLETE moet worden gecorrigeerd of de volledige structuur moet worden opgevraagd; fouten zoals ONTOLOGY_SQL_FAILURE_CONTRACT_INVALID worden afgehandeld volgens de geretourneerde errorCode, retryable en remediation. Beweer niet dat “alle multidimensionale GROUP BY-clausules of vensterfuncties verboden zijn” en verzin geen ranglijsten als er geen queryresultaten zijn.

Hoofdstuk 11

Kennis zoeken, volledige brontekst en bewijsgeschiktheid

Houd lokaliseren, lezen en het citeren van feiten gescheiden en behoud herkomst en volledigheid.

Twee gebruikelijke paden

PadDoelKernpunten
dfc_ontology_queryZoeken binnen de aan de ontologie gebonden kennis, eventueel gecombineerd met graafrouteringControleer de volledige canonical answerContextItems en de bewijsgeschiktheid
dfc_knowledge_search → dfc_knowledge_detail chunkExpliciet zoeken om te lokaliseren, daarna het geselecteerde fragment lezenDe voorbeeldweergave van een zoekresultaat geldt niet als feit; lees de volledige brontekst van dezelfde lokalisatie
json
{"name":"dfc_knowledge_search","arguments":{
  "ontologyId":"<ONTOLOGY_ID>","query":"销售金额是否排除退货", "topK":5
}}

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

Voorwaarden voor feitelijk gebruik

  • Controleer de huidige ACL, de volledigheid van de inhoud en de canonicalFactEligible, citationEligible of het overeenkomstige uitvoeringscontract aan serverzijde.
  • Volledige inhoud is gebonden aan contentSha256. Afgekapte inhoud, inhoud die vanwege het budget is weggelaten en inhoud van lage kwaliteit behandelt u volgens de werkelijke velden.
  • Documentmetadata, page_context, graaflokalisatie, zoeksamenvattingen en voorbeeldweergaven vervangen de canonical brontekst niet.
  • Kopieer bij voorkeur de evidenceId; wanneer u chunkId en documentId nodig hebt, moeten beide uit hetzelfde lokalisatieresultaat komen; stel ze niet samen uit verschillende resultaten en verzin ze niet.

Graafroutering

Het search/neighbors-resultaat is lokalisatie-informatie. Geef uitsluitend het volledige, door de server geretourneerde routeLocator-object door aan de ontologiequery, inclusief binding-, versie- en bewijsvelden. Verpak een assetId of knowledgeId niet zelf als door de server uitgegeven locator en stuur geen door het model beweerde herkomstbewijzen terug.

Gestructureerd documentherstel

De structuredPlan van dfc_ontology_query is bedoeld voor beperkt herstel en deterministische verificatie van onregelmatige documenttabellen. Gebruik het door de server gedeclareerde plan pas nadat de huidige executionContractSha256, tableIndex, de kolommen en de volledige tabel zijn geretourneerd. Gewone reeds geïmporteerde bedrijfstabellen verlopen via dfc_table SQL; behandel het herstel van Markdown-tabellen niet als een route om autorisatie voor tabelquery's te omzeilen.

Figuur A6 Bewijsketen van lokalisatieresultaat tot citeerbare brontekst. Schematische weergave.

Zoekstrategie

knowledgeIds wordt meestal weggelaten, zodat alle momenteel actieve bindingen worden gedekt; geeft u het wel op, gebruik dan uitsluitend echte kennisbank-id's uit knowledgeBindings. Gebruik een documentresource-id niet als kennisbank-id. Voer voor een nog onopgeloste vraag een nieuwe, begrensde zoekopdracht uit en vermijd exact herhaalde zoekopdrachten die geen nieuw bewijs opleveren.

Hoofdstuk 13

Taal- en regioconventies

Houd UI-locale, querywoordenboek, antwoordtaal en oorspronkelijke veldnamen strikt gescheiden.

De prioriteit is: expliciet aangevraagde taal, taal van het applicatiesysteem, de locale van het daadwerkelijk uitvoerende knooppunt. Een weggelaten waarde, null, een lege tekenreeks of alleen witruimte leidt niet vast tot terugval op het Chinees. De regiowaarden in languageRegistry moeten exact blijven; vouw en-GB, fr-CA, pt-BR, es-US of ar-AE niet zomaar samen tot een andere regio.

Taal of regioQuery-localeToelichting
Vereenvoudigd Chinees, Traditioneel Chineeszh-CN zh-HantDe oorspronkelijke Chinese regels verschillen van de catalogus voor traditioneel Chinees
Amerikaans, Brits, Australisch en Canadees Engelsen-US en-GB en-AU en-CAUI- en trefwoordpakket kunnen worden gedeeld; regiometadata blijven behouden
Duits, Italiaans, Russischde-DE it-IT ru-RUGebruiken volgens de suggesties van de huidige sessie
Spaans en Latijns-Amerikaans Spaanses-ES es-USDe regio-id van het product is es-US
Frans en Canadees Fransfr-FR fr-CARegio-id's worden niet samengevoegd
Portugees en Braziliaans Portugeespt-PT pt-BRCatalogus- en regioconventies worden apart bewaard
Nederlands, Deens, Noors, Fins en Zweedsnl-NL da-DK nb-NO fi-FI sv-SENoors is Bokmål
Japans, Koreaansja-JP ko-KRPas geen eigen woordsplitsing met Engelse spatiëringsregels toe
Saoedi-Arabisch en Emiraats Arabischar-SA ar-AEInterfacebeschrijvingen ondersteunen RTL; protocolidentificatoren worden niet gespiegeld

De trefwoordcatalogus gebruiken

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

De statische trefwoordcatalogus van dfc_manual bevat alleen expliciet vermelde locales; bij weglating geldt de Engelse referentie. Dat is de standaardreferentie, geen regel voor het bepalen van de querytaal. Wanneer voor een regiovariant geen statische catalogus beschikbaar is, haalt u de werkelijke suggesties op via de assist van de huidige sessie; verzin geen aliassen of terugvalresultaten. names bevat per aanroep maximaal 32 items.

Wat niet wordt vertaald

  • Tabellen, kolommen, enumwaarden, klantnamen, formulenamen en andere echte modeltekenreeksen.
  • Toolnamen, action, scope, Schema-velden, foutcodes en statuswaarden.
  • Resource-id's, hashes, opaque locators en door de server uitgegeven referenties.

Met een Duitstalige vraag kunt u bijvoorbeeld de kolom met de Chinese weergavenaam “销售金额” opvragen. Wie die naam in een Duitse kolomnaam verandert, krijgt een andere identificator en geen vertaling van de interface. Initialiseer de sessie na een taalwijziging opnieuw of werk deze bij conform het oorspronkelijke protocol en haal suggesties en disambiguatiekandidaten opnieuw op.

Hoofdstuk 14

Geïntegreerde analyse en interactieve resultaten

Behoud in de voorwaardelijk beschikbare analysetools de status van autorisatie, versie, vertakking en bewijs.

dfc_analysis_* wordt aangestuurd door datafocus.mcp.analysis.tools.enabled. Het gestructureerde deel loopt verder via de autoritatieve Search-query's en het huidige rijbeleid; voor het documentdeel wordt opnieuw de volledige brontekst onder de huidige ACL opgehaald. Ze vormen geen toegangspunt voor open SQL of voor het injecteren van willekeurige instructies of filters.

ToolDoelNoodzakelijke coördinaten
dfc_analysis_askEen analysevraag in natuurlijke taal stellenontologyId question, optioneel language sessionId
dfc_analysis_result_getEerder geretourneerd resultaat lezenontologyId sessionId resultId
dfc_analysis_refineDoorvragen of wijzigen op basis van het meest recente volledige resultaatOorspronkelijk resultaat expectedRevision en stabiele idempotentiesleutel
dfc_analysis_pageEén pagina van een vertakking aan serverzijde ophalenOorspronkelijke vertakking en resultaatversie pageNo pageSize
dfc_analysis_cancelEen resultaat annuleren dat nog in behandeling isOorspronkelijke sessie en resultaat
dfc_analysis_closeEen sessie vrijgeven die niet meer actief isOorspronkelijke sessie

Analyse starten

json
{"name":"dfc_analysis_ask","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "question":"按区域分析已完成订单销售金额,并引用退货统计口径",
  "language":"zh-CN"
}}
  1. Lees de geretourneerde sessionId, resultId, status en revision; lees zo nodig het oorspronkelijke resultaat verder uit.
  2. Controleer de status, volledigheid, het rijbeleid en de bronnen van elke gestructureerde vertakking afzonderlijk; de voltooiing van één vertakking staat niet gelijk aan de volledigheid van de gehele analyse.
  3. Controleer documentbewijs, het feitenregister, citatiegeschiktheid en beperkingen. Door het model gegenereerde tekst kan de bewijsgeschiktheid niet op eigen kracht verhogen.
  4. Baseer een vervolgvraag op het meest recente volledige resultaat en geef expectedRevision mee; gebruik bij een nieuwe poging voor dezelfde wijziging dezelfde idempotentiesleutel.
  5. Controleer vóór het sluiten dat de sessie niet meer actief is; annuleren en sluiten zijn verschillende acties.

Gecontroleerde filtering en paginering

filter_patch gebruikt de door de server gegeven branchId, fieldRef, valueRef en toegestane operatoren; huidige getypeerde filters ondersteunen alleen EQ. Het is verboden opaque verwijzingen te vervangen door ruwe SQL, tableId, columnId of een filterboom die de client zelf samenstelt. Bij paginering begint pageNo bij 1 (maximaal 10000); pageSize is maximaal 100.

Figuur A7 Koppeling van vertakkingen, versies en paginering; als de bron of versie verandert, voert u de query opnieuw uit om een nieuwe lokalisatie te verkrijgen. Schematische weergave.

Hints over mogelijkheden en gedrag

Tool-annotations zijn hints voor de client, geen beveiligingsautorisaties. Sommige algemene sjablonen gebruiken readOnlyHint, wat geen vervanging is voor de beoordeling van de daadwerkelijke actie; annuleren, sluiten en het maken van een rapport wijzigen de betreffende werkstatus. Handel altijd volgens de semantiek van de tool, het doel van de gebruiker en de rechten aan serverzijde.

Hoofdstuk 15

Persistente visualisatierapporten en MCP Apps

Maak herstelbare rapporten en lees de resultaten en interactieve interface ervan volgens de huidige rechten.

dfc_report_* wordt aangestuurd door datafocus.mcp.analysis.report-tools.enabled en vereist metadata- en table query-scope. Het verschilt van een in-process Search-sessie; rapporten gebruiken een persistente reportId; persistentie betekent niet dat rechten niet meer worden gecontroleerd.

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

Workflow

  1. Gebruik bij het maken een stabiele idempotencyKey van 8 tot 128 ondersteunde tekens.
  2. Sla reportId op, poll de status en controleer de werkelijke status zoals voltooid, mislukt, gedeeltelijk voltooid of geannuleerd.
  3. Controleer bij het lezen van resultaten de gestructureerde vertakkingen, visualisaties, feitenbronnen, documentcitaten en volledigheid.
  4. Gebruik de oorspronkelijke reportId om een onvoltooid rapport te annuleren; maak geen ander rapport aan als vervanging voor het annuleren.
  5. Lees na een netwerktime-out eerst de status van het oorspronkelijke rapport; een herhaling met de oorspronkelijke idempotentiesleutel moet dezelfde bedrijfsintentie behouden.

MCP Apps

Clients die UI-uitbreidingen ondersteunen, lezen rapportpagina's via de _meta van de tool en de werkelijke resourcediscovery. De persistente rapportpagina behorend bij r56 is ui://datafocus/analysis-report/v16/index.html; voor interactieve analyse worden de bijbehorende serverresourceverwijzingen gebruikt; clients mogen de door de tool geretourneerde waarden niet vervangen door hardgecodeerde waarden. Zonder UI-uitbreiding kunnen gestructureerde resultaten nog steeds worden gelezen.

Origin-binding

Bij het lezen van rapporten worden Grant, ontologie, de binding aan de Origin van het verzoek en de huidige tabelrechten opnieuw gecontroleerd. Voor cross-origin-integratie in de browser moet de goedgekeurde werkelijke origin worden gebruikt; clients omzeilen de binding niet via een vervalste Origin. Een oude reportId is geen permanente openbare link en ook geen toegangsbewijs voor andere gebruikers.

Hoofdstuk 16

Artefactconcepten, voorbeeldweergave, plan en toepassing

Dien gegenereerde inhoud in bij de oorspronkelijke server voor normalisatie, validatie en goedkeuring; laat het model niet rechtstreeks productieresources wijzigen.

Artefacttools vereisen een ingeschakelde authoring-functie, een werkelijk artefacttype, de betreffende scope en de oorspronkelijke schrijfrechten van beheerders. Standaard zijn de typen geconfigureerd als CONTROL_PANEL_SPEC en VIEW_SPEC; andere typen voor formulieren, HTTP-bronnen of scripts vallen daarnaast onder een afzonderlijke configuratie. Flash heeft geen AutoML, dus de betreffende typen worden niet als beschikbare artefacten in deze versie vermeld.

Figuur A8 Gecontroleerde volgorde van context, kandidaat, voorbeeldweergave, plan, goedkeuring en toepassing. Schematische weergave.
  1. dfc_authoring_capabilities leest de contracten en acties die beschikbaar zijn onder de huidige Grant.
  2. dfc_artifact_context haalt begrensde context, contractVersion, contextHash, baseArtifactHash en baseArtifactVersion op.
  3. Genereer kandidaten aan clientzijde op basis van de werkelijke contracten; voer code daarin niet uit.
  4. dfc_artifact_submit dient de oorspronkelijke context en kandidaat in, houdt de instruction identiek en gebruikt een stabiele clientRequestId.
  5. Lees proposalId, candidateHash, de validatieresultaten en de voorbeeldweergave; reviseer de kandidaat bij werkelijke fouten en vervals geen geslaagde serverstatus.
  6. Is een nieuwe voorbeeldweergave nodig, gebruik dan dfc_artifact_preview en dezelfde kandidaathash.
  7. dfc_artifact_plan maakt een onveranderlijk plan met de echte kandidaat, doelversie en idempotentiesleutel.
  8. Verwerk goedkeuringen volgens de oorspronkelijke interactieve goedkeuring of een reeds geautoriseerd beleid, en voer daarna dfc_artifact_apply uit; alleen een APPLIED-ontvangstbewijs betekent dat de wijziging werkelijk is toegepast.

Minimaal contextverzoek

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

VIEW_SPEC gebruikt de huidige geautoriseerde projectId; gebruik bij het bewerken van een bestaand artefact de werkelijke artifactId. Geef velden zoals variables, previewInput en viewport op volgens het geretourneerde contract en verzin geen interne kandidaatstructuur.

Gelijktijdigheid en nieuwe pogingen

Het plan is gebonden aan doelversie, kandidaathash en idempotentiesleutel. Na een wijziging van het doel kan het oude plan niet meer worden toegepast; lees de context opnieuw en behandel de werkelijke conflicten. Een transporttime-out bewijst geen mislukking; vraag eerst met dfc_artifact_status de oorspronkelijke proposalId of planId op. READY is niet APPLIED.

Goedkeuring en automatisch beleid

Algemene artefactplannen vereisen de oorspronkelijke menselijke goedkeuring. Plannen die voldoen aan het automatische publicatiebeleid van de ontologie worden volgens approvalMode verwerkt, zonder dat de gebruiker nog een door de Agent verzonnen goedkeuring hoeft te ondertekenen. approvalToken is door de server uitgegeven materiaal en kan niet door de Agent worden vervangen door een zelfgeschreven tekenreeks; de werkelijke inputSchema en het ontvangstbewijs van het plan bepalen de verplichte velden.

Hoofdstuk 17

Ontologiekandidaten maken en publicatiecontract

Gebruik de afzonderlijk geversioneerde ontologiedeclaraties en publicatieconfiguratie; pas het contract voor gewone weergave-artefacten niet toe op modelpublicatie.

Kandidaat maken

De ontologiecontainer moet al bestaan en binnen de Grant vallen. Gebruik dfc_ontology_table_schema om de huidige gestructureerde bronvelden en de v4 Binding-vingerafdruk te controleren; u kunt per veld volstaan met alleen sourceField, waarna het type automatisch wordt bepaald. Een expliciete DECIMAL-declaratie vereist de huidige precisie en het aantal decimalen; andere typen bevatten deze twee velden niet.

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

Kandidaat- en publicatieconfiguratie

ContractDoelBelangrijke grenzen
ontology-workspace-create-mcp-submit-v1Kandidaat maken met lokale declaratiesWerkelijk geautoriseerde bronnen, compilatie aan serverzijde; voltooiingsbewijzen worden niet geaccepteerd
ontology-workspace-create-mcp-submit-v2Lokale declaraties combineren met exacte verwijzingen naar gepubliceerde versiesGeef de exacte releaseSelections en de afhankelijkheden van de referentieafsluiting op
ontology-publication-mcp-submit-v1 tot en met v3Een bestaande kandidaat binden aan een verzoek om een publicatieplanExpliciete coördinaten; doel, bron, goedkeuring en validatie leidt de server zelf af
ontology-publication-mcp-submit-v4 tot en met v6Afzonderlijk ingeschakelde configuratie met betrekking tot automatische publicatieAlleen gebruiken als capabilities en het werkelijke schema dit declareren
ontology-initial-activation-retirement-submit-v1Gecontroleerde initiële activering en buitendienststellingAfzonderlijk plan, nieuwe menselijke goedkeuring en exacte scope

Publicatievolgorde

  1. Haal van de huidige kandidaat de workspaceId, workspaceRevision, candidateHash en de werkelijke bronnen op.
  2. Kies de contractversie op basis van de servermogelijkheden; dien coördinaten zoals releases en selection in, zonder velden die zichzelf “goedgekeurd” of “geslaagd” noemen.
  3. Bewaar de door submit geretourneerde proposalId en de oorspronkelijke idempotencyKey. submit en MODEL_PLAN zijn verschillende fasen van dezelfde aanvraag.
  4. Roep dfc_artifact_plan aan met de oorspronkelijke kandidaat, doelversie en dezelfde idempotentiesleutel.
  5. PLANNING_INCOMPLETE betekent alleen dat er nog geen geldig plan is gevormd; VALIDATION_UNSATISFIED betekent dat er nog lacunes in de huidige validatie zijn; handel volgens nextAction.
  6. Ga na een geslaagd plan verder op basis van HUMAN_REQUIRED of POLICY_AUTO; gebruik daarbij de oorspronkelijke goedkeurings- en publicatiefuncties.
  7. Bevestig het resultaat met het APPLIED-ontvangstbewijs en daarna door het gepubliceerde model werkelijk te lezen en er een geautoriseerde query op uit te voeren.

Time-outs en herstel

Lees na een PLAN-time-out de oorspronkelijke proposalId. MODEL_PLAN_SUBMITTED is een onvoltooide aanvraag; MODEL_PLAN_COMPLETED betekent dat het oorspronkelijke ontvangstbewijs moet worden opgehaald met de oorspronkelijke coördinaten en sleutel, niet dat de client een nieuwe aanvraag moet maken. Terminale validatielacunes kunnen niet worden omgezet in een geslaagde publicatie door van sleutel te wisselen of opnieuw in te dienen.

Menselijke bedrijfsrechten

De door de Agent verstrekte instruction en declaraties zijn Agent-invoer, geen ondertekening van menselijk beleid. MODEL_AUTHOR, MODEL_PUBLISH, delegatie van automatische publicatie, bedrijfsbevestiging, vertrouwen in publieke sleutels, budget en bron-ACL blijven door de oorspronkelijke mechanismen bepaald. Deze feiten mogen niet worden vervangen door clientvelden.

Hoofdstuk 18

Gepubliceerde modellen, kandidaatquery's en referentieafsluiting

Gebruik gepubliceerde bedrijfskennis in een exacte versie en behandel niet-gepubliceerde kandidaten als tijdelijk.

published_model, published_query en candidate_query van dfc_ontology_graph zijn voorwaardelijk beschikbare, gestructureerde configuraties en geen synoniemen van een gewone search/neighbors. Ze worden geautoriseerd volgens table query en de benodigde leesrechten voor modellering; zichtbaarheid in de graaf vervangt geen tabelrechten.

Gepubliceerd model lezen

  1. Wanneer de action-enum van de tool daadwerkelijk published_model bevat, dient u een echte committed releaseId in.
  2. v1 retourneert geautoriseerde querysjablonen; v2 voegt exacte PERSISTED-verwijzingen en releaseSelections toe; v3 voegt afhankelijkheidsverwijzingen, exacte domainRef en compacte bindingssjablonen toe.
  3. Kies objecten, attributen, Binding, scope en versie uit de werkelijke retourwaarden; genereer geen RID's en gebruik geen latest.
  4. Dien vaste getypeerde query's in voor published_query; resultaten moeten nog steeds door de huidige bron- en veldautorisatie gaan.

Kandidaatquery

candidate_query gebruikt de werkelijke workspaceId, revision, candidateHash en kandidaatdeclaraties. Combineert u dit met gepubliceerde verwijzingen, gebruik dan de bijbehorende getypeerde v2-LOCAL/PERSISTED-coördinaten en exacte selecties. Kandidaatresultaten zijn altijd ongepubliceerd en tijdelijk en mogen niet worden beschouwd als door de onderneming bevestigde kennis.

Gedeeltelijk onderhoud en afsluiting

Selecteer alleen de transitieve afhankelijkheden die nodig zijn voor de kandidaatwortel en zorg ervoor dat elke gepubliceerde verwijzing een exacte releaseSelections heeft. Het kopiëren van de publicatietekst, het indienen van slechts een reeks id's of het uitbreiden naar alle historische resources kunnen de huidige afhankelijkheids- en broncontroles niet vervangen.

Figuur A9 Kandidaatwortel, exacte gepubliceerde afhankelijkheden en bronautorisatie. Schematische weergave van de referentieafsluiting.

De query van deze acties is een geversioneerd getypeerd object; SQL, fysieke tabel-id's of brontabelnamen worden niet geaccepteerd als vervanging van de bedrijfsverwijzingen. Metadatasjablonen en graafresultaten zijn op zichzelf niet citeerbaar als feit.

Hoofdstuk 19

Ontologie-agenttaken delegeren

Hervat werk met persistente taken en de oorspronkelijke Grant; behandel Agent-instructies niet als menselijke goedkeuring.

dfc_ontology_agent wordt alleen weergegeven wanneer de werkelijke Pi Runtime en de bijbehorende rechten beschikbaar zijn. QUERY gebruikt leesmogelijkheden; AUTHORING vereist bovendien een modelleerrol en de bijbehorende authoring-scope. De tool stelt geen aparte, onbeperkte uitvoeringsengine beschikbaar.

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

Strikte parametersets

start gebruikt contractVersion, action, ontologyId, mode, instruction, idempotencyKey; status/cancel gebruikt contractVersion, action, ontologyId, runId. De server controleert de exacte veldenset per action. instruction is maximaal 16000 tekens; sleutels bestaan uit 1 tot 128 ondersteunde tekens en beginnen met een letter of cijfer.

Hervatten en annuleren

  1. Bewaar de oorspronkelijke runId, Grant, mode en idempotentiesleutel.
  2. Dezelfde sleutel met dezelfde instruction hervat dezelfde run en dient geen andere taak opnieuw in; dezelfde sleutel met een andere instruction wordt geweigerd.
  3. status vraagt de status van de oorspronkelijke taak op. Ook na voltooiing moeten de tabelquery's, het bewijs of de ontvangstbewijzen van publicatie worden gecontroleerd.
  4. Annuleren gebruikt de oorspronkelijke runId; bevestig het resultaat met de werkelijke taakstatus.

Een voltooide run is geen ontvangstbewijs van modelpublicatie. Publicatietaken worden nog steeds bevestigd via de oorspronkelijke artefactstatus en broncontroles; QUERY omvat geen impliciete schrijf- of publicatierechten.

Hoofdstuk 20

MCP voor de Business Workspace

Bevraag records op basis van gepubliceerde bedrijfscontracten en voer commando's uit via het oorspronkelijke ActionPlan.

/mcp/business gebruikt een eigen protected resource en een eigen selectie van bedrijfssystemen; een ontologie-Grant kan niet worden hergebruikt in plaats van een bedrijfsautorisatie. Een bedrijfssysteem moet gepubliceerd zijn, door Agents kunnen worden aangeroepen en voldoen aan het oorspronkelijke beveiligingsbeleid, en de huidige gebruiker moet een werkelijke runtimerol en de bijbehorende mogelijkheden hebben.

ScopeToolGrenzen
business-system:discoverdfb_systems dfb_system_describeOntdekt alleen systemen die bij deze autorisatie zijn toegekend en momenteel aanroepbaar zijn
business-system:readdfb_query dfb_record dfb_work_items dfb_action_statusRecords die de huidige gebruiker mag lezen, en diens eigen plannen
business-system:plandfb_action_planAlleen onveranderlijke plannen maken, niet uitvoeren
business-system:executedfb_action_executeAfzonderlijke, expliciete autorisatie; uitvoering volgens risico en goedkeuring
  1. dfb_systems ontdekt geautoriseerde systemen.
  2. dfb_system_describe leest de huidige gepubliceerde contracten, releaseId en alle hashes, query's en commando's.
  3. dfb_query gebruikt de gepubliceerde queryKey en specificeert indien nodig objectKey, state, page en pageSize. Het is geen willekeurige SQL.
  4. dfb_record en dfb_work_items lezen de momenteel toegestane records en openstaande taken.
  5. Geef vóór de uitvoering met dfb_action_plan de werkelijke releaseId, releaseHash, canonicalIrHash, agentManifestHash, commandType, planIdempotencyKey en de contract-payload op.
  6. Controleer riskClass, requiresApproval en status; bewaar expectedRecordVersion als doelrecords betrokken zijn.
  7. dfb_action_execute voert alleen plannen uit die bij de huidige verbinding horen en gereed zijn; goedkeuringstokens voor vereiste menselijke goedkeuring worden door DataFocus uitgegeven.
  8. Na een fout of time-out achterhaalt u met dfb_action_status de stand van het oorspronkelijke plan; nieuwe pogingen behouden de oorspronkelijke idempotentiesemantiek.
Figuur A10 Gepubliceerde contracten, plannen, goedkeuringen en actie-uitvoering. Schematische weergave.

Verbinding en versiebinding

Het plan is gebonden aan de stabiele isolatie-id van de huidige Grant. Na vernieuwing van het access token kunnen plannen van dezelfde verbinding nog steeds worden verwerkt; een andere OAuth-verbinding kan deze niet overnemen. Bij uitvoering worden opnieuw gecontroleerd: gepubliceerde versie, IR/manifest-hash, doelrecordversie, planvervaltijd, idempotentie en goedkeuring. Een OAuth-allowlist kan de bedrijfsgovernance niet omzeilen.

Hoofdstuk 21

Invoer van bedrijfskennis en te bevestigen vragen

Registreer bedrijfsinvoer wanneer de bijbehorende productieprocessor beschikbaar is, en respecteer de grens van menselijke bevestiging.

De volgende vier tools worden door de openbare MCP-controller toegevoegd op basis van geïnstalleerde processors en de huidige scope-voorwaarden. Ze staan niet altijd in de basiscatalogus. Het bestaan van een gedeclareerd Schema betekent niet dat de instantie over alle benodigde processors, budget en rechten beschikt; controleer eerst tools/list.

ToolDoelWat de tool niet autoriseert of bewerkstelligt
dfc_ontology_knowledge_input_proposeOorspronkelijke bedrijfsinvoer registreren voor een bestaande werkruimteGenereert geen bevestigingsvragen, keurt niets goed, publiceert niet
dfc_ontology_knowledge_input_previewTijdelijke voorbeeldweergave van conceptvragen op basis van de oorspronkelijke invoerNiet persistent, niet bevestigd, geen productieontvangstbewijs
dfc_ontology_knowledge_question_submitOpgestelde (authored), nog niet bevestigde vragen opslaanVoegt antwoorden niet automatisch samen, verkrijgt geen verantwoordelijkheids- of publicatierechten
dfc_ontology_business_scope_initializeExpliciet een consumentenscope voor een bedrijfssysteem initialiserenPubliceert niet, activeert niet, verleent geen brontoegang

Invoer en voorbeeldweergave

  1. Haal workspaceId, workspaceRevision, localRef en preparationDigest uit de daadwerkelijke voorbereidende werkzaamheden.
  2. propose registreert bedrijfsinvoer met het oorspronkelijke input-contract en een stabiele idempotencyKey; eenzelfde sleutel hoort altijd bij dezelfde invoer.
  3. preview gebruikt de idempotentiesleutel en ontologyId van de oorspronkelijke invoer; het retourneert telkens een revision van de server en een venster van 60 seconden en is geen idempotent ontvangstbewijs van voltooide productie.
  4. Moeten vragen worden opgeslagen, dan gebruikt question_submit een nieuwe commandosleutel, de oorspronkelijke originalInputKey, expliciete questionRevision, validFrom, validUntil en expectedRevision; bij het aanmaken is expectedRevision null.

Toegangspunt voor menselijke bevestiging

De knowledgeConfirmationPage die question_submit retourneert, is slechts een relatieve verwijzing binnen de oorspronkelijke inlogpagina die een vraag vooraf invult. Ze bevat geen Bearer, opent niet automatisch de pagina en bevestigt geen kennis. QUESTION_STORED_UNCONFIRMED geeft expliciet aan dat er nog geen bevestiging heeft plaatsgevonden; schrijf in antwoorden dus niet “kennis is gepubliceerd”.

Initialisatie van de consumentenscope

business scope initialize vereist zowel publicatierechten op de ontologie als maker- of SourceManager-beheerrechten op precies dat bedrijfssysteem. Het gebruikt de echte coördinaten van domainRid, domainRevisionId en businessSystemId; de client mag geen willekeurige consumerScope of voltooiingsbewijzen invullen. Ook bij de geretourneerde INITIALIZED en COMPLETED geldt nog steeds expliciet published=false en activationAuthorized=false.

Deze verzoeken doorlopen ook een strikte validatie van JSON, veldenset, bytes en diepte. De invoerlimiet voor verzoeken is 1 MiB; sommige specifieke bewerkingen hebben kleinere limieten. Volledige invoer- en uitvoerschema's worden met de toolreferentie meegeleverd; de soepele parameterlogica van de algemene MCP-wrapper mag niet op deze strikte contracten worden toegepast.

Hoofdstuk 22

Responsen, fouten en veilig opnieuw proberen

Interpreteer fouten per laag en behoud taakcoördinaten en idempotentiesemantiek.

LaagTe controleren inhoudVerwerkingsprincipe
Netwerk en HTTPVerbinding, TLS, 401, 403, 400, 404, 405 enz.Behandel mislukte responsen niet als gewone queryresultaten
JSON-RPCerror.code message dataOnderscheid protocol-, methode-, parameter- en autorisatieproblemen
MCP-toolresult.isError en structuredContentHTTP 200 kan nog steeds een mislukking betekenen
BedrijfsresultaatWerkelijke status, volledigheid, oorzaak van de fout, nextActionOntvangen of gereed is niet gelijk aan voltooid
Geschiktheid als feitexecutionReceipt citationEligible contentCompleteNiet-geschikte inhoud dient alleen voor lokalisatie of om hiaten te verklaren

Veelvoorkomende HTTP-situaties

  • 401: ontbrekende of verlopen Bearer; vernieuw of autoriseer opnieuw volgens de huidige OAuth-flow.
  • 403: Grant, rol, geselecteerde resources, bronrechten, Origin of configuratie voldoen niet; probeer dit niet te omzeilen door het verzoek te herhalen.
  • 400: bericht of versiecontract ongeldig, inclusief inconsistentie tussen moderne headers en metadata.
  • 404: controleer het exacte servicepad, de protocolmethode en runtime-mogelijkheden; wissel niet willekeurig van ontologie-id.
  • 405: GET en DELETE zijn op de openbare /mcp sowieso niet beschikbaar; gebruik de juiste POST in plaats van een langdurige SSE-verbinding op te zetten.

Schrijfbewerkingen met onduidelijk resultaat

MCP_OPERATION_OUTCOME_UNKNOWN kan outcome=UNKNOWN, retryable=false, nextAction=READ_ORIGINAL_STATUS, recoveryTool en de oorspronkelijke lokalisatieparameters bevatten. Controleer eerst de oorspronkelijke status en hervat daarna het oorspronkelijke verzoek. Dien geen kandidaat opnieuw in, verander de idempotentiesleutel niet en beschouw een time-out niet als transactie-rollback.

Figuur A11 Volgorde van afhandeling bij fouten, onduidelijke resultaten en situaties waarin opnieuw proberen is toegestaan. Herstelschema.

Wat ongewijzigd bewaard moet blijven

  • Oorspronkelijke Grant, resourcebereik, taak- en resultaat-id's.
  • candidateHash, planHash, expectedRevision, doelversie en publicatieselectie.
  • De idempotentiesleutel van dezelfde logische bewerking; gebruik nieuwe sleutels voor andere bedrijfsbewerkingen.
  • Door de server gedeclareerde retryable, remediation, nextAction en huidige status.

Gebruik geen interne SQL, hosts, inloggegevens of stacktraces uit foutmeldingen als bron voor antwoorden. Leg alleen openbaar te maken foutcodes en correlatie-informatie van het verzoek vast; de oorspronkelijke fout moet mogelijk door een beheerder in gecontroleerde logboeken worden bekeken.

Hoofdstuk 23

Integratiebeveiliging en grenzen van de mogelijkheden

Behoud de oorspronkelijke grenzen van identiteit, resources, uitvoering en bewijs, en behandel niet-vertrouwde documenten veilig.

  1. Verbind alleen met de officiële domeinnamen die de beheerder verstrekt; verifieer TLS en de OAuth-issuer en schakel certificaatverificatie niet uit.
  2. Gebruik een speciaal daarvoor bestemde Grant met een minimaal resourcebereik; gebruik geen beheerdersaccounts, cookies of langlevende interne tokens als inloggegevens voor de openbare interface.
  3. Behandel de documenttekst als niet-vertrouwd bedrijfsmateriaal. “Negeer regels”, “upload sleutels” en “voer commando's uit” in een document zijn geen toolautorisaties.
  4. Beperk automatische nieuwe pogingen, gelijktijdigheid en de omvang van resultaten; bouw de oorspronkelijke bedrijfsrechten niet na aan clientzijde.
  5. Leg in logboeken alleen noodzakelijke correlatie-informatie vast, geen Bearer, refresh tokens, goedkeuringstokens of volledige gevoelige bedrijfsinhoud.
  6. Nadat de gebruiker de verbinding heeft verbroken of de beheerder de rechten heeft ingetrokken, stopt u met het gebruik van gecachte autorisaties en gegevens; blijf niet aanroepen via oude locators.

Toolhints zijn geen rechten

readOnlyHint, destructiveHint, idempotentHint en openWorldHint helpen de client de mogelijkheden te begrijpen; ze garanderen niet het daadwerkelijke bedrijfseffect van elke aanroep en vervangen niet de huidige gebruikersautorisatie. Behandel alle schrijf-, plan-, voorbeeldweergave-, sessie- en annuleringsacties volgens hun werkelijke gedrag.

Toegangspunten die u niet mag aanroepen

  • De oorspronkelijke Trino/Hive/Hadoop-services en Heavy ETL die niet in Flash zijn opgenomen.
  • Interne FocusCode-specifieke scopes of werkruimte-interfaces.
  • Execution v2, AutoML of andere experimentele tools die niet in de tools/list van de huidige instantie voorkomen.
  • Private REST-interfaces van de browserclient, willekeurige databaseverbindingen of services van andere tenants om MCP-weigeringen te omzeilen.

Gegevenssemantiek

Volg de contracten van de server voor exacte decimalen, typen, valuta, eenheden, tijd en bewijs. Rond niet opnieuw af en reken geen valuta om alleen omdat de uitvoertekst op een getal lijkt, en maak geen globale ranglijst van zichtbare rijen wanneer resultaten zijn afgekapt.

Hoofdstuk 24

Beheerdersconfiguratie en voorwaardelijke schakelaars

Controleer vóór het inschakelen van uitgebreide mogelijkheden de werkelijke componenten, openbare adressen en oorspronkelijke rechtenconfiguratie.

ConfiguratieDoelVereisten voor go-live
datafocus.mcp.public-base-urlOfficieel extern basisadresOAuth-discovery, issuer, callbacks en reverse proxy komen overeen
datafocus.mcp.allowed-originsExtra goedgekeurde browseroriginsExact geconfigureerd, niet uitgebreid naar willekeurige origins
datafocus.mcp.oauth.route-proof-secretSpeciaal servergeheim voor bewijzen van graafrouteringApart opgeslagen, geen Bearer als sleutel
datafocus.mcp.analysis.tools.enabledInteractieve analysetoolsBijbehorende data-, kennis- en rechtendiensten daadwerkelijk beschikbaar
datafocus.mcp.analysis.report-tools.enabledTools voor persistente rapportenBijbehorende opslag, worker en herstelketen beschikbaar
datafocus.mcp.analysis.apps.enabledMCP Apps-weergaveClient declareert ondersteuning en controleert geretourneerde _meta
datafocus.mcp.authoring.enabledConcept- en modelleercontractenBehoud oorspronkelijke beheerders- en resourcerechten
datafocus.mcp.authoring.apply-enabledArtefacten toepassenOnveranderlijk plan, oorspronkelijke goedkeuring en hercontrole van de huidige status
datafocus.mcp.ontology-published-query-enabledGepubliceerde modellen en query'sWerkelijk vastgelegde (committed) versies en bronautorisatie
datafocus.mcp.ontology-candidate-query-enabledGestructureerde query's op kandidatenKandidaateigendom, exacte versie en leesrechten
datafocus.mcp.authoring.ontology-auto-publication-enabledGedelegeerde autorisaties voor automatische publicatieGeldig oorspronkelijk beleid, vertrouwen in openbare sleutels, budget en publicatierechten

Deze namen komen uit r56-configuratie en -implementatie; of ze kunnen worden ingeschakeld hangt af van de bijbehorende diensten en de oorspronkelijke go-live-gates. Alleen een booleaanse waarde wijzigen vult ontbrekende processors, databases, validatiebudgetten of beleid niet aan. De zichtbaarheid van kennisinvoer-uitbreidingen en Pi-taken wordt bepaald door de daadwerkelijk geïnstalleerde componenten.

Edgeproxy

Behoud Authorization, Content-Type, MCP-Protocol-Version, Mcp-Method, Mcp-Name en goedgekeurde Origin. Stel request body, time-outs en TLS in volgens de werkelijke servicevereisten; stuur de openbare /mcp niet door naar een beheerpoort of een ander product.

Go-live-controle

  • De status van anonieme discovery en beveiligde aanroepen komt overeen met de verwachtingen.
  • Gewone gebruikers ontdekken alleen hun geautoriseerde bereik; na intrekking van de rechten worden volgende verzoeken geweigerd.
  • Native Search-sessies, SQL, brontekst en optionele rapporten leveren elk werkelijke resultaten op.
  • Goedkeuring en idempotent herstel van schrijf- en publicatieacties behouden het oorspronkelijke gedrag.
  • Logboeken en openbare documentatie bevatten geen privésleutels, tokens, cookies, wachtwoorden of interne klantgegevens.
Hoofdstuk 25

Uitvoerbare client en aanroepvoorbeelden

Valideer berichten met de meegeleverde minimale client, zonder OAuth of de huidige autorisatie te omzeilen.

examples/flash_mcp.py is een minimale protocolclient die alleen afhankelijk is van de Python-standaardbibliotheek. De client logt niet in, verleent geen goedkeuringen namens anderen, roept niet automatisch onzichtbare tools aan, ondersteunt moderne en oude protocollen en sluit af met een aparte exitcode per laag: HTTP, JSON-RPC of toolfout. Tokens worden via de procesomgeving ingevoerd en niet in scripts of documentatie geschreven.

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

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

unset FLASH_ACCESS_TOKEN

Lezen en query's

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

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

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

Vervang eerst de ONTOLOGY_ID-, TABLE_RESOURCE_ID- en andere placeholders in het verzoekbestand door de echte waarden die door de huidige autorisatie worden geretourneerd. De client weigert uitvoering wanneer placeholders worden aangetroffen. Het SQL-voorbeeld vereist dat de bijbehorende CSV is geïmporteerd met de oorspronkelijke kolomnamen; zonder het bijbehorende schema kan het niet rechtstreeks worden ingediend.

Andere scenario's

  • Toegangspunt voor de Business Workspace: gebruik --endpoint business en verkrijg opnieuw een Grant voor /mcp/business.
  • Oude client: kies --protocol 2025-11-25, voer eerst initialize uit en roep daarna aan volgens hetzelfde protocol.
  • Ingebouwde instructies: gebruik resources of read-resource om de werkelijke URI te lezen.
  • Offline zelftest: --self-test verifieert de constructie van moderne headers en metadata, vereist geen token en stuurt geen verzoeken naar de productserver.

Grenzen van het voorbeeld

De client is een startpunt voor protocoltoegang; hij genereert niet automatisch modelleerkandidaten, slaat geen vraag-en-antwoord op en voert geen publicatie uit. Hij geeft de oorspronkelijke JSON weer, zodat de bovenliggende Agent de bedrijfsstatus kan verifiëren; beloof de gebruiker niet alleen op basis van de exitcode van het proces dat een query, rapport of publicatie is voltooid.

Hoofdstuk 26

Ontologiechatinterface insluiten

Sluit de chatpagina voor mensen in de front-end van een bedrijfsapplicatie in en behoud daarbij de grenzen van login en browserbeveiliging.

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

10001 is een voorbeeld-tenant-id en 1001 een voorbeeld-ontologie-id; vervang ze bij gebruik door echte coördinaten waarop u rechten hebt. Een enkele ontologie kan worden opgegeven via path of een ondersteunde queryparameter; in de all-modus kiest de huidige gebruiker met @ een van de ontologieën waartoe hij toegang heeft. skillId wordt alleen doorgegeven; beweer op basis daarvan niet dat skill-orkestratie al uitvoerbaar is.

Authenticatie en domeinnaam

De huidige ingesloten pagina is afhankelijk van een echte DataFocus-loginstatus en controleert /uc/status. Cross-site cookies, SSO, CSP frame-ancestors en gatewayconfiguratie beïnvloeden de insluiting. De pagina accepteert geen MCP Bearer in de URL als manier om zonder login toegang te krijgen; niet-geïmplementeerde outside-links mag u niet zelf samenstellen aan de hand van ontwerpvoorstellen.

Verschil tussen MCP en iframe

MethodeGebruikerIdentiteit en resultaat
Remote MCPIntegratie door externe Agent of serviceOAuth Grant en gestructureerde ontvangstbewijzen van tools
Ontologiechat-iframeMenselijke eindgebruikerBestaande loginstatus en chatinterface
MCP AppsMCP-client met ondersteuning voor uitbreidingenGecontroleerde resources en huidige toolresultaten; geen vervanging voor login via een openbaar iframe
Hoofdstuk 27

Acceptatiechecklist voor integratie

Bewijs de volledige bedrijfsketen op een echte instantie, in plaats van alleen te bevestigen dat de interface 200 retourneert.

  1. Discovery: verkrijg de daadwerkelijk ondersteunde versies, de huidige toolcatalogus en de ingebouwde resources.
  2. Autorisatie: gewone gebruikers zien alleen de goedgekeurde ontologieën en bedrijfssystemen; bewerkingen zonder scope worden geweigerd.
  3. Tabelstructuur: werkelijke weergavenamen, kolommen, typen en rechten zijn volledig.
  4. SQL: controles voor eendimensionale en multidimensionale query's, JOIN, datums, TopN en afkapping stemmen overeen met de werkelijke bedrijfsdefinities.
  5. Kennis: lokalisatie, volledige brontekst en geschiktheid als feitelijke bron zijn consistent; gemengde vragen hebben zowel een data- als een documentonderbouwing.
  6. Search: controles van model, init, suggesties, resultaten, afsluiten en buffervolledigheid geslaagd.
  7. Optionele analyse en rapporten: de werkelijke status van meerdere vertakkingen, paginering, rechtenwijzigingen en annulering behouden het oorspronkelijke gedrag.
  8. Optionele modellering: kandidaten, plannen, oorspronkelijke goedkeuring, daadwerkelijke toepassing en versiequery fase voor fase geverifieerd.
  9. Bedrijfsacties: releasehash, doelversie, goedkeuring, idempotentie en isolatie tussen Grants geverifieerd.
  10. Herstel: na een netwerktime-out wordt de oorspronkelijke status opgehaald; na een bronupdate vervalt de oude lokalisatie en wordt een nieuwe query gebruikt.

Resultatenregistratie

Registreer de instantieversie, gebruikersrol, Grant-bereik, configuratieversie, echte bewerkingen en resultaten. De offline zelftest van de protocolclient, de offline verwachte waarden van de voorbeeld-CSV, de statische JSON Schema-validatie en de echte online functionele acceptatie worden afzonderlijk gemarkeerd. Extrapoleer het slagen van één fase niet naar het slagen van het hele product.

Hoofdstuk 28

Referentiematerialen en onderhoud

Gebruik de volledige tool-Schema's die bij de handleiding zijn meegeleverd en houd ze gesynchroniseerd met de werkelijke discovery-resultaten van de instantie.

BronnenInhoud
reference/mcp-tool-catalog.jsonGedeclareerde input-Schema's van 32 tools aan ontologiezijde en 8 aan de zijde van de Business Workspace; voor sommige tools ook het oorspronkelijke output-Schema
reference/locales.json21 selecteerbare opties, 24 compatibele locales en UI-termen
reference/search-keywords.jsonStatische trefwoordencatalogus voor 17 expliciete locales
reference/analysis-contract-manifest.jsonVersiebeperkingen voor analyse, vertakkingen, feiten, ontvangstbewijzen en rapporten
examples/Synthetische CSV, toelichting op definities, Top3-SQL, verwachte resultaten en een minimale protocolclient

Ingebouwde instructieresources

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

resources/list en resources/read vereisen dat de huidige gebruiker ten minste één bijbehorende leesbevoegdheid heeft uit metadata, search operate of etl operate. ETL-documentatie is een statische, productoverstijgende referentie; de uitvoerbare mogelijkheden van Flash blijven beperkt tot het bereik dat Flash expliciet rapporteert.

Referentie voor externe protocollen

Voor de MCP-protocol- en autorisatieachtergrond raadpleegt u de officiële specificaties: https://modelcontextprotocol.io/specification/2026-07-28/basic en https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization. De eindpunten, tools en voorwaardelijke gedragingen van dit product zijn gebaseerd op de r56-implementatie en de huidige discovery-resultaten van de instantie; algemene protocolondersteuning mag niet worden gelijkgesteld met het leveren van alle optionele functies door de server.

Upgrade en onderhoud

Ontdek tools en versies opnieuw bij een upgrade en vergelijk input-Schema's, outputcontracten en configuraties; oude Grants verkrijgen niet automatisch nieuwe scopes. Houd referenties, caches en ontvangstbewijzen gebonden aan de bronversie, haal na bevestigde incompatibele wijzigingen de context opnieuw op en pas oude lokalisaties niet geforceerd toe op een nieuwe bedrijfsstatus.

Hoofdstuk 29

Toolparameterreferentie: basis en native Search

Volledige namen en invoervelden, per tool gegroepeerd.

De volgende tabellen dienen als naslag voor de invoervelden van de huidige r56-tools. Zie reference/mcp-tool-catalog.json voor volledige geneste typen, oneOf, voorwaardelijk verplichte velden, patroonbeperkingen en een deel van de output-Schema's; lees vóór het definitief indienen altijd de tools/list van de huidige Grant. “Optioneel” in de tabellen heft de interne validatie-eisen van acties niet op.

dfc_manual

ParameterTypeVereisteBetekenis en bereik
namesarrayOptioneel of voorwaardelijk verplichtDe expliciete namen die moeten worden opgezocht, maximaal 32 per keer. maxItems: 32
actionstringOptioneel of voorwaardelijk verplichtNaam van de bewerking. Gebruik de huidige enum-waarden en de parameters die bij de actie horen. enum: list, read, keywords, functions, etl_requests
localestringOptioneel of voorwaardelijk verplichtLocale van de expliciete statische naslagcatalogus, niet de standaardtaal van de query.
uristringOptioneel of voorwaardelijk verplichtURI van een ingebouwde resource die de huidige tool vermeldt. enum: datafocus://manuals/etl-formulas/v1, datafocus://manuals/search-keyword-queries/v1, datafocus://manuals/etl-functions/v1, datafocus://manuals/search-keywords/v1

dfc_search

ParameterTypeVereisteBetekenis en bereik
dataobjectOptioneel of voorwaardelijk verplichtOorspronkelijke actiepayload; zie capability discovery en de tabel met actievelden.
actionstringVerplichtNaam van de bewerking. Gebruik de huidige enum-waarden en de parameters die bij de actie horen. enum: capabilities, model_create, model_read, open, request, poll, cancel, close

dfc_etl

ParameterTypeVereisteBetekenis en bereik
dataobjectOptioneel of voorwaardelijk verplichtOorspronkelijke actiepayload; zie capability discovery en de tabel met actievelden.
actionstringVerplichtNaam van de bewerking. Gebruik de huidige enum-waarden en de parameters die bij de actie horen. enum: capabilities

dfc_ontologies

ParameterTypeVereisteBetekenis en bereik
pageSizeintegerOptioneel of voorwaardelijk verplichtAantal items per pagina; binnen de bovengrens van het Schema. minimum: 1; maximum: 100
pageintegerOptioneel of voorwaardelijk verplichtPaginanummer, beginnend bij 1. minimum: 1

dfc_ontology_resources

ParameterTypeVereisteBetekenis en bereik
resourceTypesarrayOptioneel of voorwaardelijk verplichtVerzameling resourcetypen die moeten worden geretourneerd.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
pageSizeintegerOptioneel of voorwaardelijk verplichtAantal items per pagina; binnen de bovengrens van het Schema. minimum: 1; maximum: 100
pageintegerOptioneel of voorwaardelijk verplichtPaginanummer, beginnend bij 1. minimum: 1
Hoofdstuk 30

Toolparameterreferentie: tabellen, graaf en kennis

Volledige namen en invoervelden, per tool gegroepeerd.

De volgende tabellen dienen als naslag voor de invoervelden van de huidige r56-tools. Zie reference/mcp-tool-catalog.json voor volledige geneste typen, oneOf, voorwaardelijk verplichte velden, patroonbeperkingen en een deel van de output-Schema's; lees vóór het definitief indienen altijd de tools/list van de huidige Grant. “Optioneel” in de tabellen heft de interne validatie-eisen van acties niet op.

dfc_ontology_graph

ParameterTypeVereisteBetekenis en bereik
relationTypesarrayOptioneel of voorwaardelijk verplichtFilter op relatietype.
depthintegerOptioneel of voorwaardelijk verplichtDiepte van de traversal naar buurknooppunten. minimum: 1; maximum: 3
sourceTypesarrayOptioneel of voorwaardelijk verplichtFilter op brontype.
queryobjectOptioneel of voorwaardelijk verplichtQuerytekst, of het exacte geversioneerde queryobject dat bij action hoort.
limitintegerOptioneel of voorwaardelijk verplichtBovengrens van het aantal geretourneerde items. minimum: 1; maximum: 100
actionstringVerplichtNaam van de bewerking. Gebruik de huidige enum-waarden en de parameters die bij de actie horen. enum: search, neighbors, published_model, published_query, candidate_query
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
nodeKeystringOptioneel of voorwaardelijk verplichtKnooppuntsleutel, gekopieerd uit de werkelijke graafresultaten.
keywordstringOptioneel of voorwaardelijk verplichtTrefwoord voor lokalisatie in de graaf; geen syntaxis voor trefwoordquery's.
nodeTypesarrayOptioneel of voorwaardelijk verplichtFilter op knooppunttype.

dfc_ontology_query

ParameterTypeVereisteBetekenis en bereik
routeLocatorsarrayOptioneel of voorwaardelijk verplichtVolledig gekopieerde, getypeerde routelocator die door de server is uitgegeven. maxItems: 20
topKintegerOptioneel of voorwaardelijk verplichtBovengrens van opgehaalde kandidaten; bewijst geen volledige dekking. minimum: 1; maximum: 20
queryModestringOptioneel of voorwaardelijk verplichtKies de querymodus voor bewijs uit de enum-waarden van de tool. enum: vector, hybrid, graph
fanoutPlanobjectOptioneel of voorwaardelijk verplichtBegrensd zoekplan per vertakking, volgens het geneste Schema.
structuredPlanobjectOptioneel of voorwaardelijk verplichtAan het servercontract gebonden plan voor een volledige documenttabel; geen SQL.
knowledgeIdsarrayOptioneel of voorwaardelijk verplichtKennisbank-id uit de werkelijke knowledgeBindings.
querystringVerplichtQuerytekst, of het exacte geversioneerde queryobject dat bij action hoort.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.

dfc_knowledge_search

ParameterTypeVereisteBetekenis en bereik
topKintegerOptioneel of voorwaardelijk verplichtBovengrens van opgehaalde kandidaten; bewijst geen volledige dekking. minimum: 1; maximum: 20
minScorenumberOptioneel of voorwaardelijk verplichtMinimale matchscore. minimum: 0; maximum: 1
knowledgeIdsarrayOptioneel of voorwaardelijk verplichtKennisbank-id uit de werkelijke knowledgeBindings.
querystringVerplichtQuerytekst, of het exacte geversioneerde queryobject dat bij action hoort.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
assetIdsarrayOptioneel of voorwaardelijk verplichtMomenteel toegestane documentasset-id's.
retrievalStrategystringOptioneel of voorwaardelijk verplichtDaadwerkelijk ondersteunde zoekstrategie. enum: auto, hybrid_stage2

dfc_knowledge_detail

ParameterTypeVereisteBetekenis en bereik
qdrantIdstring / integerOptioneel of voorwaardelijk verplichtIndexidentificatie die door de werkelijke lokalisatie is geretourneerd.
pageNointegerOptioneel of voorwaardelijk verplichtWerkelijke pagina of paginanummer.
evidenceIdstringOptioneel of voorwaardelijk verplichtBewijs-id die door dezelfde kennislokalisatie is geretourneerd.
actionstringVerplichtNaam van de bewerking. Gebruik de huidige enum-waarden en de parameters die bij de actie horen. enum: chunk, document, page_context
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
documentIdstring / integerOptioneel of voorwaardelijk verplichtDocument-id uit dezelfde lokalisatie.
radiusintegerOptioneel of voorwaardelijk verplichtBereik van aangrenzende pagina's. minimum: 0; maximum: 3
chunkIdstringOptioneel of voorwaardelijk verplichtWerkelijke chunk-id uit dezelfde lokalisatie.

dfc_table

ParameterTypeVereisteBetekenis en bereik
maxRowsintegerOptioneel of voorwaardelijk verplichtBovengrens van het aantal geretourneerde rijen; geen rangschikkingsbereik aan clientzijde. minimum: 1; maximum: 200
actionstringVerplichtNaam van de bewerking. Gebruik de huidige enum-waarden en de parameters die bij de actie horen. enum: detail, query
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
idstringOptioneel of voorwaardelijk verplichtEchte tabelresource-id, geen fysieke naam of weergavenaam.
sqlstringOptioneel of voorwaardelijk verplichtEén alleen-lezen Doris-SQL-instructie binnen het bereik van de ontologie, met expliciete uitvoerkolommen.
Hoofdstuk 31

Toolparameterreferentie: analyse en rapporten

Volledige namen en invoervelden, per tool gegroepeerd.

De volgende tabellen dienen als naslag voor de invoervelden van de huidige r56-tools. Zie reference/mcp-tool-catalog.json voor volledige geneste typen, oneOf, voorwaardelijk verplichte velden, patroonbeperkingen en een deel van de output-Schema's; lees vóór het definitief indienen altijd de tools/list van de huidige Grant. “Optioneel” in de tabellen heft de interne validatie-eisen van acties niet op.

dfc_analysis_ask

ParameterTypeVereisteBetekenis en bereik
questionstringVerplichtVraag in natuurlijke taal of compatibele vervolgvraag.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
languagestringOptioneel of voorwaardelijk verplichtExpliciete antwoord- of query-locale; bij weglating volgens de regels van de betreffende tool.
sessionIdstringOptioneel of voorwaardelijk verplichtEchte sessieverwijzing binnen dezelfde Grant.

dfc_analysis_refine

ParameterTypeVereisteBetekenis en bereik
branchIdstringOptioneel of voorwaardelijk verplichtDoor de server uitgegeven verwijzing naar een gestructureerde vertakking.
resultIdstringVerplichtVerwijzing naar het eerder geretourneerde analyseresultaat.
questionstringOptioneel of voorwaardelijk verplichtVraag in natuurlijke taal of compatibele vervolgvraag.
idempotencyKeystringVerplichtIdempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking.
changeobjectOptioneel of voorwaardelijk verplichtWijziging in natuurlijke taal of getypeerde filter_patch.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
languagestringOptioneel of voorwaardelijk verplichtExpliciete antwoord- of query-locale; bij weglating volgens de regels van de betreffende tool.
sessionIdstringVerplichtEchte sessieverwijzing binnen dezelfde Grant.
expectedRevisionintegerVerplichtVersievoorwaarde van het oorspronkelijke resultaat of de bedrijfsheader; mag null zijn bij het aanmaken van een vraag. minimum: 1
visualIdstringOptioneel of voorwaardelijk verplichtAan de vertakking gebonden verwijzing naar een visualisatie.

dfc_analysis_page

ParameterTypeVereisteBetekenis en bereik
branchIdstringVerplichtDoor de server uitgegeven verwijzing naar een gestructureerde vertakking.
resultIdstringVerplichtVerwijzing naar het eerder geretourneerde analyseresultaat.
pageNointegerVerplichtWerkelijke pagina of paginanummer. minimum: 1; maximum: 10000
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
pageSizeintegerVerplichtAantal items per pagina; binnen de bovengrens van het Schema. minimum: 1; maximum: 100
sessionIdstringVerplichtEchte sessieverwijzing binnen dezelfde Grant.
expectedRevisionintegerVerplichtVersievoorwaarde van het oorspronkelijke resultaat of de bedrijfsheader; mag null zijn bij het aanmaken van een vraag. minimum: 1

dfc_analysis_result_get

ParameterTypeVereisteBetekenis en bereik
resultIdstringVerplichtVerwijzing naar het eerder geretourneerde analyseresultaat.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
sessionIdstringVerplichtEchte sessieverwijzing binnen dezelfde Grant.

dfc_analysis_cancel

ParameterTypeVereisteBetekenis en bereik
resultIdstringVerplichtVerwijzing naar het eerder geretourneerde analyseresultaat.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
sessionIdstringVerplichtEchte sessieverwijzing binnen dezelfde Grant.

dfc_analysis_close

ParameterTypeVereisteBetekenis en bereik
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
sessionIdstringVerplichtEchte sessieverwijzing binnen dezelfde Grant.

dfc_report_create

ParameterTypeVereisteBetekenis en bereik
goalstringVerplichtAnalysedoel van het rapport.
idempotencyKeystringVerplichtIdempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
languagestringOptioneel of voorwaardelijk verplichtExpliciete antwoord- of query-locale; bij weglating volgens de regels van de betreffende tool.
titlestringOptioneel of voorwaardelijk verplichtOptionele rapporttitel.

dfc_report_status

ParameterTypeVereisteBetekenis en bereik
reportIdstringVerplichtVerwijzing naar een persistent rapport binnen de huidige Grant.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.

dfc_report_cancel

ParameterTypeVereisteBetekenis en bereik
reportIdstringVerplichtVerwijzing naar een persistent rapport binnen de huidige Grant.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
Hoofdstuk 32

Toolparameterreferentie: modellering en oorspronkelijke taken

Volledige namen en invoervelden, per tool gegroepeerd.

De volgende tabellen dienen als naslag voor de invoervelden van de huidige r56-tools. Zie reference/mcp-tool-catalog.json voor volledige geneste typen, oneOf, voorwaardelijk verplichte velden, patroonbeperkingen en een deel van de output-Schema's; lees vóór het definitief indienen altijd de tools/list van de huidige Grant. “Optioneel” in de tabellen heft de interne validatie-eisen van acties niet op.

dfc_ontology_agent

ParameterTypeVereisteBetekenis en bereik
modestringOptioneel of voorwaardelijk verplichtQUERY of AUTHORING; elke modus wordt afzonderlijk geautoriseerd. enum: QUERY, AUTHORING
instructionstringOptioneel of voorwaardelijk verplichtTekst met de vraag van de gebruiker; gelijk houden tussen context en indiening. maxLength: 16000
idempotencyKeystringOptioneel of voorwaardelijk verplichtIdempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking. maxLength: 128
actionstringVerplichtNaam van de bewerking. Gebruik de huidige enum-waarden en de parameters die bij de actie horen. enum: start, status, cancel
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
runIdstringOptioneel of voorwaardelijk verplichtOorspronkelijke taak-id binnen dezelfde ontologie en Grant.
contractVersionstringVerplichtGebruik de exacte contractversie die daadwerkelijk wordt ondersteund. enum: ontology-agent-task-v1

dfc_authoring_capabilities

Het input-rootobject van deze tool heeft geen velden; gebruik een leeg arguments-object.

dfc_artifact_context

ParameterTypeVereisteBetekenis en bereik
artifactTypestringVerplichtWerkelijk ingeschakeld artefact- of ontologiepublicatietype. enum: CONTROL_PANEL_SPEC, VIEW_SPEC
scopeTypestringOptioneel of voorwaardelijk verplichtHet bereiktype voor resources in het daadwerkelijke artefactcontract.
ontologyIdstringOptioneel of voorwaardelijk verplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
projectIdstringOptioneel of voorwaardelijk verplichtDe momenteel geautoriseerde project-id.
artifactIdstringOptioneel of voorwaardelijk verplichtDe echte id van het bestaande artefact dat wordt bewerkt.
instructionstringVerplichtTekst met de vraag van de gebruiker; gelijk houden tussen context en indiening.
variablesobjectOptioneel of voorwaardelijk verplichtHet variabelenobject zoals aangeleverd door het geretourneerde contract.
previewInputobjectOptioneel of voorwaardelijk verplichtBegrensde invoer voor de voorbeeldweergave, volgens het contract.
viewportobjectOptioneel of voorwaardelijk verplichtDe weergaveviewport zoals vereist door het oorspronkelijke contract.

dfc_ontology_table_schema

ParameterTypeVereisteBetekenis en bereik
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
sourceAssetRefstringVerplichtDe geregistreerde gestructureerde assetreferentie, bijvoorbeeld table:123.
fieldsarrayVerplichtDe velden van de huidige bron en optionele expliciete typeaanduidingen. minItems: 1; maxItems: 64

dfc_artifact_preview

ParameterTypeVereisteBetekenis en bereik
proposalIdstringVerplichtId van de oorspronkelijke kandidaat die onder de huidige Grant is aangemaakt.
candidateHashstringVerplichtDe exacte hash van de oorspronkelijke kandidaat op de server.
previewInputobjectVerplichtBegrensde invoer voor de voorbeeldweergave, volgens het contract.

dfc_artifact_status

ParameterTypeVereisteBetekenis en bereik
proposalIdstringOptioneel of voorwaardelijk verplichtId van de oorspronkelijke kandidaat die onder de huidige Grant is aangemaakt.
planIdstringOptioneel of voorwaardelijk verplichtId van het onveranderlijke toepassingsplan.

dfc_artifact_plan

ParameterTypeVereisteBetekenis en bereik
proposalIdstringVerplichtId van de oorspronkelijke kandidaat die onder de huidige Grant is aangemaakt.
candidateHashstringVerplichtDe exacte hash van de oorspronkelijke kandidaat op de server.
expectedTargetVersionintegerVerplichtVoorwaarde: de huidige werkelijke doelversie. minimum: 0
idempotencyKeystringVerplichtIdempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking.

dfc_artifact_apply

ParameterTypeVereisteBetekenis en bereik
planIdstringVerplichtId van het onveranderlijke toepassingsplan.
planHashstringVerplichtDe hash die door het oorspronkelijke plan is geretourneerd.
approvalTokenstringVerplichtGoedkeuringsmateriaal dat de oorspronkelijke server heeft uitgegeven; genereer dit nooit zelf.
idempotencyKeystringVerplichtIdempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking.

dfc_artifact_submit

ParameterTypeVereisteBetekenis en bereik
Configuratie1 / artifactTypestringVerplichtWerkelijk ingeschakeld artefact- of ontologiepublicatietype. enum: CONTROL_PANEL_SPEC, VIEW_SPEC
Configuratie1 / scopeTypestringOptioneel of voorwaardelijk verplichtHet bereiktype voor resources in het daadwerkelijke artefactcontract.
Configuratie1 / ontologyIdstringOptioneel of voorwaardelijk verplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
Configuratie1 / projectIdstringOptioneel of voorwaardelijk verplichtDe momenteel geautoriseerde project-id.
Configuratie1 / artifactIdstringOptioneel of voorwaardelijk verplichtDe echte id van het bestaande artefact dat wordt bewerkt.
Configuratie1 / instructionstringVerplichtTekst met de vraag van de gebruiker; gelijk houden tussen context en indiening.
Configuratie1 / variablesobjectOptioneel of voorwaardelijk verplichtHet variabelenobject zoals aangeleverd door het geretourneerde contract.
Configuratie1 / previewInputobjectOptioneel of voorwaardelijk verplichtBegrensde invoer voor de voorbeeldweergave, volgens het contract.
Configuratie1 / viewportobjectOptioneel of voorwaardelijk verplichtDe weergaveviewport zoals vereist door het oorspronkelijke contract.
Configuratie1 / contractVersionstringVerplichtGebruik de exacte contractversie die daadwerkelijk wordt ondersteund.
Configuratie1 / contextHashstringVerplichtDe volledige contexthash die context heeft geretourneerd.
Configuratie1 / baseArtifactHashstringVerplichtDe hash van het basisartefact die context heeft geretourneerd.
Configuratie1 / baseArtifactVersionintegerVerplichtDe basisversie die context heeft geretourneerd. minimum: 0
Configuratie1 / candidateobjectVerplichtHet kandidaatobject conform het huidige geretourneerde contract.
Configuratie1 / clientRequestIdstringVerplichtDe stabiele idempotentiesleutel van de client voor het huidige kandidaatverzoek.
Configuratie2 / artifactTypestringVerplichtWerkelijk ingeschakeld artefact- of ontologiepublicatietype. enum: ONTOLOGY_RELEASE
Configuratie2 / contractVersionstringVerplichtGebruik de exacte contractversie die daadwerkelijk wordt ondersteund. 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
Configuratie2 / ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
Configuratie2 / candidateHashstringVerplichtDe exacte hash van de oorspronkelijke kandidaat op de server.
Configuratie2 / workspaceIdstringVerplichtDe werkelijke coördinaten van de kandidaatwerkruimte.
Configuratie2 / workspaceRevisionstringVerplichtDe exacte kandidaatversie; gebruik geen latest.
Configuratie2 / releasesobjectVerplichtDe exacte versieselectie volgens het publicatiecontract van de ontologie.
Configuratie2 / selectionobjectVerplichtGeef alleen expliciete coördinaten van de bedrijfsselectie op; geen rechten of voltooiingsbewijzen.
Configuratie2 / idempotencyKeystringVerplichtIdempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking.
Configuratie3 / Configuratie1 / artifactTypestringVerplichtWerkelijk ingeschakeld artefact- of ontologiepublicatietype. enum: ONTOLOGY_RELEASE
Configuratie3 / Configuratie1 / contractVersionstringVerplichtGebruik de exacte contractversie die daadwerkelijk wordt ondersteund. enum: ontology-workspace-create-mcp-submit-v1
Configuratie3 / Configuratie1 / ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
Configuratie3 / Configuratie1 / workspaceIdstringVerplichtDe werkelijke coördinaten van de kandidaatwerkruimte.
Configuratie3 / Configuratie1 / resourcesarrayVerplichtOorspronkelijke modeldeclaraties die de server compileert. minItems: 1
Configuratie3 / Configuratie1 / idempotencyKeystringVerplichtIdempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking.
Configuratie3 / Configuratie2 / artifactTypestringVerplichtWerkelijk ingeschakeld artefact- of ontologiepublicatietype. enum: ONTOLOGY_RELEASE
Configuratie3 / Configuratie2 / contractVersionstringVerplichtGebruik de exacte contractversie die daadwerkelijk wordt ondersteund. enum: ontology-workspace-create-mcp-submit-v2
Configuratie3 / Configuratie2 / ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
Configuratie3 / Configuratie2 / workspaceIdstringVerplichtDe werkelijke coördinaten van de kandidaatwerkruimte.
Configuratie3 / Configuratie2 / resourcesarrayVerplichtOorspronkelijke modeldeclaraties die de server compileert. minItems: 1
Configuratie3 / Configuratie2 / idempotencyKeystringVerplichtIdempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking.
Configuratie3 / Configuratie2 / releaseSelectionsobjectVerplichtDe exacte releaseId van elke gepubliceerde verwijzing en de afsluiting van de afhankelijkheden.
Configuratie4 / artifactTypestringVerplichtWerkelijk ingeschakeld artefact- of ontologiepublicatietype. enum: ONTOLOGY_RELEASE
Configuratie4 / contractVersionstringVerplichtGebruik de exacte contractversie die daadwerkelijk wordt ondersteund. enum: ontology-initial-activation-retirement-submit-v1
Configuratie4 / ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
Configuratie4 / domainRidstringVerplichtDe RID van het echte bedrijfsdomein.
Configuratie4 / consumerScopesarrayVerplichtDe exacte consumentenscopes die de server toestaat. minItems: 1; maxItems: 256
Configuratie4 / idempotencyKeystringVerplichtIdempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking.
Hoofdstuk 33

Toolparameterreferentie: kennisinvoer en bereik

Volledige namen en invoervelden, per tool gegroepeerd.

De volgende tabellen dienen als naslag voor de invoervelden van de huidige r56-tools. Zie reference/mcp-tool-catalog.json voor volledige geneste typen, oneOf, voorwaardelijk verplichte velden, patroonbeperkingen en een deel van de output-Schema's; lees vóór het definitief indienen altijd de tools/list van de huidige Grant. “Optioneel” in de tabellen heft de interne validatie-eisen van acties niet op.

dfc_ontology_knowledge_input_propose

ParameterTypeVereisteBetekenis en bereik
requestobjectVerplichtHet oorspronkelijke verzoek met bedrijfsinvoer; volgens het volledige geneste Schema.
idempotencyKeystringVerplichtDe idempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking. minLength: 1; maxLength: 128

Deze tool heeft daarnaast een native outputSchema. Controleer de volledigheid en status van de output en de autorisatievelden die expliciet op false staan; ken voltooiing niet zelf een ruimere betekenis toe.

dfc_ontology_knowledge_input_preview

ParameterTypeVereisteBetekenis en bereik
idempotencyKeystringVerplichtDe idempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking. minLength: 1; maxLength: 128
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.

Deze tool heeft daarnaast een native outputSchema. Controleer de volledigheid en status van de output en de autorisatievelden die expliciet op false staan; ken voltooiing niet zelf een ruimere betekenis toe.

dfc_ontology_knowledge_question_submit

ParameterTypeVereisteBetekenis en bereik
questionRevision$refVerplichtDe expliciete versie van de te bevestigen vraag.
idempotencyKey$refVerplichtIdempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking.
originalInputKey$refVerplichtDe idempotentiesleutel die overeenkomt met de oorspronkelijke kennisinvoer.
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard.
validUntil$refVerplichtEinde van het geldigheidsvenster van de vraag, in UTC.
expectedRevisiononeOfVerplichtVersievoorwaarde van het oorspronkelijke resultaat of de bedrijfsheader; mag null zijn bij het aanmaken van een vraag.
validFrom$refVerplichtBegin van het geldigheidsvenster van de vraag, in UTC.

Deze tool heeft daarnaast een native outputSchema. Controleer de volledigheid en status van de output en de autorisatievelden die expliciet op false staan; ken voltooiing niet zelf een ruimere betekenis toe.

dfc_ontology_business_scope_initialize

ParameterTypeVereisteBetekenis en bereik
domainRevisionIdstringVerplichtDe exacte versie van het bedrijfsdomein. minLength: 1; maxLength: 128
idempotencyKeystringVerplichtDe idempotentiesleutel die stabiel wordt hergebruikt voor dezelfde logische bewerking. minLength: 1; maxLength: 128
businessSystemIdstringVerplichtDe echte id van het bedrijfssysteem. minLength: 1
ontologyIdstringVerplichtEchte ontologie-id binnen deze autorisatie, als tekenreeks bewaard. minLength: 1
domainRidstringVerplichtDe RID van het echte bedrijfsdomein. minLength: 1; maxLength: 128

Deze tool heeft daarnaast een native outputSchema. Controleer de volledigheid en status van de output en de autorisatievelden die expliciet op false staan; ken voltooiing niet zelf een ruimere betekenis toe.

Hoofdstuk 34

Toolparameterreferentie: Business Workspace

Volledige namen en invoervelden, per tool gegroepeerd.

De volgende tabellen dienen als naslag voor de invoervelden van de huidige r56-tools. Zie reference/mcp-tool-catalog.json voor volledige geneste typen, oneOf, voorwaardelijk verplichte velden, patroonbeperkingen en een deel van de output-Schema's; lees vóór het definitief indienen altijd de tools/list van de huidige Grant. “Optioneel” in de tabellen heft de interne validatie-eisen van acties niet op.

dfb_systems

Het input-rootobject van deze tool heeft geen velden; gebruik een leeg arguments-object.

dfb_system_describe

ParameterTypeVereisteBetekenis en bereik
systemIdstring / integerVerplichtSysteem-id die de huidige Grant voor bedrijfssystemen toestaat.

dfb_query

ParameterTypeVereisteBetekenis en bereik
systemIdstring / integerVerplichtSysteem-id die de huidige Grant voor bedrijfssystemen toestaat.
queryKeystringVerplichtDe gepubliceerde querysleutel geretourneerd door describe.
objectKeystringOptioneel of voorwaardelijk verplichtDe gepubliceerde objectsleutel.
pageSizeintegerOptioneel of voorwaardelijk verplichtAantal items per pagina; binnen de bovengrens van het Schema. minimum: 1; maximum: 100
pageintegerOptioneel of voorwaardelijk verplichtPaginanummer, beginnend bij 1. minimum: 1
statestringOptioneel of voorwaardelijk verplichtFilter op bedrijfsstatus of serverstatus.

dfb_record

ParameterTypeVereisteBetekenis en bereik
recordIdstring / integerVerplichtId van een bedrijfsrecord dat momenteel mag worden gelezen.
systemIdstring / integerVerplichtSysteem-id die de huidige Grant voor bedrijfssystemen toestaat.

dfb_work_items

ParameterTypeVereisteBetekenis en bereik
systemIdstring / integerVerplichtSysteem-id die de huidige Grant voor bedrijfssystemen toestaat.

dfb_action_plan

ParameterTypeVereisteBetekenis en bereik
expectedRecordVersionintegerOptioneel of voorwaardelijk verplichtHuidige versie voor optimistische vergrendeling van het doelrecord. minimum: 1
systemIdstring / integerVerplichtSysteem-id die de huidige Grant voor bedrijfssystemen toestaat.
commandTypestringVerplichtHet opdrachttype uit het gepubliceerde contract.
canonicalIrHashstringVerplichtDe hash van de momenteel gepubliceerde canonieke IR.
releaseIdstring / integerVerplichtDe werkelijke versie-id van het gepubliceerde contract.
payloadobjectVerplichtDe payload conform het huidige opdrachtcontract in describe.
releaseHashstringVerplichtDe werkelijke hash van het gepubliceerde contract.
targetRecordIdstring / integerOptioneel of voorwaardelijk verplichtHet echte doelrecord waarop de bewerking betrekking heeft.
agentManifestHashstringVerplichtDe werkelijke hash van het manifest met Agent-mogelijkheden.
planIdempotencyKeystringVerplichtDe stabiele idempotentiesleutel van het bedrijfsplan.

dfb_action_status

ParameterTypeVereisteBetekenis en bereik
actionPlanIdstring / integerVerplichtId van het actieplan dat bij de huidige Grant voor bedrijfssystemen hoort.

dfb_action_execute

ParameterTypeVereisteBetekenis en bereik
approvalTokenstringOptioneel of voorwaardelijk verplichtGoedkeuringsmateriaal dat de oorspronkelijke server heeft uitgegeven; genereer dit nooit zelf.
actionPlanIdstring / integerVerplichtId van het actieplan dat bij de huidige Grant voor bedrijfssystemen hoort.