DATAFOCUS · OT FLASH · R56

OT Flash Agent- och MCP-integrationsmanual

Protokoll, auktorisering, verktygskontrakt och fullständigt anropsflöde

Använd den offentliga Remote MCP i OT Flash r56 för att bygga spårbara data- och kunskapsapplikationer. Manualen beskriver OAuth, protokollmeddelanden, en parameterreferens för alla deklarerade verktyg, bevisregler, villkorade funktioner och återställningsflöden, och innehåller körbara klienter samt exempel med syntetiska data.

Agentutvecklare, integrationsingenjörer och administratörer

De medföljande exemplen behåller kinesiska visningsnamn för fälten. Översättningen av gränssnittsspråket och den förklarande texten ändrar inte de faktiska tabellnamnen, kolumnnamnen, enumvärdena, verktygsnamnen eller protokollfälten.

Kapitel 1

Omfång och slutförandekriterier för agentintegration

Välj ingång för auktoriseringen och slutför frågor, bevisinhämtning eller kontrollerade skrivningar utifrån serverns kvitton.

OT Flash r56 erbjuder externa agenter data- och kunskapsförmågor inom ontologins omfång via Remote MCP, samt en separat ingång till affärsarbetsytan. En agent ska utgå från den faktiska tools/list, inputSchema, OAuth-scope och de aktuella resursbehörigheterna för att avgöra vad som kan utföras, och får inte utifrån en statisk manual anta att en driftsättning har alla valfria funktioner aktiverade.

Figur A1 Externa agenter använder befintliga fråge-, kunskaps- och affärsförmågor via OAuth och MCP. Illustration av gränssnittsrelationer.
IngångSyfteAvgränsning
/mcpOntologi, datatabeller, dokumentkunskap, inbyggd Search samt villkorligt tillgänglig analys och modelleringSnittet mellan den aktuella användarens behörigheter och de resurser som omfattas av den här auktoriseringen
/mcp/businessIdentifiering av affärssystem, frågor, åtgärdsplaner, status och exekveringSeparat auktorisering per affärssystem samt publicerade kontrakt
Inbäddad sida för ontologiagentOntologidialog i det mänskliga gränssnittetKräver en verklig inloggningssession och är inte en ingång för MCP-tokenutbyte utan inloggning

Funktionsklassificering

  • Grundläggande läsning: ontologi och resurser, graflokalisering, kunskapssökning och fullständig originaltext, detaljer om auktoriserade tabeller samt Doris SQL.
  • Separat delegering: dfc_search kräver search:operate och fortsätter använda den ursprungliga användarens och modellens behörigheter.
  • Villkorligt tillgängligt: analys, beständiga rapporter, artefaktutkast och tillämpning av dem, frågor mot ontologimodeller samt delegerade agentuppgifter.
  • Otillgängliga funktioner: Flashs dfc_etl rapporterar endast capabilities och tillhandahåller ingen ETL-exekvering motsvarande Heavy. AutoML och ingångar till den interna FocusCode-arbetsytan ingår inte i det offentliga Flash-API som beskrivs i den här manualen.

Kriterier för slutförande

Läsning av fakta kräver ett faktiskt användbart kvitto från en fråga eller en fullständig originaltext; för genererade kandidater måste det anges att de ännu inte har tillämpats; publicering kräver ett verkligt APPLIED-kvitto; vid avbrytande måste begäran och bekräftelse hållas isär. Svarstext, HTTP 200, att verktyget har tagit emot anropet eller att modellen beskriver något som ”slutfört” kan inte var för sig bevisa att en affärsåtgärd har lyckats.

Det medföljande reference/mcp-tool-catalog.json är en offlinereferens över de deklarationer som finns i r56. Den innehåller även villkorligt aktiverade definitioner och är inte någon användares aktuella tools/list. Den fullständiga katalogen omfattar 28 kärnverktyg för ontologi, 4 villkorade tillägg från kontrollern samt 8 verktyg på affärssidan, vilket inte innebär att alla är tillgängliga som standard.

Kapitel 2

Snabb anslutning och funktionsidentifiering

Börja med instansens officiella domän och identifiera faktiskt tillgängliga verktyg med minsta möjliga behörighet.

  1. Be administratören om den officiella HTTPS-rotadressen och om vilka ontologier eller affärssystem som ska nås. Använd inte dokumentationens exempeldomäner för anrop mot verkliga affärssystem.
  2. Konfigurera MCP-serveradressen som https://flash.example.com/mcp; affärsarbetsytan använder /mcp/business på samma domän.
  3. Starta OAuth-inloggning och auktorisering på det sätt som klienten stöder och kontrollera resurser och scope; skicka inte användarnamn och lösenord till MCP.
  4. Använd discovery eller initiering enligt den protokollgeneration som klienten använder och läs sedan tools/list och resursbeskrivningarna.
  5. Gör först en liten skrivskyddad förfrågan, kontrollera strukturerade resultat och fel, och genomför först därefter användarens uppgift.

Konfigurationsutdrag för klienten

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

Utdraget visar hur serveradressen är tänkt att konfigureras; konfigurationsfilens exakta struktur och OAuth-stödet beror på klienten. Ange aldrig verkliga access_token, refresh_token, cookies eller administratörslösenord i offentliga filer.

Discovery i det moderna protokollet

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

Kontroller före anslutning

  • Resursens rotadress, OAuth-issuer och den omvända proxyns externa adress stämmer överens.
  • Klienten stöder rätt protokollgeneration i stället för att alltid skicka initialize till ingången för det nya protokollet.
  • Aktuell auktorisering är kopplad till den ontologi eller det affärssystem som behövs.
  • Token är giltig och nya valfria scope har uttryckligen beviljats.
Kapitel 3

OAuth-discovery, registrering och auktorisering

Använd auktoriseringskod och PKCE; exponera inte produktens inloggningsuppgifter för agenten.

Figur A2 Flöde för OAuth-auktoriseringskod och PKCE. Sekvensdiagram.
SlutpunktMetodSyfte
/.well-known/oauth-protected-resourceGETDiscovery av ontologins MCP-resurs
/.well-known/oauth-protected-resource/mcpGETKompatibel discovery via ontologiresursens sökväg
/.well-known/oauth-protected-resource/mcp/businessGETDiscovery av affärs-MCP-resursen
/.well-known/oauth-authorization-serverGETMetadata för auktoriseringsservern
/oauth/registerPOST JSONDynamisk registrering av public client
/oauth/authorizeGET- eller POST-formulärInloggning, resursval och bekräftelse av auktorisering
/oauth/tokenPOST-formulärInlösen av auktoriseringskod och rotation av refresh-token
/oauth/revokePOST-formulärÅterkallelse av token
/oauth/grantsGETInloggade användare kan visa auktoriserade anslutningar
/oauth/grants/revokePOST-formulärÅterkalla anslutning via den ursprungliga sidans flöde

Steg i auktoriseringen

  1. Läs metadata för skyddade resurser och auktoriseringsservern. Ett 401-svar med WWW-Authenticate på en förfrågan utan token pekar på adressen för resursdiscovery.
  2. Registrera eller använd klientidentitet. r56:s dynamiska registrering av public client använder token_endpoint_auth_method=none; en klienthemlighet kan inte ersätta PKCE.
  3. Generera slumpmässig state och code_verifier samt beräkna S256 code_challenge.
  4. Öppna authorize-adressen som anges i metadata och skicka response_type=code, client_id, exakt redirect_uri, scope, resource, state, code_challenge och code_challenge_method=S256.
  5. Användaren loggar in i DataFocus och väljer ontologi eller affärssystem. Klienten får inte i förväg välja resurser som användaren saknar åtkomst till.
  6. Ta emot återanropet, verifiera state och issuer och lös in auktoriseringskoden med den ursprungliga code_verifier.
  7. Använd endast access_token för MCP Bearer-autentisering. Förnya via det ursprungliga OAuth-flödet och spara den roterade refresh_token på ett säkert sätt.

Registreringsexempel

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"]
}

Webbklienters återanropsadress använder HTTPS; native-klienter kan använda loopback-adresser som stöds. Både auktorisering och tokeninlösen kräver exakt matchning mot den registrerade återanropsadressen. Ett Grant gäller en enda skyddad resurs (protected resource); blanda inte ontologins scope och affärsarbetsytans scope i samma anslutning.

Tokens livscykel

I r56 har servern som standard en livslängd på 3 600 sekunder för access token, 2 592 000 sekunder för refresh token och 300 sekunder för auktoriseringskoder; en driftsättning kan åsidosätta dessa värden. Klienten ska avgöra utifrån expires_in i tokensvaret och faktiska fel, och inte hårdkoda standardvärdena. Byt till de nya tokens efter förnyelse. Om en roll, en resursbehörighet eller ett Grant återkallas nekas efterföljande anrop.

Kapitel 4

Scope, resursgränser och realtidsbehörigheter

Auktoriseringens scope delegerar befintliga behörigheter, ger ingen rolluppgradering och delar inte affärsstatus mellan olika Grant.

ScopeTypiska funktionerViktiga begränsningar
ontology.metadata:readOntologi, resurser och tabellstrukturOntologin och tabellerna måste ingå i auktoriseringen och vara läsbara för användaren just nu
ontology.graph:readGrafsökning och grannoderReturnerar lokaliseringsinformation, inte faktabevis
ontology.knowledge:readKunskapslokalisering och fullständig originaltextBehåller kunskapsbibliotekets och dokumentens ursprungliga behörigheter
ontology.table:querySQL mot ontologitabeller samt frågor mot publicerade modellerTabellfrågor kräver även metadata-scope; behörigheter för de faktiska källorna och kolumnerna gäller fortfarande
search:operateInbyggd nyckelordsmodell och sessionerSeparat, uttrycklig delegering; körs med den ursprungliga modellens behörigheter och användarens tabell- och kolumnbehörigheter
etl:operateETL-capabilities i FlashGer ingen åtkomst till Heavy ETL
authoring.contract:readVillkorligt tillgängliga modelleringskontraktKräver även funktionsflagga och berörda resurser
authoring.artifact:readLäsning av kandidater, planer m.m. inom den aktuella auktoriseringenBundet till den ursprungliga huvudmannens Grant och resurser
authoring.artifact:draftInskickning av kandidater, förhandsvisning m.m.Ger inte behörighet till exekvering eller publicering
authoring.artifact:applyKontrollerade planer och tillämpningKräver fortfarande den ursprungliga affärsrollen, policyer och godkännande
execution.script:draftUtkast till vissa skriptGer inte behörighet till faktisk skriptexekvering
datasource.http:read / draft / test / importVillkorligt tillgängliga artefaktfunktioner för HTTP-datakällorSeparat funktionsflagga och ursprunglig behörighet för varje funktion
Figur A3 Användarbehörigheter, Grant, valda resurser och funktionskonfiguration avgör tillsammans vilka funktioner som är tillgängliga. Illustration.

Kombinerade krav för läsning

dfc_table-detail kräver ontology.metadata:read; query kräver dessutom ontology.table:query. dfc_ontology_query kräver båda läs-scopen graph och knowledge. dfc_knowledge_search/detail kräver knowledge. published_model/published_query går via table:query; candidate_query kräver dessutom authoring.artifact:read. Analysverktygen kontrollerar även vilka bevis-scope som är tillåtna; beständiga rapporter kräver metadata och table query.

Hårdkoda inte standardauktorisering

I r56 ingår table query i ontologins standarduppsättning av scope; Search och ETL kräver uttrycklig delegering. I slutändan avgör discovery-metadata, auktoriseringssidan, tokens faktiska scope och tools/list. Påståenden i äldre dokumentation om att ”ontologin som standard aldrig har SQL” eller att det finns ”endast sex verktyg” kan inte användas som underlag för den nuvarande implementationen.

Isolering av tillstånd

Sessioner, rapporter, kandidater och åtgärdsplaner har var sin ägare och sitt eget omfång. När en access token förnyas överförs inte arbete som hör till det ursprungliga Grant till ett annat Grant. Slå inte ihop sessionId, reportId, planId, godkännandetokens eller källtokens som returnerats av en annan anslutning med den aktuella anslutningen.

Kapitel 5

HTTP- och moderna MCP-meddelanden

