DATAFOCUS · OT FLASH · R56

OT Flash Agent- und MCP-Integrationshandbuch

Protokoll, Autorisierung, Tool-Verträge und vollständiger Aufrufablauf

Mit dem öffentlichen Remote-MCP von OT Flash r56 nachvollziehbare Daten- und Wissensanwendungen aufbauen. Dieses Handbuch beschreibt OAuth, Protokollnachrichten, die Parameterreferenz aller deklarierten Tools, Evidenzregeln, bedingte Fähigkeiten und Wiederherstellungsabläufe und enthält einen lauffähigen Client sowie Beispiele mit synthetischen Daten.

Agent-Entwickler, Integrationsingenieure und Administratoren

Die beigefügten Beispiele behalten chinesische Anzeigenamen für Felder bei. Die Übersetzung der Oberflächensprache und der Erläuterungstexte ändert keine tatsächlichen Tabellennamen, Spaltennamen, Enumerationswerte, Toolnamen oder Protokollfelder.

Kapitel 1

Agent-Integrationsumfang und Abschlusskriterien

Den passenden Autorisierungseinstieg wählen und Abfragen, Evidenzsicherung oder kontrollierte Schreibvorgänge anhand der Server-Quittungen abschließen.

OT Flash r56 stellt externen Agenten über Remote MCP Daten- und Wissensfähigkeiten im Rahmen der Ontologie bereit und bietet einen eigenständigen Einstieg in den Business Workspace. Agenten bestimmen die ausführbare Arbeit anhand der tatsächlichen tools/list, des inputSchema, der OAuth-Scopes und der aktuellen Ressourcenberechtigungen; aus einem statischen Handbuch dürfen sie nicht schließen, dass eine Bereitstellung alle optionalen Funktionen aktiviert hat.

Abbildung A1: Externe Agenten nutzen Originalabfrage, Wissen und Geschäftsfähigkeiten über OAuth und MCP. Schematische Darstellung der Schnittstellenbeziehungen.
EinstiegspunktZweckAbgrenzung
/mcpOntologie, Datentabellen, Dokumentenwissen, natives Search sowie bedingt freigegebene Analyse und ModellierungSchnittmenge aus aktuellen Benutzerberechtigungen und den in dieser Autorisierung freigegebenen Ressourcen
/mcp/businessDiscovery von Geschäftssystemen, Abfragen, Aktionspläne, Status und AusführungEigenständige Autorisierung für Geschäftssysteme und veröffentlichte Verträge
Eingebettete Seite des Ontologie-AgentenOntologie-Chat in der Benutzeroberfläche für Menschen verwendenSetzt eine echte Anmeldesitzung voraus; kein Einstieg, um ohne Anmeldung MCP-Tokens einzutauschen

Fähigkeitsklassifikation

  • Grundlegende Lesevorgänge: Ontologie und Ressourcen, Graphlokalisierung, Wissensabruf mit vollständigem Originaltext, autorisierte Tabellendetails und Doris SQL.
  • Eigenständige Delegierung: dfc_search erfordert search:operate und nutzt weiterhin die ursprünglichen Benutzer- und Modellberechtigungen.
  • Bedingt freigegeben: Analyse, persistente Berichte, Artefaktentwürfe und deren Anwendung, Ontologiemodellabfragen und delegierte Agent-Aufgaben.
  • Nicht verfügbare Fähigkeiten: Das dfc_etl von Flash meldet nur Capabilities und stellt keine Heavy-ETL-Ausführung bereit. AutoML sowie interne Einstiegspunkte des FocusCode-Workspace gehören nicht zur öffentlichen Flash-API dieses Handbuchs.

Abschlusskriterien

Fakten müssen mit einer tatsächlich nutzbaren Abfrage- oder vollständigen Originaltext-Quittung belegt werden; Kandidaten müssen als noch nicht angewendet gekennzeichnet sein; Veröffentlichungen erfordern eine echte APPLIED-Quittung; bei Abbrüchen ist zwischen Anforderung und Bestätigung zu unterscheiden. Antworttext, ein HTTP 200, die Annahme durch das Tool oder die Modellaussage „abgeschlossen“ belegen für sich allein keinen erfolgreichen Geschäftsvorgang.

Das zugehörige reference/mcp-tool-catalog.json ist eine Offline-Referenz der Deklarationen von r56 und enthält auch bedingt aktivierte Definitionen; es ist nicht die Echtzeit-tools/list eines Benutzers. Der vollständige Katalog umfasst 28 Ontologie-Kern-Tools, 4 bedingte Controller-Erweiterungen und 8 geschäftsseitige Tools; das bedeutet nicht, dass standardmäßig alle freigegeben sind.

Kapitel 2

Schnellverbindung und Fähigkeitsermittlung

Mit der offiziellen Domäne der Instanz beginnen und mit minimalen Berechtigungen die tatsächlich verfügbaren Tools ermitteln.

  1. Von einem Administrator die offizielle HTTPS-Basisadresse sowie die Ontologie oder das Geschäftssystem, auf das zugegriffen werden soll, erfragen. Die Beispieldomänen aus der Dokumentation nicht für echte Geschäftsaufrufe verwenden.
  2. Die MCP-Serveradresse als https://flash.example.com/mcp konfigurieren; der Business Workspace verwendet /mcp/business derselben Domäne.
  3. OAuth-Anmeldung und -Autorisierung gemäß Client-Unterstützung auslösen und Ressourcen und Scope prüfen; keine Benutzernamen/Passwörter an MCP übermitteln.
  4. Discovery oder Initialisierung der jeweiligen Protokollgeneration verwenden und anschließend tools/list und Ressourcenbeschreibungen lesen.
  5. Zuerst eine eng begrenzte, rein lesende Anfrage ausführen, strukturierte Ergebnisse und Fehlermeldungen prüfen und erst dann das Benutzerziel ausführen.

Client-Konfigurationsausschnitt

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

Dieser Ausschnitt veranschaulicht die Konfigurationsabsicht der Serveradresse; die konkrete Struktur der Konfigurationsdatei und die OAuth-Unterstützung hängen vom Client ab. Keine echten access_token, refresh_token, Cookies oder Administratorpasswörter in öffentlich einsehbaren Dateien eintragen.

Discovery moderner Protokolle

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

Prüfungen vor der Integration

  • Ressourcen-Basisadresse, OAuth-Issuer und externe Reverse-Proxy-Adresse sind konsistent.
  • Der Client unterstützt die entsprechende Protokollgeneration und sendet nicht pauschal initialize an den Einstiegspunkt des neuen Protokolls.
  • Die aktuelle Autorisierung ist an die benötigte Ontologie oder das benötigte Geschäftssystem gebunden.
  • Das Token ist gültig, und neue optionale Scopes wurden ausdrücklich autorisiert.
Kapitel 3

OAuth-Discovery, Registrierung und Autorisierung

Autorisierungscode und PKCE verwenden; Produkt-Anmeldeinformationen dem Agenten nicht offenlegen.

Abbildung A2: OAuth-Autorisierungscode- und PKCE-Ablauf. Sequenzdiagramm.
EndpunktMethodeZweck
/.well-known/oauth-protected-resourceGETRessourcen-Discovery für das Ontologie-MCP
/.well-known/oauth-protected-resource/mcpGETKompatibilitäts-Discovery über den Ontologie-Ressourcenpfad
/.well-known/oauth-protected-resource/mcp/businessGETRessourcen-Discovery für das Business-MCP
/.well-known/oauth-authorization-serverGETMetadaten des Autorisierungsservers
/oauth/registerPOST JSONDynamische Registrierung eines Public Clients
/oauth/authorizeGET- oder POST-FormularAnmeldung, Ressourcenauswahl und Autorisierungsbestätigung
/oauth/tokenPOST formEinlösung des Autorisierungscodes und Rotation des Refresh-Tokens
/oauth/revokePOST formToken-Widerruf
/oauth/grantsGETAngemeldete Benutzer zeigen ihre autorisierten Verbindungen an
/oauth/grants/revokePOST formVerbindung gemäß Ablauf der Originalseite widerrufen

Autorisierungsreihenfolge

  1. Metadaten der geschützten Ressource und des Autorisierungsservers lesen. Die 401-Antwort auf eine Anfrage ohne Token und der WWW-Authenticate-Header verweisen auf die Adresse der Ressourcen-Discovery.
  2. Client-Identität registrieren oder verwenden. In r56 verwendet die dynamische Registrierung eines Public Clients token_endpoint_auth_method=none; ein Client-Geheimnis darf PKCE nicht ersetzen.
  3. Zufällige Werte für state und code_verifier erzeugen und die S256-code_challenge berechnen.
  4. Die in den Metadaten angegebene authorize-Adresse öffnen und response_type=code, client_id, exakte redirect_uri, scope, resource, state, code_challenge und code_challenge_method=S256 übergeben.
  5. Der Benutzer meldet sich bei DataFocus an und wählt die Ontologie oder das Geschäftssystem. Der Client darf Ressourcen, auf die der Benutzer keinen Zugriff hat, nicht vorab auswählen.
  6. Callback empfangen und state und Issuer prüfen; den Autorisierungscode mit dem ursprünglichen code_verifier einlösen.
  7. access_token ausschließlich für die MCP-Bearer-Authentifizierung verwenden. Die Aktualisierung folgt dem ursprünglichen OAuth-Ablauf; das rotierte refresh_token sicher speichern.

Registrierungsbeispiel

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

Web-Clients verwenden HTTPS für den Callback; native Clients können unterstützte Loopback-Adressen verwenden. Autorisierung und Token-Austausch müssen exakt mit dem registrierten Callback übereinstimmen. Ein Grant gilt für genau eine geschützte Ressource; Ontologie-Scopes und Business-Workspace-Scopes dürfen nicht in derselben Verbindung gemischt werden.

Token-Lebenszyklus

Der r56-Server verwendet standardmäßig 3600 Sekunden für Access-Tokens, 2592000 Sekunden für Refresh-Tokens und 300 Sekunden für Autorisierungscodes; Bereitstellungen können diese Werte überschreiben. Clients müssen expires_in aus der Token-Antwort und tatsächliche Fehlermeldungen auswerten und dürfen die Standardwerte nicht fest einprogrammieren. Nach einer Aktualisierung die gespeicherten Tokens ersetzen; der Widerruf von Rollen, Ressourcenrechten oder Grants führt zur Ablehnung nachfolgender Aufrufe.

Kapitel 4

Scope-Ressourcengrenzen und Echtzeitberechtigungen

Der Scope delegiert nur bestehende Berechtigungen, gewährt keine erweiterten Rollenrechte und teilt keinen Geschäftszustand über Grants hinweg.

ScopeTypische FähigkeitenWichtige Einschränkungen
ontology.metadata:readOntologie-Ressourcen und TabellenstrukturenOntologie und Tabellen müssen innerhalb des autorisierten und aktuell lesbaren Bereichs liegen
ontology.graph:readGraphsuche und NachbarnLiefert Lokalisierungsinformationen, keine Faktenevidenz
ontology.knowledge:readWissenslokalisierung und vollständiger OriginaltextDie ursprünglichen Berechtigungen von Wissensdatenbanken und Dokumenten bleiben wirksam
ontology.table:querySQL auf Ontologietabellen und Abfragen veröffentlichter ModelleTabellenabfragen erfordern zusätzlich den Metadata-Scope; tatsächliche Quellen und Spaltenrechte bleiben wirksam
search:operateNative Schlüsselwortmodelle und SitzungenEigenständige, ausdrückliche Delegierung; Ausführung gemäß den ursprünglichen Modellberechtigungen und den Tabellen- und Spaltenberechtigungen des Benutzers
etl:operateFlash-ETL-CapabilitiesHeavy ETL wird nicht freigegeben
authoring.contract:readBedingt freigegebene ModellierungsverträgeZusätzlich Funktionsschalter und die betreffenden Ressourcen erforderlich
authoring.artifact:readLesen von Kandidaten, Plänen usw. im Rahmen der aktuellen AutorisierungAn den Grant und die Ressourcen des ursprünglichen Subjekts gebunden
authoring.artifact:draftKandidateneinreichung, Vorschau usw.Keine Autorisierung für Ausführung oder Veröffentlichung
authoring.artifact:applyKontrollierte Planung und AnwendungWeiterhin ursprüngliche Geschäftsrollen, Richtlinien und Genehmigungen erforderlich
execution.script:draftBestimmte SkriptentwürfeKeine Autorisierung für die tatsächliche Skriptausführung
datasource.http:read / draft / test / importBedingt freigegebene HTTP-Datenquellen-ArtefaktfähigkeitenJe Fähigkeit ein eigener Funktionsschalter; die ursprünglichen Berechtigungen gelten
Abbildung A3: Benutzerberechtigungen, Grant, ausgewählte Ressourcen und Funktionskonfiguration bestimmen gemeinsam die verfügbaren Fähigkeiten. Schematische Darstellung.

Kombinierte Leseanforderungen

dfc_table detail erfordert ontology.metadata:read; query erfordert zusätzlich ontology.table:query. dfc_ontology_query erfordert die beiden Lese-Scopes graph und knowledge. dfc_knowledge_search/detail erfordert knowledge. published_model/published_query verwendet table:query; candidate_query benötigt zusätzlich authoring.artifact:read. Analysetools prüfen zusätzlich die erlaubten Evidenz-Scopes; persistente Berichte erfordern metadata und table query.

Standardautorisierung nicht fest codieren

Die Standard-Scope-Menge der Ontologie in r56 enthält table query; Search und ETL sind ausdrückliche Delegierungen. Maßgeblich sind letztlich die Discovery-Metadaten, die Autorisierungsseite, der tatsächliche Token-Scope und tools/list. Aussagen älterer Dokumente wie „Die Ontologie hat standardmäßig niemals SQL“ oder „nur sechs Tools“ dürfen nicht als Grundlage der aktuellen Implementierung dienen.

Zustandsisolation

Sitzungen, Berichte, Kandidaten und Aktionspläne haben jeweils einen eigenen Eigentümer und Geltungsbereich. Die Aktualisierung des Access-Tokens überträgt die Arbeit des ursprünglichen Grants nicht auf einen anderen Grant. sessionId, reportId, planId, Genehmigungstokens oder Quellen-Tokens, die über eine andere Verbindung zurückgegeben wurden, nicht in die aktuelle Verbindung übernehmen.

