DATAFOCUS · OT FLASH · R56

Manuale di integrazione OT Flash Agent e MCP

Protocollo, autorizzazione, contratti degli strumenti e flusso di chiamata completo

Creare applicazioni dati e di conoscenza tracciabili utilizzando il Remote MCP pubblico di OT Flash r56. Questo manuale descrive OAuth, i messaggi di protocollo, il riferimento dei parametri di tutti gli strumenti dichiarati, le regole sulle evidenze, le capacità condizionali e i flussi di ripristino, e include un client eseguibile ed esempi con dati sintetici.

Sviluppatori Agent, ingegneri di integrazione e amministratori

Gli esempi allegati mantengono in cinese i nomi dei campi visualizzati. La traduzione dell'interfaccia e del testo esplicativo non modifica i nomi effettivi di tabelle e colonne, i valori di enumerazione, i nomi degli strumenti o i campi di protocollo.

Capitolo 1

Ambito di integrazione dell'Agent e criteri di completamento

Scegliere il punto di ingresso di autorizzazione e completare query, raccolta di evidenze o scritture controllate sulla base delle ricevute del server.

OT Flash r56 offre agli Agent esterni capacità di dati e conoscenza nell'ambito dell'ontologia tramite Remote MCP e fornisce un punto di ingresso separato per l'area di lavoro business. L'Agent deve determinare il lavoro eseguibile in base al tools/list effettivo, all'inputSchema, agli scope OAuth e ai permessi correnti sulle risorse; non può dedurre da un manuale statico che una distribuzione abbia tutte le funzioni opzionali abilitate.

Figura A1: gli Agent esterni utilizzano le capacità di query, conoscenza e business originali tramite OAuth e MCP. Schema delle relazioni di interfaccia.
Punto di ingressoFinalitàConfini
/mcpOntologia, tabelle dati, conoscenza documentale, Search nativo, nonché analisi e modellazione ad accesso condizionaleIntersezione tra i permessi dell'utente corrente e le risorse concesse con questa autorizzazione
/mcp/businessIndividuazione dei sistemi business, query, piani d'azione, stato ed esecuzioneAutorizzazione separata dei sistemi business e contratti pubblicati
Pagina incorporata dell'Agent dell'ontologiaUso del dialogo con l'ontologia in un'interfaccia per utenti umaniRichiede una sessione di login reale; non è un punto di ingresso per lo scambio di token MCP senza login

Classificazione delle capacità

  • Lettura di base: ontologia e risorse, localizzazione nel grafo, retrieval della conoscenza e testo originale completo, dettagli delle tabelle autorizzate e Doris SQL.
  • Delega separata: dfc_search richiede search:operate e continua a utilizzare i permessi originali di utente e modello.
  • Accesso condizionale: analisi, report persistenti, bozze e applicazione di artifact, query sui modelli di ontologia e attività delegate all'Agent.
  • Capacità non disponibili: lo strumento dfc_etl di Flash restituisce solo le capabilities e non fornisce l'esecuzione Heavy ETL. AutoML e i punti di ingresso interni del workspace FocusCode non rientrano nell'API pubblica di Flash descritta in questo manuale.

Criteri di completamento

Per leggere fatti occorre ottenere una ricevuta di query o di testo originale completo effettivamente utilizzabile; la generazione di un candidato deve indicare che non è ancora stato applicato; la pubblicazione richiede una ricevuta reale APPLIED; l'annullamento deve distinguere tra richiesta e conferma. Il testo della risposta, un HTTP 200, la presa in carico da parte dello strumento o la descrizione “completato” del modello non provano da soli il successo di un'operazione di business.

Il file reference/mcp-tool-catalog.json allegato è il riferimento dichiarativo offline di r56: contiene anche le definizioni abilitate solo a condizione e non è il tools/list in tempo reale di alcun utente. Il catalogo completo comprende 28 strumenti core dell'ontologia, 4 estensioni condizionali del controller e 8 strumenti lato business, e non implica che siano tutti aperti per impostazione predefinita.

Capitolo 2

Connessione rapida e individuazione delle capacità

Partire dal dominio ufficiale dell'istanza e individuare con privilegi minimi gli strumenti effettivamente disponibili.

  1. Ottenere dall'amministratore l'indirizzo radice HTTPS ufficiale e l'ontologia o il sistema business a cui accedere. Non utilizzare i domini di esempio della documentazione per chiamate su dati di business reali.
  2. Configurare l'indirizzo del server MCP come https://flash.example.com/mcp; l'area di lavoro business utilizza /mcp/business dello stesso dominio.
  3. Avviare login e autorizzazione OAuth nel modo supportato dal client e verificare risorse e scope; non inviare nome utente e password tramite MCP.
  4. Eseguire l'individuazione o l'inizializzazione secondo la generazione di protocollo corrispondente, quindi leggere tools/list e le descrizioni delle risorse.
  5. Effettuare innanzitutto una piccola richiesta di sola lettura e verificare risultati strutturati ed errori; solo dopo eseguire l'obiettivo dell'utente.

Frammento di configurazione del client

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

Questo frammento illustra l'intento di configurazione dell'indirizzo del server; la struttura effettiva del file di configurazione e il supporto OAuth dipendono dal client. Non inserire access_token, refresh_token, Cookie o password di amministratore reali in file pubblici.

Individuazione con protocollo moderno

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

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

Controlli pre-integrazione

  • L'indirizzo radice della risorsa, l'issuer OAuth e l'indirizzo pubblico del reverse proxy coincidono.
  • Il client supporta la generazione di protocollo corrispondente, anziché inviare sempre initialize al punto di ingresso del nuovo protocollo.
  • L'autorizzazione corrente è associata all'ontologia o al sistema business richiesto.
  • Il token è valido e i nuovi scope opzionali sono stati esplicitamente autorizzati.
Capitolo 3

Individuazione, registrazione e autorizzazione OAuth

Utilizzare il codice di autorizzazione e PKCE, senza esporre all'Agent le credenziali di accesso del prodotto.

Figura A2: flusso del codice di autorizzazione OAuth e PKCE. Schema di sequenza.
EndpointMetodoFunzione
/.well-known/oauth-protected-resourceGETIndividuazione della risorsa MCP dell'ontologia
/.well-known/oauth-protected-resource/mcpGETIndividuazione compatibile tramite percorso della risorsa dell'ontologia
/.well-known/oauth-protected-resource/mcp/businessGETIndividuazione della risorsa MCP business
/.well-known/oauth-authorization-serverGETMetadati del server di autorizzazione
/oauth/registerPOST JSONRegistrazione dinamica di public client
/oauth/authorizeForm GET o POSTLogin, selezione delle risorse e conferma dell'autorizzazione
/oauth/tokenPOST formScambio del codice di autorizzazione e refresh con rotazione
/oauth/revokePOST formRevoca del token
/oauth/grantsGETL'utente che ha effettuato l'accesso visualizza le connessioni autorizzate
/oauth/grants/revokePOST formRevoca della connessione secondo il flusso della pagina originale

Sequenza di autorizzazione

  1. Leggere i metadati delle risorse protette e i metadati del server di autorizzazione. Il 401 restituito a una richiesta senza token e l'header WWW-Authenticate indicano l'indirizzo di individuazione delle risorse.
  2. Registrare o utilizzare un'identità client. La registrazione dinamica dei public client in r56 usa token_endpoint_auth_method=none; il segreto client non può sostituire PKCE.
  3. Generare state e code_verifier casuali e calcolare il code_challenge S256.
  4. Aprire l'indirizzo authorize indicato nei metadati, passando response_type=code, client_id, redirect_uri esatto, scope, resource, state, code_challenge e code_challenge_method=S256.
  5. L'utente accede a DataFocus e seleziona l'ontologia o il sistema business. Il client non può preselezionare risorse a cui l'utente non ha accesso.
  6. Ricevere il callback, verificare state e issuer; scambiare il codice di autorizzazione utilizzando il code_verifier originale.
  7. Utilizzare l'access_token esclusivamente per l'autenticazione Bearer MCP. Il refresh segue il flusso OAuth originale; conservare in modo sicuro il refresh_token ruotato.

Esempio di registrazione

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

Il callback del client Web utilizza HTTPS; i client nativi possono utilizzare indirizzi di loopback supportati. Sia l'autorizzazione sia lo scambio del token richiedono la corrispondenza esatta con il callback registrato. Un Grant riguarda una sola protected resource: non mescolare scope dell'ontologia e scope dell'area di lavoro business nella stessa connessione.

Ciclo di vita del token

Sul server r56, per impostazione predefinita l'access token dura 3600 secondi, il refresh token 2592000 secondi e il codice di autorizzazione 300 secondi; la distribuzione può sovrascrivere questi valori. Il client deve basarsi su expires_in nella risposta del token e sugli errori effettivi, senza codificare in modo fisso i valori predefiniti. Aggiornare il token dopo il refresh; la revoca di ruoli, permessi su risorse o Grant fa sì che le chiamate successive vengano rifiutate.

Capitolo 4

Scope, confini delle risorse e permessi in tempo reale

Gli scope autorizzati delegano i permessi esistenti, non concedono elevazioni di ruolo e non condividono lo stato business tra Grant diversi.

ScopeCapacità tipicheVincoli importanti
ontology.metadata:readOntologia, risorse, struttura delle tabelleOntologia e tabelle devono rientrare nell'autorizzazione e nell'ambito attualmente leggibile
ontology.graph:readRicerca nel grafo e nodi viciniRestituisce informazioni di localizzazione, non evidenze fattuali
ontology.knowledge:readLocalizzazione nella conoscenza e testo originale completoConserva i permessi originali della knowledge base e dei documenti
ontology.table:queryQuery SQL sulle tabelle dell'ontologia e query sui modelli pubblicatiLa query sulle tabelle richiede anche lo scope metadata; origine effettiva e permessi sulle colonne restano in vigore
search:operateModelli e sessioni nativi per parole chiaveDelega esplicita e separata, eseguita secondo il modello originale e i permessi dell'utente su tabelle e colonne
etl:operateCapabilities Flash ETLHeavy ETL non disponibile
authoring.contract:readContratti di modellazione ad accesso condizionaleRichiede anche interruttori di funzionalità e risorse correlate
authoring.artifact:readLettura di candidati, piani ecc. con l'autorizzazione correnteVincolata al Grant e alle risorse del soggetto originale
authoring.artifact:draftInvio di candidati, anteprime ecc.Non autorizza esecuzione o pubblicazione
authoring.artifact:applyPiani e applicazione controllatiRichiedono comunque il ruolo business originale, le policy e le approvazioni
execution.script:draftBozze di script specificiNon autorizza l'esecuzione effettiva degli script
datasource.http:read / draft / test / importCapacità sugli artifact delle sorgenti dati HTTP ad accesso condizionaleInterruttore indipendente per ciascuna voce e permessi originali
Figura A3: i permessi dell'utente, il Grant, le risorse selezionate e la configurazione delle funzionalità determinano insieme le capacità disponibili. Schema illustrativo.

Combinazioni di scope richieste per la lettura

dfc_table detail richiede ontology.metadata:read; query richiede inoltre ontology.table:query. dfc_ontology_query richiede entrambi gli scope di lettura graph e knowledge. dfc_knowledge_search/detail richiede knowledge. published_model/published_query usano table:query; candidate_query richiede inoltre authoring.artifact:read. Gli strumenti di analisi verificano anche gli scope di evidenza consentiti; i report persistenti richiedono metadata e table query.

Non codificare in modo fisso le autorizzazioni predefinite

L'insieme predefinito di scope dell'ontologia di r56 include table query; Search e ETL sono deleghe esplicite. In ultima analisi fanno fede i metadati di individuazione, la pagina di autorizzazione, gli scope effettivi del token e tools/list. Le affermazioni nella documentazione precedente secondo cui “per impostazione predefinita l'ontologia non include mai SQL” o “ci sono solo sei strumenti” non valgono per l'implementazione attuale.

Isolamento dello stato

Sessioni, report, candidati e piani d'azione hanno tutti un proprietario e un ambito propri. Il refresh dell'access token non trasferisce il lavoro del Grant originale a un altro Grant. Non unire alla connessione corrente sessionId, reportId, planId, token di approvazione o token di origine restituiti da un'altra connessione.