Skicka korrekt metadata för varje förfrågan och matchande routinghuvuden, och hantera HTTP-svar och verktygsresultat var för sig.

Områder56-beteende
TransportTillståndslös Streamable HTTP, POST JSON-RPC
Versioner som stöds2026-07-28 samt 2025-11-25, 2025-06-18 och 2025-03-26
Moderna metoderserver/discover tools/list tools/call resources/list resources/read, tillgängliga enligt de faktiska funktionerna
SessionshuvudInget Mcp-Session-Id tilldelas
GET och DELETE/mcp och /mcp/business returnerar 405
SSE-notifieringar från servernTillhandahålls inte av dessa två offentliga MCP-ingångar
KatalogcacheModern discovery och listning returnerar ttlMs=60000 och cacheScope=private
Vanliga resultatModerna resultat innehåller resultType=complete samt metadata om tjänsteidentitet

Innehåll som måste matcha

  • MCP-Protocol-Version stämmer överens med io.modelcontextprotocol/protocolVersion i params._meta.
  • Mcp-Method stämmer överens med JSON-RPC-metoden.
  • Mcp-Name för tools/call stämmer överens med params.name; namnhuvudet för resources/read stämmer överens med URI:n.
  • Varje modern förfrågan innehåller io.modelcontextprotocol/clientCapabilities-objektet; ange även standardfältet clientInfo så att klienten kan identifieras.

Anropsexempel

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

Motsvarande HTTP-huvuden är Mcp-Method: tools/call och Mcp-Name: dfc_ontologies. Samtliga ACCESS_TOKEN i exemplen är platshållare. Lägg aldrig en Bearer-token i URL:er, JSON-parametrar eller cachenycklar.

Läsning av resultat

Hantera först HTTP-statusen och kontrollera därefter JSON-RPC error; finns ett result fortsätter du med att kontrollera isError. Lyckade verktygsresultat tillhandahåller vanligen structuredContent samt textinnehåll som innehåller samma affärs-JSON; läs i första hand den strukturerade kanalen och räkna inte text och structuredContent som två oberoende fakta när du sammanställer. HTTP 200 kan innehålla verktygsfel.

Offentliga resurser och UI

De inbyggda beskrivningsresurserna är inte beroende av MCP Apps. Ingången till affärsarbetsytan får därmed inte tillgång till ontologibeskrivningsresurserna. Klienter som stöder visualisering bör hitta motsvarande UI via de faktiska funktionerna och verktygets _meta och inte gissa resurs-URI:er som inte har returnerats.

Kapitel 6

Kompatibilitet med äldre protokollklienter

Håll protokollgenerationen konsekvent i klienter som fortfarande använder initieringshandskakningen.

json
{
  "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {"name": "flash-legacy-client", "version": "1.0.0"}
  }
}
  1. Skicka initialize och läs protokollversionen och de capabilities som servern har förhandlat fram.
  2. Skicka den notifiering om slutförd initiering som klientens protokoll kräver; en notifiering ger inget vanligt verktygsresultat.
  3. Använd tools/list för att läsa de verktyg som den aktuella auktoriseringen omfattar och skicka sedan tools/call.
  4. Håll huvuden och meddelanden konsekventa med den aktuella förfrågans protokollgeneration; använd inte det gamla initialize- eller ping-flödet för meddelanden enligt 2026-07-28.

Det äldre protokollet använder fortfarande samma Bearer/OAuth, behörigheter och verktygskontrakt. Det innebär inte att servern nödvändigtvis erbjuder äldre långlivade SSE-anslutningar eller Mcp-Session-Id; de offentliga tjänsterna i r56 är tillståndslösa.

Protokollfel

SituationTypiskt resultatÅtgärd
Moderna huvuden och meddelanden stämmer inte överensHTTP 400 JSON-RPC -32020Rätta huvuden, metadata och verktygsnamn
Version som inte stöds-32022 tillsammans med en lista över versioner som stödsVälj ett protokoll som faktiskt stöds
Okänd metodJSON-RPC -32601, moderna förfrågningar kan ge HTTP 404Kontrollera protokollgeneration och metod
Saknade eller ogiltiga parametrarJSON-RPC parameterfel eller verktygets isErrorRätta enligt det faktiska inputSchema
Kapitel 7

Välj rätt verktyg och beviskanal

Välj väg utifrån den affärsfråga som ännu är obesvarad och upprepa inte bevisinhämtningen genom en fast anropskedja.

Figur A4 Val av tabell-SQL, kunskapsbevis, Search, analys eller affärsåtgärd utifrån uppgiften. Illustration av routning.
UppgiftFörstahandsverktygBevis som krävs för slutförande
Identifiera auktoriserade ämnen och resurserdfc_ontologies dfc_ontology_resourcesFaktiska typer av resurs-ID och det omfång som är synligt just nu
Tabellstatistik och TopNdfc_table queryKvitto på lyckad körning samt fullständiga evidenceRows
Slå upp regelverk, kontrakt eller rapporterdfc_ontology_query eller knowledge search/detailFullständig, auktoriserad originaltext som kan användas som fakta
Lokalisera grafobjektdfc_ontology_graph search/neighborsLokalisera den faktiska källan och hämta därefter motsvarande fakta
Nyckelordsinteraktion i den inbyggda Searchdfc_manual därefter dfc_searchFaktiska resultat i den ursprungliga modellen och affärsramen
Kombinerad analys och rapporteringdfc_analysis_* eller dfc_report_*Verkligt tillstånd för varje strukturerad gren och dokumentbevis
Ändra presentation eller ontologimodelldfc_authoring_* och artifact-verktygKontrollera kandidat, plan, godkännande och faktisk tillämpning var för sig
Kör affärskommandondfb_* i /mcp/businessPublicerat kontrakt och kvitto från den ursprungliga ActionPlan

Undvik onödiga anrop

När en aktuell, fullständig och auktoriserad tabellstruktur redan finns ska inte varje fråga kräva en ny detail; när tillförlitlig lokalisering och bevis redan finns ska inte samma sökning upprepas. Om en dimension saknas gör du en avgränsad kompletterande fråga. När ett fel uttryckligen inte kan försökas igen ska luckan åtgärdas först; ”försök igen” ersätter inte en bedömning.

Det som inte ingår i Flash

dfc_etl capabilities kan returnera available=false samt ETL_NOT_INCLUDED_IN_OT_FLASH. Den statiska beskrivningen av inbyggda ETL-funktioner är avsedd som referens mellan produkter. Den bevisar inte att ETL är installerat i Flash och tillåter inte att agenten automatiskt växlar till Heavy eller en annan tenant för att köra.

Kapitel 8

Ontologiresurser och ID-typer

Hämta först faktiska resurskoordinater för att undvika att förväxla lagringsnamn, dokument-ID och kunskapsbas-ID.

  1. Anropa dfc_ontologies och bläddra med page och pageSize bland de ontologier som omfattas av den här auktoriseringen och fortfarande kan läsas.
  2. Anropa dfc_ontology_resources med ett verkligt ontologyId; välj vid behov tables, answers, pinboards, documents och knowledgeBindings.
  3. Hantera sidnumrering för varje resurstyp var för sig. pageSize är högst 100; dra inte slutsatser om hela resursomfånget utifrån den första sidan.
  4. Spara den typ som resursen deklarerar och det ursprungliga ID:t och använd dem oförändrade i senare anrop.
json
{"name":"dfc_ontology_resources","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "resourceTypes":["tables","documents","knowledgeBindings"],
  "page":1,"pageSize":100
}}
KoordinatKällaKan inte ersätta
ontologyIdAuktoriserad ontologilista eller aktuell giltig kontextID för en annan ontologi
Tabellresursens idtables-listan eller tillförlitlig kontextphysicalName eller tabellens visningsnamn
tblDisplayName colDisplayNameAktuell tabell- och kolumnmetadataGissade fysiska SQL-identifierare
knowledgeIdknowledgeBindings eller kvitto från en faktisk kunskapssökningDokumentresursens id
assetId documentId chunkId evidenceIdSamma faktiska lokaliseringskvittoFält som sammanfogats från olika lokaliseringsresultat
rid revisionId releaseIdPublicerad modell eller kandidatkontext på servernSjälvskapade ID:n eller latest

Konventioner för precision

Alla 64-bitars resursidentifierare skickas i första hand som decimalsträngar och konverteras inte via Number i JavaScript. Vissa affärsscheman godtar string eller integer, vilket inte innebär att heltalsprecision får kasseras. Opaka locators, UUID, hashvärden och engångstokens sparas också oförändrade.

Kapitel 9

Doris-tabellfrågor och strukturkontrakt

Kör skrivskyddad SQL mot auktoriserade tabeller och bevara utdatasemantik, exakta värden och fullständighet.

Läs strukturen

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

detail använder det verkliga tabellresurs-ID:t. Kontrollera schemaComplete, tblDisplayName, colDisplayName i columns och den auktoritativa sqlDataType samt den returnerade queryContract. dataType är endast en kompatibilitetsmappning; det fysiska lagringsnamnet är inte det tabellnamn som ska användas i SQL.

Kör frågor

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

SQL-begränsningar

  • Använd tabellernas och kolumnernas visningsnamn och omge identifierare med dubbla citattecken. Förfrågan ska vara en skrivskyddad Doris-fråga inom ontologins omfång.
  • Ange utdatakolumnerna explicit; SELECT * och table.* är förbjudna; de kan inte användas för att kringgå behörigheterna för registrerade kolumner via fysiska kolumner.
  • Kopplingar görs med explicit JOIN ... ON; NATURAL JOIN och JOIN USING avvisas.
  • Giltiga flerdimensionella aggregeringar, CTE:er, fönsterfunktioner, CASE, COUNT(DISTINCT ...) och andra skrivskyddade uttryck kan användas; att den semantiska valideringen inte täcker ett visst uttryck innebär inte att det generellt är förbjudet att köra det.
  • Utför aggregering, sortering och rankning först i SQL och tillämpa därefter resultatgränsen. maxRows är som standard 100 och högst 200.

Datum och tidszon

Typ eller målSkrivsättObservera
DATECAST('2026-09-01' AS DATE) och CURRENT_DATEAnta inte att en textliteral automatiskt har datumtyp
DATETIMECAST('2026-09-01 00:00:00' AS DATETIME) och CURRENT_TIMESTAMPKontrollera källans tidszon och sessionens tidszon
Relativ tidDATE_SUB(CURRENT_DATE, INTERVAL 1 YEAR)Använd motsvarande funktion för aktuellt datum respektive aktuell tidsstämpel
TidsgrupperingYEAR(column) eller DATE_TRUNC(column, 'month')Använd ett unikt alias för varje utdata; queryContract är avgörande

SQLite:s DATE('now', ...) ingår inte i Doris datumkontrakt för den här ingången. För inte över dokumentationsexemplens offlinekontroll med SQLite till SQL som körs i drift.

Läs v8-frågekvittot

evidenceRows är agentens enda kanal för raddata; rådata (raw data) exponeras inte för agenten. SQL-tal kodas som exakta decimalsträngar i JSON; använd resultColumnContracts för att avgöra deras numeriska och affärsmässiga typ, och tolka dem inte som VARCHAR enbart för att JSON är en sträng. Läs executionReceipt samt fullständighets- och trunkeringsinformation och behåll källinformation som evidenceRowsSha256.

Frågeutdata med ett citerbart exekveringskvitto kan citeras som de är; endast semantik som servern har verifierat kan ligga till grund för efterföljande deterministiska sekundärberäkningar. Gissa inte ”ackumulerat saldo”, ”värde vid periodens slut” eller ”币种” utifrån fältnamn och lägg inte till enheter på egen hand. Nollradsresultat, fel eller trunkering får inte beskrivas som fullständig statistik.

Kapitel 10

Flerdimensionell Top3 och trunkeringshantering

Besvara rankningsfrågor med aggregering och fönsterfunktioner på servern; gör inga sekundärberäkningar på ofullständiga resultat.