Kapitel 5

HTTP- und moderne MCP-Nachrichten

Anfragespezifische Metadaten und passende Routing-Header korrekt senden und HTTP-Ergebnisse und Tool-Ergebnisse getrennt verarbeiten.

Aspektr56-Verhalten
TransportZustandsloses Streamable HTTP, POST JSON-RPC
Unterstützte Versionskennungen2026-07-28 sowie 2025-11-25 2025-06-18 2025-03-26
Moderne Methodenserver/discover, tools/list, tools/call, resources/list, resources/read; Freigabe gemäß den tatsächlichen Fähigkeiten
Session-HeaderEs wird keine Mcp-Session-Id zugewiesen
GET und DELETE/mcp und /mcp/business geben 405 zurück
Server-SSE-BenachrichtigungenVon diesen beiden öffentlichen MCP-Einstiegspunkten nicht bereitgestellt
Katalog-CachingModerne Discovery- und Listenantworten liefern ttlMs=60000 und cacheScope=private
Normales ErgebnisDas moderne Ergebnis enthält resultType=complete und Metadaten zur Dienstidentität

Inhalte, die übereinstimmen müssen

  • MCP-Protocol-Version stimmt mit io.modelcontextprotocol/protocolVersion in params._meta überein.
  • Mcp-Method stimmt mit dem JSON-RPC-Feld method überein.
  • Der Mcp-Name von tools/call stimmt mit params.name überein; der Namens-Header von resources/read stimmt mit der URI überein.
  • Jede moderne Anfrage enthält das Objekt io.modelcontextprotocol/clientCapabilities; zusätzlich wird das standardmäßige clientInfo mitgesendet, damit der Client identifiziert werden kann.

Aufrufbeispiel

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

Die zugehörigen HTTP-Header lauten Mcp-Method: tools/call und Mcp-Name: dfc_ontologies. Alle ACCESS_TOKEN in den Beispielen sind Platzhalter. Platzieren Sie das Bearer-Token nicht in URLs, JSON-Parametern oder Cache-Schlüsseln.

Ergebnisse lesen

Verarbeiten Sie zuerst den HTTP-Status und prüfen Sie dann auf einen JSON-RPC-Fehler; liegt ein result vor, prüfen Sie anschließend isError. Erfolgreiche Tool-Ergebnisse liefern in der Regel structuredContent sowie text-Inhalte mit demselben fachlichen JSON; lesen Sie bevorzugt den strukturierten Kanal und fassen Sie text und structuredContent nicht als zwei unabhängige Fakten doppelt zusammen. Auch eine Antwort mit HTTP 200 kann einen Tool-Fehler enthalten.

Öffentliche Ressourcen und UI

Die integrierten Beschreibungsressourcen sind nicht von MCP Apps abhängig. Der Einstieg im Business Workspace erhält dadurch keine Ontologie-Beschreibungsressourcen. Clients mit Visualisierungsunterstützung sollten die entsprechende UI über tatsächliche Capabilities und Tool-_meta erkennen und keine Ressourcen-URIs erraten, die nicht zurückgegeben wurden.

Kapitel 6

Kompatibilität mit Clients älterer Protokollversionen

Bei Clients, die weiterhin den Initialisierungs-Handshake verwenden, eine konsistente Protokollgeneration beibehalten.

json
{
  "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {"name": "flash-legacy-client", "version": "1.0.0"}
  }
}
  1. Senden Sie initialize und lesen Sie die vom Server ausgehandelte Protokollversion und die Capabilities.
  2. Senden Sie die für Ihr Client-Protokoll erforderliche Initialisierungsabschluss-Benachrichtigung; Benachrichtigungen liefern kein normales Tool-Ergebnis.
  3. Lesen Sie mit tools/list die aktuell autorisierten Tools und senden Sie dann tools/call.
  4. Halten Sie Header und Nachricht in der Protokollgeneration der aktuellen Anfrage konsistent und senden Sie keinen alten initialize- oder ping-Ablauf an 2026-07-28-Nachrichten.

Das alte Protokoll verwendet weiterhin dasselbe Bearer/OAuth, dieselben Berechtigungen und denselben Tool-Vertrag. Es bedeutet nicht, dass der Server zwingend eine SSE-Langzeitverbindung im alten Stil oder Mcp-Session-Id bereitstellt; der öffentliche Dienst von r56 bleibt zustandslos.

Protokollfehler

SituationTypisches ErgebnisMaßnahme
Moderne Header und Nachricht stimmen nicht übereinHTTP 400 JSON-RPC -32020Header, Metadaten und Tool-Namen korrigieren
Nicht unterstützte Version-32022 mit Liste der unterstützten VersionenTatsächlich unterstütztes Protokoll auswählen
Unbekannte MethodeJSON-RPC -32601, moderne Anfrage ggf. HTTP 404Protokollgeneration und Methode prüfen
Fehlende oder ungültige ParameterJSON-RPC-Parameterfehler oder Tool-isErrorGemäß tatsächlichem inputSchema korrigieren
Kapitel 7

Das richtige Tool und den richtigen Evidenzkanal auswählen

Richten Sie das Routing an der noch offenen fachlichen Frage aus, statt Evidenz mit einer festen Aufrufkette wiederholt einzuholen.

Abbildung A4: Auswahl von Tabellen-SQL, Wissensevidenz, Search, Analyse oder fachlicher Aktion je nach Aufgabe. Routing-Schaubild.
AufgabeBevorzugtes ToolFür den Abschluss erforderliche Evidenz
Autorisierte Themen und Ressourcen findendfc_ontologies dfc_ontology_resourcesTatsächliche Ressourcen-ID-Typen und aktuell sichtbarer Umfang
Tabellenstatistiken und TopNdfc_table queryQuittung über die erfolgreiche Ausführung und vollständige evidenceRows
Richtlinien, Verträge oder Berichte nachschlagendfc_ontology_query oder knowledge search/detailVollständiger, autorisierter, als Faktenbasis verwendbarer Originaltext
Graphobjekte lokalisierendfc_ontology_graph search/neighborsBis zur tatsächlichen Quelle lokalisieren und dann die zugehörigen Fakten abrufen
Native Schlüsselwortinteraktiondfc_manual und dann dfc_searchTatsächliche Ergebnisse im Originalmodell und im fachlichen Frame
Fusionsanalyse und Berichtedfc_analysis_* oder dfc_report_*Tatsächlicher Status jedes strukturierten Zweigs und der Dokumentevidenz
Anzeige oder Ontologiemodell änderndfc_authoring_* und Artifact-ToolsKandidat, Plan, Genehmigung und tatsächliche Anwendung jeweils gesondert abgleichen
Fachliche Befehle ausführendfb_* von /mcp/businessVeröffentlichter Vertrag und ursprüngliche ActionPlan-Quittung

Unnötige Aufrufe vermeiden

Liegt bereits eine aktuelle, vollständige und autorisierte Tabellenstruktur vor, ist kein erneutes detail bei jeder Abfrage erforderlich; liegen bereits eine vertrauenswürdige Lokalisierung und Evidenz vor, wird dieselbe Suche nicht wiederholt. Bei fehlender Dimension ist eine begrenzte ergänzende Abfrage durchzuführen. Ist ein Fehler eindeutig nicht wiederholbar, zuerst die Lücke schließen und die Beurteilung nicht durch „noch einmal versuchen“ ersetzen.

Ausschlüsse in Flash

dfc_etl-Capabilities können available=false und ETL_NOT_INCLUDED_IN_OT_FLASH zurückgeben. Die statische Beschreibung der integrierten ETL-Funktionen dient nur als produktübergreifende Referenz; sie beweist nicht, dass in Flash ETL installiert ist, und erlaubt dem Agenten nicht, die Ausführung automatisch auf Heavy oder einen anderen Mandanten zu verlagern.

Kapitel 8

Ontologie-Ressourcen und ID-Typen

Ermitteln Sie zuerst die tatsächlichen Ressourcenkoordinaten, um Speichernamen, Dokument-IDs und Wissensdatenbank-IDs nicht zu verwechseln.

  1. Rufen Sie dfc_ontologies auf und blättern Sie mit page und pageSize durch die in dieser Autorisierung freigegebenen und aktuell weiterhin lesbaren Ontologien.
  2. Rufen Sie dfc_ontology_resources mit einer echten ontologyId auf; wählen Sie nach Bedarf tables, answers, pinboards, documents und knowledgeBindings.
  3. Behandeln Sie die Paginierung je Ressourcentyp getrennt. pageSize maximal 100; schließen Sie nicht aus der ersten Seite auf den gesamten Ressourcenumfang.
  4. Speichern Sie den von der Ressource deklarierten Typ und die ursprüngliche ID und verwenden Sie diese bei Folgeaufrufen unverändert.
json
{"name":"dfc_ontology_resources","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "resourceTypes":["tables","documents","knowledgeBindings"],
  "page":1,"pageSize":100
}}
KoordinateQuelleNicht ersetzbar durch
ontologyIdAutorisierte Ontologieliste oder aktuell gültiger KontextID einer anderen Ontologie
Tabellenressourcen-IDtables-Liste oder vertrauenswürdiger KontextphysicalName oder angezeigter Tabellenname
tblDisplayName colDisplayNameAktuelle Tabellen- und SpaltenmetadatenErratener physischer SQL-Bezeichner
knowledgeIdknowledgeBindings oder tatsächliche Wissensabruf-QuittungDokumentressourcen-ID
assetId documentId chunkId evidenceIdDieselbe tatsächliche LokalisierungsquittungAus unterschiedlichen Lokalisierungsergebnissen zusammengesetzte Felder
rid revisionId releaseIdVeröffentlichtes Modell oder serverseitiger KandidatenkontextSelbst generierte IDs oder latest

Präzisionskonventionen

Alle 64-Bit-Ressourcenbezeichner bevorzugt als Dezimalzeichenkette, in JavaScript ohne Umweg über Number. Einige fachliche Schemas akzeptieren string oder integer – das bedeutet nicht, dass Integer-Präzision aufgegeben werden darf. Opake Locators, UUID, Hashes und Einmal-Tokens werden ebenfalls unverändert gespeichert.

Kapitel 9

Doris-Tabellenabfragen und Strukturvertrag

Führen Sie rein lesende SQL-Abfragen auf autorisierten Tabellen aus und bewahren Sie Ausgabesemantik, exakte Zahlenwerte und Vollständigkeit.

Struktur lesen

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

Verwenden Sie detail mit einer echten Tabellenressourcen-ID. Prüfen Sie schemaComplete, tblDisplayName, colDisplayName in columns und den autoritativen sqlDataType sowie das zurückgegebene queryContract. dataType ist nur eine Kompatibilitätszuordnung; der physische Speichername ist nicht der Tabellenname, der im eingereichten SQL zu verwenden ist.

Abfrage ausführen

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

SQL-Einschränkungen

  • Verwenden Sie den angezeigten Tabellennamen und angezeigte Spaltennamen und setzen Sie Bezeichner in doppelte Anführungszeichen. Die Anfrage ist eine einzelne, rein lesende Doris-Abfrage im Ontologieumfang.
  • Listen Sie Ausgaben explizit auf; SELECT * und table.* sind verboten; über physische Spalten lassen sich registrierte Spaltenberechtigungen nicht umgehen.
  • Verknüpfungen mit explizitem JOIN ... ON; NATURAL JOIN und JOIN USING werden abgelehnt.
  • Zulässige rein lesende Ausdrücke wie mehrdimensionale Aggregation, CTE, Fensterfunktionen, CASE, COUNT(DISTINCT ...) sind möglich; dass die semantische Validierung einen Ausdruck nicht abdeckt, bedeutet nicht, dass die Ausführung pauschal verboten ist.
  • Vollziehen Sie Aggregation, Sortierung und Rangfolge zuerst in SQL und wenden Sie danach das Ergebnislimit an. maxRows ist standardmäßig 100, maximal 200.

Datum und Zeitzonen

Typ oder ZielFormHinweis
DATECAST('2026-09-01' AS DATE) und CURRENT_DATETextliterale dürfen nicht direkt als Datumstyp angenommen werden
DATETIMECAST('2026-09-01 00:00:00' AS DATETIME) und CURRENT_TIMESTAMPQuellzeitzone und Sitzungszeitzone abgleichen
Relative ZeitDATE_SUB(CURRENT_DATE, INTERVAL 1 YEAR)Für Datum und Zeitstempel die entsprechenden aktuellen Funktionen verwenden
Zeitliche GruppierungYEAR(column) oder DATE_TRUNC(column, 'month')Für jede Ausgabe einen eindeutigen Alias verwenden; maßgeblich ist queryContract

Die SQLite-Funktion DATE('now', ...) entspricht nicht dem Doris-Datumsvertrag dieses Einstiegspunkts. Übernehmen Sie die SQLite-Offline-Verifikationsmethode aus den Dokumentbeispielen nicht in das Online-SQL.

v8-Abfragequittung lesen

evidenceRows ist der einzige Kanal des Agenten für Zeilendaten; Rohdaten sind für den Agenten nicht zugänglich. SQL-Zahlen werden als exakte Dezimal-JSON-Zeichenfolgen kodiert; beurteilen Sie ihren numerischen und fachlichen Typ über resultColumnContracts und interpretieren Sie JSON-Zeichenfolgen nicht allein wegen ihres Typs als VARCHAR. Lesen Sie executionReceipt sowie Vollständigkeits- und Kürzungsinformationen und bewahren Sie Quellinformationen wie evidenceRowsSha256 auf.

Abfrageausgaben mit zitierbarer Ausführungsquittung können wörtlich zitiert werden; nur serverseitig verifizierte Semantik darf nachgelagerte deterministische Folgeberechnungen autorisieren. Leiten Sie aus Feldnamen nicht durch Raten „kumulierte Salden“, „Endstände“ oder „Währungen“ ab und ergänzen Sie keine Einheiten eigenmächtig. Ergebnisse mit null Zeilen, Fehler oder Kürzungen dürfen nicht als vollständige Statistik dargestellt werden.