Capitolo 5

HTTP e messaggi moderni MCP

Inviare correttamente i metadati di ciascuna richiesta e gli header di routing corrispondenti, gestendo separatamente lo stato HTTP e i risultati degli strumenti.

VoceComportamento r56
TrasportoSenza stato: Streamable HTTP, POST JSON-RPC
Identificativi supportati2026-07-28 e 2025-11-25 2025-06-18 2025-03-26
Metodi moderniserver/discover tools/list tools/call resources/list resources/read, esposti in base alle capacità effettive
Header di sessioneNessun Mcp-Session-Id assegnato
GET e DELETE/mcp e /mcp/business restituiscono 405
Notifiche SSE del serverNon fornite da questi due punti di ingresso MCP pubblici
Cache del catalogoL'individuazione e gli elenchi moderni restituiscono ttlMs=60000 e cacheScope=private
Risultati ordinariI risultati moderni includono resultType=complete e i metadati di identità del servizio

Contenuti che devono corrispondere

  • MCP-Protocol-Version coerente con io.modelcontextprotocol/protocolVersion nei params._meta.
  • Mcp-Method coerente con il metodo JSON-RPC.
  • Per tools/call, Mcp-Name corrisponde a params.name; per resources/read, l'header del nome corrisponde all'URI.
  • Ogni richiesta moderna include l'oggetto io.modelcontextprotocol/clientCapabilities; fornire inoltre il clientInfo standard per facilitare l'identificazione del client.

Esempio di chiamata

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

Gli header HTTP corrispondenti sono Mcp-Method: tools/call e Mcp-Name: dfc_ontologies. In tutti gli esempi ACCESS_TOKEN è un segnaposto. Non inserire il Bearer Token negli URL, nei parametri JSON o nelle chiavi di cache.

Lettura dei risultati

Elaborare prima lo stato HTTP, quindi verificare l'errore JSON-RPC; se è presente un result, controllare anche isError. I risultati degli strumenti andati a buon fine forniscono in genere structuredContent, insieme a un contenuto text contenente lo stesso JSON di business; leggere prima il canale strutturato ed evitare di aggregare due volte text e structuredContent come se fossero fatti indipendenti. Un HTTP 200 può comunque riportare un errore dello strumento.

Risorse pubbliche e UI

La risorsa di documentazione integrata non dipende da MCP Apps. Il punto di ingresso dell'area di lavoro business non ottiene per questo la risorsa di documentazione dell'ontologia. I client che supportano la visualizzazione dovrebbero individuare la UI corrispondente tramite le capacità effettive e i _meta degli strumenti, senza indovinare URI di risorse non restituiti.

Capitolo 6

Compatibilità con i client del protocollo legacy

Mantenere coerente la generazione di protocollo nei client che utilizzano ancora l'handshake di inizializzazione.

json
{
  "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {"name": "flash-legacy-client", "version": "1.0.0"}
  }
}
  1. Inviare initialize e leggere la versione del protocollo e le capabilities negoziate dal server.
  2. Inviare le notifiche di completamento dell'inizializzazione necessarie in base al protocollo del client; le notifiche non restituiscono normali risultati di strumenti.
  3. Utilizzare tools/list per leggere gli strumenti attualmente autorizzati, quindi inviare tools/call.
  4. Mantenere header e messaggi coerenti con la generazione della richiesta corrente; non applicare il flusso legacy initialize o ping ai messaggi 2026-07-28.

Il protocollo legacy continua a utilizzare lo stesso Bearer/OAuth, gli stessi permessi e gli stessi contratti degli strumenti. Non implica che il server fornisca necessariamente connessioni SSE persistenti di tipo legacy o Mcp-Session-Id; il servizio pubblico r56 rimane senza stato.

Errori di protocollo

SituazioneRisultato tipicoSoluzione
Header e messaggi moderni incoerentiHTTP 400 JSON-RPC -32020Correggere header, metadati e nomi degli strumenti
Versione non supportata-32022 con elenco delle versioni supportateSelezionare un protocollo effettivamente supportato
Metodo sconosciutoJSON-RPC -32601; le richieste moderne possono restituire HTTP 404Verificare la generazione del protocollo e il metodo
Parametri mancanti o non validiJSON-RPC: errore di parametri oppure isError dello strumentoCorreggere in base all'inputSchema effettivo
Capitolo 7

Scelta dello strumento corretto e del canale di evidenza

Instradare in base al problema di business irrisolto, senza ripetere l'acquisizione delle evidenze con una catena di chiamate fissa.

Figura A4: scelta, in base all'attività, tra SQL su tabelle, evidenze di conoscenza, Search, analisi o azioni di business. Schema di instradamento.
AttivitàStrumento preferitoEvidenze necessarie al completamento
Individuazione di temi e risorse autorizzatidfc_ontologies dfc_ontology_resourcesTipi effettivi degli ID delle risorse e ambito di visibilità corrente
Statistiche tabellari e TopNdfc_table queryRicevuta di esecuzione riuscita e evidenceRows completo
Consultazione di normative, contratti o reportdfc_ontology_query o knowledge search/detailTesto originale completo, autorizzato e utilizzabile come fatto
Localizzazione di oggetti nel grafodfc_ontology_graph search/neighborsLocalizzare la fonte effettiva, quindi ottenere i fatti corrispondenti
Interazione originale per parole chiavedfc_manual quindi dfc_searchRisultati effettivi nel modello e nei frame di business originali
Analisi ibrida e reportdfc_analysis_* o dfc_report_*Stato reale di ciascun ramo strutturato e delle evidenze documentali
Modifica della visualizzazione o del modello dell'ontologiadfc_authoring_* e strumenti artifactVerifica separata di candidato, piano, approvazione e applicazione effettiva
Esecuzione di comandi di businessdfb_* di /mcp/businessContratti pubblicati e ricevuta dell'ActionPlan originale

Evitare chiamate non necessarie

Quando si dispone già di una struttura di tabella attuale, completa e autorizzata, non richiedere un nuovo detail a ogni query; quando si dispone già di una localizzazione affidabile e delle evidenze, non ripetere la stessa ricerca. Quando manca una dimensione necessaria, effettuare un'interrogazione supplementare circoscritta. Quando un errore è esplicitamente non ritentabile, colmare prima la lacuna, anziché sostituire la valutazione con un “riprova”.

Esclusioni di Flash

Le capabilities di dfc_etl possono restituire available=false insieme a ETL_NOT_INCLUDED_IN_OT_FLASH. La documentazione statica delle funzioni ETL integrate serve come riferimento trasversale tra prodotti e non dimostra che Flash abbia ETL installato, né consente all'Agent di passare automaticamente a Heavy o ad altri tenant per l'esecuzione.

Capitolo 8

Risorse dell'ontologia e tipi di ID

Ottenere prima le coordinate effettive delle risorse, per evitare di confondere nomi di archiviazione, ID di documenti e ID della knowledge base.

  1. Chiamare dfc_ontologies ed esplorare con page e pageSize le ontologie incluse in questa autorizzazione e ancora leggibili.
  2. Chiamare dfc_ontology_resources con un ontologyId reale; selezionare tra tables, answers, pinboards, documents e knowledgeBindings secondo necessità.
  3. Gestire separatamente la paginazione per ciascun tipo di risorsa. Il valore massimo di pageSize è 100; non dedurre l'intero insieme di risorse dalla prima pagina.
  4. Salvare il tipo dichiarato della risorsa e l'ID originale, e utilizzarli successivamente così come sono.
json
{"name":"dfc_ontology_resources","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "resourceTypes":["tables","documents","knowledgeBindings"],
  "page":1,"pageSize":100
}}
CoordinateOrigineNon sostituibile con
ontologyIdElenco delle ontologie autorizzate o contesto valido correnteID di un'altra ontologia
id della risorsa tabellaElenco tables o contesto affidabilephysicalName o nome tabella visualizzato
tblDisplayName colDisplayNameMetadati correnti di tabelle e colonneIdentificatore fisico SQL ipotizzato
knowledgeIdknowledgeBindings o ricevuta effettiva di retrieval della conoscenzaid della risorsa documento
assetId documentId chunkId evidenceIdLa stessa ricevuta effettiva di localizzazioneCampi assemblati a partire da risultati di localizzazione diversi
rid revisionId releaseIdModello pubblicato o contesto del candidato lato serverID generati autonomamente o latest

Convenzioni di precisione

Tutti gli identificatori di risorsa a 64 bit vanno passati preferibilmente come stringhe decimali, senza conversione tramite Number in JavaScript. Alcuni Schema di business accettano string o integer, ma ciò non significa che si possa sacrificare la precisione degli interi. Anche gli opaque locator, UUID, gli hash e i token monouso vanno conservati così come sono.

Capitolo 9

Contratto di query e struttura delle tabelle Doris

Eseguire query SQL di sola lettura sulle tabelle autorizzate, preservando la semantica dell'output, i valori esatti e la completezza.

Lettura della struttura

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

detail utilizza un ID reale della risorsa tabella. Verificare schemaComplete, tblDisplayName, il colDisplayName in columns e il sqlDataType autorevole, nonché il queryContract restituito. dataType è solo una mappatura di compatibilità; il nome fisico di archiviazione non è il nome di tabella da usare nella SQL.

Esecuzione della query

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

Vincoli SQL

  • Utilizzare i nomi di tabella e di colonna visualizzati, racchiudendo gli identificatori tra virgolette doppie. La richiesta è una query Doris di sola lettura nell'ambito dell'ontologia.
  • Elencare esplicitamente gli output; SELECT * e table.* sono vietati: non possono essere usati per aggirare, tramite colonne fisiche, i permessi sulle colonne registrate.
  • I join utilizzano JOIN ... ON espliciti; NATURAL JOIN e JOIN USING vengono rifiutati.
  • Sono ammesse espressioni di sola lettura legittime come aggregazioni multidimensionali, CTE, finestre, CASE, COUNT(DISTINCT ...); il fatto che la validazione semantica non copra un'espressione non equivale a vietarne l'esecuzione.
  • Completare prima in SQL aggregazioni, ordinamenti e classifiche, quindi applicare il limite sui risultati. maxRows vale 100 per impostazione predefinita, con un massimo di 200.

Date e fusi orari

Tipo o destinazioneFormaNota
DATECAST('2026-09-01' AS DATE) e CURRENT_DATENon presupporre che un letterale di testo sia di tipo data
DATETIMECAST('2026-09-01 00:00:00' AS DATETIME) e CURRENT_TIMESTAMPVerificare il fuso orario della sorgente e quello della sessione
Tempo relativoDATE_SUB(CURRENT_DATE, INTERVAL 1 YEAR)Usare per date e timestamp le funzioni correnti corrispondenti
Raggruppamento temporaleYEAR(column) oppure DATE_TRUNC(column, 'month')Usare un alias univoco per ogni output; fa fede queryContract

Il DATE('now', ...) di SQLite non è il contratto data Doris di questo punto di ingresso. Non trasferire nella SQL online il metodo di verifica offline con SQLite usato negli esempi della documentazione.

Leggere la ricevuta di query v8

evidenceRows è l'unico canale dell'Agent verso i dati di riga; i raw data non sono accessibili all'Agent. I numeri SQL sono codificati come stringhe JSON decimali esatte; determinarne valore numerico e tipo di business tramite resultColumnContracts, senza interpretare i numeri codificati in JSON come VARCHAR solo perché sono stringhe. Leggere executionReceipt, le informazioni su completezza e troncamento e conservare le informazioni di origine come evidenceRowsSha256.

Gli output di query con una ricevuta di esecuzione citabile possono essere citati così come sono; solo la semantica verificata lato server autorizza successivi calcoli deterministici di secondo livello. Non dedurre dalla sola denominazione dei campi significati come “saldo cumulato”, “valore di fine periodo”, “valuta” né aggiungere unità per conto proprio. Risultati con zero righe, errori o troncamenti non devono essere descritti come statistiche complete.

Capitolo 10

Top3 multidimensionale e gestione del troncamento

Rispondere alle domande di classifica tramite aggregazioni e funzioni finestra lato server, senza ricalcoli su risultati incompleti.