Det medföljande examples/top3.sql använder exempeltabellen: det aggregerar först per 区域, 类别 och 产品, kör sedan ROW_NUMBER inom varje kombination av 区域 och 类别 och använder 产品-namnet som stabil ordning vid lika belopp. Att begära maxRows=100 räcker för exemplets 36 rader; för andra affärsdata måste du utgå från det verkliga antalet grupper.

  1. Hämta den verkliga strukturen och aktuella affärsdefinitionen; klargör 币种, period, 订单状态 och regler vid lika värden.
  2. Skicka SQL som gör aggregeringen och rankningen på servern. Fråga inte först bara efter totalen per 区域 för att sedan använda den som rankning av 类别 och 产品.
  3. Kontrollera utdatakolumnernas kontrakt mot de faktiska evidenceRows och bekräfta att svaret täcker alla nödvändiga grupper.
  4. Om trunkering upptäcks: gör avgränsade, partitionerade frågor inom de gränser som servern stöder, t.ex. en fullständig Top3 per 区域; behåll samma affärsdefinition i varje fråga.
  5. Om källperioden ändras: fråga igen och klargör den nya versionen; blanda inte olika dataversioner och använd inte ogiltiga markörer.
Figur A5 Ordningen för detaljfiltrering, gruppvis aggregering, rankning inom grupp och slutlig retur. Illustration.

Felåterställning

TABLE_SCHEMA_INCOMPLETE innebär att du ska rätta strukturen eller hämta den fullständiga strukturen; fel som ONTOLOGY_SQL_FAILURE_CONTRACT_INVALID hanteras enligt den returnerade errorCode, retryable och remediation. Påstå inte att ”alla flerdimensionella GROUP BY eller fönsterfunktioner är förbjudna”, och hitta inte på rankningar när det saknas frågeresultat.

Kapitel 11

Kunskapssökning, fullständig originaltext och bevisgiltighet

Håll isär lokalisering, läsning och citering av fakta, och bevara källhänvisning och fullständighet.

Två vanliga vägar

VägSyfteViktigt
dfc_ontology_querySöker i kunskap som är bunden till ontologin, eventuellt i kombination med grafroutningKontrollera fullständiga canonical answerContextItems och bevisgiltighet
dfc_knowledge_search → dfc_knowledge_detail-chunkLokalisera med en explicit sökning och läs sedan valda fragmentFörhandsvisningar i sökresultat räknas inte som fakta; läs den fullständiga originaltexten för samma lokalisering
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>"
}}

Villkor för att kunna användas som fakta

  • Kontrollera aktuell ACL, innehållets fullständighet samt serversidans canonicalFactEligible, citationEligible eller motsvarande exekveringskontrakt.
  • Fullständigt innehåll är bundet till contentSha256. Trunkering, utelämnanden på grund av budget och innehåll av låg kvalitet ska hanteras enligt de faktiska fälten.
  • Dokumentmetadata, page_context, graflokalisering, sökningssammanfattningar och förhandsvisningar kan inte ersätta den canonical originaltexten.
  • Kopiera i första hand evidenceId; om du behöver chunkId och documentId måste de komma från samma lokaliseringsresultat; sätt inte ihop eller gissa fram dem.

Grafroutning

Resultaten från search/neighbors är lokaliseringsinformation. Skicka till ontologins query endast det routeLocator-objekt som servern har returnerat i sin helhet, inklusive bindnings-, versions- och bevisfält. Paketera inte på egen hand ett assetId eller knowledgeId som en locator utfärdad av servern, och skicka inte tillbaka källbevis som modellen bara har påstått.

Strukturerad dokumentrekonstruktion

dfc_ontology_query:s structuredPlan är en begränsad rekonstruktion med deterministisk validering, särskilt avsedd för tabeller i oregelbundna dokument. Använd den plan som servern deklarerar endast när den har returnerat aktuell executionContractSha256, tableIndex, kolumnerna och den fullständiga tabellen. Vanliga importerade affärstabeller ska frågas via dfc_table SQL; använd inte rekonstruktion av Markdown-tabeller som en väg förbi auktoriseringen av tabellfrågor.

Figur A6 Beviskedjan från lokaliseringsresultat till citerbar originaltext. Illustration.

Sökstrategi

knowledgeIds utelämnas normalt så att alla bindningar som är aktiva just nu omfattas; om det anges får endast verkliga kunskapsbas-ID:n från knowledgeBindings användas. Behandla inte ett dokumentresurs-ID som ett kunskapsbas-ID. Gör nya avgränsade sökningar utifrån frågor som ännu är obesvarade och undvik exakt upprepade sökningar som inte ger nya bevis.

Kapitel 13

Språk och regionala konventioner

Håll isär UI-locale, frågeordlistor, svarsspråk och ursprungliga fältnamn.

Prioritetsordningen är: uttryckligen begärt språk, applikationssystemets språk och därefter locale på den nod som faktiskt kör anropet. Ett utelämnat värde, null, en tom sträng eller enbart blanksteg ger inte automatiskt kinesiska som reservspråk. De regionala värdena i languageRegistry ska behållas exakt; en-GB, fr-CA, pt-BR, es-US och ar-AE får inte godtyckligt slås ihop med en annan region.

Språk eller regionFrågelocaleBeskrivning
Förenklad kinesiska, traditionell kinesiskazh-CN zh-HantDe ursprungliga kinesiska reglerna skiljer sig från katalogen för traditionell kinesiska
Amerikansk, brittisk, australisk och kanadensisk engelskaen-US en-GB en-AU en-CAUI- och nyckelordspaket kan delas; regionsmetadata behålls
Tyska, italienska, ryskade-DE it-IT ru-RUAnvänd enligt förslagen i den aktuella sessionen
Spanska (Spanien) och latinamerikansk spanskaes-ES es-USProduktens region-ID är es-US
Franska (Frankrike) och kanadensisk franskafr-FR fr-CARegion-ID:n slås inte samman
Portugisiska (Portugal) och brasiliansk portugisiskapt-PT pt-BRKatalog- och regionkonventioner behålls separat
Nederländska, danska, norska, finska, svenskanl-NL da-DK nb-NO fi-FI sv-SENorska avser bokmål
Japanska, koreanskaja-JP ko-KROrd delas inte upp enligt engelska mellanslagsregler
Saudiarabisk och emiratisk arabiskaar-SA ar-AEGränssnittstexter stöder RTL; protokollidentifierare vänds inte

Använd nyckelordskatalogen

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

dfc_manual:s statiska nyckelordskatalog omfattar endast uttryckligen listade locales; om locale utelämnas används den engelska referensen. Detta är ett standardvärde för referensen, inte en regel för hur frågespråket tolkas. Om det saknas en statisk katalog för en regional variant hämtar du faktiska förslag via assist i den aktuella sessionen; hitta inte på alias eller reservresultat. names får innehålla högst 32 poster per anrop.

Innehåll som inte översätts

  • Tabeller, kolumner, enumvärden, kundnamn, formelnamn och andra verkliga modellsträngar.
  • Verktygsnamn, action, scope, schema-fält, felkoder och statusvärden.
  • Resurs-ID:n, hashvärden, opaka locators och referenser utfärdade av servern.

En fråga på tyska kan till exempel ställas mot den kinesiska visningskolumnen ”销售金额”. Om den byts ut mot ett tyskt kolumnnamn blir det en annan identifierare, inte en översättning av gränssnittet. Efter ett språkbyte initierar du om sessionen eller uppdaterar den enligt det ursprungliga protokollet och hämtar förslag och tvetydighetskandidater på nytt.

Kapitel 14

Kombinerad analys och interaktiva resultat

Bevara auktorisering, version, gren och bevisstatus i de villkorligt tillgängliga analysverktygen.

dfc_analysis_* styrs av datafocus.mcp.analysis.tools.enabled. Den strukturerade delen går fortfarande via auktoritativa frågor i Search och den aktuella radpolicyn; dokumentdelen hämtar på nytt den fullständiga originaltexten under aktuell ACL. De är ingen ingång för öppen SQL, godtyckliga instruktioner eller injektion av godtyckliga filter.

VerktygSyfteNödvändiga koordinater
dfc_analysis_askStäller en analysfråga på naturligt språkontologyId question, valfritt language sessionId
dfc_analysis_result_getLäser ett tidigare returnerat resultatontologyId sessionId resultId
dfc_analysis_refineStäller uppföljningsfrågor eller gör ändringar utifrån det senaste fullständiga resultatetUrsprungligt resultat, expectedRevision och stabil idempotensnyckel
dfc_analysis_pageHämtar en sida från en gren på servernUrsprunglig gren och resultatversion pageNo pageSize
dfc_analysis_cancelAvbryter ett resultat som fortfarande bearbetasUrsprunglig session och resultat
dfc_analysis_closeFrigör en session som inte längre arbetarUrsprunglig session

Starta en analys

json
{"name":"dfc_analysis_ask","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "question":"按区域分析已完成订单销售金额,并引用退货统计口径",
  "language":"zh-CN"
}}
  1. Läs returnerade sessionId, resultId, status och revision; fortsätt vid behov att läsa det ursprungliga resultatet.
  2. Kontrollera varje strukturerad grens status, fullständighet, radpolicy och källor; att en gren är klar innebär inte att hela analysen är fullständig.
  3. Granska dokumentbevis, faktaregistret, citerbarhet och begränsningar. Text som modellen genererar kan inte på egen hand höja bevisens giltighet.
  4. Vid uppföljningsfrågor utgår du från det senaste fullständiga resultatet och skickar med expectedRevision; återförsök av samma ändring ska återanvända samma idempotensnyckel.
  5. Kontrollera innan du stänger att sessionen inte längre arbetar; att avbryta och att stänga är olika åtgärder.

Kontrollerad filtrering och sidnumrering

filter_patch använder branchId, fieldRef, valueRef och tillåtna operatorer från servern; de typade filtren deklarerar för närvarande endast EQ. Använd aldrig rå SQL, tableId eller columnId eller klientgenererade filterträd i stället för opaka referenser. Vid sidnumrering börjar pageNo på 1 och är högst 10000; pageSize är högst 100.

Figur A7 Grenar, versioner och sidnumrering hör ihop; när källan eller versionen ändras ska en ny fråga ställas för att få en ny lokalisering. Illustration.

Funktionstips och beteende

Verktygens annotations är tips till klienten, inte säkerhetsauktorisering. Vissa generella mallar använder readOnlyHint, men det ersätter inte en bedömning av den faktiska åtgärden; att avbryta, stänga och skapa rapporter ändrar motsvarande arbetstillstånd. Följ alltid verktygets semantik, användarens mål och serverns behörigheter.

Kapitel 15

Beständiga visualiseringsrapporter och MCP Apps

Skapa rapporter som kan återupptas och läs deras resultat och interaktiva gränssnitt enligt aktuella behörigheter.

dfc_report_* styrs av datafocus.mcp.analysis.report-tools.enabled och kräver metadata- och table query-scope. Till skillnad från Search-sessioner, som bara finns inom processen, använder rapporter ett beständigt reportId; beständigheten innebär inte att behörigheterna slutar kontrolleras.

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

Arbetsflöde

  1. Använd en stabil idempotencyKey när rapporten skapas, med 8 till 128 tecken av de typer som stöds.
  2. Spara reportId, polla status och kontrollera det faktiska tillståndet, till exempel slutförd, misslyckad, delvis slutförd eller avbruten.
  3. När du läser resultatet kontrollerar du strukturerade grenar, visualiseringar, faktakällor, dokumentreferenser och fullständighet.
  4. Använd det ursprungliga reportId för att avbryta en ofärdig rapport; skapa inte en ny rapport i stället för att avbryta.
  5. Efter en nätverkstimeout läser du först den ursprungliga rapportens status; en upprepning med samma idempotensnyckel ska avse samma affärsavsikt.

MCP Apps

Klienter med stöd för UI-tillägg läser rapportsidor via verktygets _meta och discovery av faktiska resurser. Den beständiga rapportsidan för r56 är ui://datafocus/analysis-report/v16/index.html; interaktiv analys använder motsvarande resursreferenser från servern. Klienten ska inte hårdkoda värden som ersätter verktygets returvärden. Även utan UI-tillägg kan strukturerade resultat läsas.

Origin-bindning

När en rapport läses kontrolleras Grant, ontologi, bindningen till förfrågans Origin och aktuella tabellbehörigheter på nytt. Integration i webbläsaren mellan olika ursprung (cross-origin) kräver ett godkänt, faktiskt ursprung; klienten får inte kringgå bindningen med en förfalskad Origin. Ett gammalt reportId är varken en långlivad offentlig länk eller en åtkomstbehörighet mellan användare.