Kapitel 10

Mehrdimensionale Top 3 und Handhabung von Kürzungen

Beantworten Sie Rangfragen über serverseitige Aggregation und Fensterfunktionen und rechnen Sie nicht auf unvollständigen Ergebnissen nach.

Das beigefügte Beispiel examples/top3.sql verwendet die Beispieltabelle, aggregiert zunächst nach 区域, 类别 und 产品, führt dann innerhalb jeder Kombination von 区域 und 类别 ROW_NUMBER aus und verwendet den 产品-Namen als stabile Reihenfolge bei gleichen Beträgen. Eine Anfrage mit maxRows=100 reicht aus, um die 36 Zeilen des Beispiels aufzunehmen; andere Geschäftsdaten müssen nach der tatsächlichen Gruppenzahl bemessen werden.

  1. Ermitteln Sie die tatsächliche Struktur und die aktuelle Definition und klären Sie Währung, Zeitraum, 订单状态 und Regeln für Gleichstände.
  2. Reichen Sie die serverseitige Aggregation und Rangbildung als SQL ein. Fragen Sie nicht zunächst nur die Gesamtsumme von 区域 ab und verwenden Sie diese dann als 类别-产品-Rangliste.
  3. Prüfen Sie den Ausgabespaltenvertrag und die tatsächlichen evidenceRows und bestätigen Sie, dass die Rückgabe alle benötigten Gruppen abdeckt.
  4. Wenn Sie eine Kürzung feststellen, führen Sie begrenzte partitionsweise Abfragen an den serverseitig unterstützten Grenzen durch, z. B. je 区域 jeweils ein vollständiges Top 3; halten Sie dabei jedes Mal dieselbe fachliche Definition ein.
  5. Ändert sich der Quellzeitraum, fragen Sie erneut ab und kennzeichnen Sie die neue Version explizit; mischen Sie keine verschiedenen Datenversionen oder veralteten Cursor.
Abbildung A5: Reihenfolge von Detailfilterung, Gruppenaggregation, Rangbildung innerhalb der Gruppe und endgültiger Rückgabe. Schematische Darstellung.

Fehlerbehebung

TABLE_SCHEMA_INCOMPLETE: Struktur korrigieren oder vollständig abrufen; Fehler wie ONTOLOGY_SQL_FAILURE_CONTRACT_INVALID werden gemäß dem zurückgegebenen errorCode, retryable und remediation behandelt. Behaupten Sie nicht, „alle mehrdimensionalen GROUP BY oder Fensterfunktionen seien verboten“, und erfinden Sie keine Ranglisten, wenn keine Abfrageergebnisse vorliegen.

Kapitel 11

Wissensabruf: Vollständiger Originaltext und Evidenzqualifikation

Trennen Sie Lokalisierung, Lesen und Faktenzitierung und bewahren Sie Quelle und Vollständigkeit.

Zwei gängige Pfade

PfadZweckKernpunkte
dfc_ontology_queryInnerhalb des an die Ontologie gebundenen Wissens suchen, optional kombiniert mit GraphroutingVollständige kanonische answerContextItems und Evidenzqualifikation prüfen
dfc_knowledge_search → dfc_knowledge_detail-ChunkExplizit suchen und lokalisieren, dann die ausgewählten Chunks lesenSuchvorschauen gelten nicht als Fakten; lesen Sie den vollständigen Originaltext derselben Lokalisierung
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>"
}}

Bedingungen für die Verwendbarkeit als Fakt

  • Aktuelle ACL, Inhaltsvollständigkeit sowie serverseitige canonicalFactEligible, citationEligible oder den entsprechenden Ausführungsvertrag prüfen.
  • Der vollständige Inhalt ist an contentSha256 gebunden. Kürzungen, durch Budget ausgelassene Inhalte oder minderwertige Inhalte müssen gemäß den tatsächlichen Feldern behandelt werden.
  • Dokumentmetadaten, page_context, Graphlokalisierung, Abrufzusammenfassungen und Vorschauen können den kanonischen Originaltext nicht ersetzen.
  • Kopieren Sie vorrangig evidenceId; wenn chunkId und documentId benötigt werden, müssen sie aus demselben Lokalisierungsergebnis stammen – nicht zusammenstückeln und nicht erraten.

Graphrouting

Das search/neighbors-Ergebnis ist Lokalisierungsinformation. Übergeben Sie der Ontologie-Query nur das vom Server vollständig zurückgegebene routeLocator-Objekt, einschließlich der Bindungs-, Versions- und Nachweisfelder. Verpacken Sie keine assetId oder knowledgeId selbst zu einem serverseitig ausgestellten Locator und geben Sie keine vom Modell behaupteten Quellnachweise zurück.

Strukturierte Dokumentwiederherstellung

structuredPlan von dfc_ontology_query dient speziell der eingeschränkten Wiederherstellung und deterministischen Validierung unregelmäßiger Dokumenttabellen. Verwenden Sie den serverseitig deklarierten Plan erst, nachdem die aktuelle executionContractSha256, tableIndex, die Spalten und die vollständige Tabelle zurückgegeben wurden. Gewöhnliche bereits importierte Geschäftstabellen sollten über dfc_table SQL laufen; betrachten Sie die Markdown-Tabellenwiederherstellung nicht als Kanal zur Umgehung der Tabellenabfrageautorisierung.

Abbildung A6: Evidenzkette vom Lokalisierungsergebnis bis zum zitierbaren Originaltext. Schematische Darstellung.

Abrufstrategie

knowledgeIds wird meist weggelassen, um alle aktuell aktivierten Bindungen abzudecken; übergeben Sie es nur mit echten Wissensdatenbank-IDs aus knowledgeBindings. Verwenden Sie keine Dokumentressourcen-ID als Wissensdatenbank-ID. Führen Sie für die noch offene Frage eine neue, begrenzte Suche durch und vermeiden Sie Abrufe, die exakte Duplikate ohne zusätzliche Evidenz sind.

Kapitel 13

Sprach- und Regionskonventionen

Halten Sie die Grenzen zwischen UI-Locale, Abfragewörterbuch, Rückgabesprache und ursprünglichen Feldnamen ein.

Die Priorität ist: explizit angefragte Sprache, Sprache des Anwendungssystems, Locale des tatsächlich ausführenden Knotens. Ein fehlender Wert, null, eine leere Zeichenfolge oder Leerraum führen nicht pauschal zu einem Fallback auf Chinesisch. Der Regionswert in languageRegistry muss exakt bleiben; en-GB, fr-CA, pt-BR, es-US oder ar-AE dürfen nicht beliebig zu einer anderen Region zusammengefasst werden.

Sprache oder RegionAbfrage-LocaleBeschreibung
Vereinfachtes Chinesisch, Traditionelles Chinesischzh-CN zh-HantUrsprüngliche chinesische Regeln und traditioneller Katalog unterscheiden sich
Englisch (USA, UK, Australien, Kanada)en-US en-GB en-AU en-CAUI-/Schlüsselwortpakete können gemeinsam genutzt werden, Regionsmetadaten bleiben erhalten
Deutsch, Italienisch, Russischde-DE it-IT ru-RUGemäß den Vorschlägen der aktuellen Sitzung verwenden
Spanisch (Spanien und Lateinamerika)es-ES es-USDie Regions-ID des Produkts ist es-US
Französisch (Frankreich und Kanada)fr-FR fr-CARegions-IDs werden nicht zusammengeführt
Portugiesisch (Portugal und Brasilien)pt-PT pt-BRKatalog- und Regionskonventionen werden getrennt beibehalten
Niederländisch, Dänisch, Norwegisch, Finnisch, Schwedischnl-NL da-DK nb-NO fi-FI sv-SENorwegisch ist Bokmål
Japanisch, Koreanischja-JP ko-KRKeine eigene Worttrennung nach englischen Leerzeichenregeln
Arabisch (Saudi-Arabien und VAE)ar-SA ar-AEOberflächenbeschreibungen unterstützen RTL; Protokollbezeichner werden nicht gespiegelt

Schlüsselwortkatalog verwenden

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

Der statische Schlüsselwortkatalog von dfc_manual enthält nur die ausdrücklich aufgeführten Locales; bei Weglassen gilt die englische Referenz – ein Referenzstandard, keine Regel zum Parsen der Abfragesprache. Wenn für eine Regionsvariante kein statischer Katalog bereitgestellt wird, holen Sie die tatsächlichen Vorschläge über das assist der aktuellen Sitzung ein und erfinden Sie keine Aliasse oder Fallback-Ergebnisse. Pro Aufruf sind maximal 32 Einträge in names zulässig.

Was nicht übersetzt wird

  • Tabellen, Spalten, Enumerationswerte, Kundennamen, Formelnamen und andere echte Modellzeichenfolgen.
  • Toolnamen, action, scope, Schema-Felder, Fehlercodes und Statuswerte.
  • Ressourcen-IDs, Hashes, opake Locators und serverseitig ausgestellte Referenzen.

Beispiel: Eine deutsche Frage kann die Spalte mit dem chinesischen Anzeigenamen „销售金额“ abfragen. Ersetzt man diesen durch einen deutschen Spaltennamen, entsteht ein anderer Bezeichner – keine Oberflächenübersetzung. Initialisieren Sie die Sitzung nach einem Sprachwechsel neu oder aktualisieren Sie sie gemäß dem ursprünglichen Protokoll und holen Sie Vorschläge und Disambiguierungskandidaten erneut ein.

Kapitel 14

Fusionsanalyse und interaktive Ergebnisse

Bewahren Sie in den bedingt freigegebenen Analysetools Autorisierung, Version, Zweig und Evidenzstatus.

dfc_analysis_* wird durch datafocus.mcp.analysis.tools.enabled gesteuert. Der strukturierte Teil läuft weiterhin über die maßgeblichen Search-Abfragen und die aktuelle Zeilenrichtlinie; für den Dokumentteil wird der vollständige Originaltext erneut unter der aktuellen ACL abgerufen. Sie sind keine Einstiegspunkte für offenes SQL, beliebige Anweisungen oder beliebige Filterinjektionen.

ToolZweckNotwendige Koordinaten
dfc_analysis_askNatürlichsprachliche Analysefrage stellenontologyId question, optional language sessionId
dfc_analysis_result_getZurückgegebenes Ergebnis lesenontologyId sessionId resultId
dfc_analysis_refineAuf Basis des neuesten vollständigen Ergebnisses nachfragen oder ändernUrsprüngliches Ergebnis expectedRevision und stabiler Idempotenzschlüssel
dfc_analysis_pageEine Seite eines serverseitigen Zweigs abrufenUrsprünglicher Zweig und Ergebnisversion pageNo pageSize
dfc_analysis_cancelLaufende Ergebnisberechnung abbrechenUrsprüngliche Sitzung und Ergebnis
dfc_analysis_closeNicht mehr arbeitende Sitzung freigebenUrsprüngliche Sitzung

Analyse starten

json
{"name":"dfc_analysis_ask","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "question":"按区域分析已完成订单销售金额,并引用退货统计口径",
  "language":"zh-CN"
}}
  1. Zurückgegebene sessionId, resultId, Status und revision lesen; bei Bedarf das ursprüngliche Ergebnis weiter lesen.
  2. Prüfen Sie Status, Vollständigkeit, Zeilenrichtlinie und Quelle jedes strukturierten Zweigs einzeln; der Abschluss eines Zweigs bedeutet nicht die Vollständigkeit der gesamten Analyse.
  3. Prüfen Sie Dokumentevidenz, Faktenregister, Zitierfähigkeit und Grenzen. Modellgenerierte Narrative können die Evidenzqualifikation nicht eigenmächtig anheben.
  4. Stützen Sie Nachfragen auf das neueste vollständige Ergebnis und übergeben Sie expectedRevision; Wiederholungen derselben Änderung verwenden denselben Idempotenzschlüssel.
  5. Bestätigen Sie vor dem Schließen, dass die Sitzung nicht mehr arbeitet; Abbrechen und Schließen sind unterschiedliche Aktionen.

Kontrollierte Filterung und Paginierung

filter_patch verwendet die vom Server bereitgestellten branchId, fieldRef, valueRef und zulässigen Operatoren; der aktuelle typisierte Filter deklariert nur EQ. Opake Referenzen dürfen nicht durch rohes SQL, tableId, columnId oder einen clientseitig selbst konstruierten Filterbaum ersetzt werden. Die Paginierung pageNo beginnt bei 1, maximal 10000; pageSize höchstens 100.

Abbildung A7: Bindung von Zweig, Version und Paginierung; nach einer Änderung von Quelle oder Version erneut abfragen, um eine neue Lokalisierung zu erhalten. Schematische Darstellung.

Fähigkeitshinweise und Verhalten

Tool-Annotations sind Hinweise für den Client, keine Sicherheitsautorisierung. Einige allgemeine Vorlagen verwenden readOnlyHint, was die Beurteilung der tatsächlichen Aktion nicht ersetzen kann; Abbrechen, Schließen und Erstellen von Berichten ändern den entsprechenden Arbeitszustand. Handeln Sie stets nach Tool-Semantik, Benutzerziel und serverseitigen Berechtigungen.

Kapitel 15

Persistente Visualisierungsberichte und MCP Apps

Wiederherstellbare Berichte erstellen und deren Ergebnisse sowie interaktive Oberflächen gemäß den aktuellen Berechtigungen lesen.

dfc_report_* wird durch datafocus.mcp.analysis.report-tools.enabled gesteuert und erfordert die Scopes metadata und table query. Anders als bei In-Process-Search-Sitzungen verwenden Berichte eine persistente reportId; Persistenz bedeutet nicht, dass Berechtigungen nicht mehr geprüft werden.

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