Il file allegato examples/top3.sql usa la tabella di esempio: aggrega prima per 区域, 类别 e 产品, quindi esegue ROW_NUMBER all'interno di ciascun 区域 e 类别, usando il nome del 产品 come ordinamento stabile in caso di parità di importo. Una richiesta con maxRows=100 è sufficiente per le 36 righe dell'esempio; per altri dati di business valutare in base al numero reale di gruppi.

  1. Ottenere la struttura reale e il criterio di calcolo corrente, definendo valuta (币种), periodo, stato dell'ordine (订单状态) e regole di parità.
  2. Inviare la SQL di aggregazione e classifica lato server. Non limitarsi a interrogare prima il totale di 区域 per poi usarlo come classifica per 类别 e 产品.
  3. Verificare il contratto delle colonne di output e gli evidenceRows effettivi, confermando che i risultati restituiti coprano tutti i gruppi necessari.
  4. In caso di troncamento, eseguire query delimitate per partizione, entro i limiti supportati dal server, ad esempio ottenendo il Top3 completo separatamente per ciascun 区域; mantenere ogni volta lo stesso criterio di calcolo.
  5. Se nel frattempo la sorgente cambia, interrogare di nuovo e dichiarare esplicitamente la nuova versione, senza mescolare versioni di dati diverse o cursori non più validi.
Figura A5: ordine di filtro dei dettagli, raggruppamento con totali, classifica all'interno dei gruppi e restituzione finale. Schema illustrativo.

Ripristino dopo errori

In caso di TABLE_SCHEMA_INCOMPLETE occorre correggere o ottenere la struttura completa; gli errori come ONTOLOGY_SQL_FAILURE_CONTRACT_INVALID si gestiscono secondo errorCode, retryable e remediation restituiti. Non affermare che “tutte le GROUP BY multidimensionali o le funzioni finestra sono vietate” e non inventare classifiche in assenza di risultati di query.

Capitolo 11

Retrieval della conoscenza — testo originale completo e idoneità come evidenza

Separare localizzazione, lettura e citazione dei fatti, conservando provenienza e completezza.

Due percorsi comuni

PercorsoFinalitàPunti chiave
dfc_ontology_queryRetrieval nella conoscenza associata all'ontologia, eventualmente combinato con l'instradamento tramite grafoVerificare gli answerContextItems canonici completi e l'idoneità come evidenza
dfc_knowledge_search → chunk dfc_knowledge_detailLocalizzare con una ricerca esplicita, quindi leggere l'intero testo del frammento selezionatoL'anteprima di ricerca non costituisce un fatto; leggere il testo originale completo dello stesso risultato di localizzazione
json
{"name":"dfc_knowledge_search","arguments":{
  "ontologyId":"<ONTOLOGY_ID>","query":"销售金额是否排除退货", "topK":5
}}

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

Condizioni per l'uso come fatto

  • Verificare l'ACL corrente, la completezza del contenuto e il canonicalFactEligible, il citationEligible o il contratto di esecuzione corrispondente dichiarato dal server.
  • Il contenuto completo è vincolato al contentSha256. Troncamenti, omissioni per budget o contenuti di bassa qualità vanno trattati secondo i campi effettivi.
  • I metadati del documento, page_context, le localizzazioni nel grafo, i riassunti di retrieval e le anteprime non sostituiscono il testo canonico originale.
  • Copiare preferibilmente evidenceId; quando servono chunkId e documentId, devono provenire dallo stesso risultato di localizzazione, senza combinarli né inventarli.

Instradamento tramite grafo

Il risultato di search/neighbors è un'informazione di localizzazione. Passare alla query sull'ontologia esclusivamente gli oggetti routeLocator restituiti integralmente dal server, inclusi binding, versione e campi di attestazione. Non incapsulare autonomamente un assetId o un knowledgeId come locator emesso dal server, né rinviare attestazioni di provenienza dichiarate dal modello.

Ripristino di documenti strutturati

Il structuredPlan di dfc_ontology_query serve esclusivamente al ripristino vincolato e alla verifica deterministica delle tabelle in documenti irregolari. Usare il piano dichiarato dal server solo dopo che sono stati restituiti executionContractSha256, tableIndex correnti, le colonne e la tabella completa. Le normali tabelle di business importate devono passare per dfc_table SQL; non trattare il ripristino di tabelle Markdown come un canale per aggirare l'autorizzazione alle query sulle tabelle.

Figura A6: catena di evidenza tra risultato di localizzazione e testo originale citabile. Schema illustrativo.

Strategia di retrieval

knowledgeIds di norma viene omesso per coprire i binding attualmente abilitati; quando viene passato, utilizzare solo gli ID reali delle knowledge base presenti in knowledgeBindings. Non usare l'ID di una risorsa documento come ID di knowledge base. Per ogni questione ancora aperta effettuare una nuova ricerca delimitata, evitando retrieval identici che non apportano nuove evidenze.

Capitolo 13

Convenzioni su lingua e impostazioni regionali

Mantenere i confini tra locale della UI, dizionario di query, lingua di restituzione e nomi dei campi originali.

La priorità è: lingua richiesta esplicitamente, lingua del sistema applicativo, locale del nodo di esecuzione effettivo. Valori omessi, null, stringhe vuote e spazi non comportano un fallback fisso al cinese. I valori di regione in languageRegistry vanno mantenuti con precisione; en-GB, fr-CA, pt-BR, es-US e ar-AE non devono essere accorpati arbitrariamente in un'altra regione.

Lingua o regioneLocale della queryDescrizione
Cinese semplificato, cinese tradizionalezh-CN zh-HantLe regole originali del cinese differiscono dal catalogo del cinese tradizionale
Inglese USA, UK, Australia, Canadaen-US en-GB en-AU en-CAPacchetti UI/parole chiave condivisibili, metadati regionali conservati
Tedesco, italiano, russode-DE it-IT ru-RUSecondo i suggerimenti della sessione corrente
Spagnolo di Spagna e America Latinaes-ES es-USL'ID regione del prodotto è es-US
Francese di Francia e Canadafr-FR fr-CAGli ID regione non vengono accorpati
Portoghese di Portogallo e Brasilept-PT pt-BRCataloghi e convenzioni regionali conservati separatamente
Olandese, danese, norvegese, finlandese, svedesenl-NL da-DK nb-NO fi-FI sv-SEIl norvegese è Bokmål
Giapponese, coreanoja-JP ko-KRNon segmentare autonomamente le parole in base agli spazi come in inglese
Arabo di Arabia Saudita ed Emirati Arabi Unitiar-SA ar-AELe descrizioni dell'interfaccia supportano RTL; gli identificatori di protocollo non vengono invertiti

Uso del catalogo delle parole chiave

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

Il catalogo statico delle parole chiave di dfc_manual include solo i locale esplicitamente elencati; in caso di omissione si usa il riferimento inglese: si tratta di un valore predefinito di riferimento, non di una regola di parsing della lingua della query. Quando una variante regionale non dispone di un catalogo statico, ottenere i suggerimenti effettivi tramite l'assist della sessione corrente, senza inventare alias o risultati di fallback. Il parametro names accetta al massimo 32 elementi per chiamata.

Contenuti da non tradurre

  • Tabelle, colonne, valori di enumerazione, nomi dei clienti, nomi di formule e altre stringhe reali del modello.
  • Nomi degli strumenti, action, scope, campi dello Schema, codici di errore e valori di stato.
  • ID delle risorse, hash, locator opachi e riferimenti emessi dal server.

Ad esempio, una domanda in tedesco può interrogare la colonna visualizzata in cinese “销售金额”. Rinominarla con un nome di colonna tedesco produrrebbe un identificatore diverso, non una traduzione dell'interfaccia. Dopo un cambio di lingua, reinizializzare o aggiornare la sessione secondo il protocollo originale e recuperare di nuovo suggerimenti e candidati di disambiguazione.

Capitolo 14

Analisi ibride e risultati interattivi

Negli strumenti di analisi ad accesso condizionale, conservare autorizzazione, versione, ramo e stato delle evidenze.

dfc_analysis_* è controllato da datafocus.mcp.analysis.tools.enabled. La parte strutturata continua a passare per le query autorevoli di Search e la policy di riga corrente; per la parte documentale si riottiene il testo originale completo con l'ACL corrente. Non sono punti di ingresso per SQL libero, istruzioni arbitrarie o iniezione di filtri arbitrari.

StrumentoFinalitàCoordinate necessarie
dfc_analysis_askPone una domanda di analisi in linguaggio naturaleontologyId question; facoltativi: language, sessionId
dfc_analysis_result_getLegge i risultati già restituitiontologyId sessionId resultId
dfc_analysis_refineChiede approfondimenti o modifiche in base all'ultimo risultato completoRisultato originale, expectedRevision e chiave di idempotenza stabile
dfc_analysis_pageOttiene una pagina di un ramo lato serverRamo originale e versione del risultato, pageNo pageSize
dfc_analysis_cancelAnnulla un risultato ancora in elaborazioneSessione e risultato originali
dfc_analysis_closeRilascia una sessione non più in elaborazioneSessione originale

Avvia l'analisi

json
{"name":"dfc_analysis_ask","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "question":"按区域分析已完成订单销售金额,并引用退货统计口径",
  "language":"zh-CN"
}}
  1. Leggere i valori sessionId, resultId, lo stato e la revision restituiti; se necessario, continuare a leggere il risultato originale.
  2. Verificare uno per uno stato, completezza, policy di riga e origini di ciascun ramo strutturato; il completamento di un singolo ramo non implica che l'intera analisi sia completa.
  3. Verificare le evidenze documentali, il registro dei fatti, l'idoneità alla citazione e i limiti. Le narrazioni generate dal modello non possono elevare da sole l'idoneità delle evidenze.
  4. Per un approfondimento, basarsi sull'ultimo risultato completo e passare expectedRevision; per ritentare la stessa modifica riutilizzare la stessa chiave di idempotenza.
  5. Prima di chiudere, confermare che la sessione non sia più in elaborazione; annullare e chiudere sono azioni diverse.

Filtraggio e impaginazione controllati

filter_patch utilizza branchId, fieldRef, valueRef e gli operatori consentiti forniti dal server; il filtro tipizzato corrente dichiara solo EQ. È vietato sostituire i riferimenti opachi con SQL grezzo, tableId, columnId o con un albero di filtri costruito arbitrariamente dal client. Per l'impaginazione, pageNo parte da 1, con un massimo di 10000; pageSize ha un massimo di 100.

Figura A7: associazione tra rami, versioni e impaginazione; dopo una modifica dell'origine o della versione, occorre eseguire una nuova query per ottenere una nuova localizzazione. Schema illustrativo.

Suggerimenti sulle capacità e comportamento

Le annotations degli strumenti sono suggerimenti per il client, non autorizzazioni di sicurezza. Alcuni modelli generici utilizzano readOnlyHint, che non sostituisce la valutazione dell'azione effettiva; l'annullamento, la chiusura e la creazione di report modificano i rispettivi stati di lavoro. Agire sempre secondo la semantica dello strumento, gli obiettivi dell'utente e i permessi lato server.

Capitolo 15

Report visivi persistenti e MCP Apps

Creare report ripristinabili e leggerne risultati e interfacce interattive in base ai permessi correnti.

dfc_report_* è controllato da datafocus.mcp.analysis.report-tools.enabled e richiede gli scope metadata e table query. A differenza delle sessioni Search interne al processo, i report utilizzano un reportId persistente; persistente non significa che i permessi non vengano più verificati.

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

Flusso di lavoro

  1. Alla creazione, utilizzare un idempotencyKey stabile, lungo da 8 a 128 caratteri supportati.
  2. Salvare reportId, eseguire il polling dello status e verificare gli stati effettivi come completato, non riuscito, parzialmente completato o annullato.
  3. Alla lettura dei risultati, verificare i rami strutturati, le visualizzazioni, le origini dei fatti, le citazioni documentali e la completezza.
  4. Per annullare un report non completato, utilizzare il reportId originale; non creare un altro report al posto dell'annullamento.
  5. Dopo un timeout di rete, leggere prima lo stato del report originale; la ripetizione con la chiave di idempotenza originale deve mantenere lo stesso intento di business.

MCP Apps