Kapitel 16

Artefaktutkast, förhandsvisning, plan och tillämpning

Låt den ursprungliga servern normalisera, validera och godkänna genererat innehåll; låt inte modellen ändra produktionsresurser direkt.

Artefaktverktygen kräver att authoring-funktionen är aktiverad, en faktisk artifact type, berörda scope och den ursprungliga skrivbehörigheten som administratör. Som standard är typerna CONTROL_PANEL_SPEC och VIEW_SPEC konfigurerade; andra typer som formulär, HTTP-källor eller skript styrs dessutom av separata konfigurationer. Flash har ingen AutoML, och därför listas de typerna inte som tillgängliga artefakter i den här versionen.

Figur A8 Kontrollerad ordning för kontext, kandidat, förhandsvisning, plan, godkännande och tillämpning. Illustration.
  1. dfc_authoring_capabilities läser de kontrakt och åtgärder som är tillgängliga för det aktuella Grant.
  2. dfc_artifact_context hämtar avgränsad kontext, contractVersion, contextHash, baseArtifactHash och baseArtifactVersion.
  3. Generera kandidaten i klienten utifrån det verkliga kontraktet, utan att köra någon kod i den.
  4. dfc_artifact_submit skickar in den ursprungliga kontexten och kandidaten med oförändrad instruction och använder ett stabilt clientRequestId.
  5. Läs proposalId, candidateHash, valideringsresultat och förhandsvisning; vid faktiska fel reviderar du kandidaten och hittar aldrig på att servern har godkänt den.
  6. Om en ny förhandsvisning behövs använder du dfc_artifact_preview och samma kandidathash.
  7. dfc_artifact_plan skapar en oföränderlig plan med den verkliga kandidaten, målversionen och en idempotensnyckel.
  8. Hantera godkännandet via det ursprungliga interaktiva godkännandeflödet eller en redan auktoriserad policy och anropa därefter dfc_artifact_apply; endast ett APPLIED-kvitto innebär att ändringen faktiskt har tillämpats.

Minimal kontextförfrågan

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

VIEW_SPEC använder det auktoriserade projectId; vid redigering av en befintlig artefakt används det faktiska artifactId. Fält som variables, previewInput och viewport anges enligt det returnerade kontraktet; gissa inte kandidatens interna struktur.

Samtidighet och återförsök

Planen är bunden till målversion, kandidathash och idempotensnyckel. När målet har ändrats kan den gamla planen inte längre tillämpas; läs kontexten på nytt och hantera de faktiska konflikterna. En transporttimeout bevisar inte att anropet misslyckades; fråga först med dfc_artifact_status efter det ursprungliga proposalId eller planId. READY är inte APPLIED.

Godkännande och automatisk policy

Generella artefaktplaner kräver det ursprungliga manuella godkännandet. Planer som omfattas av ontologins policy för automatisk publicering hanteras enligt approvalMode och kräver inte att användaren dessutom undertecknar ett godkännande som agenten har hittat på. approvalToken är material som utfärdas av servern och kan inte ersättas av en sträng som agenten skriver; det faktiska inputSchema och plankvittot avgör vilka fält som är obligatoriska.

Kapitel 17

Skapande av ontologikandidater och publiceringskontrakt

Använd ontologideklarationer och publiceringskonfigurationer med egen versionering; tillämpa inte kontraktet för vanliga presentationsartefakter på modellpublicering.

Skapa kandidat

Ontologicontainern måste redan finnas och ingå i Grant. Använd dfc_ontology_table_schema för att kontrollera aktuella strukturerade källfält och v4 Binding-fingeravtryck; för ett fält räcker det att ange sourceField för att typen ska identifieras automatiskt. Explicita DECIMAL-deklarationer kräver aktuell precision och antal decimaler; andra typer har inte dessa två fält.

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

Kandidater och publiceringskonfiguration

KontraktSyfteViktiga gränser
ontology-workspace-create-mcp-submit-v1Skapar en kandidat från lokala deklarationerVerkliga auktoriserade källor och kompilering på servern; bevis på slutförande accepteras inte
ontology-workspace-create-mcp-submit-v2Blandar lokala deklarationer och exakta publicerade referenserAnge exakta releaseSelections och beroendehöljet
ontology-publication-mcp-submit-v1 till v3Binder en befintlig kandidat till en förfrågan om publiceringsplanExplicita koordinater; mål, källa, godkännande och validering återställs av servern
ontology-publication-mcp-submit-v4 till v6Separat aktiverad konfiguration för automatisk publiceringAnvänds endast när capabilities och det faktiska schemat deklarerar den
ontology-initial-activation-retirement-submit-v1Kontrollerad initial aktivering och avvecklingSeparat plan, nytt manuellt godkännande och exakt omfång

Steg för publicering

  1. Hämta den aktuella kandidatens workspaceId, workspaceRevision, candidateHash och den faktiska källan.
  2. Välj kontraktsversion enligt serverns funktioner; skicka in koordinater som releases och selection, utan fält som påstår att något är ”godkänt” eller ”har passerat”.
  3. Spara proposalId och den ursprungliga idempotencyKey från submit. Submit och MODEL_PLAN är olika faser av samma förfrågan.
  4. Anropa dfc_artifact_plan med den ursprungliga kandidaten, målversionen och samma idempotensnyckel.
  5. PLANNING_INCOMPLETE betyder endast att ingen giltig plan har skapats ännu; VALIDATION_UNSATISFIED betyder att den aktuella valideringen fortfarande har luckor; hantera dem enligt nextAction.
  6. När planen har lyckats fortsätter du enligt HUMAN_REQUIRED eller POLICY_AUTO och använder det ursprungliga godkännande- och publiceringsflödet.
  7. Bekräfta resultatet med ett APPLIED-kvitto och därefter med en verklig läsning av den publicerade modellen och en auktoriserad fråga.

Timeout och återställning

Efter en PLAN-timeout läser du det ursprungliga proposalId. MODEL_PLAN_SUBMITTED är en ofullbordad förfrågan; MODEL_PLAN_COMPLETED betyder att det ursprungliga kvittot ska återställas med de ursprungliga koordinaterna och nyckeln, inte att klienten ska skapa en ny förfrågan. Valideringsluckor i sluttillståndet kan inte omvandlas till en godkänd publicering genom att byta nyckel eller skicka in på nytt.

Mänskliga affärsbehörigheter

Agentens instruction och deklarationer är indata från agenten, inte en policy som en människa har undertecknat. MODEL_AUTHOR, MODEL_PUBLISH, delegering av automatisk publicering, affärsbekräftelse, förtroende för offentliga nycklar, budget och källans ACL avgörs fortsatt av de ursprungliga mekanismerna. Klientfält får inte ersätta dessa fakta.

Kapitel 18

Publicerad modell, kandidatfrågor och referenshölje

Använd publicerad affärskunskap med exakt version och behåll den tillfälliga karaktären hos opublicerade kandidater.

dfc_ontology_graph:s published_model, published_query och candidate_query är villkorligt tillgängliga strukturerade konfigurationer, inte synonymer till vanliga search/neighbors. De auktoriseras via table query och nödvändiga läsbehörigheter för modellering; att något syns i grafen ersätter inte tabellbehörigheter.

Läs en publicerad modell

  1. När verktygets action-enum faktiskt innehåller published_model skickar du in ett verkligt committed releaseId.
  2. v1 returnerar auktoriserade frågemallar; v2 lägger till exakta PERSISTED-referenser och releaseSelections; v3 lägger till beroendereferenser, exakt domainRef och kompakta bindningsmallar.
  3. Välj objekt, attribut, Binding, scope och version från faktiska returvärden; generera inte RIDs och använd inte latest.
  4. Skicka in den fasta typade frågan för published_query; resultatet måste fortfarande klara den aktuella auktoriseringen av källor och fält.

Kandidatfrågor

candidate_query använder det faktiska workspaceId, revision, candidateHash och kandidatdeklaration. Vid blandning med publicerade referenser används motsvarande v2-typade LOCAL/PERSISTED-koordinater och exakta urval. Kandidatresultat är alltid opublicerade och tillfälliga och får inte behandlas som kunskap som företaget har bekräftat.

Lokalt underhåll och hölje

Välj endast de transitiva beroenden som kandidatroten kräver och se till att varje publicerad referens har en exakt releaseSelections. Att kopiera publiceringens innehåll, bara skicka in en uppsättning ID:n eller utvidga till alla historiska resurser ersätter inte kontrollen av aktuella beroenden och källor.

Figur A9 Kandidatrot, exakta publicerade beroenden och källauktorisering. Illustration av referenshöljet.

För dessa actions är query ett versionerat, typat objekt; SQL, fysiska tabell-ID:n eller källtabellnamn accepteras inte i stället för dess affärsreferenser. Metadatamallar och grafresultat är i sig inte giltiga som faktareferenser.

Kapitel 19

Delegerade uppgifter för ontologiagenten

Återuppta arbetet med beständiga uppgifter och det ursprungliga Grant; behandla inte agentens instruktioner som ett mänskligt godkännande.

dfc_ontology_agent visas endast när en faktisk Pi Runtime och berörda behörigheter finns tillgängliga. QUERY använder läsfunktionerna; AUTHORING kräver dessutom en modelleringsroll och motsvarande authoring-scope. Verktyget öppnar ingen separat exekveringsmotor utan begränsningar.

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

Strikt parameteruppsättning

start använder contractVersion, action, ontologyId, mode, instruction, idempotencyKey; status/cancel använder contractVersion, action, ontologyId, runId. Servern kontrollerar den exakta fältuppsättningen per action. instruction får vara högst 16000 tecken; nycklar består av 1 till 128 tecken av de typer som stöds och börjar med en bokstav eller siffra.

Återupptagande och avbrytande

  1. Spara det ursprungliga runId, Grant, mode och idempotensnyckeln.
  2. Samma nyckel med samma instruction återupptar samma run och skickar inte in någon ny uppgift; samma nyckel med en annan instruction avvisas.
  3. status hämtar den ursprungliga uppgiftens status. Även när uppgiften är slutförd måste dess tabellfrågor, bevis eller publiceringskvitton kontrolleras.
  4. Avbryt med det ursprungliga runId; bekräfta resultatet med uppgiftens faktiska status.

En avslutad run är inte ett kvitto på modellpublicering. Publiceringsuppgifter bekräftas fortfarande via den ursprungliga artefaktens status och källkontroller; QUERY medför ingen underförstådd skriv- eller publiceringsrätt.

Kapitel 20

MCP för affärsarbetsytan

Fråga efter poster utifrån publicerade affärskontrakt och kör kommandon via den ursprungliga ActionPlan.

/mcp/business använder en separat protected resource och val av affärssystem; ett Grant för ontologin kan inte återanvändas i stället för affärsauktorisering. Affärssystemet måste vara publicerat, tillgängligt för anrop från agenter och uppfylla den ursprungliga säkerhetspolicyn, och den aktuella användaren måste ha faktiska runtime-roller och funktioner.

ScopeVerktygAvgränsning
business-system:discoverdfb_systems dfb_system_describeIdentifierar endast system som omfattas av den här auktoriseringen och som går att anropa just nu
business-system:readdfb_query dfb_record dfb_work_items dfb_action_statusPoster som den aktuella användaren kan läsa samt användarens egna planer
business-system:plandfb_action_planSkapar endast oföränderliga planer, exekverar inte
business-system:executedfb_action_executeSeparat, uttrycklig auktorisering; körs enligt risk och godkännande
  1. dfb_systems identifierar auktoriserade system.
  2. dfb_system_describe läser det aktuella publicerade kontraktet, releaseId samt alla hashvärden, frågor och kommandon.
  3. dfb_query använder publicerad queryKey och anger vid behov objectKey, state, page och pageSize. Det är inte godtycklig SQL.
  4. dfb_record och dfb_work_items läser de poster och väntande uppgifter som för närvarande är tillåtna.
  5. Före exekvering anger du med dfb_action_plan det faktiska releaseId, releaseHash, canonicalIrHash, agentManifestHash, commandType, planIdempotencyKey och kontraktets payload.
  6. Kontrollera riskClass, requiresApproval och status; när en målpost berörs ska du behålla expectedRecordVersion.
  7. dfb_action_execute exekverar endast planer som den aktuella anslutningen äger och som är redo; de godkännandetokens som krävs för manuellt godkännande utfärdas av DataFocus.
  8. Efter fel eller timeout använder du dfb_action_status för att återuppta den ursprungliga planen; återförsök behåller den ursprungliga idempotenssemantiken.