Workflow

  1. Verwenden Sie beim Erstellen einen stabilen idempotencyKey mit 8 bis 128 unterstützten Zeichen.
  2. Speichern Sie reportId, pollen Sie status und prüfen Sie die tatsächlichen Zustände wie abgeschlossen, fehlgeschlagen, teilweise abgeschlossen oder abgebrochen.
  3. Prüfen Sie beim Lesen der Ergebnisse strukturierte Zweige, Visualisierungen, Faktenquellen, Dokumentverweise und Vollständigkeit.
  4. Zum Abbrechen eines noch nicht abgeschlossenen Berichts verwenden Sie die ursprüngliche reportId; erstellen Sie keinen anderen Bericht als Ersatz für den Abbruch.
  5. Lesen Sie nach einem Netzwerk-Timeout zunächst den Status des ursprünglichen Berichts; eine Wiederholung mit dem ursprünglichen Idempotenzschlüssel muss dieselbe Geschäftsabsicht tragen.

MCP Apps

Clients mit UI-Erweiterung lesen die Berichtsseiten über Tool-_meta und die tatsächliche Ressourcen-Discovery. Die persistente Berichtsseite für r56 lautet ui://datafocus/analysis-report/v16/index.html; für die interaktive Analyse werden die entsprechenden serverseitigen Ressourcenreferenzen verwendet; Clients sollen die vom Tool zurückgegebenen Werte nicht durch fest codierte Werte ersetzen. Ohne UI-Erweiterung können die strukturierten Ergebnisse weiterhin gelesen werden.

Origin-Bindung

Beim Lesen eines Berichts werden Grant, Ontologie, die Bindung des Anfrage-Origin sowie die aktuellen Tabellenberechtigungen erneut geprüft. Browserseitige Cross-Origin-Integrationen müssen genehmigte tatsächliche Origins verwenden; Clients umgehen die Bindung nicht durch gefälschte Origins. Eine alte reportId ist weder ein dauerhafter öffentlicher Link noch eine benutzerübergreifende Zugangsberechtigung.

Kapitel 16

Artefaktentwurf, Vorschau, Plan und Anwendung

Generierte Inhalte dem ursprünglichen Server zur Normalisierung, Validierung und Genehmigung überlassen; das Modell darf Produktionsressourcen nicht direkt ändern.

Artefakt-Tools erfordern die aktivierte Funktion authoring, einen tatsächlichen artifact type, die relevanten Scopes und die ursprüngliche Schreibberechtigung des Administrators. Die Standardtypkonfiguration ist CONTROL_PANEL_SPEC und VIEW_SPEC; andere Typen wie Formulare, HTTP-Quellen oder Skripte unterliegen zusätzlich eigenen Konfigurationen. Flash hat kein AutoML, daher werden die entsprechenden Typen in dieser Version nicht als verfügbare Artefakte aufgeführt.

Abbildung A8: Kontrollierte Reihenfolge von Kontext, Kandidat, Vorschau, Plan, Genehmigung und Anwendung. Schematische Darstellung.
  1. dfc_authoring_capabilities liest die für den aktuellen Grant verfügbaren Verträge und Aktionen.
  2. dfc_artifact_context ruft begrenzten Kontext, contractVersion, contextHash, baseArtifactHash und baseArtifactVersion ab.
  3. Erzeugen Sie im Client Kandidaten anhand der echten Verträge, ohne deren Code auszuführen.
  4. dfc_artifact_submit übermittelt den ursprünglichen Kontext und den Kandidaten, hält instruction identisch und verwendet eine stabile clientRequestId.
  5. Lesen Sie proposalId, candidateHash, Validierungsergebnis und Vorschau; bei tatsächlichen Fehlern überarbeiten Sie den Kandidaten und täuschen keinen serverseitig bestandenen Status vor.
  6. Wenn eine erneute Vorschau erforderlich ist, verwenden Sie dfc_artifact_preview und denselben Kandidaten-Hash.
  7. dfc_artifact_plan erstellt einen unveränderlichen Plan mit dem echten Kandidaten, der Zielversion und einem Idempotenzschlüssel.
  8. Behandeln Sie die Genehmigung gemäß der ursprünglichen Interaktion oder einer bereits autorisierten Richtlinie und führen Sie dann dfc_artifact_apply aus; nur eine APPLIED-Quittung steht für die tatsächliche Anwendung.

Anforderung des minimalen Kontexts

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

VIEW_SPEC verwendet die aktuell autorisierte projectId; beim Bearbeiten eines vorhandenen Artefakts verwenden Sie die tatsächliche artifactId. Felder wie variables, previewInput und viewport werden gemäß dem zurückgegebenen Vertrag bereitgestellt; erraten Sie keine interne Kandidatenstruktur.

Parallelität und Wiederholung

Der Plan ist an Zielversion, Kandidaten-Hash und Idempotenzschlüssel gebunden. Nach einer Zieländerung kann der alte Plan nicht weiter angewendet werden; lesen Sie den Kontext neu und behandeln Sie die tatsächlichen Konflikte. Ein Transport-Timeout beweist keinen Fehlschlag; fragen Sie zunächst mit dfc_artifact_status die ursprüngliche proposalId oder planId ab. READY ist nicht APPLIED.

Genehmigung und automatische Richtlinie

Allgemeine Artefaktpläne erfordern die ursprüngliche menschliche Genehmigung. Pläne, die der Richtlinie für die automatische Veröffentlichung in der Ontologie entsprechen, werden gemäß approvalMode behandelt; der Benutzer muss keine vom Agenten erfundene Genehmigung zusätzlich unterzeichnen. approvalToken ist serverseitig ausgestelltes Genehmigungsmaterial und kann nicht durch eine vom Agenten geschriebene Zeichenfolge ersetzt werden; das tatsächliche inputSchema und die Planquittung bestimmen die Pflichtfelder.

Kapitel 17

Erstellung von Ontologie-Kandidaten und Veröffentlichungsvertrag

Verwenden Sie eigenständig versionierte Ontologie-Deklarationen und Veröffentlichungskonfigurationen; wenden Sie den Vertrag gewöhnlicher Anzeigeartefakte nicht auf Modellveröffentlichungen an.

Kandidat erstellen

Der Ontologie-Container muss bereits vorhanden und im Grant enthalten sein. Prüfen Sie mit dfc_ontology_table_schema die aktuellen strukturierten Quellfelder und den v4-Binding-Fingerabdruck; für Felder genügt sourceField, der Typ wird dann automatisch erkannt. Eine explizite DECIMAL-Deklaration erfordert die aktuelle Genauigkeit und Dezimalstellen; andere Typen enthalten diese beiden Felder nicht.

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

Kandidaten- und Veröffentlichungskonfiguration

VertragZweckWesentliche Grenzen
ontology-workspace-create-mcp-submit-v1Kandidat mit lokaler Deklaration erstellenEchte autorisierte Quellen; serverseitige Kompilierung; Fertigstellungsnachweise werden nicht akzeptiert
ontology-workspace-create-mcp-submit-v2Lokale und exakte veröffentlichte Referenzen mischenExakte releaseSelections und Abschlussabhängigkeiten angeben
ontology-publication-mcp-submit-v1 bis v3Vorhandenen Kandidaten an die Anforderung eines Veröffentlichungsplans bindenExplizite Koordinaten; Ziel, Quelle, Genehmigung und Validierung werden serverseitig rekonstruiert
ontology-publication-mcp-submit-v4 bis v6Separat aktivierte Konfiguration für die automatische VeröffentlichungNur verwenden, wenn capabilities und das tatsächliche Schema sie deklarieren
ontology-initial-activation-retirement-submit-v1Kontrollierte anfängliche Aktivierung und AußerbetriebnahmeSeparater Plan; neue menschliche Genehmigung und exakter Scope

Veröffentlichungsablauf

  1. Aktuelle Kandidaten-workspaceId, workspaceRevision, candidateHash und tatsächliche Quelle abrufen.
  2. Vertragsversion gemäß serverseitigen Fähigkeiten wählen; Koordinaten wie releases und selection übermitteln, ohne Felder mit Selbstauskünften wie „genehmigt“ oder „bestanden“ beizufügen.
  3. Die von submit zurückgegebene proposalId und den ursprünglichen idempotencyKey aufbewahren. submit und MODEL_PLAN sind verschiedene Phasen derselben Anfrage.
  4. dfc_artifact_plan mit dem ursprünglichen Kandidaten, der Zielversion und demselben Idempotenzschlüssel aufrufen.
  5. PLANNING_INCOMPLETE bedeutet nur, dass noch kein gültiger Plan gebildet wurde; VALIDATION_UNSATISFIED bedeutet, dass die aktuelle Validierung noch Lücken hat, und wird gemäß nextAction behandelt.
  6. Nach erfolgreichem Plan mit HUMAN_REQUIRED oder POLICY_AUTO fortfahren und die ursprünglichen Genehmigungs- und Veröffentlichungsfunktionen verwenden.
  7. Das Ergebnis mit der APPLIED-Quittung sowie durch anschließendes tatsächliches Lesen des veröffentlichten Modells und autorisierte Abfragen bestätigen.

Timeout und Wiederherstellung

Nach einem PLAN-Timeout die ursprüngliche proposalId lesen. MODEL_PLAN_SUBMITTED ist eine noch nicht abgeschlossene Anfrage; MODEL_PLAN_COMPLETED bedeutet, dass die ursprüngliche Quittung mit den ursprünglichen Koordinaten und dem ursprünglichen Schlüssel wiederhergestellt werden soll – nicht, dass der Client eine neue Anfrage erstellt. Endgültige Validierungslücken können nicht durch Schlüsselwechsel oder wiederholtes Senden in eine bestandene Veröffentlichung umgewandelt werden.

Menschliche Geschäftsberechtigungen

Vom Agenten bereitgestellte instruction und Deklarationen sind Agenteneingaben, keine von Menschen unterzeichneten Richtlinien. MODEL_AUTHOR, MODEL_PUBLISH, Delegation der automatischen Veröffentlichung, geschäftliche Bestätigung, Public-Key-Vertrauen, Budget und Quellen-ACL werden weiterhin durch die ursprünglichen Mechanismen bestimmt. Diese Fakten dürfen nicht durch Client-Felder ersetzt werden.

Kapitel 18

Veröffentlichtes Modell: Kandidatenabfrage und Referenzabschluss

Veröffentlichtes Geschäftswissen in exakten Versionen verwenden und den vorläufigen Charakter unveröffentlichter Kandidaten wahren.

published_model, published_query und candidate_query von dfc_ontology_graph sind bedingt freigegebene strukturierte Konfigurationen, keine Synonyme für gewöhnliche search/neighbors. Sie werden nach table query und den erforderlichen Modellierungs-Leseberechtigungen autorisiert; Graphsichtbarkeit ersetzt keine Tabellenberechtigungen.

Veröffentlichtes Modell lesen

  1. Wenn die Tool-action-Enumeration tatsächlich published_model enthält, übermitteln Sie die echte committed releaseId.
  2. v1 gibt autorisierte Abfragevorlagen zurück; v2 ergänzt exakte PERSISTED-Referenzen und releaseSelections; v3 ergänzt Abhängigkeitsreferenzen, exakte domainRef und kompakte Bindungsvorlagen.
  3. Objekte, Attribute, Binding, Scope und Version aus den tatsächlichen Rückgabewerten wählen; keine RIDs generieren und latest nicht verwenden.
  4. Festgelegte typisierte Abfragen für published_query übermitteln; Ergebnisse müssen weiterhin die aktuellen Quellen- und Feldautorisierungen passieren.

Kandidatenabfrage

candidate_query verwendet tatsächliche workspaceId, revision, candidateHash und Kandidatendeklarationen. Beim Mischen veröffentlichter Referenzen werden die entsprechenden v2-typisierten LOCAL-/PERSISTED-Koordinaten und exakte Selektionen verwendet. Kandidatenergebnisse sind stets unveröffentlicht und vorläufig und gelten nicht als unternehmensbestätigtes Wissen.

Partielle Wartung und Abschluss

Wählen Sie nur die transitiven Abhängigkeiten, die die Kandidatenwurzel benötigt, und stellen Sie sicher, dass jede veröffentlichte Referenz exakte releaseSelections hat. Das Kopieren veröffentlichter Inhalte, das Übermitteln nur einer Gruppe von IDs oder die Ausweitung auf alle historischen Ressourcen ersetzen nicht die Prüfung aktueller Abhängigkeiten und Quellen.

Abbildung A9: Kandidatenwurzel, exakte veröffentlichte Abhängigkeiten und Quellenautorisierung. Schematische Darstellung des Referenzabschlusses.

Die query-Werte dieser Aktionen sind versionierte, typisierte Objekte; SQL, physische Tabellen-IDs oder Quelltabellennamen werden nicht als Ersatz für ihre Geschäftsreferenzen akzeptiert. Metadatenvorlagen und Graphergebnisse sind für sich genommen nicht als Faktenreferenz zitierfähig.

Kapitel 19

Ontologie-Agent-Aufgaben delegieren

Arbeit mit persistenten Aufgaben und dem ursprünglichen Grant fortsetzen; Agentenanweisungen nicht als menschliche Genehmigung behandeln.

dfc_ontology_agent wird nur angezeigt, wenn die tatsächliche Pi Runtime und die entsprechenden Berechtigungen verfügbar sind. QUERY verwendet Leseberechtigungen; AUTHORING erfordert zusätzlich eine Modellierungsrolle und den entsprechenden authoring-Scope. Das Tool stellt keine weitere, uneingeschränkte Ausführungs-Engine bereit.

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

Strikter Parametersatz

start verwendet contractVersion, action, ontologyId, mode, instruction, idempotencyKey; status/cancel verwenden contractVersion, action, ontologyId, runId. Der Server prüft je nach action die exakte Feldmenge. instruction hat maximal 16000 Zeichen; Schlüssel bestehen aus 1 bis 128 unterstützten Zeichen und beginnen mit einem Buchstaben oder einer Ziffer.

Wiederherstellung und Abbruch

  1. Bewahren Sie die ursprüngliche runId, den Grant, den mode und den Idempotenzschlüssel auf.
  2. Derselbe Schlüssel mit derselben instruction nimmt denselben Run wieder auf und übermittelt keine weitere Aufgabe; derselbe Schlüssel mit anderer instruction wird abgelehnt.
  3. status fragt den Status der ursprünglichen Aufgabe ab. Nach Abschluss müssen weiterhin deren Tabellenabfragen, Evidenz oder Veröffentlichungsquittungen überprüft werden.
  4. Der Abbruch verwendet die ursprüngliche runId; bestätigen Sie das Ergebnis anhand des tatsächlichen Aufgabenstatus.