I client che supportano le estensioni UI leggono le pagine dei report tramite il _meta degli strumenti e l'individuazione effettiva delle risorse. La pagina del report persistente corrispondente a r56 è ui://datafocus/analysis-report/v16/index.html; l'analisi interattiva utilizza i riferimenti alle risorse lato server appropriati; il client non deve codificare in modo fisso valori in sostituzione di quelli restituiti dagli strumenti. Senza estensione UI, i risultati strutturati restano leggibili.

Binding dell'origine

La lettura dei report riverifica il Grant, l'ontologia, il binding all'Origin della richiesta e i permessi correnti sulle tabelle. Le integrazioni cross-origin del browser devono utilizzare origin effettivi approvati; il client non deve aggirare il binding falsificando l'Origin. Un vecchio reportId non è un collegamento pubblico di lunga durata né una credenziale di accesso tra utenti.

Capitolo 16

Bozze di artifact, anteprima, piano e applicazione

Affidare i contenuti generati al server originale per normalizzazione, validazione e approvazione, senza consentire al modello di modificare direttamente le risorse di produzione.

Gli strumenti artifact richiedono l'abilitazione della funzione authoring, un artifact type effettivo, gli scope pertinenti e i permessi originali di scrittura da amministratore. Per impostazione predefinita sono configurati i tipi CONTROL_PANEL_SPEC e VIEW_SPEC; gli altri tipi, per moduli, origini HTTP o script, sono soggetti anche a configurazioni separate. Flash non ha AutoML, pertanto i tipi correlati non sono elencati come artifact disponibili in questa versione.

Figura A8: sequenza controllata di contesto, candidato, anteprima, piano, approvazione e applicazione. Schema illustrativo.
  1. dfc_authoring_capabilities legge i contratti e le azioni disponibili per il Grant corrente.
  2. dfc_artifact_context ottiene il contesto delimitato, contractVersion, contextHash, baseArtifactHash e baseArtifactVersion.
  3. Generare il candidato nel client in base al contratto reale, senza eseguirne il codice.
  4. dfc_artifact_submit invia il contesto originale e il candidato, mantiene l'instruction identica e utilizza un clientRequestId stabile.
  5. Leggere proposalId, candidateHash, la verifica e l'anteprima; in presenza di errori effettivi, rivedere il candidato senza simulare un esito positivo lato server.
  6. Quando serve una nuova anteprima, utilizzare dfc_artifact_preview e lo stesso hash del candidato.
  7. dfc_artifact_plan crea un piano immutabile, utilizzando il candidato reale, la versione di destinazione e la chiave di idempotenza.
  8. Gestire l'approvazione tramite l'interazione originale o una policy già autorizzata, quindi chiamare dfc_artifact_apply; solo la ricevuta APPLIED attesta l'applicazione effettiva.

Richiesta di contesto minima

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

VIEW_SPEC utilizza il projectId attualmente autorizzato; per modificare un artifact esistente, utilizzare il artifactId effettivo. I campi variables, previewInput, viewport e simili vengono forniti secondo il contratto restituito, senza inventare la struttura interna del candidato.

Concorrenza e retry

Il piano vincola la versione di destinazione, l'hash del candidato e la chiave di idempotenza. Se la destinazione cambia, il vecchio piano non può più essere applicato; rileggere il contesto e gestire il conflitto effettivo. Un timeout di trasporto non prova un fallimento: usare prima dfc_artifact_status per interrogare il proposalId o il planId originale. READY non è APPLIED.

Approvazione e policy automatiche

I piani di artifact generici richiedono l'approvazione umana originale. I piani conformi alla policy di pubblicazione automatica dell'ontologia vengono gestiti secondo approvalMode, senza chiedere all'utente di firmare un'ulteriore approvazione inventata dall'Agent. approvalToken è materiale emesso dal server e non può essere sostituito da una stringa scritta dall'Agent; il inputSchema effettivo e la ricevuta del piano determinano i campi obbligatori.

Capitolo 17

Contratti di creazione e pubblicazione dei candidati di ontologia

Utilizzare dichiarazioni di ontologia e configurazioni di pubblicazione con versioni indipendenti; non applicare alla pubblicazione dei modelli i contratti degli artifact di visualizzazione ordinari.

Creazione del candidato

Il contenitore di ontologia deve già esistere ed essere compreso nel Grant. Utilizzare dfc_ontology_table_schema per verificare i campi delle origini strutturate correnti e l'impronta del Binding v4; per i campi è possibile fornire solo sourceField affinché il tipo venga rilevato automaticamente. Una dichiarazione esplicita DECIMAL richiede la precisione e le cifre decimali correnti; gli altri tipi non includono questi due campi.

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

Candidati e configurazione di pubblicazione

ContrattoFinalitàConfini critici
ontology-workspace-create-mcp-submit-v1Creazione del candidato da dichiarazioni localiOrigini realmente autorizzate, compilazione lato server, non accetta attestazioni di completamento
ontology-workspace-create-mcp-submit-v2Combinazione di dichiarazioni locali e riferimenti esatti già pubblicatiFornire releaseSelections esatte e le dipendenze della chiusura
ontology-publication-mcp-submit-v1 fino a v3Associazione di un candidato esistente alla richiesta di piano di pubblicazioneCoordinate esplicite; destinazione, origine, approvazione e verifica vengono ricostruite dal server
ontology-publication-mcp-submit-v4 fino a v6Configurazioni correlate alla pubblicazione automatica abilitate separatamenteUtilizzo solo quando capabilities e schema effettivo lo dichiarano
ontology-initial-activation-retirement-submit-v1Operazioni controllate di attivazione iniziale e ritiroPiano separato, nuova approvazione umana e ambito esatto

Sequenza di pubblicazione

  1. Ottenere per il candidato corrente workspaceId, workspaceRevision, candidateHash e le origini effettive.
  2. Scegliere la versione del contratto in base alle capacità del server; inviare le coordinate come releases e selection, senza allegare campi che si dichiarino “approvato” o “convalidato”.
  3. Conservare il proposalId e l'idempotencyKey originale, restituiti da submit. submit e MODEL_PLAN sono fasi diverse della stessa richiesta.
  4. Chiamare dfc_artifact_plan, utilizzando il candidato originale, la versione di destinazione e la stessa chiave di idempotenza.
  5. PLANNING_INCOMPLETE indica solo che non è ancora stato formato un piano valido; VALIDATION_UNSATISFIED indica che la verifica corrente presenta ancora lacune, da gestire secondo nextAction.
  6. Dopo il successo del piano, proseguire secondo HUMAN_REQUIRED o POLICY_AUTO, utilizzando l'approvazione e le capacità di pubblicazione originali.
  7. Confermare il risultato con la ricevuta APPLIED e con la successiva lettura effettiva del modello pubblicato e una query autorizzata.

Timeout e ripristino

Dopo il timeout di PLAN, leggere il proposalId originale. MODEL_PLAN_SUBMITTED è una richiesta non completata; MODEL_PLAN_COMPLETED indica di ripristinare la ricevuta originale con le coordinate e la chiave originali, non di far creare al client una nuova richiesta. Le lacune di verifica nello stato finale non possono diventare una pubblicazione convalidata cambiando chiave o inviando di nuovo.

Permessi di business umani

L'instruction e le dichiarazioni fornite dall'Agent sono input dell'Agent, non firme di policy umane. MODEL_AUTHOR, MODEL_PUBLISH, la delega alla pubblicazione automatica, la conferma di business, l'attendibilità delle chiavi pubbliche, i budget e le ACL delle origini continuano a essere determinati dai meccanismi originali. Non sostituire questi fatti con campi lato client.

Capitolo 18

Modelli pubblicati, query sui candidati e chiusura dei riferimenti

Utilizzare la conoscenza di business pubblicata in base a versioni esatte e preservare la natura provvisoria dei candidati non pubblicati.

published_model, published_query e candidate_query di dfc_ontology_graph sono configurazioni strutturate ad accesso condizionale, non sinonimi del normale search/neighbors. L'autorizzazione si basa su table query e sui permessi di lettura per la modellazione necessari; la visibilità nel grafo non sostituisce i permessi sulle tabelle.

Lettura del modello pubblicato

  1. Quando l'enumerazione action dello strumento include effettivamente published_model, inviare il releaseId committed reale.
  2. v1 restituisce template di query autorizzate; v2 aggiunge i riferimenti esatti PERSISTED e releaseSelections; v3 aggiunge i riferimenti alle dipendenze, il domainRef esatto e template di binding compatti.
  3. Selezionare oggetti, proprietà, Binding, scope e versioni dai valori effettivamente restituiti, senza generare RID né usare latest.
  4. Inviare per published_query la query tipizzata fissa; i risultati devono comunque superare le autorizzazioni correnti su origini e campi.

Query sui candidati

candidate_query utilizza il workspaceId effettivo, revision, candidateHash e le dichiarazioni del candidato. In caso di combinazione con riferimenti pubblicati, usare le corrispondenti coordinate tipizzate LOCAL/PERSISTED v2 e la selezione esatta. I risultati sui candidati restano sempre non pubblicati e provvisori e non vanno considerati conoscenza confermata dall'azienda.

Manutenzione parziale e chiusura

Selezionare solo le dipendenze transitive necessarie alla radice del candidato e garantire che ogni riferimento pubblicato abbia un releaseSelections esatto. Copiare il contenuto pubblicato, inviare solo un insieme di ID o estendere la selezione a tutte le risorse storiche non sostituisce la verifica delle dipendenze e delle origini correnti.

Figura A9: radice del candidato, dipendenze pubblicate esatte e autorizzazione delle origini. Schema della chiusura dei riferimenti.

Le query di queste action sono oggetti tipizzati con versione e non accettano SQL, ID di tabelle fisiche o nomi di tabelle di origine al posto dei riferimenti di business. I template di metadati e i risultati del grafo non hanno di per sé idoneità come riferimenti fattuali.

Capitolo 19

Delega di attività all'Agent dell'ontologia

Riprendere il lavoro con attività persistenti e il Grant originale; non trattare le istruzioni dell'Agent come approvazioni umane.

dfc_ontology_agent viene mostrato solo quando il Pi Runtime effettivo e i permessi pertinenti sono disponibili. QUERY utilizza le capacità di lettura; AUTHORING richiede inoltre un ruolo di modellazione e lo scope authoring corrispondente. Non espone un altro motore di esecuzione privo di vincoli.

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

Set di parametri rigoroso

start utilizza contractVersion, action, ontologyId, mode, instruction, idempotencyKey; status/cancel utilizzano contractVersion, action, ontologyId, runId. Il server verifica l'insieme esatto dei campi per action. L'instruction ha al massimo 16000 caratteri; la chiave è composta da 1 a 128 caratteri supportati e inizia con una lettera o una cifra.

Ripristino e annullamento

  1. Conservare il runId originale, il Grant, il mode e la chiave di idempotenza.
  2. La stessa chiave con la stessa instruction ripristina lo stesso run, senza inviare un'altra attività; la stessa chiave con un'instruction diversa viene rifiutata.
  3. status interroga lo stato dell'attività originale. Anche al completamento occorre verificare le query sulle tabelle, le evidenze o le ricevute di pubblicazione.
  4. L'annullamento utilizza il runId originale; confermare l'esito con lo stato effettivo dell'attività.

Il completamento del run non è una ricevuta di pubblicazione del modello. L'attività di pubblicazione viene comunque confermata tramite lo stato dell'artifact originale e le verifiche delle origini; QUERY non comporta implicitamente diritti di scrittura o pubblicazione.

Capitolo 20

MCP dell'area di lavoro business

Interrogare i record in base ai contratti di business pubblicati ed eseguire i comandi tramite l'ActionPlan originale.

/mcp/business utilizza una protected resource separata e una propria selezione dei sistemi business; il Grant dell'ontologia non può essere riutilizzato al posto dell'autorizzazione business. Il sistema business deve essere pubblicato, invocabile dall'Agent e conforme alla policy di sicurezza originale, e l'utente corrente deve disporre di ruoli e capacità di runtime effettivi.