Figur A10 Publicerade kontrakt, planer, godkännanden och åtgärdskörning. Illustration.

Anslutning och versionsbindning

Planen är bunden till det aktuella Grant via dess stabila isolerings-ID. När access token har förnyats kan samma anslutnings planer fortfarande hanteras, men en annan OAuth-anslutning kan inte ta över dem. Vid körning kontrolleras publicerad version, IR/manifest-hash, målpostversion, planens utgång, idempotens och godkännande på nytt. OAuth-allowlistan kan inte kringgå affärsstyrningen.

Kapitel 21

Inmatning av affärskunskap och frågor som väntar på bekräftelse

Registrera affärsinmatning när motsvarande produktionsprocessor är aktiverad och behåll gränsen för mänsklig bekräftelse.

Följande fyra verktyg läggs till villkorligt av den offentliga MCP-kontrollern beroende på installerade processorer och aktuellt scope. De visas inte alltid i baskatalogen. Att ett schema deklareras innebär inte att instansen har alla processorer, budget och behörigheter på plats; kontrollera alltid tools/list först.

VerktygSyfteAuktoriseringar och effekter som inte uppstår
dfc_ontology_knowledge_input_proposeRegistrerar den ursprungliga affärsinmatningen för en befintlig arbetsytaGenererar inga bekräftelsefrågor, godkänner inte, publicerar inte
dfc_ontology_knowledge_input_previewFörhandsvisar tillfälligt frågeutkast utifrån den ursprungliga inmatningenSparas inte beständigt, bekräftar inte, ger inget produktionskvitto
dfc_ontology_knowledge_question_submitSparar frågor som är authored och ännu inte bekräftadeSlår inte automatiskt ihop svar; ger ingen ansvarsbehörighet eller publiceringsrätt
dfc_ontology_business_scope_initializeInitierar uttryckligen ett konsumentscope för ett affärssystemPublicerar inte, aktiverar inte, beviljar inte källåtkomst

Inmatning och förhandsvisning

  1. Hämta workspaceId, workspaceRevision, localRef och preparationDigest från det faktiska förberedelsearbetet.
  2. propose registrerar affärsinmatning med det ursprungliga input-kontraktet och ett stabilt idempotencyKey; samma nyckel får bara motsvara samma inmatning.
  3. preview använder den ursprungliga inmatningens idempotensnyckel och ontologyId; den returnerar varje gång serverns revision och ett 60-sekundersfönster och är inte ett idempotent kvitto på slutförd produktion.
  4. När frågor behöver lagras använder question_submit en ny kommandonyckel, den ursprungliga originalInputKey, en uttrycklig questionRevision, validFrom, validUntil och expectedRevision; vid skapande är expectedRevision null.

Ingång för mänsklig bekräftelse

knowledgeConfirmationPage som returneras av question_submit är endast en relativ adress till den ursprungliga inloggningssidan, där en viss fråga är förifylld. Den innehåller ingen Bearer, öppnar inte sidan automatiskt och bekräftar inte kunskap. QUESTION_STORED_UNCONFIRMED anger uttryckligen att frågan ännu inte är bekräftad, och det får inte beskrivas som att ”kunskapen har publicerats” i svaret.

Initiering av konsumentscope

business scope initialize kräver både publiceringsrätt för ontologin och att användaren är skapare av eller har SourceManager-administratörsrätt för det exakta affärssystemet. Den använder verkliga koordinater för domainRid, domainRevisionId och businessSystemId; klienten kan inte fylla i godtycklig consumerScope eller bevis på slutförande. Även när INITIALIZED och COMPLETED returneras anges fortfarande uttryckligen published=false och activationAuthorized=false.

Dessa förfrågningar genomgår dessutom strikt JSON-validering samt kontroll av fältuppsättning, storlek i byte och djup. Gränsen för indataförfrågningar är 1 MiB; vissa specifika operationer har lägre gränser. Fullständiga in- och utdatascheman levereras med verktygsreferensen; den toleranta parameterlogiken i det allmänna MCP-omslaget får inte tillämpas på dessa strikta kontrakt.

Kapitel 22

Svar, fel och säkra återförsök

Tolka fel lager för lager och bevara uppgiftskoordinater och idempotenssemantik.

LagerVad som kontrollerasHanteringsprincip
Nätverk och HTTPAnslutning, TLS, 401, 403, 400, 404, 405 m.fl.Behandla inte felsvar som vanliga frågeresultat
JSON-RPCerror.code message dataSkilj mellan protokoll-, metod-, parameter- och auktoriseringsproblem
MCP-verktygresult.isError och structuredContentHTTP 200 kan ändå innebära ett fel
AffärsresultatVerklig status, fullständighet, felorsak, nextActionMottaget eller redo betyder inte slutfört
Giltighet som faktaexecutionReceipt citationEligible contentCompleteInnehåll som inte är giltigt som fakta används endast för lokalisering eller för att förklara luckor

Vanliga HTTP-situationer

  • 401: Bearer saknas eller är ogiltig; förnya eller auktorisera på nytt enligt det aktuella OAuth-flödet.
  • 403: Grant, roll, vald resurs, källbehörighet, Origin eller konfiguration uppfyller inte kraven; försök inte kringgå det genom att skicka om förfrågan.
  • 400: Meddelandet eller det versionshanterade kontraktet är ogiltigt, inklusive inkonsekvens mellan moderna huvuden och metadata.
  • 404: Kontrollera exakt tjänstesökväg, protokollmetod och runtime-funktioner; byt inte ontologi-ID på måfå.
  • 405: GET och DELETE är över huvud taget inte tillgängliga på den offentliga /mcp; använd rätt POST i stället för att upprätta en långlivad SSE-anslutning.

Skrivoperationer med oklart resultat

MCP_OPERATION_OUTCOME_UNKNOWN kan innehålla outcome=UNKNOWN, retryable=false, nextAction=READ_ORIGINAL_STATUS, recoveryTool samt de ursprungliga lokaliseringsparametrarna. Kontrollera först den ursprungliga statusen och återuppta sedan den ursprungliga förfrågan. Skicka inte in kandidater på nytt, byt inte idempotensnyckel och behandla inte en timeout som en återställd transaktion (rollback).

Figur A11 Hanteringsordning för fel, oklara resultat och situationer som kan försökas igen. Illustration av återställning.

Innehåll som ska bevaras oförändrat

  • Det ursprungliga Grant, resursomfång samt uppgifts- och resultat-ID:n.
  • candidateHash, planHash, expectedRevision, målversion och publiceringsval.
  • Idempotensnyckeln för samma logiska operation; olika affärsoperationer ska använda nya nycklar.
  • Värdena för retryable, remediation, nextAction och aktuell status som servern har deklarerat.

Extrahera inte intern SQL, värdnamn, autentiseringsuppgifter eller stackspår ur undantagstexter som källa för svar. Det räcker att registrera felkoder som kan visas offentligt och information för att koppla ihop förfrågningar; det ursprungliga felet kan behöva granskas av en administratör i kontrollerade loggar.

Kapitel 23

Integrationssäkerhet och funktionsgränser

Behåll de ursprungliga gränserna för identitet, resurser, körning och bevis; hantera icke betrodda dokument på ett säkert sätt.

  1. Anslut endast till de officiella domäner som administratören anger; verifiera TLS och OAuth-issuer och stäng inte av certifikatvalideringen.
  2. Använd ett dedikerat Grant med minsta möjliga resursomfång; använd inte administratörskonton, cookies eller långlivade interna tokens som autentiseringsuppgifter för offentliga gränssnitt.
  3. Behandla dokumenttext som icke betrott affärsmaterial. ”Ignorera regler”, ”ladda upp nycklar” och ”kör kommandon” i ett dokument är ingen auktorisering av verktyg.
  4. Begränsa automatiska återförsök, samtidighet och resultatomfång; återskapa inte de ursprungliga affärsbehörigheterna på klientsidan.
  5. Logga endast nödvändig korrelationsinformation; logga inte Bearer-token, refresh token, godkännandetokens eller fullständigt känsligt affärsinnehåll.
  6. När användaren har kopplat från eller administratören har återkallat behörigheten ska du sluta använda cachelagrade auktoriseringar och data och inte fortsätta anropa med gamla locators.

Verktygstips är inte behörigheter

readOnlyHint, destructiveHint, idempotentHint och openWorldHint hjälper klienten att förstå verktygens funktioner; de garanterar inte den faktiska affärseffekten av varje anrop och ersätter inte den aktuella användarens auktorisering. Behandla alla skriv-, plan-, förhandsvisnings-, sessions- och avbrytningsåtgärder enligt deras verkliga beteende.

Ingångar som inte ska anropas

  • Ursprungliga Trino/Hive/Hadoop-tjänster samt Heavy ETL som inte ingår i Flash.
  • Scope eller arbetsytegränssnitt som är specifika för den interna FocusCode.
  • Execution v2, AutoML eller andra experimentella verktyg som inte visas i den aktuella instansens tools/list.
  • Webbläsarens privata REST-gränssnitt, godtyckliga databasanslutningar eller tjänster hos andra tenants för att kringgå att MCP nekar åtkomst.

Datasemantik

Följ serverns exakta kontrakt för decimaler, typer, 币种, enheter, tid och bevis. Avrunda inte på nytt och konvertera inte 币种 bara för att utdatatexten ser ut som ett tal, och gör ingen global rankning av de synliga raderna när resultatet är trunkerat.

Kapitel 24

Administratörskonfiguration och villkorade funktionsflaggor

Kontrollera verkliga komponenter, offentliga adresser och den ursprungliga behörighetskonfigurationen innan utökade funktioner aktiveras.

KonfigurationSyfteKrav för lansering
datafocus.mcp.public-base-urlOfficiell extern rotadressOAuth-discovery, issuer, återanrop och omvänd proxy stämmer överens
datafocus.mcp.allowed-originsYtterligare godkända webbläsarursprung (origins)Exakt konfiguration; utvidga inte till godtyckliga ursprung
datafocus.mcp.oauth.route-proof-secretDedikerad serverhemlighet för bevis vid grafroutningFörvaras separat; använd inte en Bearer-token som nyckel
datafocus.mcp.analysis.tools.enabledInteraktiva analysverktygTillhörande data-, kunskaps- och behörighetstjänster är faktiskt tillgängliga
datafocus.mcp.analysis.report-tools.enabledBeständiga rapportverktygTillhörande lagring, worker och återställningskedja är tillgängliga
datafocus.mcp.analysis.apps.enabledMCP Apps-visningKlienten deklarerar stöd och kontrollerar den returnerade _meta
datafocus.mcp.authoring.enabledUtkast- och modelleringskontraktDe ursprungliga administratörs- och resursbehörigheterna behålls
datafocus.mcp.authoring.apply-enabledTillämpning av artefakterOföränderlig plan, ursprungligt godkännande och omvalidering av aktuell status
datafocus.mcp.ontology-published-query-enabledPublicerade modeller och frågorVerkliga committade versioner och auktorisering av källor
datafocus.mcp.ontology-candidate-query-enabledStrukturerade kandidatfrågorÄgarskap för kandidaten, exakt version och läsbehörighet
datafocus.mcp.authoring.ontology-auto-publication-enabledAuktorisering för delegering av automatisk publiceringGiltig ursprunglig policy, förtroende för offentliga nycklar, budget och publiceringsrätt

Namnen kommer från konfigurationen och implementationen i r56; om de kan aktiveras beror på tillhörande tjänster och de ursprungliga grindarna för lansering. Att bara ändra ett booleskt värde ersätter inte saknade processorer, databaser, valideringsbudgetar eller policyer. Om tilläggen för kunskapsinmatning och Pi-uppgifter syns avgörs av vilka komponenter som faktiskt är installerade.

Edge-proxy

Behåll Authorization, Content-Type, MCP-Protocol-Version, Mcp-Method, Mcp-Name och godkänd Origin. Ställ in förfrågningskropp, timeout och TLS enligt tjänstens faktiska krav; vidarebefordra inte den offentliga /mcp till en administrationsport eller till en annan produkt.