Ein abgeschlossener Run ist keine Quittung über die Modellveröffentlichung. Veröffentlichungsaufgaben werden weiterhin über den ursprünglichen artifact-Status und die Quellenprüfung bestätigt; QUERY impliziert kein Schreib- oder Veröffentlichungsrecht.

Kapitel 20

Business Workspace MCP

Datensätze anhand veröffentlichter Geschäftsverträge abfragen und Befehle über den ursprünglichen ActionPlan ausführen.

/mcp/business verwendet eine separate protected resource und eine eigene Auswahl des Geschäftssystems; der Ontologie-Grant kann nicht wiederverwendet werden, um die Geschäftsautorisierung zu ersetzen. Geschäftssysteme müssen veröffentlicht, für Agenten aufrufbar, mit der ursprünglichen Sicherheitsrichtlinie konform sein, und der aktuelle Benutzer muss über tatsächliche Laufzeitrollen und -fähigkeiten verfügen.

ScopeToolAbgrenzung
business-system:discoverdfb_systems dfb_system_describeNur die in dieser Autorisierung freigegebenen und aktuell aufrufbaren Systeme ermitteln
business-system:readdfb_query dfb_record dfb_work_items dfb_action_statusVom aktuellen Benutzer lesbare Datensätze und eigene Pläne
business-system:plandfb_action_planNur unveränderliche Pläne erstellen, nicht ausführen
business-system:executedfb_action_executeSeparate ausdrückliche Autorisierung; Ausführung nach Risiko und Genehmigung
  1. dfb_systems ermittelt autorisierte Systeme.
  2. dfb_system_describe liest den aktuell veröffentlichten Vertrag, releaseId sowie alle Hashes, Abfragen und Befehle.
  3. dfb_query verwendet den veröffentlichten queryKey und gibt bei Bedarf objectKey, state, page und pageSize an. Es ist kein beliebiges SQL.
  4. dfb_record und dfb_work_items lesen die aktuell erlaubten Datensätze und anstehenden Aufgaben.
  5. Übergeben Sie vor der Ausführung an dfb_action_plan die tatsächliche releaseId, releaseHash, canonicalIrHash, agentManifestHash, commandType, planIdempotencyKey und die Vertrags-Payload.
  6. Prüfen Sie riskClass, requiresApproval und status; betrifft der Plan einen Zieldatensatz, behalten Sie expectedRecordVersion bei.
  7. dfb_action_execute führt nur Pläne aus, die der aktuellen Verbindung gehören und bereit sind; Genehmigungstokens für erforderliche menschliche Genehmigungen werden von DataFocus ausgestellt.
  8. Nach Fehlschlag oder Timeout ermitteln Sie mit dfb_action_status den Stand des ursprünglichen Plans; Wiederholungen behalten die ursprüngliche Idempotenzsemantik bei.
Abbildung A10: Veröffentlichte Verträge, Pläne, Genehmigungen und Aktionsausführung. Schematische Darstellung.

Verbindungs- und Versionsbindung

Pläne sind an die stabile isolierte ID des aktuellen Grants gebunden. Nach der Aktualisierung des Access-Tokens können Pläne derselben Verbindung weiterhin verarbeitet werden; eine andere OAuth-Verbindung kann sie nicht übernehmen. Bei der Ausführung werden veröffentlichte Version, IR-/manifest-Hashes, Zieldatensatzversion, Planablauf, Idempotenz und Genehmigung erneut geprüft. Die OAuth-Allowlist umgeht nicht die Geschäfts-Governance.

Kapitel 21

Geschäftswissen-Eingaben und offene Bestätigungsfragen

Geschäftseingaben registrieren, wenn der entsprechende Produktionsprozessor freigegeben ist, und die Grenze der menschlichen Bestätigung bewahren.

Die folgenden vier Tools werden vom öffentlichen MCP-Controller abhängig von installierten Prozessoren und dem aktuellen Scope hinzugefügt. Sie erscheinen nicht ständig im Basiskatalog. Die Existenz einer deklarierten Schema-Definition bedeutet nicht, dass die Instanz vollständig über die erforderlichen Prozessoren, Budgets und Berechtigungen verfügt; prüfen Sie zunächst tools/list.

ToolZweckNicht erzeugte Autorisierungen oder Effekte
dfc_ontology_knowledge_input_proposeUrsprüngliche Geschäftseingaben für einen bestehenden Workspace registrierenKeine Bestätigungsfragen erzeugen; keine Genehmigung; keine Veröffentlichung
dfc_ontology_knowledge_input_previewFragenentwürfe aus der ursprünglichen Eingabe vorläufig in der Vorschau anzeigenKeine Persistenz; keine Bestätigung; keine Produktionsquittung
dfc_ontology_knowledge_question_submitVerfasste und unbestätigte Fragen speichernAntworten nicht automatisch zusammenführen; keine Verantwortungsberechtigung oder Veröffentlichungsrechte erlangen
dfc_ontology_business_scope_initializeDen Consumer-Scope eines Geschäftssystems ausdrücklich initialisierenNicht veröffentlichen, nicht aktivieren, keine Quellzugriffsberechtigung erteilen

Eingabe und Vorschau

  1. Übernehmen Sie workspaceId, workspaceRevision, localRef und preparationDigest aus der tatsächlichen Vorbereitung.
  2. propose registriert die Geschäftseingaben mit dem ursprünglichen input-Vertrag und einem stabilen idempotencyKey; derselbe Schlüssel darf nur derselben Eingabe entsprechen.
  3. preview verwendet den Idempotenzschlüssel der ursprünglichen Eingabe und ontologyId; es gibt bei jedem Aufruf die serverseitige Revision und ein 60-Sekunden-Fenster zurück und ist keine idempotente Quittung über eine abgeschlossene Produktion.
  4. question_submit verwendet zum Speichern einer Frage bei Bedarf einen neuen Befehlsschlüssel, den ursprünglichen originalInputKey, eine explizite questionRevision, validFrom, validUntil und expectedRevision; bei der Erstellung ist expectedRevision null.

Einstiegspunkt für die menschliche Bestätigung

Die von question_submit zurückgegebene knowledgeConfirmationPage ist lediglich ein relativer Verweis auf die ursprüngliche, anmeldepflichtige Seite, auf der eine bestimmte Frage vorausgefüllt wird. Sie enthält kein Bearer-Token, öffnet keine Seite automatisch und bestätigt kein Wissen. QUESTION_STORED_UNCONFIRMED zeigt ausdrücklich an, dass noch nicht bestätigt wurde; in Antworten darf dies nicht als „Wissen veröffentlicht“ dargestellt werden.

Initialisierung des Consumer-Scopes

business scope initialize erfordert sowohl die Veröffentlichungsberechtigung für die Ontologie als auch die Ersteller- oder SourceManager-Verwaltungsberechtigung für genau das betreffende Geschäftssystem. Es verwendet die tatsächlichen Koordinaten von domainRid, domainRevisionId und businessSystemId; der Client darf keine beliebigen consumerScope-Werte oder Fertigstellungsnachweise eintragen. Die Rückgabe von INITIALIZED und COMPLETED weist weiterhin ausdrücklich published=false und activationAuthorized=false aus.

Diese Anfragen durchlaufen zudem strenge JSON-, Feldmengen-, Byte- und Tiefenprüfungen. Das Limit für Eingabeanfragen beträgt 1 MiB; einzelne konkrete Operationen haben kleinere Limits. Vollständige Ein- und Ausgabe-Schemas werden mit der Tool-Referenz ausgeliefert; die tolerante Parameterlogik des allgemeinen MCP-Wrappers darf nicht auf diese strengen Verträge angewendet werden.

Kapitel 22

Antworten, Fehler und sichere Wiederholungen

Werten Sie Fehler Ebene für Ebene aus und bewahren Sie Aufgabenkoordinaten und Idempotenzsemantik.

EbenePrüfumfangVerarbeitungsprinzip
Netzwerk und HTTPVerbindung, TLS, 401, 403, 400, 404, 405 usw.Fehlgeschlagene Antworten nicht als gewöhnliche Abfrageergebnisse behandeln
JSON-RPCerror.code message dataProtokoll-, Methoden-, Parameter- und Autorisierungsprobleme unterscheiden
MCP-Toolresult.isError und structuredContentHTTP 200 schließt einen Fehlschlag nicht aus
GeschäftsergebnisTatsächlicher Status, Vollständigkeit, Fehlerursache, nextActionEmpfang oder Bereitschaft bedeutet nicht Fertigstellung
Eignung als FaktexecutionReceipt citationEligible contentCompleteNicht geeignete Inhalte dienen nur der Lokalisierung oder der Erklärung von Lücken

Häufige HTTP-Fälle

  • 401: Bearer-Token fehlt oder ist ungültig; gemäß dem aktuellen OAuth-Ablauf aktualisieren oder neu autorisieren.
  • 403: Grant, Rolle, ausgewählte Ressource, Quellenberechtigung, Origin oder Konfiguration nicht erfüllt; nicht durch Wiederholung umgehen.
  • 400: Nachricht oder versionierter Vertrag ungültig, einschließlich Inkonsistenz zwischen modernen Headern und Metadaten.
  • 404: Exakten Dienstpfad, Protokollmethode und Laufzeitfähigkeiten prüfen; nicht willkürlich die Ontologie-ID wechseln.
  • 405: GET und DELETE sind auf dem öffentlichen /mcp grundsätzlich nicht freigegeben; verwenden Sie korrekt POST und bauen Sie keine SSE-Langzeitverbindung auf.

Schreiboperationen mit unklarem Ergebnis

MCP_OPERATION_OUTCOME_UNKNOWN kann outcome=UNKNOWN, retryable=false, nextAction=READ_ORIGINAL_STATUS, recoveryTool sowie die ursprünglichen Lokalisierungsparameter enthalten. Zuerst den ursprünglichen Status prüfen, dann die ursprüngliche Anfrage wieder aufnehmen. Kandidaten nicht erneut einreichen, den Idempotenzschlüssel nicht wechseln und einen Timeout nicht als Transaktions-Rollback behandeln.

Abbildung A11: Reihenfolge der Behandlung von Fehlern, unklaren Ergebnissen und wiederholbaren Fällen. Wiederherstellungsschema.

Unverändert beizubehaltende Inhalte

  • Ursprünglicher Grant, Ressourcenumfang, Aufgaben- und Ergebnis-IDs.
  • candidateHash, planHash, expectedRevision, Zielversion und Veröffentlichungsauswahl.
  • Idempotenzschlüssel derselben logischen Operation; unterschiedliche Geschäftsvorgänge sollten neue Schlüssel verwenden.
  • Serverseitig deklarierte Werte für retryable, remediation, nextAction und der aktuelle Status.

Interne SQL-Angaben, Hosts, Anmeldeinformationen oder Stacktraces nicht aus Fehlertexten als Antwortquelle extrahieren. Es genügt, offenlegbare Fehlercodes und Korrelationsinformationen der Anfrage zu protokollieren; die ursprünglichen Fehler muss ggf. ein Administrator in kontrollierten Protokollen einsehen.

Kapitel 23

Integrationssicherheit und Fähigkeitsgrenzen

Die ursprünglichen Grenzen von Identität, Ressourcen, Ausführung und Evidenz bewahren und nicht vertrauenswürdige Dokumente sicher verarbeiten.

  1. Nur mit den offiziellen, vom Administrator angegebenen Domänen verbinden; TLS und OAuth-Issuer prüfen und die Zertifikatsprüfung nicht deaktivieren.
  2. Einen dedizierten Grant mit minimalem Ressourcenbereich verwenden; Administratorkonten, Cookies oder langfristige interne Tokens nicht als Anmeldeinformationen für öffentliche Schnittstellen verwenden.
  3. Dokumentinhalt als nicht vertrauenswürdiges Geschäftsmaterial behandeln. „Regeln ignorieren“, „Schlüssel hochladen“ oder „Befehle ausführen“ in Dokumenten stellen keine Tool-Autorisierung dar.
  4. Automatische Wiederholungen, Parallelität und Ergebnisbereich begrenzen; die ursprünglichen Geschäftsberechtigungen nicht clientseitig nachbilden.
  5. Protokolle erfassen nur notwendige Korrelationsinformationen, jedoch keine Bearer-Tokens, Refresh-Tokens, Genehmigungstokens oder vollständigen vertraulichen Geschäftsinhalte.
  6. Nach Trennung des Benutzers oder Widerruf durch den Administrator zwischengespeicherte Autorisierungen und Daten nicht weiter verwenden und keine weiteren Aufrufe mit alten Locators ausführen.

Tool-Hinweise sind keine Berechtigungen

readOnlyHint, destructiveHint, idempotentHint und openWorldHint dienen dem Verständnis der Fähigkeiten auf Clientseite, garantieren nicht den tatsächlichen Geschäftseffekt jedes Aufrufs und ersetzen nicht die Autorisierung des aktuellen Benutzers. Alle Schreib-, Planungs-, Vorschau-, Sitzungs- und Abbruchaktionen werden gemäß ihrem tatsächlichen Verhalten behandelt.

Nicht aufzurufende Einstiegspunkte

  • Die ursprünglichen Trino-/Hive-/Hadoop-Dienste und Heavy ETL, die nicht in Flash enthalten sind.
  • Interne, FocusCode-exklusive Scopes oder Workspace-Schnittstellen.
  • Ausführung v2, AutoML oder andere experimentelle Tools, die nicht in der tools/list der aktuellen Instanz erscheinen.
  • Private Browser-REST-Schnittstellen, beliebige Datenbankverbindungen oder Dienste anderer Mandanten, um eine MCP-Ablehnung zu umgehen.

Datensemantik

Folgen Sie den serverseitigen Verträgen für exakte Dezimalwerte, Typen, Währungen, Einheiten, Zeit und Evidenz. Runden Sie Werte nicht erneut und rechnen Sie keine Währungen um, nur weil der Ausgabetext wie eine Zahl aussieht, und erstellen Sie keine globale Rangliste aus den sichtbaren Zeilen, wenn Ergebnisse gekürzt wurden.