ScopeStrumentoConfini
business-system:discoverdfb_systems dfb_system_describeIndividua solo i sistemi inclusi in questa autorizzazione e attualmente invocabili
business-system:readdfb_query dfb_record dfb_work_items dfb_action_statusRecord leggibili dall'utente corrente e i suoi piani
business-system:plandfb_action_planCrea solo piani immutabili, senza eseguirli
business-system:executedfb_action_executeAutorizzazione esplicita separata; esecuzione in base a rischio e approvazione
  1. dfb_systems individua i sistemi autorizzati.
  2. dfb_system_describe legge il contratto pubblicato corrente, releaseId e tutti gli hash, le query e i comandi.
  3. dfb_query utilizza il queryKey pubblicato, specificando all'occorrenza objectKey, state, page e pageSize. Non è SQL arbitrario.
  4. dfb_record e dfb_work_items leggono i record e le attività in sospeso attualmente consentiti.
  5. Prima dell'esecuzione, fornire con dfb_action_plan i valori effettivi di releaseId, releaseHash, canonicalIrHash, agentManifestHash, commandType, planIdempotencyKey e il payload del contratto.
  6. Verificare riskClass, requiresApproval e status; quando sono coinvolti record di destinazione, conservare expectedRecordVersion.
  7. dfb_action_execute esegue solo piani pronti appartenenti alla connessione corrente; i token per le approvazioni umane richieste sono emessi da DataFocus.
  8. In caso di errore o timeout, dfb_action_status recupera lo stato del piano originale; i retry mantengono la semantica di idempotenza originale.
Figura A10: contratti pubblicati, piani, approvazioni ed esecuzione delle azioni. Schema illustrativo.

Binding di connessione e versione

I piani sono vincolati all'ID di isolamento stabile del Grant corrente. Dopo il refresh dell'access token è ancora possibile elaborare i piani della stessa connessione; un'altra connessione OAuth non può subentrare. All'esecuzione vengono verificati nuovamente la versione pubblicata, gli hash IR/manifest, la versione del record di destinazione, la scadenza del piano, l'idempotenza e l'approvazione. L'allowlist di OAuth non consente di aggirare la governance di business.

Capitolo 21

Input di conoscenza di business e domande da confermare

Registrare gli input di business quando il processore di produzione corrispondente è disponibile, mantenendo i confini di conferma umana.

I seguenti quattro strumenti vengono aggiunti dal controller pubblico MCP in base ai processori installati e agli scope correnti. Non compaiono sempre nel catalogo di base. La presenza di uno Schema dichiarato non implica che l'istanza disponga di tutti i processori, budget o permessi necessari; verificare prima tools/list.

StrumentoFinalitàAutorizzazioni o effetti non prodotti
dfc_ontology_knowledge_input_proposeRegistra gli input di business originali per un workspace esistenteNon genera domande di conferma, non approva, non pubblica
dfc_ontology_knowledge_input_previewGenera un'anteprima temporanea delle bozze di domande dall'input originaleNon salva in modo persistente, non conferma, non genera ricevute di produzione
dfc_ontology_knowledge_question_submitSalva domande authored e non confermateNon unisce automaticamente le risposte, non acquisisce permessi di responsabilità né diritti di pubblicazione
dfc_ontology_business_scope_initializeInizializza esplicitamente un ambito consumer per un sistema businessNon pubblica, non attiva, non concede accesso alle origini

Input e anteprima

  1. Ottenere workspaceId, workspaceRevision, localRef e preparationDigest dalla preparazione effettiva.
  2. propose registra gli input di business usando il contratto input originale e un idempotencyKey stabile; alla stessa chiave può corrispondere solo lo stesso input.
  3. preview usa la chiave di idempotenza e l'ontologyId dell'input originale; restituisce ogni volta una revision lato server e una finestra di 60 secondi; non è una ricevuta idempotente di completamento in produzione.
  4. Per archiviare una domanda, question_submit usa una nuova chiave di comando, l'originalInputKey originale, un questionRevision, validFrom, validUntil e expectedRevision espliciti; alla creazione expectedRevision è null.

Punto di ingresso per la conferma umana

La knowledgeConfirmationPage restituita da question_submit è solo un riferimento relativo alla pagina di login originale, con precompilazione di una domanda. Non contiene Bearer, non apre automaticamente la pagina e non conferma la conoscenza. QUESTION_STORED_UNCONFIRMED indica esplicitamente che la conferma non è ancora avvenuta; nelle risposte non si deve scrivere “la conoscenza è stata pubblicata”.

Inizializzazione dell'ambito consumer

business scope initialize richiede contemporaneamente il diritto di pubblicazione dell'ontologia e il ruolo di creatore del sistema di business esatto o permessi di amministrazione SourceManager. Usa le coordinate reali di domainRid, domainRevisionId e businessSystemId; il client non può inserire a piacere consumerScope o attestazioni di completamento. Anche quando restituisce INITIALIZED e COMPLETED, la risposta riporta comunque esplicitamente published=false e activationAuthorized=false.

Queste richieste sono inoltre soggette a rigorosi controlli di JSON, insieme di campi, byte e profondità. Il limite per le richieste in input è 1 MiB; alcune operazioni specifiche hanno limiti inferiori. Gli Schema completi di input e output sono forniti con il riferimento agli strumenti; la logica permissiva dei parametri dei wrapper MCP generici non può essere applicata a questi contratti rigorosi.

Capitolo 22

Risposta, errori e retry sicuri

Interpretare gli errori per livelli, mantenendo le coordinate dell'attività e la semantica di idempotenza.

LivelloContenuto da verificarePrincipio di gestione
Rete e HTTPConnessione, TLS, 401, 403, 400, 404, 405 ecc.Non trattare una risposta di errore come un normale risultato di query
JSON-RPCerror.code message dataDistinguere problemi di protocollo, metodo, parametri e autorizzazione
Strumento MCPresult.isError e structuredContentHTTP 200 può comunque indicare un errore
Risultato di businessStato reale, completezza, causa dell'errore, nextActionRicevuto o pronto non equivale a completato
Idoneità fattualeexecutionReceipt citationEligible contentCompleteI contenuti senza idoneità servono solo a localizzare o spiegare le lacune

Casi comuni di stato HTTP

  • 401: Bearer mancante o non valido; eseguire il refresh o ripetere l'autorizzazione secondo il flusso OAuth corrente.
  • 403: Grant, ruolo, risorsa selezionata, permessi sull'origine, Origin o configurazione non soddisfatti; non tentare di aggirarli ripetendo la richiesta.
  • 400: messaggio o contratto versionato non valido, inclusi header moderni incoerenti con i metadati.
  • 404: verificare il percorso esatto del servizio, il metodo di protocollo e le capacità di runtime; non sostituire casualmente l'ID dell'ontologia.
  • 405: GET e DELETE non sono previsti per il /mcp pubblico; usare il POST corretto anziché aprire una connessione SSE persistente.

Operazioni di scrittura con esito incerto

MCP_OPERATION_OUTCOME_UNKNOWN può contenere outcome=UNKNOWN, retryable=false, nextAction=READ_ORIGINAL_STATUS, recoveryTool e i parametri di localizzazione originali. Verificare prima lo stato originale, poi recuperare la richiesta originale. Non reinviare il candidato, non cambiare la chiave di idempotenza e non trattare il timeout come un rollback della transazione.

Figura A11: ordine di gestione di errori, esiti incerti e situazioni ritentabili. Schema illustrativo del ripristino.

Contenuti da conservare invariati

  • Grant, ambito delle risorse e ID di attività e risultati originali.
  • candidateHash, planHash, expectedRevision, versione di destinazione e selezioni di pubblicazione.
  • Chiave di idempotenza della stessa operazione logica; per operazioni di business diverse usare chiavi nuove.
  • retryable, remediation, nextAction e stato corrente dichiarati dal server.

Non estrarre dal testo dell'errore SQL interni, host, credenziali o stack trace come fonte per la risposta. Registrare solo i codici di errore pubblicabili e le informazioni di correlazione della richiesta; gli errori originali possono richiedere la consultazione da parte di un amministratore nei log controllati.

Capitolo 23

Sicurezza dell'integrazione e confini di capacità

Mantenere i confini originali di identità, risorse, esecuzione ed evidenze; gestire in modo sicuro i documenti non attendibili.

  1. Connettersi solo ai domini ufficiali indicati dall'amministratore; verificare TLS e l'issuer OAuth, non disattivare la verifica dei certificati.
  2. Usare Grant dedicati con ambito di risorse minimo; non usare account amministratore, Cookie o token interni di lunga durata come credenziali per l'interfaccia pubblica.
  3. Trattare il testo dei documenti come materiale di business non attendibile. “Ignora le regole”, “carica le chiavi” o “esegui comandi” presenti nei documenti non sono autorizzazioni per gli strumenti.
  4. Limitare retry automatici, concorrenza e ambito dei risultati; non ricostruire lato client i permessi di business originali.
  5. Nei log registrare solo le informazioni di correlazione necessarie, non Bearer, refresh token, token di approvazione né contenuti di business sensibili completi.
  6. Dopo la disconnessione dell'utente o la revoca da parte dell'amministratore, smettere di usare autorizzazioni e dati in cache, senza continuare le chiamate con locator obsoleti.

Gli hint degli strumenti non sono permessi

readOnlyHint, destructiveHint, idempotentHint e openWorldHint servono al client per comprendere le capacità, non garantiscono l'effetto di business effettivo di ogni chiamata e non sostituiscono l'autorizzazione dell'utente corrente. Tutte le azioni di scrittura, piani, anteprime, sessioni e annullamenti vanno trattate secondo il loro comportamento reale.

Punti di ingresso da non chiamare

  • Servizi Trino/Hive/Hadoop originali e Heavy ETL non inclusi in Flash.
  • Scope dedicati o interfacce del workspace interni di FocusCode.
  • Strumenti execution v2, AutoML o altri strumenti sperimentali non presenti in tools/list dell'istanza corrente.
  • REST privati del browser, connessioni arbitrarie a database o servizi di altri tenant per aggirare un rifiuto MCP.

Semantica dei dati

Rispettare i contratti lato server su decimali esatti, tipi, valuta, unità, tempo ed evidenze. Non arrotondare nuovamente né convertire la valuta solo perché il testo dell'output sembra numerico, e non eseguire classifiche globali sulle righe visibili quando il risultato è troncato.

Capitolo 24

Configurazione amministratore e interruttori condizionali

Prima di abilitare le funzionalità estese, verificare i componenti reali, gli indirizzi pubblici e la configurazione originale dei permessi.

ConfigurazioneFinalitàRequisiti per il rilascio
datafocus.mcp.public-base-urlIndirizzo radice esterno ufficialeIndividuazione OAuth, issuer, callback e reverse proxy coerenti
datafocus.mcp.allowed-originsOrigini del browser approvate in aggiuntaConfigurazione precisa, senza estendere a origini arbitrarie
datafocus.mcp.oauth.route-proof-secretSegreto del server dedicato all'attestazione del routing nel grafoConservazione separata, senza usare Bearer come chiave
datafocus.mcp.analysis.tools.enabledStrumenti di analisi interattivaServizi dati, conoscenza e permessi collegati realmente disponibili
datafocus.mcp.analysis.report-tools.enabledStrumenti di report persistentiStorage collegato, worker e catena di ripristino disponibili
datafocus.mcp.analysis.apps.enabledVisualizzazione MCP AppsDichiarazione di supporto lato client e verifica del _meta restituito
datafocus.mcp.authoring.enabledContratti di bozza e modellazioneConservazione dei permessi originali di amministratore e risorse
datafocus.mcp.authoring.apply-enabledCapacità di applicazione degli artifactPiani immutabili, approvazione originale e nuova verifica dello stato corrente
datafocus.mcp.ontology-published-query-enabledModelli e query pubblicatiVersioni realmente sottoposte a commit e autorizzazione delle origini
datafocus.mcp.ontology-candidate-query-enabledQuery strutturate sui candidatiProprietà del candidato, versione esatta e diritti di lettura
datafocus.mcp.authoring.ontology-auto-publication-enabledAutorizzazioni per la delega di pubblicazione automaticaPolicy originale valida, fiducia nella chiave pubblica, budget e diritto di pubblicazione

Questi nomi derivano dalla configurazione e dall'implementazione di r56; la possibilità di attivazione dipende dai servizi collegati e dai gate originali di messa in produzione. Cambiare solo valori booleani non supplisce a processori, database, budget di verifica o policy mancanti. La visibilità delle estensioni di input di conoscenza e delle attività Pi dipende dai componenti effettivamente installati.