Kontroller inför lansering

  • Statusen för anonym discovery och skyddade anrop är som förväntat.
  • Vanliga användare kan bara identifiera det som ingår i deras auktorisering; efter återkallad behörighet nekas efterföljande förfrågningar.
  • Inbyggda Search-sessioner, SQL, originaltext och valfria rapporter ger alla verkliga resultat.
  • Godkännanden och idempotent återställning för skriv- och publiceringsoperationer behåller ursprungligt beteende.
  • Loggar och offentlig dokumentation innehåller inte privata nycklar, tokens, cookies, lösenord eller interna kunduppgifter.
Kapitel 25

Körbara klienter och anropsexempel

Verifiera meddelanden med den tillhörande minimala klienten; kringgå inte OAuth eller den aktuella auktoriseringen.

examples/flash_mcp.py är en minimal protokollklient som bara är beroende av Pythons standardbibliotek. Den loggar inte in, godkänner inget å användarens vägnar, anropar inte automatiskt verktyg som inte syns, stöder både moderna och äldre protokoll och avslutas på olika nivåer vid fel i HTTP, JSON-RPC eller verktyg. Token anges via processmiljön och skrivs inte in i skript eller dokumentationsfiler.

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

Läsning och frågor

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

Ersätt först platshållare som ONTOLOGY_ID och TABLE_RESOURCE_ID i förfrågningsfilen med de verkliga värden som den aktuella auktoriseringen har returnerat. Klienten vägrar att köra om platshållare påträffas. SQL-exemplet kräver att den medföljande CSV-filen har importerats med de ursprungliga kolumnnamnen; utan motsvarande schema kan det inte skickas in direkt.

Andra scenarier

  • Affärsingång: använd --endpoint business och hämta ett nytt Grant för /mcp/business.
  • Äldre klient: välj --protocol 2025-11-25, kör först initialize och anropa sedan med samma protokoll.
  • Inbyggd dokumentation: läs de verkliga URI:erna med resources eller read-resource.
  • Självtest offline: --self-test verifierar att moderna huvuden och metadata byggs korrekt, kräver ingen token och skickar inga förfrågningar till produktens server.

Exemplets avgränsningar

Klienten är startpunkten för protokollanslutning och genererar inte automatiskt modelleringskandidater, sparar inte frågor och svar och utför ingen publicering. Den skriver ut den ursprungliga JSON så att agenten i lagret ovanför kan kontrollera affärsstatusen; lova inte användaren att en fråga, rapport eller publicering är slutförd enbart utifrån processens slutkod.

Kapitel 26

Bädda in ontologins dialoggränssnitt

Bädda in dialogsidan för människor i affärsapplikationens frontend och behåll gränserna för inloggning och webbläsarsäkerhet.

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 är ett exempel på tenant-ID och 1001 ett exempel på ontologi-ID; ersätt dem vid användning med verkliga koordinater du har behörighet till. En enskild ontologi kan anges via path eller en query som stöds; i läget all kan användaren med @ välja bland de ontologier som hen har åtkomst till. skillId skickas bara vidare; påstå inte utifrån det att orkestrering av skills redan kan köras.

Autentisering och domäner

Den nuvarande inbäddade sidan kräver en verklig DataFocus-inloggningssession och kontrollerar /uc/status. Cookies över flera webbplatser, SSO, CSP frame-ancestors och gatewaykonfiguration påverkar inbäddningen. Den accepterar inte att en MCP Bearer-token läggs i URL:en som en väg förbi inloggningen; externa outside-länkar som ännu inte är implementerade får inte konstrueras på egen hand utifrån designförslag.

Skillnaden mellan MCP och iframe

MetodAnvändareIdentitet och resultat
Remote MCPExterna agenter eller tjänsteintegrationerOAuth Grant och strukturerade verktygskvitton
Ontologidialog i iframeSlutanvändare (människor)Ursprunglig inloggningssession och dialoggränssnitt
MCP AppsMCP-klienter med stöd för tilläggetKontrollerade resurser och aktuella verktygsresultat, ingen ersättning för inloggning via en offentlig iframe
Kapitel 27

Checklista för integrationsgodkännande

Visa att hela affärskedjan fungerar på en verklig instans, i stället för att bara bekräfta att gränssnittet returnerar 200.

  1. Discovery: hämta de versioner som faktiskt stöds, den aktuella verktygskatalogen och inbyggda resurser.
  2. Auktorisering: vanliga användare ser endast godkända ontologier och affärssystem; åtgärder utan scope nekas.
  3. Tabellstruktur: verkliga visningsnamn, kolumner, typer och behörigheter är fullständiga.
  4. SQL: kontroller av endimensionella, flerdimensionella, JOIN-, datum-, TopN- och trunkeringsfrågor motsvarar faktiska affärsdefinitioner.
  5. Kunskap: lokalisering, fullständig originaltext och giltighet som faktareferens stämmer överens; blandade frågor har både data- och dokumentunderlag.
  6. Search: kontrollerna av modell, init, förslag, resultat, stängning och buffertens fullständighet klaras.
  7. Valfri analys och rapportering: verklig status för flera grenar, sidbläddring, behörighetsändringar och avbrytande behåller det ursprungliga beteendet.
  8. Valfri modellering: kandidat, plan, ursprungligt godkännande, faktisk tillämpning och versionsfrågor kontrolleras steg för steg.
  9. Affärsåtgärder: publiceringshash, målversion, godkännande, idempotens och isolering mellan olika Grant kontrolleras.
  10. Återställning: efter en nätverkstimeout återställs det ursprungliga tillståndet; när källan uppdateras blir gamla lokaliseringar ogiltiga och nya frågor används.

Dokumentation av resultat

Dokumentera instansversion, användarroll, Grant-omfång, konfigurationsversion, faktiska åtgärder och resultat. Protokollklientens offline-självtest, förväntade offlinevärden för exempel-CSV, statisk JSON Schema-validering och verkligt funktionellt acceptanstest i drift märks var för sig. Dra inte slutsatsen att hela produkten är godkänd bara för att ett steg har godkänts.

Kapitel 28

Referensresurser och underhåll

Använd de fullständiga verktygsscheman som medföljer manualen och håll dem synkroniserade med instansens faktiska discovery-resultat.

ResurserInnehåll
reference/mcp-tool-catalog.jsonDeklarerade indatascheman för 32 verktyg på ontologisidan och 8 på affärssidan; vissa verktyg har även det ursprungliga outputSchema
reference/locales.json21 valbara och 24 kompatibla locales samt UI-terminologi
reference/search-keywords.jsonStatisk nyckelordskatalog för 17 uttryckligen angivna locales
reference/analysis-contract-manifest.jsonVersionsbegränsningar för analys, grenar, fakta, kvitton och rapporter
examples/Syntetisk CSV, beskrivning av affärsdefinitioner, Top3-SQL, förväntade resultat och en minimal protokollklient

Inbyggda beskrivningsresurser

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

resources/list och resources/read kräver att den aktuella användaren har motsvarande läsbehörighet för minst en av metadata, search operate eller etl operate. ETL-dokumentationen är en statisk referens mellan produkter; Flashs körbara funktioner är fortfarande begränsade till det som Flash uttryckligen rapporterar.

Extern protokollreferens

För MCP-protokollet och auktoriseringsbakgrunden, se de officiella specifikationerna: https://modelcontextprotocol.io/specification/2026-07-28/basic och https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization. För den här produktens slutpunkter, verktyg och villkorade beteenden gäller implementationen i r56 och instansens aktuella discovery-resultat; allmänt protokollstöd får inte jämställas med att servern tillhandahåller alla valfria funktioner.

Uppgradering och underhåll

Vid uppgradering gör du om discovery av verktyg och versioner och jämför indatascheman, utdatakontrakt och konfiguration; ett gammalt Grant får inte automatiskt nya scope. Håll referenser, cache och kvitton bundna till källversionen, hämta kontexten på nytt när inkompatibla ändringar har bekräftats och tvinga inte in gamla lokaliseringar i ett nytt affärstillstånd.

Kapitel 29

Referens för verktygsparametrar: grundläggande verktyg och inbyggd Search

Fullständiga namn och indatafält, grupperade per verktyg.

Tabellerna nedan är en läsreferens för indatafälten i de aktuella r56-verktygen. Fullständiga nästlade typer, oneOf, villkorligt obligatoriska fält, mönsterbegränsningar och vissa utdatascheman finns i reference/mcp-tool-catalog.json; läs ändå tools/list för det aktuella Grant innan du skickar in slutgiltigt. ”Valfri” i tabellen tar inte bort kraven från åtgärdens interna validering.

dfc_manual

ParameterTypKravBetydelse och omfång
namesarrayValfri eller villkorligt obligatoriskUttryckliga namn att slå upp, högst 32 per anrop. maxItems: 32
actionstringValfri eller villkorligt obligatoriskÅtgärdens namn. Används enligt aktuell enum tillsammans med de parametrar som hör till respektive åtgärd. enum: list, read, keywords, functions, etl_requests
localestringValfri eller villkorligt obligatoriskUttrycklig locale för den statiska referenskatalogen, inte standardspråk för frågor.
uristringValfri eller villkorligt obligatoriskURI för inbyggda resurser som listas av det aktuella verktyget. enum: datafocus://manuals/etl-formulas/v1, datafocus://manuals/search-keyword-queries/v1, datafocus://manuals/etl-functions/v1, datafocus://manuals/search-keywords/v1

dfc_search

ParameterTypKravBetydelse och omfång
dataobjectValfri eller villkorligt obligatoriskUrsprunglig payload för åtgärden; se tabellen över funktionsidentifiering och åtgärdsfält.
actionstringObligatoriskÅtgärdens namn. Används enligt aktuell enum tillsammans med de parametrar som hör till respektive åtgärd. enum: capabilities, model_create, model_read, open, request, poll, cancel, close

dfc_etl

ParameterTypKravBetydelse och omfång
dataobjectValfri eller villkorligt obligatoriskUrsprunglig payload för åtgärden; se tabellen över funktionsidentifiering och åtgärdsfält.
actionstringObligatoriskÅtgärdens namn. Används enligt aktuell enum tillsammans med de parametrar som hör till respektive åtgärd. enum: capabilities

dfc_ontologies

ParameterTypKravBetydelse och omfång
pageSizeintegerValfri eller villkorligt obligatoriskAntal poster per sida; enligt schemats gräns. minimum: 1; maximum: 100
pageintegerValfri eller villkorligt obligatoriskSidnummer, börjar på 1. minimum: 1

dfc_ontology_resources

ParameterTypKravBetydelse och omfång
resourceTypesarrayValfri eller villkorligt obligatoriskUppsättning resurstyper som ska returneras.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
pageSizeintegerValfri eller villkorligt obligatoriskAntal poster per sida; enligt schemats gräns. minimum: 1; maximum: 100
pageintegerValfri eller villkorligt obligatoriskSidnummer, börjar på 1. minimum: 1
Kapitel 30

Referens för verktygsparametrar: tabeller, graf och kunskap

Fullständiga namn och indatafält, grupperade per verktyg.

Tabellerna nedan är en läsreferens för indatafälten i de aktuella r56-verktygen. Fullständiga nästlade typer, oneOf, villkorligt obligatoriska fält, mönsterbegränsningar och vissa utdatascheman finns i reference/mcp-tool-catalog.json; läs ändå tools/list för det aktuella Grant innan du skickar in slutgiltigt. ”Valfri” i tabellen tar inte bort kraven från åtgärdens interna validering.

dfc_ontology_graph

ParameterTypKravBetydelse och omfång
relationTypesarrayValfri eller villkorligt obligatoriskFilter för relationstyp.
depthintegerValfri eller villkorligt obligatoriskDjup för granntraversering. minimum: 1; maximum: 3
sourceTypesarrayValfri eller villkorligt obligatoriskFilter för källtyp.
queryobjectValfri eller villkorligt obligatoriskFrågetext, eller exakt versionerat frågeobjekt motsvarande action.
limitintegerValfri eller villkorligt obligatoriskHögsta antal resultat som returneras. minimum: 1; maximum: 100
actionstringObligatoriskÅtgärdens namn. Används enligt aktuell enum tillsammans med de parametrar som hör till respektive åtgärd. enum: search, neighbors, published_model, published_query, candidate_query
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
nodeKeystringValfri eller villkorligt obligatoriskNodnyckel kopierad från faktiskt grafresultat.
keywordstringValfri eller villkorligt obligatoriskNyckelord för graflokalisering, inte syntaxen för nyckelordsfrågor.
nodeTypesarrayValfri eller villkorligt obligatoriskFilter för nodtyp.