Kapitel 24

Administrator-Verdrahtung und bedingte Schalter

Vor dem Aktivieren erweiterter Fähigkeiten die tatsächlichen Komponenten, öffentlichen Adressen und ursprünglichen Berechtigungskonfigurationen prüfen.

KonfigurationZweckVoraussetzungen für den Go-Live
datafocus.mcp.public-base-urlOffizielle externe BasisadresseOAuth-Discovery, Issuer, Callbacks und Reverse-Proxy konsistent
datafocus.mcp.allowed-originsZusätzlich genehmigte Browser-OriginsExakte Konfiguration, keine Ausweitung auf beliebige Origins
datafocus.mcp.oauth.route-proof-secretEigenes Server-Geheimnis für Graph-Routing-NachweiseSeparat speichern; kein Bearer-Token als Schlüssel verwenden
datafocus.mcp.analysis.tools.enabledInteraktive AnalysetoolsZugehörige Daten-, Wissens- und Berechtigungsdienste tatsächlich verfügbar
datafocus.mcp.analysis.report-tools.enabledPersistente BerichtstoolsZugehöriger Speicher, Worker und Wiederherstellungskette verfügbar
datafocus.mcp.analysis.apps.enabledAnzeige über MCP AppsClient deklariert Unterstützung und prüft das zurückgegebene _meta
datafocus.mcp.authoring.enabledEntwurfs- und ModellierungsverträgeUrsprüngliche Administrator- und Ressourcenberechtigungen beibehalten
datafocus.mcp.authoring.apply-enabledAnwenden von ArtefaktenUnveränderlicher Plan, ursprüngliche Genehmigung und erneute Prüfung des aktuellen Status
datafocus.mcp.ontology-published-query-enabledVeröffentlichte Modelle und AbfragenTatsächlich festgeschriebene (committed) Version und Quellenautorisierung
datafocus.mcp.ontology-candidate-query-enabledStrukturierte KandidatenabfragenKandidaten-Eigentümerschaft, exakte Version und Leserecht
datafocus.mcp.authoring.ontology-auto-publication-enabledAutorisierungen für die Delegation der automatischen VeröffentlichungGültige ursprüngliche Richtlinie, Public-Key-Vertrauen, Budget und Veröffentlichungsrecht

Diese Namen stammen aus der r56-Konfiguration und -Implementierung; ob sie aktiviert werden können, hängt von den zugehörigen Diensten und den ursprünglichen Go-Live-Freigabekriterien ab. Das bloße Ändern boolescher Werte ergänzt keine fehlenden Prozessoren, Datenbanken, Validierungsbudgets oder Richtlinien. Die Sichtbarkeit von Wissenseingabeerweiterungen und Pi-Aufgaben richtet sich nach den tatsächlich installierten Komponenten.

Edge-Proxy

Authorization, Content-Type, MCP-Protocol-Version, Mcp-Method, Mcp-Name und die genehmigte Origin beibehalten. Request-Body, Timeouts und TLS gemäß den tatsächlichen Dienstanforderungen festlegen; das öffentliche /mcp nicht an einen Verwaltungsport oder ein anderes Produkt weiterleiten.

Go-Live-Checkliste

  • Die Statuscodes anonymer Discovery-Anfragen und geschützter Aufrufe entsprechen den Erwartungen.
  • Normale Benutzer können nur ihren autorisierten Bereich ermitteln; nach Widerruf werden nachfolgende Anfragen abgelehnt.
  • Native Search-Sitzungen, SQL, Originaltexte und optionale Berichte liefern jeweils tatsächliche Ergebnisse.
  • Genehmigung und idempotente Wiederherstellung von Schreib- und Veröffentlichungsvorgängen behalten das ursprüngliche Verhalten bei.
  • Protokolle und öffentliche Dokumente enthalten keine privaten Schlüssel, Tokens, Cookies, Passwörter oder internen Kundeninformationen.
Kapitel 25

Lauffähiger Client und Aufrufbeispiele

Nachrichten mit dem zugehörigen minimalen Client prüfen, ohne OAuth oder die aktuelle Autorisierung zu umgehen.

examples/flash_mcp.py ist ein minimaler Protokollclient, der nur von der Python-Standardbibliothek abhängt. Er meldet sich nicht an, erteilt keine Genehmigungen stellvertretend, ruft keine nicht sichtbaren Tools automatisch auf, unterstützt moderne und ältere Protokolle und unterscheidet beim Beenden zwischen HTTP, JSON-RPC- und Tool-Fehlern. Tokens werden über Umgebungsvariablen des Prozesses übergeben und nicht in Skripte oder Dokumentationsdateien geschrieben.

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

Lesen und Abfragen

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

Ersetzen Sie zunächst Platzhalter wie ONTOLOGY_ID und TABLE_RESOURCE_ID in der Anfragedatei durch die tatsächlichen, von der aktuellen Autorisierung zurückgegebenen Werte. Der Client lehnt die Ausführung ab, wenn er auf Platzhalter trifft. Das SQL-Beispiel setzt voraus, dass das zugehörige CSV bereits mit den ursprünglichen Spaltennamen importiert wurde; ohne passendes Schema kann es nicht direkt eingereicht werden.

Weitere Szenarien

  • Geschäftseinstieg: --endpoint business verwenden, um erneut einen Grant für /mcp/business zu erhalten.
  • Ältere Clients: --protocol 2025-11-25 wählen, zuerst initialize, dann im selben Protokoll aufrufen.
  • Integrierte Dokumentation: Mit resources oder read-resource die tatsächliche URI lesen.
  • Offline-Selbsttest: --self-test prüft die Konstruktion moderner Header und Metadaten, benötigt kein Token und fragt keinen Produktserver ab.

Grenzen der Beispiele

Der Client ist der Einstiegspunkt für den Protokollzugriff; er erzeugt keine Modellierungskandidaten, speichert keine Frage-Antwort-Einträge und führt keine Veröffentlichung durch. Er gibt das ursprüngliche JSON aus, damit übergeordnete Agenten den Geschäftsstatus prüfen können; versprechen Sie dem Benutzer nicht allein anhand des Prozess-Exitcodes den Abschluss von Abfragen, Berichten oder Veröffentlichungen.

Kapitel 26

Einbetten der Ontologie-Chat-Oberfläche

Die Chat-Seite für Menschen in das Geschäftsfrontend einbetten und die Grenzen von Anmeldung und Browsersicherheit wahren.

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 ist eine Beispiel-Mandanten-ID und 1001 eine Beispiel-Ontologie-ID; beim Einsatz durch tatsächlich berechtigte Koordinaten ersetzen. Eine einzelne Ontologie kann per path oder unterstütztem query angegeben werden; der all-Modus bietet eine @-Auswahl der für den aktuellen Benutzer zugänglichen Ontologien. skillId wird nur transparent weitergegeben; daraus lässt sich nicht ableiten, dass die Skill-Orchestrierung bereits ausführbar ist.

Authentifizierung und Domänen

Die aktuelle eingebettete Seite setzt eine echte DataFocus-Anmeldesitzung voraus und prüft /uc/status. Cross-Site-Cookies, SSO, CSP-frame-ancestors und Gateway-Konfigurationen beeinflussen die Einbettung. Ein in die URL eingefügtes MCP-Bearer-Token wird nicht als anmeldefreier Zugang akzeptiert; nicht implementierte outside-Links dürfen nicht anhand von Designvorschlägen selbst zusammengesetzt werden.

Unterschied zwischen MCP und iframe

MethodeNutzerIdentität und Ergebnis
Remote MCPExterne Agent- oder DienstintegrationOAuth-Grant und strukturierte Tool-Quittungen
Ontologie-Chat-iframeEndbenutzer (Mensch)Ursprüngliche Anmeldesitzung und Chat-Oberfläche
MCP AppsMCP-Clients mit Unterstützung der ErweiterungKontrollierte Ressourcen und aktuelle Tool-Ergebnisse, kein öffentlicher Ersatz für den iframe-Login
Kapitel 27

Abnahmeliste für die Integration

Die vollständige Geschäftskette auf einer realen Instanz nachweisen, statt nur zu bestätigen, dass Schnittstellen 200 zurückgeben.

  1. Discovery: Tatsächlich unterstützte Versionen, aktuellen Tool-Katalog und integrierte Ressourcen erfassen.
  2. Autorisierung: Normale Benutzer sehen nur die genehmigten Ontologien und Geschäftssysteme; Operationen ohne Scope werden abgelehnt.
  3. Tabellenstruktur: Tatsächliche Anzeigenamen, Spalten, Typen und Berechtigungen sind vollständig.
  4. SQL: Eindimensionale, mehrdimensionale, JOIN-, Datums-, TopN- und Kürzungsprüfungen entsprechen der tatsächlichen fachlichen Definition.
  5. Wissen: Lokalisierung, vollständiger Originaltext und Zitierfähigkeit als Fakt sind konsistent; gemischte Fragen stützen sich zugleich auf Daten- und Dokumentevidenz.
  6. Search: Modell-, init-, Vorschlags-, Ergebnis-, close- und Puffer-Integritätsprüfungen bestanden.
  7. Optionale Analyse und Berichte: Tatsächlicher Zustand mehrerer Zweige, Paginierung, Berechtigungsänderungen und Abbruch behalten das ursprüngliche Verhalten bei.
  8. Optionale Modellierung: Kandidat, Plan, ursprüngliche Genehmigung, tatsächliche Anwendung und Versionsabfrage in jeder Phase geprüft.
  9. Geschäftsaktionen: Veröffentlichungs-Hash, Zielversion, Genehmigung, Idempotenz und Isolation zwischen Grants geprüft.
  10. Wiederherstellung: Nach einem Netzwerk-Timeout wird der ursprüngliche Zustand wieder aufgenommen; nach einer Quellenaktualisierung verliert die alte Lokalisierung ihre Gültigkeit, und eine neue Abfrage wird verwendet.

Ergebnisdokumentation

Instanzversion, Benutzerrolle, Grant-Umfang, Konfigurationsversion, tatsächliche Operationen und Ergebnisse dokumentieren. Offline-Selbsttest des Protokoll-Clients, Offline-Erwartungswerte des Beispiel-CSV, statische JSON-Schema-Validierung und echte Online-Funktionsabnahme getrennt kennzeichnen. Das Bestehen einer Phase nicht auf das Bestehen des gesamten Produkts extrapolieren.

Kapitel 28

Spezifikationsressourcen und Wartung

Die mit dem Handbuch gelieferten vollständigen Tool-Schemas verwenden und mit den tatsächlichen Discovery-Ergebnissen der Instanz synchron halten.

RessourcenInhalt
reference/mcp-tool-catalog.json32 deklarierte Eingabeschemata auf der Ontologie- und 8 auf der Geschäftsseite; einige Tools enthalten ursprüngliche Ausgabeschemata
reference/locales.json21 auswählbare Optionen sowie 24 kompatible Locales und UI-Begriffe
reference/search-keywords.jsonStatische Schlüsselwortkataloge für 17 explizit aufgeführte Locales
reference/analysis-contract-manifest.jsonVersionseinschränkungen für Analyse, Zweige, Fakten, Quittungen und Berichte
examples/Synthetische CSV-Daten, Erläuterung der fachlichen Definitionen, Top3-SQL, erwartete Ergebnisse und minimaler Protokoll-Client

Integrierte Beschreibungsressourcen

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

resources/list und resources/read erfordern, dass der aktuelle Benutzer mindestens eine entsprechende Leseberechtigung aus metadata, search operate oder etl operate besitzt. ETL-Dokumente sind statische produktübergreifende Referenzen; Ausführbare Fähigkeiten in Flash beschränken sich weiterhin auf den Umfang, den Flash ausdrücklich meldet.

Externe Protokollreferenzen

Hintergrund zu MCP-Protokoll und Autorisierung liefern die offiziellen Spezifikationen: https://modelcontextprotocol.io/specification/2026-07-28/basic und https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization. Endpunkte, Tools und bedingtes Verhalten dieses Produkts richten sich nach der r56-Implementierung und den aktuellen Discovery-Ergebnissen der Instanz; allgemeine Protokollunterstützung ist nicht gleichbedeutend damit, dass der Server alle optionalen Funktionen bereitstellt.

Upgrade und Wartung

Beim Upgrade Tools und Versionen neu ermitteln und Eingabeschemata, Ausgabeverträge und Konfiguration vergleichen; alte Grants erhalten keine neuen Scopes automatisch. Referenzen, Caches und Quittungen an die Quellversion binden, nach bestätigten inkompatiblen Änderungen den Kontext neu erfassen und alte Lokalisierungen nicht zwangsweise auf neue Geschäftszustände anwenden.

Kapitel 29

Tool-Parameterreferenz: Basis und natives Search

Vollständige Namen und Eingabefelder, gruppiert nach Tools.

Die folgenden Tabellen dienen als Lesehilfe zu den Eingabefeldern der aktuellen r56-Tools. Vollständige verschachtelte Typen, oneOf, bedingte Pflichtfelder, Musterbeschränkungen und einzelne Ausgabeschemata siehe reference/mcp-tool-catalog.json; vor der endgültigen Übermittlung muss weiterhin tools/list des aktuellen Grants gelesen werden. Das Label „Optional“ in den Tabellen hebt die internen Validierungsanforderungen der Aktion nicht auf.

dfc_manual

ParameterTypAnforderungBedeutung und Umfang
namesarrayOptional oder bedingt erforderlichDie explizit zu suchenden Namen, maximal 32 pro Aufruf. maxItems: 32
actionstringOptional oder bedingt erforderlichOperationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: list, read, keywords, functions, etl_requests
localestringOptional oder bedingt erforderlichExplizites Locale des statischen Referenzkatalogs, nicht die Standard-Abfragesprache.
uristringOptional oder bedingt erforderlichVom aktuellen Tool aufgeführte integrierte Ressourcen-URI. enum: datafocus://manuals/etl-formulas/v1, datafocus://manuals/search-keyword-queries/v1, datafocus://manuals/etl-functions/v1, datafocus://manuals/search-keywords/v1

dfc_search