Proxy perimetrale

Conservare Authorization, Content-Type, MCP-Protocol-Version, Mcp-Method, Mcp-Name e le Origin approvate. Impostare corpo della richiesta, timeout e TLS secondo i requisiti effettivi del servizio; non inoltrare il /mcp pubblico alla porta di amministrazione o a un altro prodotto.

Verifica di messa in produzione

  • Gli stati dell'individuazione anonima e delle chiamate protette sono conformi alle attese.
  • Gli utenti normali individuano solo il proprio ambito autorizzato; dopo la revoca le richieste successive vengono rifiutate.
  • Sessioni native Search, SQL, testo originale e report opzionali hanno ciascuno risultati reali.
  • Approvazioni per scrittura e pubblicazione e ripristino idempotente mantengono il comportamento originale.
  • Log e documentazione pubblica non contengono chiavi private, Token, Cookie, password o dati interni dei clienti.
Capitolo 25

Client eseguibile ed esempi di chiamata

Usare il client minimo allegato per verificare i messaggi, senza aggirare OAuth o l'autorizzazione corrente.

examples/flash_mcp.py è un client di protocollo minimo che dipende solo dalla libreria standard Python. Non effettua login, non approva per conto dell'utente, non chiama automaticamente strumenti non visibili; supporta protocolli moderni e legacy ed esce con codici distinti per livello: HTTP, JSON-RPC ed errori degli strumenti. Il token viene passato tramite l'ambiente del processo, senza essere scritto in script o file di documentazione.

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

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

unset FLASH_ACCESS_TOKEN

Lettura e query

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

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

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

Sostituire prima i segnaposto come ONTOLOGY_ID e TABLE_RESOURCE_ID nel file di richiesta con i valori reali restituiti dall'autorizzazione corrente. Il client rifiuta l'esecuzione in presenza di segnaposto. L'esempio SQL richiede che il CSV allegato sia stato importato con i nomi di colonna originali; senza lo schema corrispondente non può essere inviato direttamente.

Altri scenari

  • Accesso business: usare --endpoint business per ottenere nuovamente un Grant relativo a /mcp/business.
  • Client legacy: selezionare --protocol 2025-11-25, eseguire prima initialize e poi effettuare le chiamate secondo lo stesso protocollo.
  • Istruzioni integrate: usare resources o read-resource per leggere l'URI effettivo.
  • Autotest offline: --self-test verifica la costruzione degli header moderni e dei metadati, senza necessità di Token e senza interpellare il server del prodotto.

Limiti degli esempi

Il client è un punto di partenza per l'integrazione del protocollo: non genera automaticamente candidati di modellazione, non salva domande e risposte e non esegue pubblicazioni. Restituisce il JSON originale affinché l'Agent di livello superiore possa verificare lo stato del business; non promettere all'utente il completamento di query, report o pubblicazioni basandosi solo sul codice di uscita del processo.

Capitolo 26

Incorporare l'interfaccia di dialogo dell'ontologia

Incorporare la pagina di dialogo per utenti umani nel frontend business, mantenendo il login e i confini di sicurezza del browser.

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

10001 è un ID tenant di esempio e 1001 è un ID ontologia di esempio; all'uso vanno sostituiti con coordinate reali per le quali si possiedono i permessi. Una singola ontologia può essere specificata tramite path o una query supportata; la modalità all fornisce @ per selezionare le ontologie accessibili all'utente corrente. skillId viene solo inoltrato: non se ne può dedurre che l'orchestrazione delle skill sia già eseguibile.

Autenticazione e dominio

La pagina incorporata si basa su uno stato di login DataFocus reale e verifica /uc/status. I cookie cross-site, SSO, il frame-ancestors di CSP e la configurazione del gateway influiscono tutti sull'incorporamento. Non accetta l'inserimento di un Bearer MCP in URL come canale di accesso senza login; i link esterni outside, non implementati, non vanno costruiti autonomamente sulla base delle proposte di design.

Differenza tra MCP e iframe

ModalitàUtenteIdentità e risultato
Remote MCPIntegrazione di Agent o servizi esterniGrant OAuth e ricevute strutturate degli strumenti
Iframe di dialogo dell'ontologiaUtente finale umanoStato di login originale e interfaccia di dialogo
MCP AppsClient MCP con supporto per estensioniRisorse controllate e risultati degli strumenti correnti, non un sostituto pubblico del login via iframe
Capitolo 27

Elenco di verifica per l'accettazione dell'integrazione

Dimostrare l'intera catena business su un'istanza reale, senza limitarsi a confermare che le API restituiscano 200.

  1. Individuazione: ottenere le versioni effettivamente supportate, il catalogo degli strumenti corrente e le risorse integrate.
  2. Autorizzazione: gli utenti normali vedono solo le ontologie e i sistemi business autorizzati; le operazioni senza scope vengono rifiutate.
  3. Struttura delle tabelle: nomi visualizzati reali, colonne, tipi e permessi completi.
  4. SQL: verifiche su dimensione singola, più dimensioni, JOIN, date, TopN e troncamento conformi ai criteri business effettivi.
  5. Conoscenza: localizzazione, testo originale completo e idoneità come riferimento fattuale coerenti; le domande miste devono avere fondamenti sia nei dati sia nei documenti.
  6. Search: superati i controlli su modello, init, suggerimenti, risultati, chiusura e completezza del buffer.
  7. Analisi e report opzionali: stati reali di più rami, paginazione, modifiche ai permessi e annullamento mantengono il comportamento originale.
  8. Modellazione opzionale: verifica per fasi di candidati, piani, approvazione originale, applicazione effettiva e query di versione.
  9. Azioni business: verifica di hash di pubblicazione, versione di destinazione, approvazione, idempotenza e isolamento tra Grant.
  10. Ripristino: dopo un timeout di rete si recupera lo stato dell'operazione originale; dopo l'aggiornamento della fonte la vecchia localizzazione perde validità e si usa una nuova query.

Registrazione dei risultati

Registrare la versione dell'istanza, il ruolo dell'utente, l'ambito del Grant, la versione della configurazione, le operazioni reali e i risultati. Contrassegnare separatamente: l'autotest offline del client di protocollo, i valori attesi offline del CSV di esempio, la validazione statica dello Schema JSON e la vera accettazione funzionale online. Non estrapolare il superamento di una fase al superamento dell'intero prodotto.

Capitolo 28

Risorse di riferimento e manutenzione

Utilizzare gli Schema completi degli strumenti forniti con il manuale, mantenendoli sincronizzati con i risultati effettivi di individuazione dell'istanza.

RisorseContenuto
reference/mcp-tool-catalog.json32 Schema di input dichiarati lato ontologia e 8 lato business; alcuni strumenti includono lo Schema di output originale
reference/locales.json21 opzioni selezionabili, 24 locale compatibili e terminologia della UI
reference/search-keywords.json17 cataloghi statici di parole chiave con locale esplicito
reference/analysis-contract-manifest.jsonVincoli di versione relativi ad analisi, rami, fatti, ricevute e report
examples/CSV sintetico, note sui criteri di calcolo, Top3 SQL, risultati attesi e client di protocollo minimo

Risorse di documentazione integrate

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

resources/list e resources/read richiedono che l'utente corrente soddisfi almeno uno dei requisiti di lettura corrispondenti: metadata, search operate o etl operate. La documentazione ETL è un riferimento statico trasversale ai prodotti; le capacità eseguibili di Flash restano limitate a quanto Flash dichiara esplicitamente.

Riferimenti al protocollo esterno

Per il protocollo MCP e il contesto di autorizzazione fare riferimento alle specifiche ufficiali: https://modelcontextprotocol.io/specification/2026-07-28/basic e https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization. Per endpoint, strumenti e comportamenti condizionali di questo prodotto fanno fede l'implementazione di r56 e i risultati di individuazione dell'istanza corrente; il supporto generico del protocollo non va equiparato alla disponibilità sul server di tutte le funzionalità opzionali.

Aggiornamento e manutenzione

A ogni aggiornamento eseguire nuovamente l'individuazione di strumenti e versioni, confrontando gli Schema di input, i contratti di output e le configurazioni; i Grant precedenti non acquisiscono automaticamente i nuovi scope. Mantenere riferimenti, cache e ricevute vincolati alla versione di origine; dopo aver confermato modifiche incompatibili, riottenere il contesto e non forzare l'uso di vecchie localizzazioni su nuovi stati business.

Capitolo 29

Riferimento dei parametri degli strumenti: base e Search nativo

Nomi completi e campi di input, consultabili per strumento.

Le tabelle seguenti sono un riferimento di lettura per i campi di input degli strumenti r56 correnti. Per i tipi nidificati completi, oneOf, i campi obbligatori condizionali, i vincoli di pattern e alcuni Schema di output vedere reference/mcp-tool-catalog.json; prima dell'invio finale è comunque necessario leggere il tools/list del Grant corrente. L'indicazione “opzionale” nella tabella non elimina i requisiti di validazione interna dell'azione.

dfc_manual

ParametroTipoRequisitoSignificato e ambito
namesarrayOpzionale o condizionalmente obbligatorioNomi espliciti da cercare, massimo 32 per singola chiamata. maxItems: 32
actionstringOpzionale o condizionalmente obbligatorioNome dell'operazione. Usare secondo l'enumerazione corrente e i parametri corrispondenti all'azione. enum: list, read, keywords, functions, etl_requests
localestringOpzionale o condizionalmente obbligatorioLocale esplicito del catalogo di riferimento statico, non la lingua predefinita delle query.
uristringOpzionale o condizionalmente obbligatorioURI delle risorse integrate elencate dallo strumento corrente. enum: datafocus://manuals/etl-formulas/v1, datafocus://manuals/search-keyword-queries/v1, datafocus://manuals/etl-functions/v1, datafocus://manuals/search-keywords/v1

dfc_search

ParametroTipoRequisitoSignificato e ambito
dataobjectOpzionale o condizionalmente obbligatorioPayload dell'azione originale; fare riferimento all'individuazione delle capacità e alle tabelle dei campi delle azioni.
actionstringObbligatorioNome dell'operazione. Usare secondo l'enumerazione corrente e i parametri corrispondenti all'azione. enum: capabilities, model_create, model_read, open, request, poll, cancel, close

dfc_etl

ParametroTipoRequisitoSignificato e ambito
dataobjectOpzionale o condizionalmente obbligatorioPayload dell'azione originale; fare riferimento all'individuazione delle capacità e alle tabelle dei campi delle azioni.
actionstringObbligatorioNome dell'operazione. Usare secondo l'enumerazione corrente e i parametri corrispondenti all'azione. enum: capabilities

dfc_ontologies

ParametroTipoRequisitoSignificato e ambito
pageSizeintegerOpzionale o condizionalmente obbligatorioNumero di elementi per pagina; entro il limite massimo dello Schema. minimum: 1; maximum: 100
pageintegerOpzionale o condizionalmente obbligatorioNumero di pagina, a partire da 1. minimum: 1

dfc_ontology_resources

ParametroTipoRequisitoSignificato e ambito
resourceTypesarrayOpzionale o condizionalmente obbligatorioInsieme dei tipi di risorse da restituire.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
pageSizeintegerOpzionale o condizionalmente obbligatorioNumero di elementi per pagina; entro il limite massimo dello Schema. minimum: 1; maximum: 100
pageintegerOpzionale o condizionalmente obbligatorioNumero di pagina, a partire da 1. minimum: 1
Capitolo 30

Riferimento dei parametri degli strumenti: tabelle, grafo e conoscenza

Nomi completi e campi di input, consultabili per strumento.

Le tabelle seguenti sono un riferimento di lettura per i campi di input degli strumenti r56 correnti. Per i tipi nidificati completi, oneOf, i campi obbligatori condizionali, i vincoli di pattern e alcuni Schema di output vedere reference/mcp-tool-catalog.json; prima dell'invio finale è comunque necessario leggere il tools/list del Grant corrente. L'indicazione “opzionale” nella tabella non elimina i requisiti di validazione interna dell'azione.

dfc_ontology_graph