dfc_ontology_query

ParameterTypKravBetydelse och omfång
routeLocatorsarrayValfri eller villkorligt obligatoriskDen typade routningslokalisering som servern har utfärdat, kopierad i sin helhet. maxItems: 20
topKintegerValfri eller villkorligt obligatoriskHögsta antal kandidater vid återhämtning (recall); bevisar inte fullständig täckning. minimum: 1; maximum: 20
queryModestringValfri eller villkorligt obligatoriskLäge för bevisfrågor, väljs enligt verktygets enum. enum: vector, hybrid, graph
fanoutPlanobjectValfri eller villkorligt obligatoriskBegränsad sökplan för grenar, enligt det nästlade schemat.
structuredPlanobjectValfri eller villkorligt obligatoriskPlan för en fullständig dokumenttabell, bunden till serverns kontrakt; inte SQL.
knowledgeIdsarrayValfri eller villkorligt obligatoriskKunskapsbas-ID från faktiska knowledgeBindings.
querystringObligatoriskFrågetext, eller exakt versionerat frågeobjekt motsvarande action.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.

dfc_knowledge_search

ParameterTypKravBetydelse och omfång
topKintegerValfri eller villkorligt obligatoriskHögsta antal kandidater vid återhämtning (recall); bevisar inte fullständig täckning. minimum: 1; maximum: 20
minScorenumberValfri eller villkorligt obligatoriskLägsta matchpoäng. minimum: 0; maximum: 1
knowledgeIdsarrayValfri eller villkorligt obligatoriskKunskapsbas-ID från faktiska knowledgeBindings.
querystringObligatoriskFrågetext, eller exakt versionerat frågeobjekt motsvarande action.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
assetIdsarrayValfri eller villkorligt obligatoriskAsset-ID:n för dokument som för närvarande är tillåtna.
retrievalStrategystringValfri eller villkorligt obligatoriskSökstrategi som faktiskt stöds. enum: auto, hybrid_stage2

dfc_knowledge_detail

ParameterTypKravBetydelse och omfång
qdrantIdstring / integerValfri eller villkorligt obligatoriskIndexidentifierare som returnerats vid faktisk lokalisering.
pageNointegerValfri eller villkorligt obligatoriskFaktiskt sidnummer i dokumentet eller i sidnumreringen.
evidenceIdstringValfri eller villkorligt obligatoriskBevis-ID som returnerats för samma kunskapslokalisering.
actionstringObligatoriskÅtgärdens namn. Används enligt aktuell enum tillsammans med de parametrar som hör till respektive åtgärd. enum: chunk, document, page_context
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
documentIdstring / integerValfri eller villkorligt obligatoriskDokument-ID för samma lokalisering.
radiusintegerValfri eller villkorligt obligatoriskIntilliggande sidintervall. minimum: 0; maximum: 3
chunkIdstringValfri eller villkorligt obligatoriskFaktiskt chunk-ID för samma lokalisering.

dfc_table

ParameterTypKravBetydelse och omfång
maxRowsintegerValfri eller villkorligt obligatoriskHögsta antal rader som returneras; inte ett rankningsomfång för klienten. minimum: 1; maximum: 200
actionstringObligatoriskÅtgärdens namn. Används enligt aktuell enum tillsammans med de parametrar som hör till respektive åtgärd. enum: detail, query
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
idstringValfri eller villkorligt obligatoriskVerkligt tabellresurs-ID, inte fysiskt namn eller visningsnamn.
sqlstringValfri eller villkorligt obligatoriskEn enda skrivskyddad Doris-SQL-sats inom ontologins omfång, med explicita utdatakolumner.
Kapitel 31

Referens för verktygsparametrar: analys och rapportering

Fullständiga namn och indatafält, grupperade per verktyg.

Tabellerna nedan är en läsreferens för indatafälten i de aktuella r56-verktygen. Fullständiga nästlade typer, oneOf, villkorligt obligatoriska fält, mönsterbegränsningar och vissa utdatascheman finns i reference/mcp-tool-catalog.json; läs ändå tools/list för det aktuella Grant innan du skickar in slutgiltigt. ”Valfri” i tabellen tar inte bort kraven från åtgärdens interna validering.

dfc_analysis_ask

ParameterTypKravBetydelse och omfång
questionstringObligatoriskFråga på naturligt språk eller kompatibel uppföljningsfråga.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
languagestringValfri eller villkorligt obligatoriskExplicit locale för svar eller fråga; om den utelämnas gäller respektive verktygs regler.
sessionIdstringValfri eller villkorligt obligatoriskVerklig sessionslokalisering under samma Grant.

dfc_analysis_refine

ParameterTypKravBetydelse och omfång
branchIdstringValfri eller villkorligt obligatoriskStrukturerad grenlokalisering utfärdad av servern.
resultIdstringObligatoriskLokalisering av det ursprungliga analysresultatet.
questionstringValfri eller villkorligt obligatoriskFråga på naturligt språk eller kompatibel uppföljningsfråga.
idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd.
changeobjectValfri eller villkorligt obligatoriskÄndring på naturligt språk eller typad filter_patch.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
languagestringValfri eller villkorligt obligatoriskExplicit locale för svar eller fråga; om den utelämnas gäller respektive verktygs regler.
sessionIdstringObligatoriskVerklig sessionslokalisering under samma Grant.
expectedRevisionintegerObligatoriskVersionsvillkor för det ursprungliga resultatet eller affärshuvudet; kan vara null när frågan skapas. minimum: 1
visualIdstringValfri eller villkorligt obligatoriskVisualiseringslokalisering bunden till grenen.

dfc_analysis_page

ParameterTypKravBetydelse och omfång
branchIdstringObligatoriskStrukturerad grenlokalisering utfärdad av servern.
resultIdstringObligatoriskLokalisering av det ursprungliga analysresultatet.
pageNointegerObligatoriskFaktiskt sidnummer i dokumentet eller i sidnumreringen. minimum: 1; maximum: 10000
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
pageSizeintegerObligatoriskAntal poster per sida; enligt schemats gräns. minimum: 1; maximum: 100
sessionIdstringObligatoriskVerklig sessionslokalisering under samma Grant.
expectedRevisionintegerObligatoriskVersionsvillkor för det ursprungliga resultatet eller affärshuvudet; kan vara null när frågan skapas. minimum: 1

dfc_analysis_result_get

ParameterTypKravBetydelse och omfång
resultIdstringObligatoriskLokalisering av det ursprungliga analysresultatet.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
sessionIdstringObligatoriskVerklig sessionslokalisering under samma Grant.

dfc_analysis_cancel

ParameterTypKravBetydelse och omfång
resultIdstringObligatoriskLokalisering av det ursprungliga analysresultatet.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
sessionIdstringObligatoriskVerklig sessionslokalisering under samma Grant.

dfc_analysis_close

ParameterTypKravBetydelse och omfång
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
sessionIdstringObligatoriskVerklig sessionslokalisering under samma Grant.

dfc_report_create

ParameterTypKravBetydelse och omfång
goalstringObligatoriskRapportens analysmål.
idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
languagestringValfri eller villkorligt obligatoriskExplicit locale för svar eller fråga; om den utelämnas gäller respektive verktygs regler.
titlestringValfri eller villkorligt obligatoriskValfri rapportrubrik.

dfc_report_status

ParameterTypKravBetydelse och omfång
reportIdstringObligatoriskLokalisering av en beständig rapport för det aktuella Grant.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.

dfc_report_cancel

ParameterTypKravBetydelse och omfång
reportIdstringObligatoriskLokalisering av en beständig rapport för det aktuella Grant.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
Kapitel 32

Referens för verktygsparametrar: modellering och agentuppgifter

Fullständiga namn och indatafält, grupperade per verktyg.

Tabellerna nedan är en läsreferens för indatafälten i de aktuella r56-verktygen. Fullständiga nästlade typer, oneOf, villkorligt obligatoriska fält, mönsterbegränsningar och vissa utdatascheman finns i reference/mcp-tool-catalog.json; läs ändå tools/list för det aktuella Grant innan du skickar in slutgiltigt. ”Valfri” i tabellen tar inte bort kraven från åtgärdens interna validering.

dfc_ontology_agent

ParameterTypKravBetydelse och omfång
modestringValfri eller villkorligt obligatoriskQUERY eller AUTHORING; funktionerna auktoriseras var för sig. enum: QUERY, AUTHORING
instructionstringValfri eller villkorligt obligatoriskAnvändarens kravtext; måste vara densamma i context och submit. maxLength: 16000
idempotencyKeystringValfri eller villkorligt obligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd. maxLength: 128
actionstringObligatoriskÅtgärdens namn. Används enligt aktuell enum tillsammans med de parametrar som hör till respektive åtgärd. enum: start, status, cancel
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
runIdstringValfri eller villkorligt obligatoriskUrsprungligt uppgifts-ID för samma ontologi och Grant.
contractVersionstringObligatoriskMåste vara en exakt kontraktsversion som faktiskt stöds. enum: ontology-agent-task-v1

dfc_authoring_capabilities

Rotobjektet för verktygets indata har inga fält; använd ett tomt arguments-objekt.

dfc_artifact_context

ParameterTypKravBetydelse och omfång
artifactTypestringObligatoriskArtefakt- eller ontologipubliceringstyp som faktiskt är aktiverad. enum: CONTROL_PANEL_SPEC, VIEW_SPEC
scopeTypestringValfri eller villkorligt obligatoriskTyp av resursomfång i det faktiska artefaktkontraktet.
ontologyIdstringValfri eller villkorligt obligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
projectIdstringValfri eller villkorligt obligatoriskAktuellt auktoriserat projekt-ID.
artifactIdstringValfri eller villkorligt obligatoriskVerkligt ID för den befintliga artefakt som redigeras.
instructionstringObligatoriskAnvändarens kravtext; måste vara densamma i context och submit.
variablesobjectValfri eller villkorligt obligatoriskVariabelobjekt enligt det returnerade kontraktet.
previewInputobjectValfri eller villkorligt obligatoriskBegränsade indata för förhandsvisning enligt kontraktet.
viewportobjectValfri eller villkorligt obligatoriskVisningsområde (viewport) som det ursprungliga kontraktet kräver.

dfc_ontology_table_schema

ParameterTypKravBetydelse och omfång
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
sourceAssetRefstringObligatoriskRegistrerad strukturerad tillgångsreferens, t.ex. table:123.
fieldsarrayObligatoriskFält i den aktuella källan samt valfria explicita typdeklarationer. minItems: 1; maxItems: 64

dfc_artifact_preview

ParameterTypKravBetydelse och omfång
proposalIdstringObligatoriskUrsprungligt kandidat-ID som skapades med det aktuella Grant.
candidateHashstringObligatoriskExakt hash för den ursprungliga kandidaten på servern.
previewInputobjectObligatoriskBegränsade indata för förhandsvisning enligt kontraktet.

dfc_artifact_status

ParameterTypKravBetydelse och omfång
proposalIdstringValfri eller villkorligt obligatoriskUrsprungligt kandidat-ID som skapades med det aktuella Grant.
planIdstringValfri eller villkorligt obligatoriskID för den oföränderliga tillämpningsplanen.

dfc_artifact_plan

ParameterTypKravBetydelse och omfång
proposalIdstringObligatoriskUrsprungligt kandidat-ID som skapades med det aktuella Grant.
candidateHashstringObligatoriskExakt hash för den ursprungliga kandidaten på servern.
expectedTargetVersionintegerObligatoriskVillkor om den aktuella verkliga målversionen. minimum: 0
idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd.

dfc_artifact_apply

ParameterTypKravBetydelse och omfång
planIdstringObligatoriskID för den oföränderliga tillämpningsplanen.
planHashstringObligatoriskHash som returnerades för den ursprungliga planen.
approvalTokenstringObligatoriskGodkännandematerial som utfärdats av den ursprungliga servern; får inte genereras på egen hand.
idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd.