ParameterTypAnforderungBedeutung und Umfang
dataobjectOptional oder bedingt erforderlichUrsprüngliche Aktions-Payload; siehe Fähigkeitsermittlung und Tabelle der Aktionsfelder.
actionstringErforderlichOperationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: capabilities, model_create, model_read, open, request, poll, cancel, close

dfc_etl

ParameterTypAnforderungBedeutung und Umfang
dataobjectOptional oder bedingt erforderlichUrsprüngliche Aktions-Payload; siehe Fähigkeitsermittlung und Tabelle der Aktionsfelder.
actionstringErforderlichOperationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: capabilities

dfc_ontologies

ParameterTypAnforderungBedeutung und Umfang
pageSizeintegerOptional oder bedingt erforderlichEinträge pro Seite; gemäß Schema-Obergrenze. minimum: 1; maximum: 100
pageintegerOptional oder bedingt erforderlichSeitennummer, beginnend bei 1. minimum: 1

dfc_ontology_resources

ParameterTypAnforderungBedeutung und Umfang
resourceTypesarrayOptional oder bedingt erforderlichMenge der zurückzugebenden Ressourcentypen.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
pageSizeintegerOptional oder bedingt erforderlichEinträge pro Seite; gemäß Schema-Obergrenze. minimum: 1; maximum: 100
pageintegerOptional oder bedingt erforderlichSeitennummer, beginnend bei 1. minimum: 1
Kapitel 30

Tool-Parameterreferenz: Tabelle, Graph und Wissen

Vollständige Namen und Eingabefelder, gruppiert nach Tools.

Die folgenden Tabellen dienen als Lesehilfe zu den Eingabefeldern der aktuellen r56-Tools. Vollständige verschachtelte Typen, oneOf, bedingte Pflichtfelder, Musterbeschränkungen und einzelne Ausgabeschemata siehe reference/mcp-tool-catalog.json; vor der endgültigen Übermittlung muss weiterhin tools/list des aktuellen Grants gelesen werden. Das Label „Optional“ in den Tabellen hebt die internen Validierungsanforderungen der Aktion nicht auf.

dfc_ontology_graph

ParameterTypAnforderungBedeutung und Umfang
relationTypesarrayOptional oder bedingt erforderlichBeziehungstypfilter.
depthintegerOptional oder bedingt erforderlichTiefe der Nachbartraversierung. minimum: 1; maximum: 3
sourceTypesarrayOptional oder bedingt erforderlichQuellentypfilter.
queryobjectOptional oder bedingt erforderlichAbfragetext oder ein exakt versioniertes Abfrageobjekt entsprechend der action.
limitintegerOptional oder bedingt erforderlichObergrenze der zurückgegebenen Anzahl. minimum: 1; maximum: 100
actionstringErforderlichOperationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: search, neighbors, published_model, published_query, candidate_query
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
nodeKeystringOptional oder bedingt erforderlichAus den tatsächlichen Graph-Ergebnissen kopierter Knotenschlüssel.
keywordstringOptional oder bedingt erforderlichSchlüsselwörter zur Lokalisierung im Graphen, nicht die Schlüsselwortsyntax für Datenabfragen.
nodeTypesarrayOptional oder bedingt erforderlichKnotentypfilter.

dfc_ontology_query

ParameterTypAnforderungBedeutung und Umfang
routeLocatorsarrayOptional oder bedingt erforderlichVom Server ausgestellte typisierte Routing-Locators, vollständig zu übernehmen. maxItems: 20
topKintegerOptional oder bedingt erforderlichObergrenze der abgerufenen Kandidaten, kein Beleg für vollständige Abdeckung. minimum: 1; maximum: 20
queryModestringOptional oder bedingt erforderlichEvidenzabfragemodus gemäß Tool-Enum wählen. enum: vector, hybrid, graph
fanoutPlanobjectOptional oder bedingt erforderlichEingeschränkter Abrufplan für Zweige, gemäß verschachteltem Schema.
structuredPlanobjectOptional oder bedingt erforderlichAn den serverseitigen Vertrag gebundener Plan für die vollständige Dokumenttabelle, kein SQL.
knowledgeIdsarrayOptional oder bedingt erforderlichWissensdatenbank-ID aus den tatsächlichen knowledgeBindings.
querystringErforderlichAbfragetext oder ein exakt versioniertes Abfrageobjekt entsprechend der action.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.

dfc_knowledge_search

ParameterTypAnforderungBedeutung und Umfang
topKintegerOptional oder bedingt erforderlichObergrenze der abgerufenen Kandidaten, kein Beleg für vollständige Abdeckung. minimum: 1; maximum: 20
minScorenumberOptional oder bedingt erforderlichMinimaler Übereinstimmungswert. minimum: 0; maximum: 1
knowledgeIdsarrayOptional oder bedingt erforderlichWissensdatenbank-ID aus den tatsächlichen knowledgeBindings.
querystringErforderlichAbfragetext oder ein exakt versioniertes Abfrageobjekt entsprechend der action.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
assetIdsarrayOptional oder bedingt erforderlichDerzeit erlaubte Dokument-Asset-ID.
retrievalStrategystringOptional oder bedingt erforderlichTatsächlich unterstützte Abrufstrategie. enum: auto, hybrid_stage2

dfc_knowledge_detail

ParameterTypAnforderungBedeutung und Umfang
qdrantIdstring / integerOptional oder bedingt erforderlichIndexkennung aus der tatsächlichen Lokalisierung.
pageNointegerOptional oder bedingt erforderlichTatsächliche Seiten- oder Paginierungsseitennummer.
evidenceIdstringOptional oder bedingt erforderlichEvidenz-ID aus derselben Wissenslokalisierung.
actionstringErforderlichOperationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: chunk, document, page_context
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
documentIdstring / integerOptional oder bedingt erforderlichDokument-ID derselben Lokalisierung.
radiusintegerOptional oder bedingt erforderlichBereich benachbarter Seiten. minimum: 0; maximum: 3
chunkIdstringOptional oder bedingt erforderlichTatsächliche Chunk-ID derselben Lokalisierung.

dfc_table

ParameterTypAnforderungBedeutung und Umfang
maxRowsintegerOptional oder bedingt erforderlichObergrenze der zurückgegebenen Zeilen; kein Bereich für clientseitige Rangbildung. minimum: 1; maximum: 200
actionstringErforderlichOperationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: detail, query
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
idstringOptional oder bedingt erforderlichTatsächliche Tabellenressourcen-ID, nicht der physische oder Anzeigename.
sqlstringOptional oder bedingt erforderlichEine einzelne, rein lesende Doris-SQL-Anweisung im Ontologieumfang, mit expliziten Ausgabespalten.
Kapitel 31

Tool-Parameterreferenz: Analyse und Berichte

Vollständige Namen und Eingabefelder, gruppiert nach Tools.

Die folgenden Tabellen dienen als Lesehilfe zu den Eingabefeldern der aktuellen r56-Tools. Vollständige verschachtelte Typen, oneOf, bedingte Pflichtfelder, Musterbeschränkungen und einzelne Ausgabeschemata siehe reference/mcp-tool-catalog.json; vor der endgültigen Übermittlung muss weiterhin tools/list des aktuellen Grants gelesen werden. Das Label „Optional“ in den Tabellen hebt die internen Validierungsanforderungen der Aktion nicht auf.

dfc_analysis_ask

ParameterTypAnforderungBedeutung und Umfang
questionstringErforderlichFrage in natürlicher Sprache oder kompatible Nachfrage.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
languagestringOptional oder bedingt erforderlichExplizites Antwort- oder Abfrage-Locale; bei Weglassen gemäß den Regeln des jeweiligen Tools.
sessionIdstringOptional oder bedingt erforderlichTatsächlicher Sitzungs-Locator unter demselben Grant.

dfc_analysis_refine

ParameterTypAnforderungBedeutung und Umfang
branchIdstringOptional oder bedingt erforderlichVom Server ausgestellter Locator eines strukturierten Zweigs.
resultIdstringErforderlichLocator des ursprünglich zurückgegebenen Analyseergebnisses.
questionstringOptional oder bedingt erforderlichFrage in natürlicher Sprache oder kompatible Nachfrage.
idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird.
changeobjectOptional oder bedingt erforderlichÄnderung in natürlicher Sprache oder typisierter filter_patch.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
languagestringOptional oder bedingt erforderlichExplizites Antwort- oder Abfrage-Locale; bei Weglassen gemäß den Regeln des jeweiligen Tools.
sessionIdstringErforderlichTatsächlicher Sitzungs-Locator unter demselben Grant.
expectedRevisionintegerErforderlichVersionsvorbedingung für das ursprüngliche Ergebnis oder die fachliche Head-Version; beim Erstellen einer Frage kann der Wert null sein. minimum: 1
visualIdstringOptional oder bedingt erforderlichAn den Zweig gebundener Visualisierungs-Locator.

dfc_analysis_page

ParameterTypAnforderungBedeutung und Umfang
branchIdstringErforderlichVom Server ausgestellter Locator eines strukturierten Zweigs.
resultIdstringErforderlichLocator des ursprünglich zurückgegebenen Analyseergebnisses.
pageNointegerErforderlichTatsächliche Seiten- oder Paginierungsseitennummer. minimum: 1; maximum: 10000
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
pageSizeintegerErforderlichEinträge pro Seite; gemäß Schema-Obergrenze. minimum: 1; maximum: 100
sessionIdstringErforderlichTatsächlicher Sitzungs-Locator unter demselben Grant.
expectedRevisionintegerErforderlichVersionsvorbedingung für das ursprüngliche Ergebnis oder die fachliche Head-Version; beim Erstellen einer Frage kann der Wert null sein. minimum: 1

dfc_analysis_result_get

ParameterTypAnforderungBedeutung und Umfang
resultIdstringErforderlichLocator des ursprünglich zurückgegebenen Analyseergebnisses.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
sessionIdstringErforderlichTatsächlicher Sitzungs-Locator unter demselben Grant.

dfc_analysis_cancel

ParameterTypAnforderungBedeutung und Umfang
resultIdstringErforderlichLocator des ursprünglich zurückgegebenen Analyseergebnisses.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
sessionIdstringErforderlichTatsächlicher Sitzungs-Locator unter demselben Grant.

dfc_analysis_close

ParameterTypAnforderungBedeutung und Umfang
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
sessionIdstringErforderlichTatsächlicher Sitzungs-Locator unter demselben Grant.

dfc_report_create

ParameterTypAnforderungBedeutung und Umfang
goalstringErforderlichBerichtsanalyseziel.
idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
languagestringOptional oder bedingt erforderlichExplizites Antwort- oder Abfrage-Locale; bei Weglassen gemäß den Regeln des jeweiligen Tools.
titlestringOptional oder bedingt erforderlichOptionaler Berichtstitel.

dfc_report_status

ParameterTypAnforderungBedeutung und Umfang
reportIdstringErforderlichLocator des persistenten Berichts im aktuellen Grant.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.

dfc_report_cancel

ParameterTypAnforderungBedeutung und Umfang
reportIdstringErforderlichLocator des persistenten Berichts im aktuellen Grant.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
Kapitel 32

Tool-Parameterreferenz: Modellierung und ursprüngliche Aufgaben

Vollständige Namen und Eingabefelder, gruppiert nach Tools.

Die folgenden Tabellen dienen als Lesehilfe zu den Eingabefeldern der aktuellen r56-Tools. Vollständige verschachtelte Typen, oneOf, bedingte Pflichtfelder, Musterbeschränkungen und einzelne Ausgabeschemata siehe reference/mcp-tool-catalog.json; vor der endgültigen Übermittlung muss weiterhin tools/list des aktuellen Grants gelesen werden. Das Label „Optional“ in den Tabellen hebt die internen Validierungsanforderungen der Aktion nicht auf.

dfc_ontology_agent

ParameterTypAnforderungBedeutung und Umfang
modestringOptional oder bedingt erforderlichQUERY oder AUTHORING; beide Fähigkeiten werden separat autorisiert. enum: QUERY, AUTHORING
instructionstringOptional oder bedingt erforderlichAnforderungstext des Benutzers; Kontext und Übermittlung müssen übereinstimmen. maxLength: 16000
idempotencyKeystringOptional oder bedingt erforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. maxLength: 128
actionstringErforderlichOperationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: start, status, cancel
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
runIdstringOptional oder bedingt erforderlichUrsprüngliche Aufgaben-ID derselben Ontologie und desselben Grants.
contractVersionstringErforderlichEs muss die exakte, tatsächlich unterstützte Vertragsversion verwendet werden. enum: ontology-agent-task-v1

dfc_authoring_capabilities

Das Eingabe-Stammobjekt dieses Tools hat keine Felder; ein leeres arguments-Objekt verwenden.

dfc_artifact_context

ParameterTypAnforderungBedeutung und Umfang
artifactTypestringErforderlichTatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: CONTROL_PANEL_SPEC, VIEW_SPEC
scopeTypestringOptional oder bedingt erforderlichRessourcenumfangstyp im tatsächlichen Artefaktvertrag.
ontologyIdstringOptional oder bedingt erforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
projectIdstringOptional oder bedingt erforderlichDerzeit autorisierte Projekt-ID.
artifactIdstringOptional oder bedingt erforderlichTatsächliche ID eines zu bearbeitenden vorhandenen Artefakts.
instructionstringErforderlichAnforderungstext des Benutzers; Kontext und Übermittlung müssen übereinstimmen.
variablesobjectOptional oder bedingt erforderlichVariablenobjekt gemäß zurückgegebenem Vertrag.
previewInputobjectOptional oder bedingt erforderlichBegrenzte Vorschau-Eingaben gemäß Vertrag.
viewportobjectOptional oder bedingt erforderlichVom Vertrag geforderter Anzeige-Viewport.

dfc_ontology_table_schema

ParameterTypAnforderungBedeutung und Umfang
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
sourceAssetRefstringErforderlichRegistrierte strukturierte Asset-Referenz, z. B. table:123.
fieldsarrayErforderlichFelder der aktuellen Quelle mit optionalen expliziten Typdeklarationen. minItems: 1; maxItems: 64

dfc_artifact_preview