ParametroTipoRequisitoSignificato e ambito
relationTypesarrayOpzionale o condizionalmente obbligatorioFiltro per tipo di relazione.
depthintegerOpzionale o condizionalmente obbligatorioProfondità di attraversamento dei vicini. minimum: 1; maximum: 3
sourceTypesarrayOpzionale o condizionalmente obbligatorioFiltro per tipo di origine.
queryobjectOpzionale o condizionalmente obbligatorioTesto della query, oppure oggetto di query esatto e versionato corrispondente all'azione.
limitintegerOpzionale o condizionalmente obbligatorioLimite superiore del numero di risultati restituiti. minimum: 1; maximum: 100
actionstringObbligatorioNome dell'operazione. Usare secondo l'enumerazione corrente e i parametri corrispondenti all'azione. enum: search, neighbors, published_model, published_query, candidate_query
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
nodeKeystringOpzionale o condizionalmente obbligatorioChiave del nodo copiata dai risultati effettivi del grafo.
keywordstringOpzionale o condizionalmente obbligatorioParola chiave per la localizzazione nel grafo, non sintassi delle query per parole chiave.
nodeTypesarrayOpzionale o condizionalmente obbligatorioFiltro per tipo di nodo.

dfc_ontology_query

ParametroTipoRequisitoSignificato e ambito
routeLocatorsarrayOpzionale o condizionalmente obbligatorioLocalizzazioni di instradamento tipizzate emesse dal server, da copiare integralmente. maxItems: 20
topKintegerOpzionale o condizionalmente obbligatorioLimite superiore dei candidati richiamati; non dimostra una copertura completa. minimum: 1; maximum: 20
queryModestringOpzionale o condizionalmente obbligatorioSelezionare la modalità di ricerca delle evidenze secondo l'enumerazione dello strumento. enum: vector, hybrid, graph
fanoutPlanobjectOpzionale o condizionalmente obbligatorioPiano vincolato di retrieval per rami, secondo lo Schema nidificato.
structuredPlanobjectOpzionale o condizionalmente obbligatorioPiano vincolato al contratto del server per tabelle complete nei documenti; non è SQL.
knowledgeIdsarrayOpzionale o condizionalmente obbligatorioID di knowledge base presente nel knowledgeBindings effettivo.
querystringObbligatorioTesto della query, oppure oggetto di query esatto e versionato corrispondente all'azione.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.

dfc_knowledge_search

ParametroTipoRequisitoSignificato e ambito
topKintegerOpzionale o condizionalmente obbligatorioLimite superiore dei candidati richiamati; non dimostra una copertura completa. minimum: 1; maximum: 20
minScorenumberOpzionale o condizionalmente obbligatorioPunteggio minimo di corrispondenza. minimum: 0; maximum: 1
knowledgeIdsarrayOpzionale o condizionalmente obbligatorioID di knowledge base presente nel knowledgeBindings effettivo.
querystringObbligatorioTesto della query, oppure oggetto di query esatto e versionato corrispondente all'azione.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
assetIdsarrayOpzionale o condizionalmente obbligatorioID degli asset documentali attualmente consentiti.
retrievalStrategystringOpzionale o condizionalmente obbligatorioStrategia di retrieval effettivamente supportata. enum: auto, hybrid_stage2

dfc_knowledge_detail

ParametroTipoRequisitoSignificato e ambito
qdrantIdstring / integerOpzionale o condizionalmente obbligatorioIdentificativo dell'indice restituito dalla localizzazione effettiva.
pageNointegerOpzionale o condizionalmente obbligatorioNumero della pagina effettiva o della pagina di paginazione.
evidenceIdstringOpzionale o condizionalmente obbligatorioID dell'evidenza restituito dalla stessa localizzazione nella conoscenza.
actionstringObbligatorioNome dell'operazione. Usare secondo l'enumerazione corrente e i parametri corrispondenti all'azione. enum: chunk, document, page_context
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
documentIdstring / integerOpzionale o condizionalmente obbligatorioID del documento della stessa localizzazione.
radiusintegerOpzionale o condizionalmente obbligatorioIntervallo di pagine adiacenti. minimum: 0; maximum: 3
chunkIdstringOpzionale o condizionalmente obbligatorioID effettivo del chunk della stessa localizzazione.

dfc_table

ParametroTipoRequisitoSignificato e ambito
maxRowsintegerOpzionale o condizionalmente obbligatorioLimite superiore delle righe restituite; non è un intervallo di classificazione lato client. minimum: 1; maximum: 200
actionstringObbligatorioNome dell'operazione. Usare secondo l'enumerazione corrente e i parametri corrispondenti all'azione. enum: detail, query
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
idstringOpzionale o condizionalmente obbligatorioID reale della risorsa tabella, non il nome fisico o il nome visualizzato.
sqlstringOpzionale o condizionalmente obbligatorioSingola istruzione Doris SQL di sola lettura nell'ambito dell'ontologia, con colonne di output esplicite.
Capitolo 31

Riferimento dei parametri degli strumenti: analisi e report

Nomi completi e campi di input, consultabili per strumento.

Le tabelle seguenti sono un riferimento di lettura per i campi di input degli strumenti r56 correnti. Per i tipi nidificati completi, oneOf, i campi obbligatori condizionali, i vincoli di pattern e alcuni Schema di output vedere reference/mcp-tool-catalog.json; prima dell'invio finale è comunque necessario leggere il tools/list del Grant corrente. L'indicazione “opzionale” nella tabella non elimina i requisiti di validazione interna dell'azione.

dfc_analysis_ask

ParametroTipoRequisitoSignificato e ambito
questionstringObbligatorioDomanda in linguaggio naturale o domanda di follow-up compatibile.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
languagestringOpzionale o condizionalmente obbligatorioLocale esplicito per la risposta o la query; in caso di omissione valgono le regole dello strumento corrispondente.
sessionIdstringOpzionale o condizionalmente obbligatorioRiferimento reale alla sessione nello stesso Grant.

dfc_analysis_refine

ParametroTipoRequisitoSignificato e ambito
branchIdstringOpzionale o condizionalmente obbligatorioRiferimento al ramo strutturato emesso dal server.
resultIdstringObbligatorioRiferimento al risultato di analisi restituito in precedenza.
questionstringOpzionale o condizionalmente obbligatorioDomanda in linguaggio naturale o domanda di follow-up compatibile.
idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica.
changeobjectOpzionale o condizionalmente obbligatorioModifica in linguaggio naturale oppure filter_patch tipizzato.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
languagestringOpzionale o condizionalmente obbligatorioLocale esplicito per la risposta o la query; in caso di omissione valgono le regole dello strumento corrispondente.
sessionIdstringObbligatorioRiferimento reale alla sessione nello stesso Grant.
expectedRevisionintegerObbligatorioPrecondizione sulla versione del risultato originale o dell'intestazione business; può essere null alla creazione della domanda. minimum: 1
visualIdstringOpzionale o condizionalmente obbligatorioRiferimento alla visualizzazione, vincolato al ramo.

dfc_analysis_page

ParametroTipoRequisitoSignificato e ambito
branchIdstringObbligatorioRiferimento al ramo strutturato emesso dal server.
resultIdstringObbligatorioRiferimento al risultato di analisi restituito in precedenza.
pageNointegerObbligatorioNumero della pagina effettiva o della pagina di paginazione. minimum: 1; maximum: 10000
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
pageSizeintegerObbligatorioNumero di elementi per pagina; entro il limite massimo dello Schema. minimum: 1; maximum: 100
sessionIdstringObbligatorioRiferimento reale alla sessione nello stesso Grant.
expectedRevisionintegerObbligatorioPrecondizione sulla versione del risultato originale o dell'intestazione business; può essere null alla creazione della domanda. minimum: 1

dfc_analysis_result_get

ParametroTipoRequisitoSignificato e ambito
resultIdstringObbligatorioRiferimento al risultato di analisi restituito in precedenza.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
sessionIdstringObbligatorioRiferimento reale alla sessione nello stesso Grant.

dfc_analysis_cancel

ParametroTipoRequisitoSignificato e ambito
resultIdstringObbligatorioRiferimento al risultato di analisi restituito in precedenza.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
sessionIdstringObbligatorioRiferimento reale alla sessione nello stesso Grant.

dfc_analysis_close

ParametroTipoRequisitoSignificato e ambito
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
sessionIdstringObbligatorioRiferimento reale alla sessione nello stesso Grant.

dfc_report_create

ParametroTipoRequisitoSignificato e ambito
goalstringObbligatorioObiettivo analitico del report.
idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
languagestringOpzionale o condizionalmente obbligatorioLocale esplicito per la risposta o la query; in caso di omissione valgono le regole dello strumento corrispondente.
titlestringOpzionale o condizionalmente obbligatorioTitolo facoltativo del report.

dfc_report_status

ParametroTipoRequisitoSignificato e ambito
reportIdstringObbligatorioRiferimento persistente al report nel Grant corrente.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.

dfc_report_cancel

ParametroTipoRequisitoSignificato e ambito
reportIdstringObbligatorioRiferimento persistente al report nel Grant corrente.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
Capitolo 32

Riferimento dei parametri degli strumenti: modellazione e attività originali

Nomi completi e campi di input, consultabili per strumento.

Le tabelle seguenti sono un riferimento di lettura per i campi di input degli strumenti r56 correnti. Per i tipi nidificati completi, oneOf, i campi obbligatori condizionali, i vincoli di pattern e alcuni Schema di output vedere reference/mcp-tool-catalog.json; prima dell'invio finale è comunque necessario leggere il tools/list del Grant corrente. L'indicazione “opzionale” nella tabella non elimina i requisiti di validazione interna dell'azione.

dfc_ontology_agent

ParametroTipoRequisitoSignificato e ambito
modestringOpzionale o condizionalmente obbligatorioQUERY o AUTHORING; ciascuna capacità è autorizzata separatamente. enum: QUERY, AUTHORING
instructionstringOpzionale o condizionalmente obbligatorioTesto della richiesta dell'utente; deve restare identico tra context e submit. maxLength: 16000
idempotencyKeystringOpzionale o condizionalmente obbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica. maxLength: 128
actionstringObbligatorioNome dell'operazione. Usare secondo l'enumerazione corrente e i parametri corrispondenti all'azione. enum: start, status, cancel
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
runIdstringOpzionale o condizionalmente obbligatorioID dell'attività originale per la stessa ontologia e lo stesso Grant.
contractVersionstringObbligatorioDeve essere utilizzata la versione esatta del contratto effettivamente supportata. enum: ontology-agent-task-v1

dfc_authoring_capabilities

L'oggetto radice di input di questo strumento non ha campi; utilizzare un oggetto arguments vuoto.

dfc_artifact_context

ParametroTipoRequisitoSignificato e ambito
artifactTypestringObbligatorioTipo di artifact o di pubblicazione dell'ontologia effettivamente abilitato. enum: CONTROL_PANEL_SPEC, VIEW_SPEC
scopeTypestringOpzionale o condizionalmente obbligatorioTipo di ambito delle risorse nel contratto artifact effettivo.
ontologyIdstringOpzionale o condizionalmente obbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
projectIdstringOpzionale o condizionalmente obbligatorioID del progetto autorizzato corrente.
artifactIdstringOpzionale o condizionalmente obbligatorioID reale dell'artifact esistente da modificare.
instructionstringObbligatorioTesto della richiesta dell'utente; deve restare identico tra context e submit.
variablesobjectOpzionale o condizionalmente obbligatorioOggetto delle variabili fornito in base al contratto restituito.
previewInputobjectOpzionale o condizionalmente obbligatorioInput di anteprima delimitato fornito in base al contratto.
viewportobjectOpzionale o condizionalmente obbligatorioViewport di visualizzazione richiesto dal contratto originale.

dfc_ontology_table_schema

ParametroTipoRequisitoSignificato e ambito
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
sourceAssetRefstringObbligatorioRiferimento a un asset strutturato registrato, ad esempio table:123.
fieldsarrayObbligatorioCampi della sorgente corrente con eventuali dichiarazioni esplicite dei tipi. minItems: 1; maxItems: 64

dfc_artifact_preview

ParametroTipoRequisitoSignificato e ambito
proposalIdstringObbligatorioID del candidato originale creato con il Grant corrente.
candidateHashstringObbligatorioHash esatto del candidato originale lato server.
previewInputobjectObbligatorioInput di anteprima delimitato fornito in base al contratto.

dfc_artifact_status