dfc_artifact_submit

ParameterTypKravBetydelse och omfång
Konfiguration 1 / artifactTypestringObligatoriskArtefakt- eller ontologipubliceringstyp som faktiskt är aktiverad. enum: CONTROL_PANEL_SPEC, VIEW_SPEC
Konfiguration 1 / scopeTypestringValfri eller villkorligt obligatoriskTyp av resursomfång i det faktiska artefaktkontraktet.
Konfiguration 1 / ontologyIdstringValfri eller villkorligt obligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
Konfiguration 1 / projectIdstringValfri eller villkorligt obligatoriskAktuellt auktoriserat projekt-ID.
Konfiguration 1 / artifactIdstringValfri eller villkorligt obligatoriskVerkligt ID för den befintliga artefakt som redigeras.
Konfiguration 1 / instructionstringObligatoriskAnvändarens kravtext; måste vara densamma i context och submit.
Konfiguration 1 / variablesobjectValfri eller villkorligt obligatoriskVariabelobjekt enligt det returnerade kontraktet.
Konfiguration 1 / previewInputobjectValfri eller villkorligt obligatoriskBegränsade indata för förhandsvisning enligt kontraktet.
Konfiguration 1 / viewportobjectValfri eller villkorligt obligatoriskVisningsområde (viewport) som det ursprungliga kontraktet kräver.
Konfiguration 1 / contractVersionstringObligatoriskMåste vara en exakt kontraktsversion som faktiskt stöds.
Konfiguration 1 / contextHashstringObligatoriskFullständig kontexthash som returnerats av context.
Konfiguration 1 / baseArtifactHashstringObligatoriskHash för basartefakten som returnerats av context.
Konfiguration 1 / baseArtifactVersionintegerObligatoriskBasversion som returnerats av context. minimum: 0
Konfiguration 1 / candidateobjectObligatoriskKandidatobjekt som överensstämmer med det aktuella returnerade kontraktet.
Konfiguration 1 / clientRequestIdstringObligatoriskKlientens idempotensnyckel, som används stabilt för den aktuella kandidatförfrågan.
Konfiguration 2 / artifactTypestringObligatoriskArtefakt- eller ontologipubliceringstyp som faktiskt är aktiverad. enum: ONTOLOGY_RELEASE
Konfiguration 2 / contractVersionstringObligatoriskMåste vara en exakt kontraktsversion som faktiskt stöds. 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
Konfiguration 2 / ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
Konfiguration 2 / candidateHashstringObligatoriskExakt hash för den ursprungliga kandidaten på servern.
Konfiguration 2 / workspaceIdstringObligatoriskFaktiska arbetsytekoordinater för kandidaten.
Konfiguration 2 / workspaceRevisionstringObligatoriskExakt kandidatversion; använd inte latest.
Konfiguration 2 / releasesobjectObligatoriskExakt versionsval enligt kontraktet för ontologipublicering.
Konfiguration 2 / selectionobjectObligatoriskAnger endast uttryckliga koordinater för affärsurvalet, inte behörigheter eller bevis på slutförande.
Konfiguration 2 / idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd.
Konfiguration 3 / Konfiguration 1 / artifactTypestringObligatoriskArtefakt- eller ontologipubliceringstyp som faktiskt är aktiverad. enum: ONTOLOGY_RELEASE
Konfiguration 3 / Konfiguration 1 / contractVersionstringObligatoriskMåste vara en exakt kontraktsversion som faktiskt stöds. enum: ontology-workspace-create-mcp-submit-v1
Konfiguration 3 / Konfiguration 1 / ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
Konfiguration 3 / Konfiguration 1 / workspaceIdstringObligatoriskFaktiska arbetsytekoordinater för kandidaten.
Konfiguration 3 / Konfiguration 1 / resourcesarrayObligatoriskUrsprunglig modelldeklaration kompilerad på servern. minItems: 1
Konfiguration 3 / Konfiguration 1 / idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd.
Konfiguration 3 / Konfiguration 2 / artifactTypestringObligatoriskArtefakt- eller ontologipubliceringstyp som faktiskt är aktiverad. enum: ONTOLOGY_RELEASE
Konfiguration 3 / Konfiguration 2 / contractVersionstringObligatoriskMåste vara en exakt kontraktsversion som faktiskt stöds. enum: ontology-workspace-create-mcp-submit-v2
Konfiguration 3 / Konfiguration 2 / ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
Konfiguration 3 / Konfiguration 2 / workspaceIdstringObligatoriskFaktiska arbetsytekoordinater för kandidaten.
Konfiguration 3 / Konfiguration 2 / resourcesarrayObligatoriskUrsprunglig modelldeklaration kompilerad på servern. minItems: 1
Konfiguration 3 / Konfiguration 2 / idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd.
Konfiguration 3 / Konfiguration 2 / releaseSelectionsobjectObligatoriskExakt releaseId för varje publicerad referens samt dess beroendehölje.
Konfiguration 4 / artifactTypestringObligatoriskArtefakt- eller ontologipubliceringstyp som faktiskt är aktiverad. enum: ONTOLOGY_RELEASE
Konfiguration 4 / contractVersionstringObligatoriskMåste vara en exakt kontraktsversion som faktiskt stöds. enum: ontology-initial-activation-retirement-submit-v1
Konfiguration 4 / ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
Konfiguration 4 / domainRidstringObligatoriskVerklig RID för affärsdomänen.
Konfiguration 4 / consumerScopesarrayObligatoriskExakta konsumentscope som servern tillåter. minItems: 1; maxItems: 256
Konfiguration 4 / idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd.
Kapitel 33

Referens för verktygsparametrar: kunskapsinmatning och omfång

Fullständiga namn och indatafält, grupperade per verktyg.

Tabellerna nedan är en läsreferens för indatafälten i de aktuella r56-verktygen. Fullständiga nästlade typer, oneOf, villkorligt obligatoriska fält, mönsterbegränsningar och vissa utdatascheman finns i reference/mcp-tool-catalog.json; läs ändå tools/list för det aktuella Grant innan du skickar in slutgiltigt. ”Valfri” i tabellen tar inte bort kraven från åtgärdens interna validering.

dfc_ontology_knowledge_input_propose

ParameterTypKravBetydelse och omfång
requestobjectObligatoriskUrsprunglig förfrågan med affärsindata; enligt det fullständiga nästlade schemat.
idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd. minLength: 1; maxLength: 128

Det här verktyget har dessutom ett inbyggt outputSchema. Kontrollera utdatans fullständighet, status och de auktoriseringsfält som uttryckligen är false; tolka inte själv resultatet som mer slutfört än det är.

dfc_ontology_knowledge_input_preview

ParameterTypKravBetydelse och omfång
idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd. minLength: 1; maxLength: 128
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.

Det här verktyget har dessutom ett inbyggt outputSchema. Kontrollera utdatans fullständighet, status och de auktoriseringsfält som uttryckligen är false; tolka inte själv resultatet som mer slutfört än det är.

dfc_ontology_knowledge_question_submit

ParameterTypKravBetydelse och omfång
questionRevision$refObligatoriskExakt version av frågan som ska bekräftas.
idempotencyKey$refObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd.
originalInputKey$refObligatoriskIdempotensnyckel motsvarande den ursprungliga kunskapsinmatningen.
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng.
validUntil$refObligatoriskSlutpunkt för frågans giltighetsfönster, UTC-tid.
expectedRevisiononeOfObligatoriskVersionsvillkor för det ursprungliga resultatet eller affärshuvudet; kan vara null när frågan skapas.
validFrom$refObligatoriskStartpunkt för frågans giltighetsfönster, UTC-tid.

Det här verktyget har dessutom ett inbyggt outputSchema. Kontrollera utdatans fullständighet, status och de auktoriseringsfält som uttryckligen är false; tolka inte själv resultatet som mer slutfört än det är.

dfc_ontology_business_scope_initialize

ParameterTypKravBetydelse och omfång
domainRevisionIdstringObligatoriskExakt version av affärsdomänen. minLength: 1; maxLength: 128
idempotencyKeystringObligatoriskIdempotensnyckel som återanvänds stabilt för samma logiska åtgärd. minLength: 1; maxLength: 128
businessSystemIdstringObligatoriskVerkligt affärssystem-ID. minLength: 1
ontologyIdstringObligatoriskVerkligt ontologi-ID inom den här auktoriseringen, bevaras som sträng. minLength: 1
domainRidstringObligatoriskVerklig RID för affärsdomänen. minLength: 1; maxLength: 128

Det här verktyget har dessutom ett inbyggt outputSchema. Kontrollera utdatans fullständighet, status och de auktoriseringsfält som uttryckligen är false; tolka inte själv resultatet som mer slutfört än det är.

Kapitel 34

Referens för verktygsparametrar: affärsarbetsytan

Fullständiga namn och indatafält, grupperade per verktyg.

Tabellerna nedan är en läsreferens för indatafälten i de aktuella r56-verktygen. Fullständiga nästlade typer, oneOf, villkorligt obligatoriska fält, mönsterbegränsningar och vissa utdatascheman finns i reference/mcp-tool-catalog.json; läs ändå tools/list för det aktuella Grant innan du skickar in slutgiltigt. ”Valfri” i tabellen tar inte bort kraven från åtgärdens interna validering.

dfb_systems

Rotobjektet för verktygets indata har inga fält; använd ett tomt arguments-objekt.

dfb_system_describe

ParameterTypKravBetydelse och omfång
systemIdstring / integerObligatoriskSystem-ID som tillåts av det aktuella affärs-Grant.

dfb_query

ParameterTypKravBetydelse och omfång
systemIdstring / integerObligatoriskSystem-ID som tillåts av det aktuella affärs-Grant.
queryKeystringObligatoriskPublicerad frågenyckel som returnerats av describe.
objectKeystringValfri eller villkorligt obligatoriskPublicerad objektnyckel.
pageSizeintegerValfri eller villkorligt obligatoriskAntal poster per sida; enligt schemats gräns. minimum: 1; maximum: 100
pageintegerValfri eller villkorligt obligatoriskSidnummer, börjar på 1. minimum: 1
statestringValfri eller villkorligt obligatoriskFilter för affärsstatus eller serverstatus.

dfb_record

ParameterTypKravBetydelse och omfång
recordIdstring / integerObligatoriskID för en affärspost som du för närvarande har behörighet att läsa.
systemIdstring / integerObligatoriskSystem-ID som tillåts av det aktuella affärs-Grant.

dfb_work_items

ParameterTypKravBetydelse och omfång
systemIdstring / integerObligatoriskSystem-ID som tillåts av det aktuella affärs-Grant.

dfb_action_plan

ParameterTypKravBetydelse och omfång
expectedRecordVersionintegerValfri eller villkorligt obligatoriskMålpostens aktuella version för optimistisk låsning. minimum: 1
systemIdstring / integerObligatoriskSystem-ID som tillåts av det aktuella affärs-Grant.
commandTypestringObligatoriskKommandotyp enligt det publicerade kontraktet.
canonicalIrHashstringObligatoriskHash för den aktuella publicerade kanoniska IR.
releaseIdstring / integerObligatoriskVerkligt ID för den publicerade kontraktsversionen.
payloadobjectObligatoriskPayload som överensstämmer med det aktuella kommandokontraktet i describe.
releaseHashstringObligatoriskHash för det faktiska publicerade kontraktet.
targetRecordIdstring / integerValfri eller villkorligt obligatoriskVerklig målpost som ska åtgärdas.
agentManifestHashstringObligatoriskHash för det faktiska manifestet över agentens funktioner.
planIdempotencyKeystringObligatoriskStabil idempotensnyckel för affärsplanen.

dfb_action_status

ParameterTypKravBetydelse och omfång
actionPlanIdstring / integerObligatoriskID för en åtgärdsplan som ägs av det aktuella affärs-Grant.

dfb_action_execute

ParameterTypKravBetydelse och omfång
approvalTokenstringValfri eller villkorligt obligatoriskGodkännandematerial som utfärdats av den ursprungliga servern; får inte genereras på egen hand.
actionPlanIdstring / integerObligatoriskID för en åtgärdsplan som ägs av det aktuella affärs-Grant.