ParameterTypAnforderungBedeutung und Umfang
proposalIdstringErforderlichUrsprüngliche, unter dem aktuellen Grant erstellte Kandidaten-ID.
candidateHashstringErforderlichExakter Hash des ursprünglichen serverseitigen Kandidaten.
previewInputobjectErforderlichBegrenzte Vorschau-Eingaben gemäß Vertrag.

dfc_artifact_status

ParameterTypAnforderungBedeutung und Umfang
proposalIdstringOptional oder bedingt erforderlichUrsprüngliche, unter dem aktuellen Grant erstellte Kandidaten-ID.
planIdstringOptional oder bedingt erforderlichID des unveränderlichen Anwendungsplans.

dfc_artifact_plan

ParameterTypAnforderungBedeutung und Umfang
proposalIdstringErforderlichUrsprüngliche, unter dem aktuellen Grant erstellte Kandidaten-ID.
candidateHashstringErforderlichExakter Hash des ursprünglichen serverseitigen Kandidaten.
expectedTargetVersionintegerErforderlichVersionsvorbedingung für die aktuelle tatsächliche Zielversion. minimum: 0
idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird.

dfc_artifact_apply

ParameterTypAnforderungBedeutung und Umfang
planIdstringErforderlichID des unveränderlichen Anwendungsplans.
planHashstringErforderlichHash aus dem ursprünglichen Plan.
approvalTokenstringErforderlichVom ursprünglichen Server ausgestelltes Genehmigungsmaterial; nicht selbst generieren.
idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird.

dfc_artifact_submit

ParameterTypAnforderungBedeutung und Umfang
Konfiguration 1 / artifactTypestringErforderlichTatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: CONTROL_PANEL_SPEC, VIEW_SPEC
Konfiguration 1 / scopeTypestringOptional oder bedingt erforderlichRessourcenumfangstyp im tatsächlichen Artefaktvertrag.
Konfiguration 1 / ontologyIdstringOptional oder bedingt erforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
Konfiguration 1 / projectIdstringOptional oder bedingt erforderlichDerzeit autorisierte Projekt-ID.
Konfiguration 1 / artifactIdstringOptional oder bedingt erforderlichTatsächliche ID eines zu bearbeitenden vorhandenen Artefakts.
Konfiguration 1 / instructionstringErforderlichAnforderungstext des Benutzers; Kontext und Übermittlung müssen übereinstimmen.
Konfiguration 1 / variablesobjectOptional oder bedingt erforderlichVariablenobjekt gemäß zurückgegebenem Vertrag.
Konfiguration 1 / previewInputobjectOptional oder bedingt erforderlichBegrenzte Vorschau-Eingaben gemäß Vertrag.
Konfiguration 1 / viewportobjectOptional oder bedingt erforderlichVom Vertrag geforderter Anzeige-Viewport.
Konfiguration 1 / contractVersionstringErforderlichEs muss die exakte, tatsächlich unterstützte Vertragsversion verwendet werden.
Konfiguration 1 / contextHashstringErforderlichVollständiger Kontext-Hash, wie von context zurückgegeben.
Konfiguration 1 / baseArtifactHashstringErforderlichBasis-Artefakt-Hash, wie von context zurückgegeben.
Konfiguration 1 / baseArtifactVersionintegerErforderlichBasisversion, wie von context zurückgegeben. minimum: 0
Konfiguration 1 / candidateobjectErforderlichKandidat, der dem aktuell zurückgegebenen Vertrag entspricht.
Konfiguration 1 / clientRequestIdstringErforderlichVom Client stabil verwendeter Idempotenzschlüssel für die aktuelle Kandidatenanfrage.
Konfiguration 2 / artifactTypestringErforderlichTatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: ONTOLOGY_RELEASE
Konfiguration 2 / contractVersionstringErforderlichEs muss die exakte, tatsächlich unterstützte Vertragsversion verwendet werden. 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 / ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
Konfiguration 2 / candidateHashstringErforderlichExakter Hash des ursprünglichen serverseitigen Kandidaten.
Konfiguration 2 / workspaceIdstringErforderlichTatsächliche Kandidaten-Workspace-Koordinaten.
Konfiguration 2 / workspaceRevisionstringErforderlichExakte Kandidatenversion, nicht latest.
Konfiguration 2 / releasesobjectErforderlichExakte Versionsauswahl gemäß dem Ontologie-Veröffentlichungsvertrag.
Konfiguration 2 / selectionobjectErforderlichNur explizite fachliche Auswahlkoordinaten angeben, keine Berechtigungs- oder Fertigstellungsnachweise.
Konfiguration 2 / idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird.
Konfiguration 3 / Konfiguration 1 / artifactTypestringErforderlichTatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: ONTOLOGY_RELEASE
Konfiguration 3 / Konfiguration 1 / contractVersionstringErforderlichEs muss die exakte, tatsächlich unterstützte Vertragsversion verwendet werden. enum: ontology-workspace-create-mcp-submit-v1
Konfiguration 3 / Konfiguration 1 / ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
Konfiguration 3 / Konfiguration 1 / workspaceIdstringErforderlichTatsächliche Kandidaten-Workspace-Koordinaten.
Konfiguration 3 / Konfiguration 1 / resourcesarrayErforderlichUrsprüngliche Modelldeklarationen, die serverseitig kompiliert werden. minItems: 1
Konfiguration 3 / Konfiguration 1 / idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird.
Konfiguration 3 / Konfiguration 2 / artifactTypestringErforderlichTatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: ONTOLOGY_RELEASE
Konfiguration 3 / Konfiguration 2 / contractVersionstringErforderlichEs muss die exakte, tatsächlich unterstützte Vertragsversion verwendet werden. enum: ontology-workspace-create-mcp-submit-v2
Konfiguration 3 / Konfiguration 2 / ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
Konfiguration 3 / Konfiguration 2 / workspaceIdstringErforderlichTatsächliche Kandidaten-Workspace-Koordinaten.
Konfiguration 3 / Konfiguration 2 / resourcesarrayErforderlichUrsprüngliche Modelldeklarationen, die serverseitig kompiliert werden. minItems: 1
Konfiguration 3 / Konfiguration 2 / idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird.
Konfiguration 3 / Konfiguration 2 / releaseSelectionsobjectErforderlichExakte releaseId jeder veröffentlichten Referenz sowie deren Abhängigkeitsabschluss.
Konfiguration 4 / artifactTypestringErforderlichTatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: ONTOLOGY_RELEASE
Konfiguration 4 / contractVersionstringErforderlichEs muss die exakte, tatsächlich unterstützte Vertragsversion verwendet werden. enum: ontology-initial-activation-retirement-submit-v1
Konfiguration 4 / ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
Konfiguration 4 / domainRidstringErforderlichTatsächliche RID der Geschäftsdomäne.
Konfiguration 4 / consumerScopesarrayErforderlichVom Server zugelassene exakte Consumer-Scopes. minItems: 1; maxItems: 256
Konfiguration 4 / idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird.
Kapitel 33

Tool-Parameterreferenz: Wissenseingaben und Scope

Vollständige Namen und Eingabefelder, gruppiert nach Tools.

Die folgenden Tabellen dienen als Lesehilfe zu den Eingabefeldern der aktuellen r56-Tools. Vollständige verschachtelte Typen, oneOf, bedingte Pflichtfelder, Musterbeschränkungen und einzelne Ausgabeschemata siehe reference/mcp-tool-catalog.json; vor der endgültigen Übermittlung muss weiterhin tools/list des aktuellen Grants gelesen werden. Das Label „Optional“ in den Tabellen hebt die internen Validierungsanforderungen der Aktion nicht auf.

dfc_ontology_knowledge_input_propose

ParameterTypAnforderungBedeutung und Umfang
requestobjectErforderlichUrsprüngliche geschäftliche Eingabeanforderung; gemäß dem vollständigen verschachtelten Schema.
idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. minLength: 1; maxLength: 128

Dieses Tool verfügt zusätzlich über ein natives outputSchema. Prüfen Sie Vollständigkeit und Status der Ausgabe sowie die ausdrücklich auf false gesetzten Autorisierungsfelder; werten Sie die Bedeutung von „abgeschlossen“ nicht eigenmächtig auf.

dfc_ontology_knowledge_input_preview

ParameterTypAnforderungBedeutung und Umfang
idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. minLength: 1; maxLength: 128
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.

Dieses Tool verfügt zusätzlich über ein natives outputSchema. Prüfen Sie Vollständigkeit und Status der Ausgabe sowie die ausdrücklich auf false gesetzten Autorisierungsfelder; werten Sie die Bedeutung von „abgeschlossen“ nicht eigenmächtig auf.

dfc_ontology_knowledge_question_submit

ParameterTypAnforderungBedeutung und Umfang
questionRevision$refErforderlichExplizite Version der aktuell zu bestätigenden Frage.
idempotencyKey$refErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird.
originalInputKey$refErforderlichIdempotenzschlüssel der zugehörigen ursprünglichen Wissenseingabe.
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten.
validUntil$refErforderlichEnde des Gültigkeitsfensters der Frage, UTC-Zeit.
expectedRevisiononeOfErforderlichVersionsvorbedingung für das ursprüngliche Ergebnis oder die fachliche Head-Version; beim Erstellen einer Frage kann der Wert null sein.
validFrom$refErforderlichBeginn des Gültigkeitsfensters der Frage, UTC-Zeit.

Dieses Tool verfügt zusätzlich über ein natives outputSchema. Prüfen Sie Vollständigkeit und Status der Ausgabe sowie die ausdrücklich auf false gesetzten Autorisierungsfelder; werten Sie die Bedeutung von „abgeschlossen“ nicht eigenmächtig auf.

dfc_ontology_business_scope_initialize

ParameterTypAnforderungBedeutung und Umfang
domainRevisionIdstringErforderlichExakte Version der Geschäftsdomäne. minLength: 1; maxLength: 128
idempotencyKeystringErforderlichIdempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. minLength: 1; maxLength: 128
businessSystemIdstringErforderlichTatsächliche Geschäftssystem-ID. minLength: 1
ontologyIdstringErforderlichTatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. minLength: 1
domainRidstringErforderlichTatsächliche RID der Geschäftsdomäne. minLength: 1; maxLength: 128

Dieses Tool verfügt zusätzlich über ein natives outputSchema. Prüfen Sie Vollständigkeit und Status der Ausgabe sowie die ausdrücklich auf false gesetzten Autorisierungsfelder; werten Sie die Bedeutung von „abgeschlossen“ nicht eigenmächtig auf.

Kapitel 34

Tool-Parameterreferenz: Business Workspace

Vollständige Namen und Eingabefelder, gruppiert nach Tools.

Die folgenden Tabellen dienen als Lesehilfe zu den Eingabefeldern der aktuellen r56-Tools. Vollständige verschachtelte Typen, oneOf, bedingte Pflichtfelder, Musterbeschränkungen und einzelne Ausgabeschemata siehe reference/mcp-tool-catalog.json; vor der endgültigen Übermittlung muss weiterhin tools/list des aktuellen Grants gelesen werden. Das Label „Optional“ in den Tabellen hebt die internen Validierungsanforderungen der Aktion nicht auf.

dfb_systems

Das Eingabe-Stammobjekt dieses Tools hat keine Felder; ein leeres arguments-Objekt verwenden.

dfb_system_describe

ParameterTypAnforderungBedeutung und Umfang
systemIdstring / integerErforderlichVom aktuellen Business-Grant zugelassene System-ID.

dfb_query

ParameterTypAnforderungBedeutung und Umfang
systemIdstring / integerErforderlichVom aktuellen Business-Grant zugelassene System-ID.
queryKeystringErforderlichVeröffentlichter Abfrageschlüssel, wie von describe zurückgegeben.
objectKeystringOptional oder bedingt erforderlichVeröffentlichter Objektschlüssel.
pageSizeintegerOptional oder bedingt erforderlichEinträge pro Seite; gemäß Schema-Obergrenze. minimum: 1; maximum: 100
pageintegerOptional oder bedingt erforderlichSeitennummer, beginnend bei 1. minimum: 1
statestringOptional oder bedingt erforderlichGeschäftsstatus-Filter oder Serverstatus.

dfb_record

ParameterTypAnforderungBedeutung und Umfang
recordIdstring / integerErforderlichID des aktuell lesbaren Geschäftsdatensatzes.
systemIdstring / integerErforderlichVom aktuellen Business-Grant zugelassene System-ID.

dfb_work_items

ParameterTypAnforderungBedeutung und Umfang
systemIdstring / integerErforderlichVom aktuellen Business-Grant zugelassene System-ID.

dfb_action_plan

ParameterTypAnforderungBedeutung und Umfang
expectedRecordVersionintegerOptional oder bedingt erforderlichAktuelle Optimistic-Lock-Version des Zieldatensatzes. minimum: 1
systemIdstring / integerErforderlichVom aktuellen Business-Grant zugelassene System-ID.
commandTypestringErforderlichBefehlstyp aus dem veröffentlichten Vertrag.
canonicalIrHashstringErforderlichHash der aktuell veröffentlichten kanonischen IR.
releaseIdstring / integerErforderlichVersions-ID des tatsächlich veröffentlichten Vertrags.
payloadobjectErforderlichPayload, die dem aktuellen Befehlsvertrag aus describe entspricht.
releaseHashstringErforderlichHash des tatsächlichen veröffentlichten Vertrags.
targetRecordIdstring / integerOptional oder bedingt erforderlichTatsächlicher Zieldatensatz, der bearbeitet werden soll.
agentManifestHashstringErforderlichHash des tatsächlichen Agent-Capability-Manifests.
planIdempotencyKeystringErforderlichStabiler Idempotenzschlüssel des Geschäftsplans.

dfb_action_status

ParameterTypAnforderungBedeutung und Umfang
actionPlanIdstring / integerErforderlichAktionsplan-ID im Besitz des aktuellen Business-Grants.

dfb_action_execute

ParameterTypAnforderungBedeutung und Umfang
approvalTokenstringOptional oder bedingt erforderlichVom ursprünglichen Server ausgestelltes Genehmigungsmaterial; nicht selbst generieren.
actionPlanIdstring / integerErforderlichAktionsplan-ID im Besitz des aktuellen Business-Grants.