ParametroTipoRequisitoSignificato e ambito
proposalIdstringOpzionale o condizionalmente obbligatorioID del candidato originale creato con il Grant corrente.
planIdstringOpzionale o condizionalmente obbligatorioID del piano di applicazione immutabile.

dfc_artifact_plan

ParametroTipoRequisitoSignificato e ambito
proposalIdstringObbligatorioID del candidato originale creato con il Grant corrente.
candidateHashstringObbligatorioHash esatto del candidato originale lato server.
expectedTargetVersionintegerObbligatorioPrecondizione della versione di destinazione reale corrente. minimum: 0
idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica.

dfc_artifact_apply

ParametroTipoRequisitoSignificato e ambito
planIdstringObbligatorioID del piano di applicazione immutabile.
planHashstringObbligatorioHash restituito dal piano originale.
approvalTokenstringObbligatorioMateriale di approvazione emesso dal server originale; vietato generarlo autonomamente.
idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica.

dfc_artifact_submit

ParametroTipoRequisitoSignificato e ambito
config1 / artifactTypestringObbligatorioTipo di artifact o di pubblicazione dell'ontologia effettivamente abilitato. enum: CONTROL_PANEL_SPEC, VIEW_SPEC
config1 / scopeTypestringOpzionale o condizionalmente obbligatorioTipo di ambito delle risorse nel contratto artifact effettivo.
config1 / ontologyIdstringOpzionale o condizionalmente obbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
config1 / projectIdstringOpzionale o condizionalmente obbligatorioID del progetto autorizzato corrente.
config1 / artifactIdstringOpzionale o condizionalmente obbligatorioID reale dell'artifact esistente da modificare.
config1 / instructionstringObbligatorioTesto della richiesta dell'utente; deve restare identico tra context e submit.
config1 / variablesobjectOpzionale o condizionalmente obbligatorioOggetto delle variabili fornito in base al contratto restituito.
config1 / previewInputobjectOpzionale o condizionalmente obbligatorioInput di anteprima delimitato fornito in base al contratto.
config1 / viewportobjectOpzionale o condizionalmente obbligatorioViewport di visualizzazione richiesto dal contratto originale.
config1 / contractVersionstringObbligatorioDeve essere utilizzata la versione esatta del contratto effettivamente supportata.
config1 / contextHashstringObbligatorioHash completo del contesto restituito da context.
config1 / baseArtifactHashstringObbligatorioHash dell'artifact di base restituito da context.
config1 / baseArtifactVersionintegerObbligatorioVersione di base restituita da context. minimum: 0
config1 / candidateobjectObbligatorioOggetto candidato conforme al contratto corrente restituito.
config1 / clientRequestIdstringObbligatorioChiave di idempotenza client utilizzata in modo stabile per la richiesta corrente del candidato.
config2 / artifactTypestringObbligatorioTipo di artifact o di pubblicazione dell'ontologia effettivamente abilitato. enum: ONTOLOGY_RELEASE
config2 / contractVersionstringObbligatorioDeve essere utilizzata la versione esatta del contratto effettivamente supportata. 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
config2 / ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
config2 / candidateHashstringObbligatorioHash esatto del candidato originale lato server.
config2 / workspaceIdstringObbligatorioCoordinate effettive del workspace del candidato.
config2 / workspaceRevisionstringObbligatorioVersione esatta del candidato, non latest.
config2 / releasesobjectObbligatorioSelezione di versioni esatte fornita in base al contratto di pubblicazione dell'ontologia.
config2 / selectionobjectObbligatorioSolo coordinate esplicite della selezione di business, non permessi né attestazioni di completamento.
config2 / idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica.
config3 / config1 / artifactTypestringObbligatorioTipo di artifact o di pubblicazione dell'ontologia effettivamente abilitato. enum: ONTOLOGY_RELEASE
config3 / config1 / contractVersionstringObbligatorioDeve essere utilizzata la versione esatta del contratto effettivamente supportata. enum: ontology-workspace-create-mcp-submit-v1
config3 / config1 / ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
config3 / config1 / workspaceIdstringObbligatorioCoordinate effettive del workspace del candidato.
config3 / config1 / resourcesarrayObbligatorioDichiarazioni del modello originale, compilate dal server. minItems: 1
config3 / config1 / idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica.
config3 / config2 / artifactTypestringObbligatorioTipo di artifact o di pubblicazione dell'ontologia effettivamente abilitato. enum: ONTOLOGY_RELEASE
config3 / config2 / contractVersionstringObbligatorioDeve essere utilizzata la versione esatta del contratto effettivamente supportata. enum: ontology-workspace-create-mcp-submit-v2
config3 / config2 / ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
config3 / config2 / workspaceIdstringObbligatorioCoordinate effettive del workspace del candidato.
config3 / config2 / resourcesarrayObbligatorioDichiarazioni del modello originale, compilate dal server. minItems: 1
config3 / config2 / idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica.
config3 / config2 / releaseSelectionsobjectObbligatorioreleaseId esatto di ogni riferimento pubblicato e chiusura delle dipendenze.
config4 / artifactTypestringObbligatorioTipo di artifact o di pubblicazione dell'ontologia effettivamente abilitato. enum: ONTOLOGY_RELEASE
config4 / contractVersionstringObbligatorioDeve essere utilizzata la versione esatta del contratto effettivamente supportata. enum: ontology-initial-activation-retirement-submit-v1
config4 / ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
config4 / domainRidstringObbligatorioRID reale del dominio di business.
config4 / consumerScopesarrayObbligatorioAmbiti consumer esatti consentiti dal server. minItems: 1; maxItems: 256
config4 / idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica.
Capitolo 33

Riferimento dei parametri degli strumenti: input di conoscenza e ambito

Nomi completi e campi di input, consultabili per strumento.

Le tabelle seguenti sono un riferimento di lettura per i campi di input degli strumenti r56 correnti. Per i tipi nidificati completi, oneOf, i campi obbligatori condizionali, i vincoli di pattern e alcuni Schema di output vedere reference/mcp-tool-catalog.json; prima dell'invio finale è comunque necessario leggere il tools/list del Grant corrente. L'indicazione “opzionale” nella tabella non elimina i requisiti di validazione interna dell'azione.

dfc_ontology_knowledge_input_propose

ParametroTipoRequisitoSignificato e ambito
requestobjectObbligatorioRichiesta originale di input di business; secondo lo Schema nidificato completo.
idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica. minLength: 1; maxLength: 128

Questo strumento dispone inoltre di un outputSchema nativo. Verificare la completezza dell'output, lo stato e i campi di autorizzazione esplicitamente impostati su false, senza attribuire di propria iniziativa un significato di completamento più ampio.

dfc_ontology_knowledge_input_preview

ParametroTipoRequisitoSignificato e ambito
idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica. minLength: 1; maxLength: 128
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.

Questo strumento dispone inoltre di un outputSchema nativo. Verificare la completezza dell'output, lo stato e i campi di autorizzazione esplicitamente impostati su false, senza attribuire di propria iniziativa un significato di completamento più ampio.

dfc_ontology_knowledge_question_submit

ParametroTipoRequisitoSignificato e ambito
questionRevision$refObbligatorioVersione esplicita della domanda da confermare in questa richiesta.
idempotencyKey$refObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica.
originalInputKey$refObbligatorioChiave di idempotenza corrispondente all'input di conoscenza originale.
ontologyIdstringObbligatorioID ontologia reale nell'ambito dell'autorizzazione corrente, conservato come stringa.
validUntil$refObbligatorioFine della finestra di validità della domanda, ora UTC.
expectedRevisiononeOfObbligatorioPrecondizione della versione del risultato o dell'intestazione di business originale; può essere null alla creazione della domanda.
validFrom$refObbligatorioInizio della finestra di validità della domanda, ora UTC.

Questo strumento dispone inoltre di un outputSchema nativo. Verificare la completezza dell'output, lo stato e i campi di autorizzazione esplicitamente impostati su false, senza attribuire di propria iniziativa un significato di completamento più ampio.

dfc_ontology_business_scope_initialize

ParametroTipoRequisitoSignificato e ambito
domainRevisionIdstringObbligatorioVersione esatta del dominio di business. minLength: 1; maxLength: 128
idempotencyKeystringObbligatorioChiave di idempotenza stabile e riutilizzabile per la medesima operazione logica. minLength: 1; maxLength: 128
businessSystemIdstringObbligatorioID reale del sistema di business. minLength: 1
ontologyIdstringObbligatorioID reale dell'ontologia nell'ambito di questa autorizzazione, conservato come stringa. minLength: 1
domainRidstringObbligatorioRID reale del dominio di business. minLength: 1; maxLength: 128

Questo strumento dispone inoltre di un outputSchema nativo. Verificare la completezza dell'output, lo stato e i campi di autorizzazione esplicitamente impostati su false, senza attribuire di propria iniziativa un significato di completamento più ampio.

Capitolo 34

Riferimento dei parametri degli strumenti: area di lavoro business

Nomi completi e campi di input, consultabili per strumento.

Le tabelle seguenti sono un riferimento di lettura per i campi di input degli strumenti r56 correnti. Per i tipi nidificati completi, oneOf, i campi obbligatori condizionali, i vincoli di pattern e alcuni Schema di output vedere reference/mcp-tool-catalog.json; prima dell'invio finale è comunque necessario leggere il tools/list del Grant corrente. L'indicazione “opzionale” nella tabella non elimina i requisiti di validazione interna dell'azione.

dfb_systems

L'oggetto radice di input di questo strumento non ha campi; utilizzare un oggetto arguments vuoto.

dfb_system_describe

ParametroTipoRequisitoSignificato e ambito
systemIdstring / integerObbligatorioID del sistema consentito da questo Grant di business.

dfb_query

ParametroTipoRequisitoSignificato e ambito
systemIdstring / integerObbligatorioID del sistema consentito da questo Grant di business.
queryKeystringObbligatorioChiave di query pubblicata restituita da describe.
objectKeystringOpzionale o condizionalmente obbligatorioChiave dell'oggetto pubblicato.
pageSizeintegerOpzionale o condizionalmente obbligatorioNumero di elementi per pagina; entro il limite massimo dello Schema. minimum: 1; maximum: 100
pageintegerOpzionale o condizionalmente obbligatorioNumero di pagina, a partire da 1. minimum: 1
statestringOpzionale o condizionalmente obbligatorioFiltro sullo stato di business o stato lato server.

dfb_record

ParametroTipoRequisitoSignificato e ambito
recordIdstring / integerObbligatorioID del record di business attualmente consentito in lettura.
systemIdstring / integerObbligatorioID del sistema consentito da questo Grant di business.

dfb_work_items

ParametroTipoRequisitoSignificato e ambito
systemIdstring / integerObbligatorioID del sistema consentito da questo Grant di business.

dfb_action_plan

ParametroTipoRequisitoSignificato e ambito
expectedRecordVersionintegerOpzionale o condizionalmente obbligatorioVersione corrente di blocco ottimistico del record di destinazione. minimum: 1
systemIdstring / integerObbligatorioID del sistema consentito da questo Grant di business.
commandTypestringObbligatorioTipo di comando nel contratto pubblicato.
canonicalIrHashstringObbligatorioHash dell'IR canonico della pubblicazione corrente.
releaseIdstring / integerObbligatorioID di versione del contratto pubblicato effettivo.
payloadobjectObbligatorioPayload conforme al contratto di comando corrente in describe.
releaseHashstringObbligatorioHash del contratto pubblicato effettivo.
targetRecordIdstring / integerOpzionale o condizionalmente obbligatorioRecord di destinazione reale su cui operare.
agentManifestHashstringObbligatorioHash del manifest delle capacità effettivo dell'Agent.
planIdempotencyKeystringObbligatorioChiave di idempotenza stabile del piano di business.

dfb_action_status

ParametroTipoRequisitoSignificato e ambito
actionPlanIdstring / integerObbligatorioID del piano di azione detenuto dal Grant di business corrente.

dfb_action_execute

ParametroTipoRequisitoSignificato e ambito
approvalTokenstringOpzionale o condizionalmente obbligatorioMateriale di approvazione emesso dal server originale; vietato generarlo autonomamente.
actionPlanIdstring / integerObbligatorioID del piano di azione detenuto dal Grant di business corrente.