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.
Inhaltsverzeichnis
- 1Agent-Integrationsumfang und Abschlusskriterien
- 2Schnellverbindung und Fähigkeitsermittlung
- 3OAuth-Discovery, Registrierung und Autorisierung
- 4Scope-Ressourcengrenzen und Echtzeitberechtigungen
- 5HTTP- und moderne MCP-Nachrichten
- 6Kompatibilität mit Clients älterer Protokollversionen
- 7Das richtige Tool und den richtigen Evidenzkanal auswählen
- 8Ontologie-Ressourcen und ID-Typen
- 9Doris-Tabellenabfragen und Strukturvertrag
- 10Mehrdimensionale Top 3 und Handhabung von Kürzungen
- 11Wissensabruf: Vollständiger Originaltext und Evidenzqualifikation
- 12Native Search-Modelle und Sitzungen
- 13Sprach- und Regionskonventionen
- 14Fusionsanalyse und interaktive Ergebnisse
- 15Persistente Visualisierungsberichte und MCP Apps
- 16Artefaktentwurf, Vorschau, Plan und Anwendung
- 17Erstellung von Ontologie-Kandidaten und Veröffentlichungsvertrag
- 18Veröffentlichtes Modell: Kandidatenabfrage und Referenzabschluss
- 19Ontologie-Agent-Aufgaben delegieren
- 20Business Workspace MCP
- 21Geschäftswissen-Eingaben und offene Bestätigungsfragen
- 22Antworten, Fehler und sichere Wiederholungen
- 23Integrationssicherheit und Fähigkeitsgrenzen
- 24Administrator-Verdrahtung und bedingte Schalter
- 25Lauffähiger Client und Aufrufbeispiele
- 26Einbetten der Ontologie-Chat-Oberfläche
- 27Abnahmeliste für die Integration
- 28Spezifikationsressourcen und Wartung
- 29Tool-Parameterreferenz: Basis und natives Search
- 30Tool-Parameterreferenz: Tabelle, Graph und Wissen
- 31Tool-Parameterreferenz: Analyse und Berichte
- 32Tool-Parameterreferenz: Modellierung und ursprüngliche Aufgaben
- 33Tool-Parameterreferenz: Wissenseingaben und Scope
- 34Tool-Parameterreferenz: Business Workspace
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.
| Einstiegspunkt | Zweck | Abgrenzung |
|---|---|---|
| /mcp | Ontologie, Datentabellen, Dokumentenwissen, natives Search sowie bedingt freigegebene Analyse und Modellierung | Schnittmenge aus aktuellen Benutzerberechtigungen und den in dieser Autorisierung freigegebenen Ressourcen |
| /mcp/business | Discovery von Geschäftssystemen, Abfragen, Aktionspläne, Status und Ausführung | Eigenständige Autorisierung für Geschäftssysteme und veröffentlichte Verträge |
| Eingebettete Seite des Ontologie-Agenten | Ontologie-Chat in der Benutzeroberfläche für Menschen verwenden | Setzt 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.
Schnellverbindung und Fähigkeitsermittlung
Mit der offiziellen Domäne der Instanz beginnen und mit minimalen Berechtigungen die tatsächlich verfügbaren Tools ermitteln.
- 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.
- Die MCP-Serveradresse als https://flash.example.com/mcp konfigurieren; der Business Workspace verwendet /mcp/business derselben Domäne.
- OAuth-Anmeldung und -Autorisierung gemäß Client-Unterstützung auslösen und Ressourcen und Scope prüfen; keine Benutzernamen/Passwörter an MCP übermitteln.
- Discovery oder Initialisierung der jeweiligen Protokollgeneration verwenden und anschließend tools/list und Ressourcenbeschreibungen lesen.
- Zuerst eine eng begrenzte, rein lesende Anfrage ausführen, strukturierte Ergebnisse und Fehlermeldungen prüfen und erst dann das Benutzerziel ausführen.
Client-Konfigurationsausschnitt
{
"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
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.
OAuth-Discovery, Registrierung und Autorisierung
Autorisierungscode und PKCE verwenden; Produkt-Anmeldeinformationen dem Agenten nicht offenlegen.
| Endpunkt | Methode | Zweck |
|---|---|---|
| /.well-known/oauth-protected-resource | GET | Ressourcen-Discovery für das Ontologie-MCP |
| /.well-known/oauth-protected-resource/mcp | GET | Kompatibilitäts-Discovery über den Ontologie-Ressourcenpfad |
| /.well-known/oauth-protected-resource/mcp/business | GET | Ressourcen-Discovery für das Business-MCP |
| /.well-known/oauth-authorization-server | GET | Metadaten des Autorisierungsservers |
| /oauth/register | POST JSON | Dynamische Registrierung eines Public Clients |
| /oauth/authorize | GET- oder POST-Formular | Anmeldung, Ressourcenauswahl und Autorisierungsbestätigung |
| /oauth/token | POST form | Einlösung des Autorisierungscodes und Rotation des Refresh-Tokens |
| /oauth/revoke | POST form | Token-Widerruf |
| /oauth/grants | GET | Angemeldete Benutzer zeigen ihre autorisierten Verbindungen an |
| /oauth/grants/revoke | POST form | Verbindung gemäß Ablauf der Originalseite widerrufen |
Autorisierungsreihenfolge
- 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.
- 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.
- Zufällige Werte für state und code_verifier erzeugen und die S256-code_challenge berechnen.
- 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.
- 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.
- Callback empfangen und state und Issuer prüfen; den Autorisierungscode mit dem ursprünglichen code_verifier einlösen.
- 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
{
"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.
Scope-Ressourcengrenzen und Echtzeitberechtigungen
Der Scope delegiert nur bestehende Berechtigungen, gewährt keine erweiterten Rollenrechte und teilt keinen Geschäftszustand über Grants hinweg.
| Scope | Typische Fähigkeiten | Wichtige Einschränkungen |
|---|---|---|
| ontology.metadata:read | Ontologie-Ressourcen und Tabellenstrukturen | Ontologie und Tabellen müssen innerhalb des autorisierten und aktuell lesbaren Bereichs liegen |
| ontology.graph:read | Graphsuche und Nachbarn | Liefert Lokalisierungsinformationen, keine Faktenevidenz |
| ontology.knowledge:read | Wissenslokalisierung und vollständiger Originaltext | Die ursprünglichen Berechtigungen von Wissensdatenbanken und Dokumenten bleiben wirksam |
| ontology.table:query | SQL auf Ontologietabellen und Abfragen veröffentlichter Modelle | Tabellenabfragen erfordern zusätzlich den Metadata-Scope; tatsächliche Quellen und Spaltenrechte bleiben wirksam |
| search:operate | Native Schlüsselwortmodelle und Sitzungen | Eigenständige, ausdrückliche Delegierung; Ausführung gemäß den ursprünglichen Modellberechtigungen und den Tabellen- und Spaltenberechtigungen des Benutzers |
| etl:operate | Flash-ETL-Capabilities | Heavy ETL wird nicht freigegeben |
| authoring.contract:read | Bedingt freigegebene Modellierungsverträge | Zusätzlich Funktionsschalter und die betreffenden Ressourcen erforderlich |
| authoring.artifact:read | Lesen von Kandidaten, Plänen usw. im Rahmen der aktuellen Autorisierung | An den Grant und die Ressourcen des ursprünglichen Subjekts gebunden |
| authoring.artifact:draft | Kandidateneinreichung, Vorschau usw. | Keine Autorisierung für Ausführung oder Veröffentlichung |
| authoring.artifact:apply | Kontrollierte Planung und Anwendung | Weiterhin ursprüngliche Geschäftsrollen, Richtlinien und Genehmigungen erforderlich |
| execution.script:draft | Bestimmte Skriptentwürfe | Keine Autorisierung für die tatsächliche Skriptausführung |
| datasource.http:read / draft / test / import | Bedingt freigegebene HTTP-Datenquellen-Artefaktfähigkeiten | Je Fähigkeit ein eigener Funktionsschalter; die ursprünglichen Berechtigungen gelten |
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.
HTTP- und moderne MCP-Nachrichten
Anfragespezifische Metadaten und passende Routing-Header korrekt senden und HTTP-Ergebnisse und Tool-Ergebnisse getrennt verarbeiten.
| Aspekt | r56-Verhalten |
|---|---|
| Transport | Zustandsloses Streamable HTTP, POST JSON-RPC |
| Unterstützte Versionskennungen | 2026-07-28 sowie 2025-11-25 2025-06-18 2025-03-26 |
| Moderne Methoden | server/discover, tools/list, tools/call, resources/list, resources/read; Freigabe gemäß den tatsächlichen Fähigkeiten |
| Session-Header | Es wird keine Mcp-Session-Id zugewiesen |
| GET und DELETE | /mcp und /mcp/business geben 405 zurück |
| Server-SSE-Benachrichtigungen | Von diesen beiden öffentlichen MCP-Einstiegspunkten nicht bereitgestellt |
| Katalog-Caching | Moderne Discovery- und Listenantworten liefern ttlMs=60000 und cacheScope=private |
| Normales Ergebnis | Das 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
{
"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.
Kompatibilität mit Clients älterer Protokollversionen
Bei Clients, die weiterhin den Initialisierungs-Handshake verwenden, eine konsistente Protokollgeneration beibehalten.
{
"jsonrpc": "2.0", "id": 1, "method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {"name": "flash-legacy-client", "version": "1.0.0"}
}
}- Senden Sie initialize und lesen Sie die vom Server ausgehandelte Protokollversion und die Capabilities.
- Senden Sie die für Ihr Client-Protokoll erforderliche Initialisierungsabschluss-Benachrichtigung; Benachrichtigungen liefern kein normales Tool-Ergebnis.
- Lesen Sie mit tools/list die aktuell autorisierten Tools und senden Sie dann tools/call.
- 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
| Situation | Typisches Ergebnis | Maßnahme |
|---|---|---|
| Moderne Header und Nachricht stimmen nicht überein | HTTP 400 JSON-RPC -32020 | Header, Metadaten und Tool-Namen korrigieren |
| Nicht unterstützte Version | -32022 mit Liste der unterstützten Versionen | Tatsächlich unterstütztes Protokoll auswählen |
| Unbekannte Methode | JSON-RPC -32601, moderne Anfrage ggf. HTTP 404 | Protokollgeneration und Methode prüfen |
| Fehlende oder ungültige Parameter | JSON-RPC-Parameterfehler oder Tool-isError | Gemäß tatsächlichem inputSchema korrigieren |
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.
| Aufgabe | Bevorzugtes Tool | Für den Abschluss erforderliche Evidenz |
|---|---|---|
| Autorisierte Themen und Ressourcen finden | dfc_ontologies dfc_ontology_resources | Tatsächliche Ressourcen-ID-Typen und aktuell sichtbarer Umfang |
| Tabellenstatistiken und TopN | dfc_table query | Quittung über die erfolgreiche Ausführung und vollständige evidenceRows |
| Richtlinien, Verträge oder Berichte nachschlagen | dfc_ontology_query oder knowledge search/detail | Vollständiger, autorisierter, als Faktenbasis verwendbarer Originaltext |
| Graphobjekte lokalisieren | dfc_ontology_graph search/neighbors | Bis zur tatsächlichen Quelle lokalisieren und dann die zugehörigen Fakten abrufen |
| Native Schlüsselwortinteraktion | dfc_manual und dann dfc_search | Tatsächliche Ergebnisse im Originalmodell und im fachlichen Frame |
| Fusionsanalyse und Berichte | dfc_analysis_* oder dfc_report_* | Tatsächlicher Status jedes strukturierten Zweigs und der Dokumentevidenz |
| Anzeige oder Ontologiemodell ändern | dfc_authoring_* und Artifact-Tools | Kandidat, Plan, Genehmigung und tatsächliche Anwendung jeweils gesondert abgleichen |
| Fachliche Befehle ausführen | dfb_* von /mcp/business | Verö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.
Ontologie-Ressourcen und ID-Typen
Ermitteln Sie zuerst die tatsächlichen Ressourcenkoordinaten, um Speichernamen, Dokument-IDs und Wissensdatenbank-IDs nicht zu verwechseln.
- Rufen Sie dfc_ontologies auf und blättern Sie mit page und pageSize durch die in dieser Autorisierung freigegebenen und aktuell weiterhin lesbaren Ontologien.
- Rufen Sie dfc_ontology_resources mit einer echten ontologyId auf; wählen Sie nach Bedarf tables, answers, pinboards, documents und knowledgeBindings.
- Behandeln Sie die Paginierung je Ressourcentyp getrennt. pageSize maximal 100; schließen Sie nicht aus der ersten Seite auf den gesamten Ressourcenumfang.
- Speichern Sie den von der Ressource deklarierten Typ und die ursprüngliche ID und verwenden Sie diese bei Folgeaufrufen unverändert.
{"name":"dfc_ontology_resources","arguments":{
"ontologyId":"<ONTOLOGY_ID>",
"resourceTypes":["tables","documents","knowledgeBindings"],
"page":1,"pageSize":100
}}| Koordinate | Quelle | Nicht ersetzbar durch |
|---|---|---|
| ontologyId | Autorisierte Ontologieliste oder aktuell gültiger Kontext | ID einer anderen Ontologie |
| Tabellenressourcen-ID | tables-Liste oder vertrauenswürdiger Kontext | physicalName oder angezeigter Tabellenname |
| tblDisplayName colDisplayName | Aktuelle Tabellen- und Spaltenmetadaten | Erratener physischer SQL-Bezeichner |
| knowledgeId | knowledgeBindings oder tatsächliche Wissensabruf-Quittung | Dokumentressourcen-ID |
| assetId documentId chunkId evidenceId | Dieselbe tatsächliche Lokalisierungsquittung | Aus unterschiedlichen Lokalisierungsergebnissen zusammengesetzte Felder |
| rid revisionId releaseId | Veröffentlichtes Modell oder serverseitiger Kandidatenkontext | Selbst 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.
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
{"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
{
"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 Ziel | Form | Hinweis |
|---|---|---|
| DATE | CAST('2026-09-01' AS DATE) und CURRENT_DATE | Textliterale dürfen nicht direkt als Datumstyp angenommen werden |
| DATETIME | CAST('2026-09-01 00:00:00' AS DATETIME) und CURRENT_TIMESTAMP | Quellzeitzone und Sitzungszeitzone abgleichen |
| Relative Zeit | DATE_SUB(CURRENT_DATE, INTERVAL 1 YEAR) | Für Datum und Zeitstempel die entsprechenden aktuellen Funktionen verwenden |
| Zeitliche Gruppierung | YEAR(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.
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.
- Ermitteln Sie die tatsächliche Struktur und die aktuelle Definition und klären Sie Währung, Zeitraum, 订单状态 und Regeln für Gleichstände.
- 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.
- Prüfen Sie den Ausgabespaltenvertrag und die tatsächlichen evidenceRows und bestätigen Sie, dass die Rückgabe alle benötigten Gruppen abdeckt.
- 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.
- Ändert sich der Quellzeitraum, fragen Sie erneut ab und kennzeichnen Sie die neue Version explizit; mischen Sie keine verschiedenen Datenversionen oder veralteten Cursor.
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.
Wissensabruf: Vollständiger Originaltext und Evidenzqualifikation
Trennen Sie Lokalisierung, Lesen und Faktenzitierung und bewahren Sie Quelle und Vollständigkeit.
Zwei gängige Pfade
| Pfad | Zweck | Kernpunkte |
|---|---|---|
| dfc_ontology_query | Innerhalb des an die Ontologie gebundenen Wissens suchen, optional kombiniert mit Graphrouting | Vollständige kanonische answerContextItems und Evidenzqualifikation prüfen |
| dfc_knowledge_search → dfc_knowledge_detail-Chunk | Explizit suchen und lokalisieren, dann die ausgewählten Chunks lesen | Suchvorschauen gelten nicht als Fakten; lesen Sie den vollständigen Originaltext derselben Lokalisierung |
{"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.
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.
Native Search-Modelle und Sitzungen
Verwenden Sie das Schlüsselwortprotokoll des Rust-Search über dfc_search und warten Sie auf den Endzustand des ursprünglichen Geschäftsframes.
Erst die Anleitung lesen, dann Fähigkeiten ermitteln
{"name":"dfc_manual","arguments":{
"action":"read","uri":"datafocus://manuals/search-keyword-queries/v1"
}}
{"name":"dfc_search","arguments":{"action":"capabilities"}}dfc_search erfordert ein explizites search:operate. Es kapselt den ursprünglichen Schlüsselwort-WebSocket und schreibt Schlüsselwörter nicht in SQL- oder LLM-Anfragen um. Die Sitzung ist an den aktuellen Mandanten, Benutzer, Grant, Client und das Modell gebunden; bei Operationen werden die ursprünglichen Tabellen- und Spaltenberechtigungen erneut geprüft.
Minimaler Sitzungsablauf
{"name":"dfc_search","arguments":{
"action":"model_create","data":{"tableIds":["<ACTUAL_TABLE_ID>"]}
}}
{"name":"dfc_search","arguments":{
"action":"open","data":{"sourceToken":"<MODEL_SOURCE_TOKEN>","language":"en-US"}
}}
{"name":"dfc_search","arguments":{
"action":"poll","data":{"sessionId":"<SEARCH_SESSION_ID>","waitMillis":10000}
}}
{"name":"dfc_search","arguments":{
"action":"request","data":{"sessionId":"<SEARCH_SESSION_ID>",
"message":{"type":"assist","datas":{}}}
}}
{"name":"dfc_search","arguments":{
"action":"request","data":{"sessionId":"<SEARCH_SESSION_ID>",
"message":{"type":"search","datas":{"search":"<QUERY_USING_ACTUAL_COLUMNS>","ambiguities":[]}}}
}}- model_create mit 1 bis 100 echten Tabellen-IDs, für die Berechtigungen bestehen, oder model_read zum Lesen eines bereits vorhandenen eigenen sourceToken.
- open liefert nur initializationSent; pollen Sie zunächst, lesen Sie die ursprüngliche init-Geschäftsantwort und bestätigen Sie den Erfolg.
- Lesen Sie assist und Vorschläge und senden Sie dann die unterstützte ursprüngliche message. In query datas wird isNl durch den Wrapper fest auf false gesetzt.
- Lesen Sie fortlaufend frames und unterscheiden Sie Vorschläge, Parsing, Empfang und endgültiges Geschäftsergebnis.
- Schließen Sie am Ende mit close; zum Abbrechen verwenden Sie cancel und prüfen anhand des tatsächlichen Aufgabenstatus, ob die Ausführung beendet wurde.
| action | data | Bedeutung |
|---|---|---|
| capabilities | Weglassen oder leeres Objekt | Aktionen, Befehle, TTL und Übertragungshinweise lesen |
| model_create | tableIds-Array | Autorisiertes Modell des aktuellen Benutzers erstellen |
| model_read | sourceToken | Modell lesen; Spalten ohne Berechtigung und sensible Quellkonfigurationen werden herausgefiltert |
| open | sourceToken und optionales language | Native Sitzung aufbauen und init senden |
| request | sessionId und message | Ursprüngliche type/datas-Protokollnachricht senden |
| poll | sessionId und waitMillis von 0 bis 30000 | Aktuell gepufferte Frames abholen, optional mit begrenztem Warten |
| cancel close | sessionId | Diese native Sitzung schließen; ein BI-Endzustand kann nicht behauptet werden |
Unterstützte ursprüngliche Befehle
search associateSearch guide assist exportContext reInit
putFormula modifyFormula deleteFormula fnamecheck
disambiguite reDisambiguite clearDisambiguiteGroß-/Kleinschreibung der Befehle und die datas-Struktur folgen den aktuellen capabilities und dem ursprünglichen Sitzungsprotokoll. Ergänzen Sie keine nicht existierenden Aktionen im request; z. B. muss die Schreibweise von disambiguite gemäß dem tatsächlichen Protokoll beibehalten werden. Nachrichten sind auf maximal 256 Ki Zeichen begrenzt.
Sitzung und Integrität
Die Sitzungs-TTL beträgt 10 Minuten und bleibt nur für die Lebensdauer des aktuellen Prozesses erhalten; es handelt sich nicht um eine dauerhaft wiederherstellbare Aufgabe. Der Puffer fasst höchstens 256 Frames und unterliegt einer Speicherobergrenze; bei bufferOverflow=true dürfen bereits abgeholte Frames nicht als vollständiges Ergebnis gelten. Nach Übertragungsfehlern zunächst die ursprüngliche Sitzung pollen und möglicherweise bereits ausgeführte Abfragen nicht blind erneut senden.
Der aktuelle Wrapper bietet keine Antwort- oder Pinboard-Speicherung, kein Lesen/Schreiben des Verlaufs und keine beliebige Kontextwiederherstellung. Die Existenz von exportContext bedeutet nicht, dass beliebige Kontexte selbst wiederhergestellt werden dürfen. Zum Speichern von Ergebnissen die tatsächlich freigegebenen ursprünglichen Ressourcenfähigkeiten der Instanz verwenden; keine Aktionen erfinden.
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 Region | Abfrage-Locale | Beschreibung |
|---|---|---|
| Vereinfachtes Chinesisch, Traditionelles Chinesisch | zh-CN zh-Hant | Ursprüngliche chinesische Regeln und traditioneller Katalog unterscheiden sich |
| Englisch (USA, UK, Australien, Kanada) | en-US en-GB en-AU en-CA | UI-/Schlüsselwortpakete können gemeinsam genutzt werden, Regionsmetadaten bleiben erhalten |
| Deutsch, Italienisch, Russisch | de-DE it-IT ru-RU | Gemäß den Vorschlägen der aktuellen Sitzung verwenden |
| Spanisch (Spanien und Lateinamerika) | es-ES es-US | Die Regions-ID des Produkts ist es-US |
| Französisch (Frankreich und Kanada) | fr-FR fr-CA | Regions-IDs werden nicht zusammengeführt |
| Portugiesisch (Portugal und Brasilien) | pt-PT pt-BR | Katalog- und Regionskonventionen werden getrennt beibehalten |
| Niederländisch, Dänisch, Norwegisch, Finnisch, Schwedisch | nl-NL da-DK nb-NO fi-FI sv-SE | Norwegisch ist Bokmål |
| Japanisch, Koreanisch | ja-JP ko-KR | Keine eigene Worttrennung nach englischen Leerzeichenregeln |
| Arabisch (Saudi-Arabien und VAE) | ar-SA ar-AE | Oberflächenbeschreibungen unterstützen RTL; Protokollbezeichner werden nicht gespiegelt |
Schlüsselwortkatalog verwenden
{"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.
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.
| Tool | Zweck | Notwendige Koordinaten |
|---|---|---|
| dfc_analysis_ask | Natürlichsprachliche Analysefrage stellen | ontologyId question, optional language sessionId |
| dfc_analysis_result_get | Zurückgegebenes Ergebnis lesen | ontologyId sessionId resultId |
| dfc_analysis_refine | Auf Basis des neuesten vollständigen Ergebnisses nachfragen oder ändern | Ursprüngliches Ergebnis expectedRevision und stabiler Idempotenzschlüssel |
| dfc_analysis_page | Eine Seite eines serverseitigen Zweigs abrufen | Ursprünglicher Zweig und Ergebnisversion pageNo pageSize |
| dfc_analysis_cancel | Laufende Ergebnisberechnung abbrechen | Ursprüngliche Sitzung und Ergebnis |
| dfc_analysis_close | Nicht mehr arbeitende Sitzung freigeben | Ursprüngliche Sitzung |
Analyse starten
{"name":"dfc_analysis_ask","arguments":{
"ontologyId":"<ONTOLOGY_ID>",
"question":"按区域分析已完成订单销售金额,并引用退货统计口径",
"language":"zh-CN"
}}- Zurückgegebene sessionId, resultId, Status und revision lesen; bei Bedarf das ursprüngliche Ergebnis weiter lesen.
- 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.
- Prüfen Sie Dokumentevidenz, Faktenregister, Zitierfähigkeit und Grenzen. Modellgenerierte Narrative können die Evidenzqualifikation nicht eigenmächtig anheben.
- Stützen Sie Nachfragen auf das neueste vollständige Ergebnis und übergeben Sie expectedRevision; Wiederholungen derselben Änderung verwenden denselben Idempotenzschlüssel.
- 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.
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.
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.
{"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
- Verwenden Sie beim Erstellen einen stabilen idempotencyKey mit 8 bis 128 unterstützten Zeichen.
- Speichern Sie reportId, pollen Sie status und prüfen Sie die tatsächlichen Zustände wie abgeschlossen, fehlgeschlagen, teilweise abgeschlossen oder abgebrochen.
- Prüfen Sie beim Lesen der Ergebnisse strukturierte Zweige, Visualisierungen, Faktenquellen, Dokumentverweise und Vollständigkeit.
- Zum Abbrechen eines noch nicht abgeschlossenen Berichts verwenden Sie die ursprüngliche reportId; erstellen Sie keinen anderen Bericht als Ersatz für den Abbruch.
- 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.
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.
- dfc_authoring_capabilities liest die für den aktuellen Grant verfügbaren Verträge und Aktionen.
- dfc_artifact_context ruft begrenzten Kontext, contractVersion, contextHash, baseArtifactHash und baseArtifactVersion ab.
- Erzeugen Sie im Client Kandidaten anhand der echten Verträge, ohne deren Code auszuführen.
- dfc_artifact_submit übermittelt den ursprünglichen Kontext und den Kandidaten, hält instruction identisch und verwendet eine stabile clientRequestId.
- Lesen Sie proposalId, candidateHash, Validierungsergebnis und Vorschau; bei tatsächlichen Fehlern überarbeiten Sie den Kandidaten und täuschen keinen serverseitig bestandenen Status vor.
- Wenn eine erneute Vorschau erforderlich ist, verwenden Sie dfc_artifact_preview und denselben Kandidaten-Hash.
- dfc_artifact_plan erstellt einen unveränderlichen Plan mit dem echten Kandidaten, der Zielversion und einem Idempotenzschlüssel.
- 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
{"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.
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.
{"name":"dfc_ontology_table_schema","arguments":{
"ontologyId":"<ONTOLOGY_ID>","sourceAssetRef":"table:<ACTUAL_TABLE_ID>",
"fields":[{"sourceField":"区域"},{"sourceField":"销售金额"}]
}}Kandidaten- und Veröffentlichungskonfiguration
| Vertrag | Zweck | Wesentliche Grenzen |
|---|---|---|
| ontology-workspace-create-mcp-submit-v1 | Kandidat mit lokaler Deklaration erstellen | Echte autorisierte Quellen; serverseitige Kompilierung; Fertigstellungsnachweise werden nicht akzeptiert |
| ontology-workspace-create-mcp-submit-v2 | Lokale und exakte veröffentlichte Referenzen mischen | Exakte releaseSelections und Abschlussabhängigkeiten angeben |
| ontology-publication-mcp-submit-v1 bis v3 | Vorhandenen Kandidaten an die Anforderung eines Veröffentlichungsplans binden | Explizite Koordinaten; Ziel, Quelle, Genehmigung und Validierung werden serverseitig rekonstruiert |
| ontology-publication-mcp-submit-v4 bis v6 | Separat aktivierte Konfiguration für die automatische Veröffentlichung | Nur verwenden, wenn capabilities und das tatsächliche Schema sie deklarieren |
| ontology-initial-activation-retirement-submit-v1 | Kontrollierte anfängliche Aktivierung und Außerbetriebnahme | Separater Plan; neue menschliche Genehmigung und exakter Scope |
Veröffentlichungsablauf
- Aktuelle Kandidaten-workspaceId, workspaceRevision, candidateHash und tatsächliche Quelle abrufen.
- Vertragsversion gemäß serverseitigen Fähigkeiten wählen; Koordinaten wie releases und selection übermitteln, ohne Felder mit Selbstauskünften wie „genehmigt“ oder „bestanden“ beizufügen.
- Die von submit zurückgegebene proposalId und den ursprünglichen idempotencyKey aufbewahren. submit und MODEL_PLAN sind verschiedene Phasen derselben Anfrage.
- dfc_artifact_plan mit dem ursprünglichen Kandidaten, der Zielversion und demselben Idempotenzschlüssel aufrufen.
- 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.
- Nach erfolgreichem Plan mit HUMAN_REQUIRED oder POLICY_AUTO fortfahren und die ursprünglichen Genehmigungs- und Veröffentlichungsfunktionen verwenden.
- 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.
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
- Wenn die Tool-action-Enumeration tatsächlich published_model enthält, übermitteln Sie die echte committed releaseId.
- v1 gibt autorisierte Abfragevorlagen zurück; v2 ergänzt exakte PERSISTED-Referenzen und releaseSelections; v3 ergänzt Abhängigkeitsreferenzen, exakte domainRef und kompakte Bindungsvorlagen.
- Objekte, Attribute, Binding, Scope und Version aus den tatsächlichen Rückgabewerten wählen; keine RIDs generieren und latest nicht verwenden.
- 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.
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.
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.
{"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
- Bewahren Sie die ursprüngliche runId, den Grant, den mode und den Idempotenzschlüssel auf.
- Derselbe Schlüssel mit derselben instruction nimmt denselben Run wieder auf und übermittelt keine weitere Aufgabe; derselbe Schlüssel mit anderer instruction wird abgelehnt.
- status fragt den Status der ursprünglichen Aufgabe ab. Nach Abschluss müssen weiterhin deren Tabellenabfragen, Evidenz oder Veröffentlichungsquittungen überprüft werden.
- 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.
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.
| Scope | Tool | Abgrenzung |
|---|---|---|
| business-system:discover | dfb_systems dfb_system_describe | Nur die in dieser Autorisierung freigegebenen und aktuell aufrufbaren Systeme ermitteln |
| business-system:read | dfb_query dfb_record dfb_work_items dfb_action_status | Vom aktuellen Benutzer lesbare Datensätze und eigene Pläne |
| business-system:plan | dfb_action_plan | Nur unveränderliche Pläne erstellen, nicht ausführen |
| business-system:execute | dfb_action_execute | Separate ausdrückliche Autorisierung; Ausführung nach Risiko und Genehmigung |
- dfb_systems ermittelt autorisierte Systeme.
- dfb_system_describe liest den aktuell veröffentlichten Vertrag, releaseId sowie alle Hashes, Abfragen und Befehle.
- dfb_query verwendet den veröffentlichten queryKey und gibt bei Bedarf objectKey, state, page und pageSize an. Es ist kein beliebiges SQL.
- dfb_record und dfb_work_items lesen die aktuell erlaubten Datensätze und anstehenden Aufgaben.
- Übergeben Sie vor der Ausführung an dfb_action_plan die tatsächliche releaseId, releaseHash, canonicalIrHash, agentManifestHash, commandType, planIdempotencyKey und die Vertrags-Payload.
- Prüfen Sie riskClass, requiresApproval und status; betrifft der Plan einen Zieldatensatz, behalten Sie expectedRecordVersion bei.
- 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.
- Nach Fehlschlag oder Timeout ermitteln Sie mit dfb_action_status den Stand des ursprünglichen Plans; Wiederholungen behalten die ursprüngliche Idempotenzsemantik bei.
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.
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.
| Tool | Zweck | Nicht erzeugte Autorisierungen oder Effekte |
|---|---|---|
| dfc_ontology_knowledge_input_propose | Ursprüngliche Geschäftseingaben für einen bestehenden Workspace registrieren | Keine Bestätigungsfragen erzeugen; keine Genehmigung; keine Veröffentlichung |
| dfc_ontology_knowledge_input_preview | Fragenentwürfe aus der ursprünglichen Eingabe vorläufig in der Vorschau anzeigen | Keine Persistenz; keine Bestätigung; keine Produktionsquittung |
| dfc_ontology_knowledge_question_submit | Verfasste und unbestätigte Fragen speichern | Antworten nicht automatisch zusammenführen; keine Verantwortungsberechtigung oder Veröffentlichungsrechte erlangen |
| dfc_ontology_business_scope_initialize | Den Consumer-Scope eines Geschäftssystems ausdrücklich initialisieren | Nicht veröffentlichen, nicht aktivieren, keine Quellzugriffsberechtigung erteilen |
Eingabe und Vorschau
- Übernehmen Sie workspaceId, workspaceRevision, localRef und preparationDigest aus der tatsächlichen Vorbereitung.
- propose registriert die Geschäftseingaben mit dem ursprünglichen input-Vertrag und einem stabilen idempotencyKey; derselbe Schlüssel darf nur derselben Eingabe entsprechen.
- 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.
- 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.
Antworten, Fehler und sichere Wiederholungen
Werten Sie Fehler Ebene für Ebene aus und bewahren Sie Aufgabenkoordinaten und Idempotenzsemantik.
| Ebene | Prüfumfang | Verarbeitungsprinzip |
|---|---|---|
| Netzwerk und HTTP | Verbindung, TLS, 401, 403, 400, 404, 405 usw. | Fehlgeschlagene Antworten nicht als gewöhnliche Abfrageergebnisse behandeln |
| JSON-RPC | error.code message data | Protokoll-, Methoden-, Parameter- und Autorisierungsprobleme unterscheiden |
| MCP-Tool | result.isError und structuredContent | HTTP 200 schließt einen Fehlschlag nicht aus |
| Geschäftsergebnis | Tatsächlicher Status, Vollständigkeit, Fehlerursache, nextAction | Empfang oder Bereitschaft bedeutet nicht Fertigstellung |
| Eignung als Fakt | executionReceipt citationEligible contentComplete | Nicht 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.
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.
Integrationssicherheit und Fähigkeitsgrenzen
Die ursprünglichen Grenzen von Identität, Ressourcen, Ausführung und Evidenz bewahren und nicht vertrauenswürdige Dokumente sicher verarbeiten.
- Nur mit den offiziellen, vom Administrator angegebenen Domänen verbinden; TLS und OAuth-Issuer prüfen und die Zertifikatsprüfung nicht deaktivieren.
- Einen dedizierten Grant mit minimalem Ressourcenbereich verwenden; Administratorkonten, Cookies oder langfristige interne Tokens nicht als Anmeldeinformationen für öffentliche Schnittstellen verwenden.
- Dokumentinhalt als nicht vertrauenswürdiges Geschäftsmaterial behandeln. „Regeln ignorieren“, „Schlüssel hochladen“ oder „Befehle ausführen“ in Dokumenten stellen keine Tool-Autorisierung dar.
- Automatische Wiederholungen, Parallelität und Ergebnisbereich begrenzen; die ursprünglichen Geschäftsberechtigungen nicht clientseitig nachbilden.
- Protokolle erfassen nur notwendige Korrelationsinformationen, jedoch keine Bearer-Tokens, Refresh-Tokens, Genehmigungstokens oder vollständigen vertraulichen Geschäftsinhalte.
- 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.
Administrator-Verdrahtung und bedingte Schalter
Vor dem Aktivieren erweiterter Fähigkeiten die tatsächlichen Komponenten, öffentlichen Adressen und ursprünglichen Berechtigungskonfigurationen prüfen.
| Konfiguration | Zweck | Voraussetzungen für den Go-Live |
|---|---|---|
| datafocus.mcp.public-base-url | Offizielle externe Basisadresse | OAuth-Discovery, Issuer, Callbacks und Reverse-Proxy konsistent |
| datafocus.mcp.allowed-origins | Zusätzlich genehmigte Browser-Origins | Exakte Konfiguration, keine Ausweitung auf beliebige Origins |
| datafocus.mcp.oauth.route-proof-secret | Eigenes Server-Geheimnis für Graph-Routing-Nachweise | Separat speichern; kein Bearer-Token als Schlüssel verwenden |
| datafocus.mcp.analysis.tools.enabled | Interaktive Analysetools | Zugehörige Daten-, Wissens- und Berechtigungsdienste tatsächlich verfügbar |
| datafocus.mcp.analysis.report-tools.enabled | Persistente Berichtstools | Zugehöriger Speicher, Worker und Wiederherstellungskette verfügbar |
| datafocus.mcp.analysis.apps.enabled | Anzeige über MCP Apps | Client deklariert Unterstützung und prüft das zurückgegebene _meta |
| datafocus.mcp.authoring.enabled | Entwurfs- und Modellierungsverträge | Ursprüngliche Administrator- und Ressourcenberechtigungen beibehalten |
| datafocus.mcp.authoring.apply-enabled | Anwenden von Artefakten | Unveränderlicher Plan, ursprüngliche Genehmigung und erneute Prüfung des aktuellen Status |
| datafocus.mcp.ontology-published-query-enabled | Veröffentlichte Modelle und Abfragen | Tatsächlich festgeschriebene (committed) Version und Quellenautorisierung |
| datafocus.mcp.ontology-candidate-query-enabled | Strukturierte Kandidatenabfragen | Kandidaten-Eigentümerschaft, exakte Version und Leserecht |
| datafocus.mcp.authoring.ontology-auto-publication-enabled | Autorisierungen für die Delegation der automatischen Veröffentlichung | Gü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.
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.
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_TOKENLesen und Abfragen
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.jsonErsetzen 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.
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.
<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
| Methode | Nutzer | Identität und Ergebnis |
|---|---|---|
| Remote MCP | Externe Agent- oder Dienstintegration | OAuth-Grant und strukturierte Tool-Quittungen |
| Ontologie-Chat-iframe | Endbenutzer (Mensch) | Ursprüngliche Anmeldesitzung und Chat-Oberfläche |
| MCP Apps | MCP-Clients mit Unterstützung der Erweiterung | Kontrollierte Ressourcen und aktuelle Tool-Ergebnisse, kein öffentlicher Ersatz für den iframe-Login |
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.
- Discovery: Tatsächlich unterstützte Versionen, aktuellen Tool-Katalog und integrierte Ressourcen erfassen.
- Autorisierung: Normale Benutzer sehen nur die genehmigten Ontologien und Geschäftssysteme; Operationen ohne Scope werden abgelehnt.
- Tabellenstruktur: Tatsächliche Anzeigenamen, Spalten, Typen und Berechtigungen sind vollständig.
- SQL: Eindimensionale, mehrdimensionale, JOIN-, Datums-, TopN- und Kürzungsprüfungen entsprechen der tatsächlichen fachlichen Definition.
- Wissen: Lokalisierung, vollständiger Originaltext und Zitierfähigkeit als Fakt sind konsistent; gemischte Fragen stützen sich zugleich auf Daten- und Dokumentevidenz.
- Search: Modell-, init-, Vorschlags-, Ergebnis-, close- und Puffer-Integritätsprüfungen bestanden.
- Optionale Analyse und Berichte: Tatsächlicher Zustand mehrerer Zweige, Paginierung, Berechtigungsänderungen und Abbruch behalten das ursprüngliche Verhalten bei.
- Optionale Modellierung: Kandidat, Plan, ursprüngliche Genehmigung, tatsächliche Anwendung und Versionsabfrage in jeder Phase geprüft.
- Geschäftsaktionen: Veröffentlichungs-Hash, Zielversion, Genehmigung, Idempotenz und Isolation zwischen Grants geprüft.
- 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.
Spezifikationsressourcen und Wartung
Die mit dem Handbuch gelieferten vollständigen Tool-Schemas verwenden und mit den tatsächlichen Discovery-Ergebnissen der Instanz synchron halten.
| Ressourcen | Inhalt |
|---|---|
| reference/mcp-tool-catalog.json | 32 deklarierte Eingabeschemata auf der Ontologie- und 8 auf der Geschäftsseite; einige Tools enthalten ursprüngliche Ausgabeschemata |
| reference/locales.json | 21 auswählbare Optionen sowie 24 kompatible Locales und UI-Begriffe |
| reference/search-keywords.json | Statische Schlüsselwortkataloge für 17 explizit aufgeführte Locales |
| reference/analysis-contract-manifest.json | Versionseinschrä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
datafocus://manuals/etl-formulas/v1
datafocus://manuals/search-keyword-queries/v1
datafocus://manuals/etl-functions/v1
datafocus://manuals/search-keywords/v1resources/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.
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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| names | array | Optional oder bedingt erforderlich | Die explizit zu suchenden Namen, maximal 32 pro Aufruf. maxItems: 32 |
| action | string | Optional oder bedingt erforderlich | Operationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: list, read, keywords, functions, etl_requests |
| locale | string | Optional oder bedingt erforderlich | Explizites Locale des statischen Referenzkatalogs, nicht die Standard-Abfragesprache. |
| uri | string | Optional oder bedingt erforderlich | Vom 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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| data | object | Optional oder bedingt erforderlich | Ursprüngliche Aktions-Payload; siehe Fähigkeitsermittlung und Tabelle der Aktionsfelder. |
| action | string | Erforderlich | Operationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: capabilities, model_create, model_read, open, request, poll, cancel, close |
dfc_etl
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| data | object | Optional oder bedingt erforderlich | Ursprüngliche Aktions-Payload; siehe Fähigkeitsermittlung und Tabelle der Aktionsfelder. |
| action | string | Erforderlich | Operationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: capabilities |
dfc_ontologies
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| pageSize | integer | Optional oder bedingt erforderlich | Einträge pro Seite; gemäß Schema-Obergrenze. minimum: 1; maximum: 100 |
| page | integer | Optional oder bedingt erforderlich | Seitennummer, beginnend bei 1. minimum: 1 |
dfc_ontology_resources
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| resourceTypes | array | Optional oder bedingt erforderlich | Menge der zurückzugebenden Ressourcentypen. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| pageSize | integer | Optional oder bedingt erforderlich | Einträge pro Seite; gemäß Schema-Obergrenze. minimum: 1; maximum: 100 |
| page | integer | Optional oder bedingt erforderlich | Seitennummer, beginnend bei 1. minimum: 1 |
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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| relationTypes | array | Optional oder bedingt erforderlich | Beziehungstypfilter. |
| depth | integer | Optional oder bedingt erforderlich | Tiefe der Nachbartraversierung. minimum: 1; maximum: 3 |
| sourceTypes | array | Optional oder bedingt erforderlich | Quellentypfilter. |
| query | object | Optional oder bedingt erforderlich | Abfragetext oder ein exakt versioniertes Abfrageobjekt entsprechend der action. |
| limit | integer | Optional oder bedingt erforderlich | Obergrenze der zurückgegebenen Anzahl. minimum: 1; maximum: 100 |
| action | string | Erforderlich | Operationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: search, neighbors, published_model, published_query, candidate_query |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| nodeKey | string | Optional oder bedingt erforderlich | Aus den tatsächlichen Graph-Ergebnissen kopierter Knotenschlüssel. |
| keyword | string | Optional oder bedingt erforderlich | Schlüsselwörter zur Lokalisierung im Graphen, nicht die Schlüsselwortsyntax für Datenabfragen. |
| nodeTypes | array | Optional oder bedingt erforderlich | Knotentypfilter. |
dfc_ontology_query
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| routeLocators | array | Optional oder bedingt erforderlich | Vom Server ausgestellte typisierte Routing-Locators, vollständig zu übernehmen. maxItems: 20 |
| topK | integer | Optional oder bedingt erforderlich | Obergrenze der abgerufenen Kandidaten, kein Beleg für vollständige Abdeckung. minimum: 1; maximum: 20 |
| queryMode | string | Optional oder bedingt erforderlich | Evidenzabfragemodus gemäß Tool-Enum wählen. enum: vector, hybrid, graph |
| fanoutPlan | object | Optional oder bedingt erforderlich | Eingeschränkter Abrufplan für Zweige, gemäß verschachteltem Schema. |
| structuredPlan | object | Optional oder bedingt erforderlich | An den serverseitigen Vertrag gebundener Plan für die vollständige Dokumenttabelle, kein SQL. |
| knowledgeIds | array | Optional oder bedingt erforderlich | Wissensdatenbank-ID aus den tatsächlichen knowledgeBindings. |
| query | string | Erforderlich | Abfragetext oder ein exakt versioniertes Abfrageobjekt entsprechend der action. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
dfc_knowledge_search
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| topK | integer | Optional oder bedingt erforderlich | Obergrenze der abgerufenen Kandidaten, kein Beleg für vollständige Abdeckung. minimum: 1; maximum: 20 |
| minScore | number | Optional oder bedingt erforderlich | Minimaler Übereinstimmungswert. minimum: 0; maximum: 1 |
| knowledgeIds | array | Optional oder bedingt erforderlich | Wissensdatenbank-ID aus den tatsächlichen knowledgeBindings. |
| query | string | Erforderlich | Abfragetext oder ein exakt versioniertes Abfrageobjekt entsprechend der action. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| assetIds | array | Optional oder bedingt erforderlich | Derzeit erlaubte Dokument-Asset-ID. |
| retrievalStrategy | string | Optional oder bedingt erforderlich | Tatsächlich unterstützte Abrufstrategie. enum: auto, hybrid_stage2 |
dfc_knowledge_detail
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| qdrantId | string / integer | Optional oder bedingt erforderlich | Indexkennung aus der tatsächlichen Lokalisierung. |
| pageNo | integer | Optional oder bedingt erforderlich | Tatsächliche Seiten- oder Paginierungsseitennummer. |
| evidenceId | string | Optional oder bedingt erforderlich | Evidenz-ID aus derselben Wissenslokalisierung. |
| action | string | Erforderlich | Operationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: chunk, document, page_context |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| documentId | string / integer | Optional oder bedingt erforderlich | Dokument-ID derselben Lokalisierung. |
| radius | integer | Optional oder bedingt erforderlich | Bereich benachbarter Seiten. minimum: 0; maximum: 3 |
| chunkId | string | Optional oder bedingt erforderlich | Tatsächliche Chunk-ID derselben Lokalisierung. |
dfc_table
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| maxRows | integer | Optional oder bedingt erforderlich | Obergrenze der zurückgegebenen Zeilen; kein Bereich für clientseitige Rangbildung. minimum: 1; maximum: 200 |
| action | string | Erforderlich | Operationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: detail, query |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| id | string | Optional oder bedingt erforderlich | Tatsächliche Tabellenressourcen-ID, nicht der physische oder Anzeigename. |
| sql | string | Optional oder bedingt erforderlich | Eine einzelne, rein lesende Doris-SQL-Anweisung im Ontologieumfang, mit expliziten Ausgabespalten. |
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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| question | string | Erforderlich | Frage in natürlicher Sprache oder kompatible Nachfrage. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| language | string | Optional oder bedingt erforderlich | Explizites Antwort- oder Abfrage-Locale; bei Weglassen gemäß den Regeln des jeweiligen Tools. |
| sessionId | string | Optional oder bedingt erforderlich | Tatsächlicher Sitzungs-Locator unter demselben Grant. |
dfc_analysis_refine
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| branchId | string | Optional oder bedingt erforderlich | Vom Server ausgestellter Locator eines strukturierten Zweigs. |
| resultId | string | Erforderlich | Locator des ursprünglich zurückgegebenen Analyseergebnisses. |
| question | string | Optional oder bedingt erforderlich | Frage in natürlicher Sprache oder kompatible Nachfrage. |
| idempotencyKey | string | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. |
| change | object | Optional oder bedingt erforderlich | Änderung in natürlicher Sprache oder typisierter filter_patch. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| language | string | Optional oder bedingt erforderlich | Explizites Antwort- oder Abfrage-Locale; bei Weglassen gemäß den Regeln des jeweiligen Tools. |
| sessionId | string | Erforderlich | Tatsächlicher Sitzungs-Locator unter demselben Grant. |
| expectedRevision | integer | Erforderlich | Versionsvorbedingung für das ursprüngliche Ergebnis oder die fachliche Head-Version; beim Erstellen einer Frage kann der Wert null sein. minimum: 1 |
| visualId | string | Optional oder bedingt erforderlich | An den Zweig gebundener Visualisierungs-Locator. |
dfc_analysis_page
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| branchId | string | Erforderlich | Vom Server ausgestellter Locator eines strukturierten Zweigs. |
| resultId | string | Erforderlich | Locator des ursprünglich zurückgegebenen Analyseergebnisses. |
| pageNo | integer | Erforderlich | Tatsächliche Seiten- oder Paginierungsseitennummer. minimum: 1; maximum: 10000 |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| pageSize | integer | Erforderlich | Einträge pro Seite; gemäß Schema-Obergrenze. minimum: 1; maximum: 100 |
| sessionId | string | Erforderlich | Tatsächlicher Sitzungs-Locator unter demselben Grant. |
| expectedRevision | integer | Erforderlich | Versionsvorbedingung 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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| resultId | string | Erforderlich | Locator des ursprünglich zurückgegebenen Analyseergebnisses. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| sessionId | string | Erforderlich | Tatsächlicher Sitzungs-Locator unter demselben Grant. |
dfc_analysis_cancel
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| resultId | string | Erforderlich | Locator des ursprünglich zurückgegebenen Analyseergebnisses. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| sessionId | string | Erforderlich | Tatsächlicher Sitzungs-Locator unter demselben Grant. |
dfc_analysis_close
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| sessionId | string | Erforderlich | Tatsächlicher Sitzungs-Locator unter demselben Grant. |
dfc_report_create
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| goal | string | Erforderlich | Berichtsanalyseziel. |
| idempotencyKey | string | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| language | string | Optional oder bedingt erforderlich | Explizites Antwort- oder Abfrage-Locale; bei Weglassen gemäß den Regeln des jeweiligen Tools. |
| title | string | Optional oder bedingt erforderlich | Optionaler Berichtstitel. |
dfc_report_status
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| reportId | string | Erforderlich | Locator des persistenten Berichts im aktuellen Grant. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
dfc_report_cancel
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| reportId | string | Erforderlich | Locator des persistenten Berichts im aktuellen Grant. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| mode | string | Optional oder bedingt erforderlich | QUERY oder AUTHORING; beide Fähigkeiten werden separat autorisiert. enum: QUERY, AUTHORING |
| instruction | string | Optional oder bedingt erforderlich | Anforderungstext des Benutzers; Kontext und Übermittlung müssen übereinstimmen. maxLength: 16000 |
| idempotencyKey | string | Optional oder bedingt erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. maxLength: 128 |
| action | string | Erforderlich | Operationsname. Gemäß aktuellem Enum und den zur Aktion gehörenden Parametern verwenden. enum: start, status, cancel |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| runId | string | Optional oder bedingt erforderlich | Ursprüngliche Aufgaben-ID derselben Ontologie und desselben Grants. |
| contractVersion | string | Erforderlich | Es 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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| artifactType | string | Erforderlich | Tatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: CONTROL_PANEL_SPEC, VIEW_SPEC |
| scopeType | string | Optional oder bedingt erforderlich | Ressourcenumfangstyp im tatsächlichen Artefaktvertrag. |
| ontologyId | string | Optional oder bedingt erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| projectId | string | Optional oder bedingt erforderlich | Derzeit autorisierte Projekt-ID. |
| artifactId | string | Optional oder bedingt erforderlich | Tatsächliche ID eines zu bearbeitenden vorhandenen Artefakts. |
| instruction | string | Erforderlich | Anforderungstext des Benutzers; Kontext und Übermittlung müssen übereinstimmen. |
| variables | object | Optional oder bedingt erforderlich | Variablenobjekt gemäß zurückgegebenem Vertrag. |
| previewInput | object | Optional oder bedingt erforderlich | Begrenzte Vorschau-Eingaben gemäß Vertrag. |
| viewport | object | Optional oder bedingt erforderlich | Vom Vertrag geforderter Anzeige-Viewport. |
dfc_ontology_table_schema
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| sourceAssetRef | string | Erforderlich | Registrierte strukturierte Asset-Referenz, z. B. table:123. |
| fields | array | Erforderlich | Felder der aktuellen Quelle mit optionalen expliziten Typdeklarationen. minItems: 1; maxItems: 64 |
dfc_artifact_preview
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| proposalId | string | Erforderlich | Ursprüngliche, unter dem aktuellen Grant erstellte Kandidaten-ID. |
| candidateHash | string | Erforderlich | Exakter Hash des ursprünglichen serverseitigen Kandidaten. |
| previewInput | object | Erforderlich | Begrenzte Vorschau-Eingaben gemäß Vertrag. |
dfc_artifact_status
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| proposalId | string | Optional oder bedingt erforderlich | Ursprüngliche, unter dem aktuellen Grant erstellte Kandidaten-ID. |
| planId | string | Optional oder bedingt erforderlich | ID des unveränderlichen Anwendungsplans. |
dfc_artifact_plan
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| proposalId | string | Erforderlich | Ursprüngliche, unter dem aktuellen Grant erstellte Kandidaten-ID. |
| candidateHash | string | Erforderlich | Exakter Hash des ursprünglichen serverseitigen Kandidaten. |
| expectedTargetVersion | integer | Erforderlich | Versionsvorbedingung für die aktuelle tatsächliche Zielversion. minimum: 0 |
| idempotencyKey | string | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. |
dfc_artifact_apply
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| planId | string | Erforderlich | ID des unveränderlichen Anwendungsplans. |
| planHash | string | Erforderlich | Hash aus dem ursprünglichen Plan. |
| approvalToken | string | Erforderlich | Vom ursprünglichen Server ausgestelltes Genehmigungsmaterial; nicht selbst generieren. |
| idempotencyKey | string | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. |
dfc_artifact_submit
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| Konfiguration 1 / artifactType | string | Erforderlich | Tatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: CONTROL_PANEL_SPEC, VIEW_SPEC |
| Konfiguration 1 / scopeType | string | Optional oder bedingt erforderlich | Ressourcenumfangstyp im tatsächlichen Artefaktvertrag. |
| Konfiguration 1 / ontologyId | string | Optional oder bedingt erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| Konfiguration 1 / projectId | string | Optional oder bedingt erforderlich | Derzeit autorisierte Projekt-ID. |
| Konfiguration 1 / artifactId | string | Optional oder bedingt erforderlich | Tatsächliche ID eines zu bearbeitenden vorhandenen Artefakts. |
| Konfiguration 1 / instruction | string | Erforderlich | Anforderungstext des Benutzers; Kontext und Übermittlung müssen übereinstimmen. |
| Konfiguration 1 / variables | object | Optional oder bedingt erforderlich | Variablenobjekt gemäß zurückgegebenem Vertrag. |
| Konfiguration 1 / previewInput | object | Optional oder bedingt erforderlich | Begrenzte Vorschau-Eingaben gemäß Vertrag. |
| Konfiguration 1 / viewport | object | Optional oder bedingt erforderlich | Vom Vertrag geforderter Anzeige-Viewport. |
| Konfiguration 1 / contractVersion | string | Erforderlich | Es muss die exakte, tatsächlich unterstützte Vertragsversion verwendet werden. |
| Konfiguration 1 / contextHash | string | Erforderlich | Vollständiger Kontext-Hash, wie von context zurückgegeben. |
| Konfiguration 1 / baseArtifactHash | string | Erforderlich | Basis-Artefakt-Hash, wie von context zurückgegeben. |
| Konfiguration 1 / baseArtifactVersion | integer | Erforderlich | Basisversion, wie von context zurückgegeben. minimum: 0 |
| Konfiguration 1 / candidate | object | Erforderlich | Kandidat, der dem aktuell zurückgegebenen Vertrag entspricht. |
| Konfiguration 1 / clientRequestId | string | Erforderlich | Vom Client stabil verwendeter Idempotenzschlüssel für die aktuelle Kandidatenanfrage. |
| Konfiguration 2 / artifactType | string | Erforderlich | Tatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: ONTOLOGY_RELEASE |
| Konfiguration 2 / contractVersion | string | Erforderlich | Es 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 / ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| Konfiguration 2 / candidateHash | string | Erforderlich | Exakter Hash des ursprünglichen serverseitigen Kandidaten. |
| Konfiguration 2 / workspaceId | string | Erforderlich | Tatsächliche Kandidaten-Workspace-Koordinaten. |
| Konfiguration 2 / workspaceRevision | string | Erforderlich | Exakte Kandidatenversion, nicht latest. |
| Konfiguration 2 / releases | object | Erforderlich | Exakte Versionsauswahl gemäß dem Ontologie-Veröffentlichungsvertrag. |
| Konfiguration 2 / selection | object | Erforderlich | Nur explizite fachliche Auswahlkoordinaten angeben, keine Berechtigungs- oder Fertigstellungsnachweise. |
| Konfiguration 2 / idempotencyKey | string | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. |
| Konfiguration 3 / Konfiguration 1 / artifactType | string | Erforderlich | Tatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: ONTOLOGY_RELEASE |
| Konfiguration 3 / Konfiguration 1 / contractVersion | string | Erforderlich | Es muss die exakte, tatsächlich unterstützte Vertragsversion verwendet werden. enum: ontology-workspace-create-mcp-submit-v1 |
| Konfiguration 3 / Konfiguration 1 / ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| Konfiguration 3 / Konfiguration 1 / workspaceId | string | Erforderlich | Tatsächliche Kandidaten-Workspace-Koordinaten. |
| Konfiguration 3 / Konfiguration 1 / resources | array | Erforderlich | Ursprüngliche Modelldeklarationen, die serverseitig kompiliert werden. minItems: 1 |
| Konfiguration 3 / Konfiguration 1 / idempotencyKey | string | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. |
| Konfiguration 3 / Konfiguration 2 / artifactType | string | Erforderlich | Tatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: ONTOLOGY_RELEASE |
| Konfiguration 3 / Konfiguration 2 / contractVersion | string | Erforderlich | Es muss die exakte, tatsächlich unterstützte Vertragsversion verwendet werden. enum: ontology-workspace-create-mcp-submit-v2 |
| Konfiguration 3 / Konfiguration 2 / ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| Konfiguration 3 / Konfiguration 2 / workspaceId | string | Erforderlich | Tatsächliche Kandidaten-Workspace-Koordinaten. |
| Konfiguration 3 / Konfiguration 2 / resources | array | Erforderlich | Ursprüngliche Modelldeklarationen, die serverseitig kompiliert werden. minItems: 1 |
| Konfiguration 3 / Konfiguration 2 / idempotencyKey | string | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. |
| Konfiguration 3 / Konfiguration 2 / releaseSelections | object | Erforderlich | Exakte releaseId jeder veröffentlichten Referenz sowie deren Abhängigkeitsabschluss. |
| Konfiguration 4 / artifactType | string | Erforderlich | Tatsächlich aktivierter Artefakttyp oder Ontologie-Veröffentlichungstyp. enum: ONTOLOGY_RELEASE |
| Konfiguration 4 / contractVersion | string | Erforderlich | Es muss die exakte, tatsächlich unterstützte Vertragsversion verwendet werden. enum: ontology-initial-activation-retirement-submit-v1 |
| Konfiguration 4 / ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| Konfiguration 4 / domainRid | string | Erforderlich | Tatsächliche RID der Geschäftsdomäne. |
| Konfiguration 4 / consumerScopes | array | Erforderlich | Vom Server zugelassene exakte Consumer-Scopes. minItems: 1; maxItems: 256 |
| Konfiguration 4 / idempotencyKey | string | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. |
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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| request | object | Erforderlich | Ursprüngliche geschäftliche Eingabeanforderung; gemäß dem vollständigen verschachtelten Schema. |
| idempotencyKey | string | Erforderlich | Idempotenzschlü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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| idempotencyKey | string | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. minLength: 1; maxLength: 128 |
| ontologyId | string | Erforderlich | Tatsä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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| questionRevision | $ref | Erforderlich | Explizite Version der aktuell zu bestätigenden Frage. |
| idempotencyKey | $ref | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. |
| originalInputKey | $ref | Erforderlich | Idempotenzschlüssel der zugehörigen ursprünglichen Wissenseingabe. |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. |
| validUntil | $ref | Erforderlich | Ende des Gültigkeitsfensters der Frage, UTC-Zeit. |
| expectedRevision | oneOf | Erforderlich | Versionsvorbedingung für das ursprüngliche Ergebnis oder die fachliche Head-Version; beim Erstellen einer Frage kann der Wert null sein. |
| validFrom | $ref | Erforderlich | Beginn 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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| domainRevisionId | string | Erforderlich | Exakte Version der Geschäftsdomäne. minLength: 1; maxLength: 128 |
| idempotencyKey | string | Erforderlich | Idempotenzschlüssel, der bei derselben logischen Operation stabil wiederverwendet wird. minLength: 1; maxLength: 128 |
| businessSystemId | string | Erforderlich | Tatsächliche Geschäftssystem-ID. minLength: 1 |
| ontologyId | string | Erforderlich | Tatsächliche Ontologie-ID innerhalb der aktuellen Autorisierung, als Zeichenfolge beibehalten. minLength: 1 |
| domainRid | string | Erforderlich | Tatsä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.
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
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| systemId | string / integer | Erforderlich | Vom aktuellen Business-Grant zugelassene System-ID. |
dfb_query
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| systemId | string / integer | Erforderlich | Vom aktuellen Business-Grant zugelassene System-ID. |
| queryKey | string | Erforderlich | Veröffentlichter Abfrageschlüssel, wie von describe zurückgegeben. |
| objectKey | string | Optional oder bedingt erforderlich | Veröffentlichter Objektschlüssel. |
| pageSize | integer | Optional oder bedingt erforderlich | Einträge pro Seite; gemäß Schema-Obergrenze. minimum: 1; maximum: 100 |
| page | integer | Optional oder bedingt erforderlich | Seitennummer, beginnend bei 1. minimum: 1 |
| state | string | Optional oder bedingt erforderlich | Geschäftsstatus-Filter oder Serverstatus. |
dfb_record
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| recordId | string / integer | Erforderlich | ID des aktuell lesbaren Geschäftsdatensatzes. |
| systemId | string / integer | Erforderlich | Vom aktuellen Business-Grant zugelassene System-ID. |
dfb_work_items
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| systemId | string / integer | Erforderlich | Vom aktuellen Business-Grant zugelassene System-ID. |
dfb_action_plan
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| expectedRecordVersion | integer | Optional oder bedingt erforderlich | Aktuelle Optimistic-Lock-Version des Zieldatensatzes. minimum: 1 |
| systemId | string / integer | Erforderlich | Vom aktuellen Business-Grant zugelassene System-ID. |
| commandType | string | Erforderlich | Befehlstyp aus dem veröffentlichten Vertrag. |
| canonicalIrHash | string | Erforderlich | Hash der aktuell veröffentlichten kanonischen IR. |
| releaseId | string / integer | Erforderlich | Versions-ID des tatsächlich veröffentlichten Vertrags. |
| payload | object | Erforderlich | Payload, die dem aktuellen Befehlsvertrag aus describe entspricht. |
| releaseHash | string | Erforderlich | Hash des tatsächlichen veröffentlichten Vertrags. |
| targetRecordId | string / integer | Optional oder bedingt erforderlich | Tatsächlicher Zieldatensatz, der bearbeitet werden soll. |
| agentManifestHash | string | Erforderlich | Hash des tatsächlichen Agent-Capability-Manifests. |
| planIdempotencyKey | string | Erforderlich | Stabiler Idempotenzschlüssel des Geschäftsplans. |
dfb_action_status
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| actionPlanId | string / integer | Erforderlich | Aktionsplan-ID im Besitz des aktuellen Business-Grants. |
dfb_action_execute
| Parameter | Typ | Anforderung | Bedeutung und Umfang |
|---|---|---|---|
| approvalToken | string | Optional oder bedingt erforderlich | Vom ursprünglichen Server ausgestelltes Genehmigungsmaterial; nicht selbst generieren. |
| actionPlanId | string / integer | Erforderlich | Aktionsplan-ID im Besitz des aktuellen Business-Grants. |