DATAFOCUS · OT FLASH · R56

OT Flash Agent および MCP 接続マニュアル

プロトコル、認可、ツール契約および完全な呼び出しフロー

OT Flash r56 の公開 Remote MCP を使用して、追跡可能なデータ・ナレッジアプリケーションを構築します。本書では、OAuth、プロトコルメッセージ、宣言済みのすべてのツールのパラメーターリファレンス、エビデンスルール、条件付き機能および復旧フローを提供し、実行可能なクライアントと合成データのサンプルも示します。

Agent 開発者、インテグレーションエンジニアおよび管理者

付属サンプルには中国語表示のフィールド名が保持されています。インターフェース言語および説明文の翻訳は、実際のテーブル名、列名、列挙値、ツール名またはプロトコルフィールドを変更しません。

第 1 章

Agent 接続範囲と完了基準

認可のエントリポイントを選択し、サーバー側のレシートに基づいてクエリ、エビデンス取得または制御された書き込みを実行します。

OT Flash r56 は Remote MCP を通じて外部 Agent にオントロジー範囲内のデータおよびナレッジ機能を提供し、独立した業務ワークスペースのエントリポイントも提供します。Agent は実際の tools/list、inputSchema、OAuth scope および現在のリソース権限に基づいて実行可能な作業を判断する必要があり、静的なマニュアルからあるデプロイがすべてのオプション機能を有効にしていると推測してはなりません。

図 A1 外部 Agent が OAuth および MCP を通じて元のクエリ、ナレッジおよび業務機能を使用する様子。インターフェース関係の概念図。
入口用途境界
/mcpオントロジー、データテーブル、ドキュメントナレッジ、ネイティブ Search および条件付きで提供される分析・モデリング現在のユーザー権限と今回認可されたリソースの共通部分
/mcp/business業務システムの検出、クエリ、アクションプラン、ステータスと実行独立した業務システムの認可および公開契約
オントロジーエージェントの埋め込みページ人間向けインターフェースでオントロジー対話を使用する実際のログイン状態に依存しており、ログイン不要で MCP Token と交換するためのエントリポイントではない

機能分類

  • 基本読み取り:オントロジーとリソース、グラフでの位置特定、ナレッジ検索と完全な原文、認可されたテーブルの詳細および Doris SQL。
  • 独立した委任:dfc_search は search:operate を必要とし、引き続き元のユーザーとモデルの権限を使用します。
  • 条件付き提供:分析、永続レポート、成果物のドラフトと適用、オントロジーモデルクエリおよび委任 Agent タスク。
  • 利用不可の機能:Flash の dfc_etl は capabilities の報告のみを行い、Heavy ETL の実行は提供しません。AutoML および内部 FocusCode ワークスペースのエントリポイントは、本書の公開 Flash API に含まれません。

完了基準

事実の読み取りには、実際に使用可能なクエリまたは完全な原文のレシートを取得する必要があります。候補の生成では、まだ適用されていないことを明示する必要があります。公開には実際の APPLIED レシートが必要です。キャンセルは要求と確認を区別する必要があります。回答のテキスト、HTTP 200、ツールの受付確認またはモデルによる「完了」という説明は、いずれもそれだけでは業務操作の成功を証明できません。

付属の reference/mcp-tool-catalog.json は r56 のオフライン宣言リファレンスであり、条件付きで有効化される定義を含みますが、特定のユーザーのリアルタイムの tools/list ではありません。完全なカタログには 28 個のオントロジーコアツール、4 個のコントローラー条件付き拡張および 8 個の業務側ツールが含まれますが、デフォルトですべてが提供されることを意味しません。

第 2 章

クイック接続と機能の検出

インスタンスの正式ドメイン名から開始し、最小権限で実際に利用可能なツールを検出します。

  1. 管理者から正式な HTTPS ルートアドレスおよびアクセスが必要なオントロジーまたは業務システムを入手します。ドキュメント内のサンプルドメイン名を使用して実際の業務を呼び出さないでください。
  2. MCP サーバーアドレスを https://flash.example.com/mcp として設定し、業務ワークスペースは同じドメインの /mcp/business を使用します。
  3. クライアントの対応に応じて OAuth のログインと認可をトリガーし、リソースと scope を確認します。ユーザー名とパスワードを MCP に送信しないでください。
  4. 対応する世代のプロトコルで検出または初期化を行い、その後 tools/list とリソースの説明を読み取ります。
  5. まず小規模な読み取り専用リクエストを実行して、構造化された結果とエラーを確認してから、ユーザーの目標を実行します。

クライアント設定スニペット

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

このスニペットはサーバーアドレスの設定意図を説明するものであり、具体的な設定ファイルの構造と OAuth の対応はクライアントによって異なります。公開ファイルに実際の access_token、refresh_token、Cookie または管理者パスワードを記入しないでください。

現行プロトコルの検出

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

接続前チェック

  • リソースのルートアドレス、OAuth issuer およびリバースプロキシの外部アドレスが一致していること。
  • クライアントが該当するプロトコル世代に対応しており、新しいプロトコルのエントリポイントに一律に initialize を送信していないこと。
  • 現在の認可が必要なオントロジーまたは業務システムにバインドされていること。
  • Token が有効であり、新しいオプションの scope が明示的に認可されていること。
第 3 章

OAuth の検出、登録と認可

認可コードと PKCE を使用し、製品のログイン資格情報を Agent に公開しません。

図 A2 OAuth 認可コードと PKCE のフロー。シーケンス概念図。
エンドポイントメソッド役割
/.well-known/oauth-protected-resourceGETオントロジー MCP リソース検出
/.well-known/oauth-protected-resource/mcpGETオントロジーリソースパスの互換検出
/.well-known/oauth-protected-resource/mcp/businessGET業務 MCP リソース検出
/.well-known/oauth-authorization-serverGET認可サーバーのメタデータ
/oauth/registerPOST JSONpublic client の動的登録
/oauth/authorizeGET または POST フォームログイン、リソースの選択と認可の確認
/oauth/tokenPOST form認可コードの交換とリフレッシュのローテーション
/oauth/revokePOST formToken の失効(取り消し)
/oauth/grantsGETログイン済みユーザーによる認可済み接続の表示
/oauth/grants/revokePOST form元のページのフローに従って接続を取り消す

認可の順序

  1. 保護されたリソースのメタデータと認可サーバーのメタデータを読み取ります。Token なしのリクエストに対して返される 401 および WWW-Authenticate は、リソース検出アドレスを指します。
  2. クライアント ID を登録または使用します。r56 の動的登録の public client は token_endpoint_auth_method=none を使用します。クライアントシークレットで PKCE を代替してはなりません。
  3. ランダムな state と code_verifier を生成し、S256 の code_challenge を計算します。
  4. メタデータが示す authorize アドレスを開き、response_type=code、client_id、正確な redirect_uri、scope、resource、state、code_challenge および code_challenge_method=S256 を渡します。
  5. ユーザーが DataFocus にログインし、オントロジーまたは業務システムを選択します。クライアントは、ユーザーがアクセス権を持たないリソースを事前に選択してはなりません。
  6. コールバックを受信し、state と issuer を検証します。元の code_verifier を使用して認可コードを交換します。
  7. access_token は MCP Bearer 認証にのみ使用します。リフレッシュは元の OAuth フローを使用し、ローテーション後の refresh_token を安全に保存します。

登録の例

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

Web クライアントのコールバックは HTTPS を使用します。ネイティブクライアントはサポートされているループバックアドレスを使用できます。認可と Token の交換はいずれも、登録されたコールバックと正確に一致させます。1 つの Grant は 1 つの protected resource に対応し、オントロジーの scope と業務ワークスペースの scope を同じ接続に混在させません。

Token のライフサイクル

r56 サーバー側のデフォルトでは、access token は 3600 秒、refresh token は 2592000 秒、認可コードは 300 秒ですが、デプロイ時にこれらの値を上書きできます。クライアントは token レスポンスの expires_in と実際のエラーに基づいて判断し、デフォルト値をハードコードしてはなりません。リフレッシュ後は Token を更新してください。ロール、リソース権限または Grant の取り消しにより、その後の呼び出しは拒否されます。

第 4 章

Scope、リソース境界とリアルタイム権限

認可範囲は既存の権限を委任するものであり、ロールの昇格を付与せず、Grant 間で業務状態を共有することもありません。

Scope代表的な機能重要な制約
ontology.metadata:readオントロジー・リソース・テーブル構造オントロジーおよびテーブルは、認可範囲内かつ現在読み取り可能な範囲内である必要がある
ontology.graph:readグラフの検索と隣接ノード位置特定情報を返すものであり、事実のエビデンスではない
ontology.knowledge:readナレッジの位置特定と完全な原文ナレッジベースおよびドキュメントの元の権限を保持
ontology.table:queryオントロジーテーブルの SQL および公開済みモデルのクエリテーブルクエリには metadata scope も必要。実際のソースと列権限は引き続き有効
search:operateネイティブキーワードモデルとセッション独立した明示的な委任が必要で、元のモデルとユーザーのテーブル列権限に従って実行
etl:operateFlash ETL の capabilitiesHeavy ETL は提供しない
authoring.contract:read条件付きで提供されるモデリング契約機能スイッチと関連リソースも必要
authoring.artifact:read現在の認可による候補や計画などの読み取り元の主体の Grant とリソースにバインド
authoring.artifact:draft候補の提出、プレビューなど実行や公開は認可しない
authoring.artifact:apply制御された計画と適用引き続き元の業務ロール、ポリシーと承認が必要
execution.script:draft特定のスクリプトのドラフト実際のスクリプト実行は認可しない
datasource.http:read / draft / test / import条件付きで提供される HTTP データソース成果物の機能各項目は独立したスイッチと元の権限による
図 A3 ユーザー権限、Grant、選択されたリソースおよび機能設定が、利用可能な機能を共同で決定する様子。概念図。

読み取りの組み合わせ要件

dfc_table detail には ontology.metadata:read が必要です。query にはさらに ontology.table:query が必要です。dfc_ontology_query には graph と knowledge の 2 つの読み取り scope が必要です。dfc_knowledge_search/detail には knowledge が必要です。published_model/published_query は table:query を使用し、candidate_query にはさらに authoring.artifact:read が必要です。分析ツールは許可されたエビデンス scope も確認します。永続レポートには metadata と table query が必要です。

デフォルトの認可をハードコードしない

r56 のオントロジーのデフォルト scope セットには table query が含まれます。Search および ETL は明示的な委任です。最終的には、検出メタデータ、認可ページ、実際の Token scope および tools/list が基準となります。旧ドキュメントの「オントロジーのデフォルトには必ず SQL がない」または「ツールは 6 個のみ」という記述は、現在の実装の根拠としては使用できません。

状態の分離

セッション、レポート、候補およびアクションプランには、それぞれ固有の所有者と範囲があります。access token のリフレッシュは、元の Grant の作業を別の Grant に引き継がせません。別の接続から返された sessionId、reportId、planId、承認トークンまたはソース Token を現在の接続に統合しないでください。

第 5 章

HTTP と現行 MCP のメッセージ

リクエストごとのメタデータと一致するルーティングヘッダーを正しく送信し、HTTP とツール結果をそれぞれ処理します。

項目r56 の動作
トランスポートステートレス Streamable HTTP、POST JSON-RPC
サポートするバージョン識別子2026-07-28 および 2025-11-25 2025-06-18 2025-03-26
現行メソッドserver/discover tools/list tools/call resources/list resources/read、実際の機能に応じて提供
セッションヘッダーMcp-Session-Id を割り当てない
GET と DELETE/mcp と /mcp/business は 405 を返す
サーバー側の SSE 通知これら 2 つの公開 MCP エントリポイントでは提供しない
カタログキャッシュ現行の検出および一覧では ttlMs=60000 と cacheScope=private を返す
通常の結果現行の結果には resultType=complete とサービス ID メタデータが含まれる

一致が必須の内容

  • MCP-Protocol-Version と params._meta 内の io.modelcontextprotocol/protocolVersion が一致すること。
  • Mcp-Method と JSON-RPC method が一致すること。
  • tools/call の Mcp-Name は params.name と一致し、resources/read の名称ヘッダーは URI と一致すること。
  • 各現行リクエストには io.modelcontextprotocol/clientCapabilities オブジェクトを含め、クライアントが識別できるよう標準の clientInfo も併せて提供する。

呼び出し例

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

対応する HTTP ヘッダーは Mcp-Method: tools/call および Mcp-Name: dfc_ontologies です。例中の ACCESS_TOKEN はすべてプレースホルダーです。Bearer トークンを URL、JSON パラメーターやキャッシュキーに入れないでください。

結果の読み取り

まず HTTP ステータスを処理し、次に JSON-RPC error を確認します。result があれば isError を確認します。成功したツール結果は通常 structuredContent を提供し、同じ業務 JSON を含む text コンテンツもあります。構造化チャネルを優先して読み、text と structuredContent を 2 つの独立した事実として重複集計しないでください。HTTP 200 でもツール失敗が含まれる場合があります。

公開リソースと UI

内蔵の説明リソースは MCP Apps に依存しません。業務ワークスペースのエントリポイントは、これによってオントロジー説明リソースを取得するわけではありません。可視化対応クライアントは実際の機能とツール _meta によって対応する UI を検出し、返されないリソース URI を推測してはなりません。

第 6 章

旧プロトコルクライアントの互換性

引き続き初期化ハンドシェイクを使用するクライアントでは、一貫したプロトコル世代を維持します。

json
{
  "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {"name": "flash-legacy-client", "version": "1.0.0"}
  }
}
  1. initialize を送信し、サーバーがネゴシエートしたプロトコルバージョンと capabilities を読み取ります。
  2. クライアントのプロトコルに従って必要な初期化完了通知を送信します。通知には通常のツール結果はありません。
  3. tools/list で現在認可されているツールを読み取り、tools/call を送信します。
  4. 現在のリクエストのプロトコル世代に合わせてヘッダーとメッセージを一致させ、2026-07-28 メッセージに旧 initialize や ping フローを送信しないでください。

旧プロトコルも同じ Bearer/OAuth、権限、ツール契約を使用します。サーバーが必ず旧式の SSE 長時間接続や Mcp-Session-Id を提供するとは限りません。r56 の公開サービスはステートレスのままです。

プロトコルエラー

状況典型的な結果対処
現行ヘッダーとメッセージの不一致HTTP 400 JSON-RPC -32020ヘッダー・メタデータ・ツール名を修正
未対応のバージョン-32022 とサポートバージョン一覧を提供実際にサポートされているプロトコルを選択
不明なメソッドJSON-RPC -32601、現行リクエストでは HTTP 404 の可能性プロトコル世代とメソッドを確認
パラメーター不足または不正なパラメーターJSON-RPC パラメーターエラーまたはツール isError実際の inputSchema に従って修正
第 7 章

正しいツールとエビデンスチャネルの選択

未解決の業務課題に基づいてルーティングし、固定の呼び出しチェーンでエビデンスを繰り返し取得しません。

図 A4 タスクに応じてテーブル SQL、ナレッジエビデンス、Search、分析または業務アクションを選択する様子。ルーティングの概念図。
タスク推奨ツール完了に必要なエビデンス
認可されたトピックとリソースの検出dfc_ontologies dfc_ontology_resources実際のリソース ID タイプおよび現在の可視範囲
テーブル統計と TopNdfc_table query実行成功のレシートと完全な evidenceRows
規定・契約・レポートの照会dfc_ontology_query または knowledge search/detail完全で認可された、事実として利用可能な原文
グラフオブジェクトの特定dfc_ontology_graph search/neighbors実際のソースを特定してから対応する事実を取得
元のキーワード方式による対話dfc_manual の後に dfc_search元のモデルと業務フレーム内の実際の結果
融合分析とレポートdfc_analysis_* または dfc_report_*各構造化ブランチとドキュメントエビデンスの実際の状態
表示またはオントロジーモデルの変更dfc_authoring_* と artifact ツール候補・計画・承認・実際の適用をそれぞれ確認
業務コマンドの実行/mcp/business の dfb_*公開済み契約と元の ActionPlan レシート

不要な呼び出しを避ける

最新かつ完全で、認可されたテーブル構造がすでにある場合は、クエリのたびに detail を再取得する必要はありません。信頼できる位置特定とエビデンスがすでにある場合は、同じ検索を繰り返しません。不足しているディメンションが必要な場合は、範囲を限定した補足クエリを行います。失敗が明確に再試行不可の場合は、まずギャップを解消し、「もう一度試す」で判断を代替しないでください。

Flash の除外事項

dfc_etl capabilities は available=false と ETL_NOT_INCLUDED_IN_OT_FLASH を返す場合があります。内蔵 ETL 関数の静的説明は製品間の参考用であり、Flash に ETL がインストールされていることを証明するものではなく、Agent が自動的に Heavy や他のテナントへ実行を移すことも許されません。

第 8 章

オントロジーリソースと ID タイプ

実際のリソース座標を先に取得し、ストレージ名、ドキュメント ID、ナレッジベース ID を混同しないようにします。

  1. dfc_ontologies を呼び出し、page と pageSize に従って今回認可され、現在も読み取り可能なオントロジーを閲覧します。
  2. 実際の ontologyId で dfc_ontology_resources を呼び出します。必要に応じて tables、answers、pinboards、documents、knowledgeBindings を選択します。
  3. リソースごとにページングを個別に処理します。pageSize の最大は 100 です。最初のページからリソース全体の範囲を推測しないでください。
  4. リソースが宣言するタイプと元の ID を保存し、以降の呼び出しではそのまま使用します。
json
{"name":"dfc_ontology_resources","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "resourceTypes":["tables","documents","knowledgeBindings"],
  "page":1,"pageSize":100
}}
座標ソース代替できないもの
ontologyId認可されたオントロジー一覧または現在有効なコンテキスト別のオントロジーの ID
テーブルリソース idtables 一覧または信頼できるコンテキストphysicalName または表示テーブル名
tblDisplayName colDisplayName現在のテーブルとカラムのメタデータ推測された物理 SQL 識別子
knowledgeIdknowledgeBindings または実際のナレッジ検索レシートドキュメントリソース id
assetId documentId chunkId evidenceId同一の実際の位置特定レシート異なる位置特定結果を寄せ集めたフィールド
rid revisionId releaseId公開済みモデルまたはサーバー側の候補コンテキスト独自に生成した ID または latest

精度に関する規約

すべての 64 ビットリソース識別子は 10 進文字列を優先し、JavaScript で Number 変換を経由させないでください。一部の業務 Schema は string または integer を許容しますが、整数精度を捨ててよいことにはなりません。opaque locator、UUID、ハッシュおよびワンタイムトークンも元のまま保存します。

第 9 章

Doris テーブルクエリと構造契約

認可されたテーブル上で読み取り専用の SQL を実行し、出力のセマンティクス、正確な数値、完全性を保持します。

構造の読み取り

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

detail には実際のテーブルリソース ID を使用します。schemaComplete、tblDisplayName、columns 内の colDisplayName と権威ある sqlDataType、および返される queryContract を確認します。dataType は互換マッピングにすぎず、物理ストレージ名は SQL で指定するテーブル名ではありません。

クエリの実行

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

SQL の制約

  • 表示テーブル名と表示カラム名を使用し、識別子は二重引用符で囲みます。リクエストは、オントロジー範囲内の 1 件の読み取り専用 Doris クエリです。
  • 出力を明示的に列挙し、SELECT * と table.* は禁止です。これらを使って物理カラム経由で登録済みカラムの権限を回避することはできません。
  • 結合には明示的な JOIN ... ON を使用します。NATURAL JOIN と JOIN USING は拒否されます。
  • 正当な多次元集計、CTE、ウィンドウ、CASE、COUNT(DISTINCT ...) などの読み取り専用式は使用可能です。セマンティック検証が式をカバーしていないからといって、一律に実行が禁止されるわけではありません。
  • まず SQL 内で集計・ソート・ランキングを行い、その後結果上限を適用します。maxRows のデフォルトは 100、最大は 200 です。

日付とタイムゾーン

型またはターゲット形式注意
DATECAST('2026-09-01' AS DATE) と CURRENT_DATEテキストリテラルを日付型と決めつけてはならない
DATETIMECAST('2026-09-01 00:00:00' AS DATETIME) と CURRENT_TIMESTAMPソースのタイムゾーンとセッションのタイムゾーンを確認する
相対時間DATE_SUB(CURRENT_DATE, INTERVAL 1 YEAR)日付とタイムスタンプには対応する現在時刻関数を使用する
時間によるグループ化YEAR(column) または DATE_TRUNC(column, 'month')各出力には一意の別名を付けること。queryContract を基準とする

SQLite の DATE('now', ...) はこのエントリポイントの Doris 日付契約ではありません。ドキュメント例の SQLite オフライン検証方法を本番の SQL に持ち込まないでください。

v8 クエリレシートの読み取り

evidenceRows は Agent が行データにアクセスする唯一のチャネルであり、raw data は Agent には提供されません。SQL の数値は正確な 10 進数の JSON 文字列としてエンコードされます。resultColumnContracts によって数値型と業務型を判定し、JSON が文字列だからといって VARCHAR と解釈してはなりません。executionReceipt、完全性、切り詰め情報を読み取り、evidenceRowsSha256 などのソース情報を保持してください。

参照可能な実行レシートを持つクエリ出力はそのまま引用できます。後続の決定的な二次計算を許可できるのは、サーバー側で検証されたセマンティクスのみです。フィールド名から「累積残高」「期末値」「通貨」を推測したり、単位を独自に補完したりしてはなりません。ゼロ行の結果、失敗、切り詰めを完全な統計として記述してはなりません。

第 10 章

多次元 Top3 と切り詰め処理

ランキングにはサーバー側の集計とウィンドウ関数を使用し、不完全な結果に対して二次計算を行いません。

付属の examples/top3.sql はサンプルテーブルを使用し、まず 区域、类别、产品 で集計し、各 区域 と 类别 内で ROW_NUMBER を実行し、金額が同値の場合の安定した順序として 产品(製品名)を使用します。maxRows=100 を要求すればサンプルの 36 行を十分に収容できます。その他の業務データでは、実際のグループ数に基づいて見積もる必要があります。

  1. 実際の構造と現在の算定基準を取得し、通貨、期間、订单状态、同値の扱いを明確にします。
  2. サーバー側の集計とランキングの SQL を送信します。まず 区域 の総額だけを照会し、それを 类别 内の 产品 ランキングとして扱わないでください。
  3. 出力カラム契約と実際の evidenceRows を確認し、必要なすべてのグループが返されていることを確認します。
  4. 切り詰めが検出された場合は、サーバーがサポートする境界に基づいて範囲を限定したパーティション単位のクエリを実行します。たとえば 区域 ごとに完全な Top3 を取得します。毎回同一の業務上の算定基準を維持してください。
  5. ソースの期間が変更された場合は、再クエリを行い新しいバージョンを明示し、異なるデータバージョンや無効なカーソルを混在させないでください。
図 A5 明細フィルター、グループ集計、グループ内ランキング、最終返却の順序。概念図。

エラー回復

TABLE_SCHEMA_INCOMPLETE では構造を修正するか完全な構造を取得します。ONTOLOGY_SQL_FAILURE_CONTRACT_INVALID などの失敗は、返却された errorCode、retryable、remediation に従って処理します。「すべての多次元 GROUP BY やウィンドウ関数が禁止されている」と主張したり、クエリ結果がない状態でランキングを作り上げたりしてはなりません。

第 11 章

ナレッジ検索、完全な原文とエビデンスの適格性

特定、読み取り、事実引用を分離し、出典と完全性を保持します。

よく使う 2 つの経路

経路用途要点
dfc_ontology_queryオントロジーにバインドされたナレッジ内を検索し、グラフルーティングと組み合わせ可能完全な canonical answerContextItems とエビデンスの適格性を確認する
dfc_knowledge_search → dfc_knowledge_detail chunk明示的な検索で特定し、選択したチャンクを読み取る検索プレビューは事実として扱わない。同一の特定情報について完全な原文を読み取る
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>"
}}

事実として使用できる条件

  • 現在の ACL、コンテンツの完全性、およびサーバー側の canonicalFactEligible、citationEligible または対応する実行契約を確認します。
  • 完全なコンテンツは contentSha256 にバインドされます。切り詰め、予算による省略、低品質コンテンツは実際のフィールドに従って処理します。
  • ドキュメントのメタデータ、page_context、グラフ上の特定情報、検索要約、プレビューは、canonical な原文の代わりにはなりません。
  • evidenceId を優先してコピーします。chunkId と documentId が必要な場合は、同じ特定結果から取得しなければならず、継ぎ合わせたり推測で作成したりしてはなりません。

グラフルーティング

search/neighbors の結果は特定情報です。サーバーが完全に返却した routeLocator オブジェクトのみをオントロジー query に、バインディング、バージョン、証明フィールドを含めてそのまま渡してください。assetId や knowledgeId を独自にラップしてサーバー発行の locator に見せかけたり、モデルが主張する出典証明を送り返したりしてはなりません。

構造化ドキュメントの復元

dfc_ontology_query の structuredPlan は、不規則なドキュメント内の表を対象とした、制限付きの復元と決定的検証専用の機能です。現在の executionContractSha256、tableIndex、列、および完全なテーブルを返却した場合にのみ、サーバーが宣言する計画を使用してください。インポート済みの通常の業務テーブルには dfc_table SQL を使用してください。Markdown テーブルの復元をテーブルクエリの認可を回避する経路として扱ってはなりません。

図 A6 位置特定結果と引用可能な原文のエビデンスチェーン。概念図。

検索戦略

knowledgeIds は通常省略し、現在有効なバインディングを網羅します。指定する場合は knowledgeBindings の実際のナレッジベース ID のみを使用します。ドキュメントリソース ID をナレッジベース ID として扱わないでください。未解決の問題に基づいて範囲を限定した新しい検索を行い、完全に同一で新たなエビデンスが得られない検索は避けてください。

第 13 章

言語と地域の規約

UI locale、クエリ辞書、返却言語、元のフィールド名の間の境界を維持します。

優先順位は、明示的にリクエストされた言語、アプリケーションシステムの言語、実際の実行ノードの locale の順です。省略、null、空文字列、空白のいずれの場合も、中国語へ固定的にフォールバックすることはありません。languageRegistry 内の地域の値は正確に保持してください。languageRegistry の en-GB、fr-CA、pt-BR、es-US、ar-AE を、別の地域に安易に統合してはなりません。

言語または地域クエリ locale説明
簡体字中国語・繁体字中国語zh-CN zh-Hant元の中国語ルールと繁体字カタログは異なる
英語(米国・英国・オーストラリア・カナダ)en-US en-GB en-AU en-CAUI/キーワードパッケージは共用可能、地域メタデータは保持
ドイツ語・イタリア語・ロシア語de-DE it-IT ru-RU現在のセッションの提案に従って使用
スペイン語(スペイン・ラテンアメリカ)es-ES es-US製品の地域 ID は es-US
フランス語(フランス・カナダ)fr-FR fr-CA地域 ID は統合しない
ポルトガル語(ポルトガル・ブラジル)pt-PT pt-BRカタログと地域の規約をそれぞれ保持
オランダ語・デンマーク語・ノルウェー語・フィンランド語・スウェーデン語nl-NL da-DK nb-NO fi-FI sv-SEノルウェー語は Bokmål
日本語・韓国語ja-JP ko-KR英語のスペース規則に基づいて独自に分かち書きしない
アラビア語(サウジアラビア・UAE)ar-SA ar-AEUI の説明は RTL をサポート、プロトコル識別子は反転しない

キーワードカタログの使用

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

dfc_manual の静的キーワードカタログには明示的に列挙された locale のみが含まれ、省略時は英語がリファレンスとして使用されます。これは参照用のデフォルト値であり、クエリ言語の解析規則ではありません。地域バリアントに静的カタログが提供されていない場合は、現在のセッションの assist から実際の提案を取得し、エイリアスやフォールバック結果を作り上げてはなりません。1 回の names は最大 32 項目です。

翻訳しない内容

  • テーブル、列、列挙値、顧客名、数式名、その他の実際のモデル文字列。
  • ツール名、action、scope、Schema フィールド、エラーコード、ステータス値。
  • リソース ID、ハッシュ、opaque locator、サーバー発行の参照。

たとえば、ドイツ語の質問で中国語表示列の「销售金额」をクエリできます。それをドイツ語の列名に変更すると、UI 翻訳ではなく別の識別子になります。言語を変更した後はセッションを再初期化するか元のプロトコルに従って更新し、提案と曖昧性解消の候補を再取得してください。

第 14 章

融合分析と対話型結果

条件付きで提供される分析ツールでは、認可、バージョン、ブランチ、エビデンスの状態を保持します。

dfc_analysis_* は datafocus.mcp.analysis.tools.enabled によって制御されます。構造化部分は引き続き Search の権威あるクエリと現在の行ポリシーを使用し、ドキュメント部分は現在の ACL の下で完全な原文を再取得します。これらは、自由形式の SQL、任意の命令、任意のフィルターを注入するためのエントリポイントではありません。

ツール用途必要な座標
dfc_analysis_ask自然言語による分析質問を行うontologyId question、オプション language sessionId
dfc_analysis_result_get返却済みの結果を読み取るontologyId sessionId resultId
dfc_analysis_refine最新の完全な結果に基づいてフォローアップまたは変更を行う元の結果 expectedRevision と安定した冪等キー
dfc_analysis_pageサーバー側ブランチの 1 ページを取得元のブランチと結果バージョン pageNo pageSize
dfc_analysis_cancel実行中の結果をキャンセル元のセッションと結果
dfc_analysis_close実行中でないセッションを解放元のセッション

分析を開始

json
{"name":"dfc_analysis_ask","arguments":{
  "ontologyId":"<ONTOLOGY_ID>",
  "question":"按区域分析已完成订单销售金额,并引用退货统计口径",
  "language":"zh-CN"
}}
  1. 返された sessionId、resultId、ステータス、revision を読み取り、必要に応じて元の結果を引き続き読み取ります。
  2. 各構造化ブランチのステータス、完全性、行ポリシー、およびソースを個別に確認します。1 つのブランチが完了しても、分析全体が完了したことを意味しません。
  3. ドキュメントエビデンス、ファクト台帳、引用適格性および制限事項を確認します。モデルが生成した説明だけで、エビデンスの適格性が格上げされることはありません。
  4. 追加で質問する場合は、最新の完全な結果に基づき expectedRevision を渡します。同一の変更を再試行する場合は、同一の冪等キーを再利用します。
  5. 閉じる前に、セッションが実行中でないことを確認します。キャンセルとクローズは別の操作です。

制御されたフィルタリングとページネーション

filter_patch は、サーバーが提示した branchId、fieldRef、valueRef および許可された演算子を使用します。現在の型付きフィルターは EQ のみを宣言します。生の SQL、tableId、columnId やクライアント側で独自に作成したフィルターツリーで opaque 参照を置き換えることは禁止されています。ページネーションの pageNo は 1 から開始し、最大 10000、pageSize の最大値は 100 です。

図 A7 ブランチ、バージョン、ページネーションのバインディング。ソースまたはバージョンが変化した後は、再クエリして新しい位置情報を取得する必要があります。概念図。

機能ヒントと動作

ツールの annotations はクライアントへのヒントであり、セキュリティ上の認可ではありません。一部の汎用テンプレートは readOnlyHint を使用しますが、実際の操作に対する判断の代わりにはなりません。キャンセル、クローズ、レポート作成は、対応する作業状態を変更します。常にツールのセマンティクス、ユーザーの目標、およびサーバー側の権限に従って実行してください。

第 15 章

永続的な可視化レポートと MCP Apps

復元可能なレポートを作成し、現在の権限でその結果と対話画面を読み取ります。

dfc_report_* は datafocus.mcp.analysis.report-tools.enabled により制御され、metadata と table query scope が必要です。インプロセスの Search セッションとは異なり、レポートは永続的な reportId を使用します。永続的であることは、権限の再確認が不要であることを意味しません。

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

ワークフロー

  1. 作成時には、8~128 文字のサポート対象文字からなる安定した idempotencyKey を使用します。
  2. reportId を保存し、status をポーリングして、完了、失敗、部分的な完了、キャンセルなどの実際の状態を確認します。
  3. 結果を読み取る際は、構造化ブランチ、可視化、ファクトのソース、ドキュメント引用および完全性を照合します。
  4. 未完了のレポートをキャンセルするには、元の reportId を使用します。キャンセルの代わりに別のレポートを作成しないでください。
  5. ネットワークタイムアウト後は、まず元のレポートの状態を読み取ります。元の冪等キーによるリプレイは、同一の業務意図を維持する必要があります。

MCP Apps

UI 拡張をサポートするクライアントは、ツールの _meta と実際のリソース検出を通じてレポートページを読み取ります。r56 に対応する永続的なレポートページは ui://datafocus/analysis-report/v16/index.html であり、対話型分析では対応するサーバー側リソース参照を使用します。クライアントがツールの戻り値をハードコードで置き換えてはなりません。UI 拡張がない場合でも、構造化結果は読み取れます。

ソースバインディング

レポートの読み取り時に、Grant、オントロジー、リクエスト Origin バインディングおよび現在のテーブル権限を再確認します。ブラウザーのクロスオリジン統合には、承認済みの実際のオリジンを使用する必要があります。クライアントが偽装 Origin によりバインディングを回避してはなりません。旧 reportId は長期的な公開リンクではなく、ユーザー間アクセスの資格情報でもありません。

第 16 章

成果物のドラフト・プレビュー・計画と適用

生成されたコンテンツを元のサーバー側で正規化、検証、承認させ、モデルが本番リソースを直接変更しないようにします。

成果物ツールには、authoring 機能が有効であること、実際の artifact type、関連する scope および元の管理者の書き込み権限が必要です。デフォルトの型設定は CONTROL_PANEL_SPEC と VIEW_SPEC です。その他のフォーム、HTTP ソースまたはスクリプト型は、個別の設定による制御を受けます。Flash には AutoML がないため、関連する型を本バージョンで利用可能な成果物として列挙しません。

図 A8 コンテキスト、候補、プレビュー、計画、承認および適用の制御された順序。概念図。
  1. dfc_authoring_capabilities は、現在の Grant で利用可能な契約とアクションを読み取ります。
  2. dfc_artifact_context は、範囲が限定されたコンテキスト、contractVersion、contextHash、baseArtifactHash および baseArtifactVersion を取得します。
  3. クライアント側で実際の契約に基づいて候補を生成します。候補に含まれるコードは実行しません。
  4. dfc_artifact_submit は元のコンテキストと候補を送信し、instruction を同一に保ち、安定した clientRequestId を使用します。
  5. proposalId、candidateHash、検証結果とプレビューを読み取ります。実際のエラーがある場合は候補を修正し、サーバーの合格状態を偽装しません。
  6. 再プレビューが必要な場合は、dfc_artifact_preview と同一の候補ハッシュを使用します。
  7. dfc_artifact_plan は、実際の候補、ターゲットバージョンおよび冪等キーを使用して不変の計画を作成します。
  8. 承認は、元の対話による承認、または既に認可されたポリシーに従って処理し、その後 dfc_artifact_apply します。APPLIED レシートのみが実際の適用を表します。

最小限のコンテキストリクエスト

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

VIEW_SPEC は現在の認可された projectId を使用し、既存の成果物を編集する場合は実際の artifactId を使用します。variables、previewInput、viewport などのフィールドは、返された契約に従って提供し、候補の内部構造を推測して作成しません。

同時実行とリトライ

計画は、ターゲットバージョン、候補ハッシュおよび冪等キーにバインドされます。ターゲットが変化した後、旧計画は適用を継続できません。コンテキストを再読み取りし、実際の競合に従って処理します。transport timeout は失敗を証明しません。まず dfc_artifact_status で元の proposalId または planId を照会します。READY は APPLIED ではありません。

承認と自動ポリシー

汎用成果物計画には元の人手による承認が必要です。オントロジーの自動公開ポリシーに適合する計画は approvalMode に従って処理され、Agent が独自に作り出した承認にユーザーが別途署名するよう求められることはありません。approvalToken はサーバーが発行する情報であり、Agent が任意の文字列を書いて代用することはできません。実際の inputSchema と計画のレシートによって必須フィールドが決まります。

第 17 章

オントロジー候補の作成と公開契約

独立したバージョンのオントロジー宣言と公開設定を使用し、通常の表示用成果物契約をモデルの公開に適用しません。

候補の作成

オントロジーコンテナは既に存在し、Grant 内になければなりません。dfc_ontology_table_schema を使用して、現在の構造化ソースフィールドと v4 Binding フィンガープリントを確認します。フィールドは sourceField のみを提供し、型を自動検出させることができます。明示的な DECIMAL 宣言には現在の精度と小数桁数が必要であり、その他の型はこれら 2 つのフィールドを持ちません。

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

候補と公開設定

契約用途主要な境界
ontology-workspace-create-mcp-submit-v1ローカル宣言により候補を作成実際に認可されたソース。サーバー側でコンパイルし、完了証明を受け付けない
ontology-workspace-create-mcp-submit-v2ローカルと厳密な公開済み参照の混在厳密な releaseSelections とクロージャ依存を提供
ontology-publication-mcp-submit-v1~v3既存の候補を公開計画リクエストにバインド明示的な座標。ターゲット・ソース・承認および検証はサーバー側で復元
ontology-publication-mcp-submit-v4~v6個別に有効化された自動公開関連設定capabilities と実際の schema 宣言がある場合にのみ使用
ontology-initial-activation-retirement-submit-v1制御された初期アクティブ化・廃止操作独立した計画。新たな人による承認と厳密な範囲

公開の順序

  1. 現在の候補 workspaceId、workspaceRevision、candidateHash および実際のソースを取得します。
  2. サーバーの機能に従って契約バージョンを選択し、releases や selection などの座標を送信します。「承認済み」「合格済み」を自称するフィールドは添付しません。
  3. submit が返した proposalId と元の idempotencyKey を保持します。submit と MODEL_PLAN は同一リクエストの異なるフェーズです。
  4. dfc_artifact_plan を呼び出します。元の候補、ターゲットバージョンおよび同一の冪等キーを使用します。
  5. PLANNING_INCOMPLETE は有効な計画がまだ形成されていないことを示し、VALIDATION_UNSATISFIED は現在の検証にまだ不足があることを示します。nextAction に従って処理します。
  6. 計画が成功した後は、HUMAN_REQUIRED または POLICY_AUTO に従って継続し、元の承認と公開機能を使用します。
  7. APPLIED レシートと、その後の実際の公開済みモデルの読み取りおよび認可クエリにより結果を確認します。

タイムアウトと復旧

PLAN のタイムアウト後、元の proposalId を読み取ります。MODEL_PLAN_SUBMITTED は未完了のリクエストです。MODEL_PLAN_COMPLETED は、元の座標と元のキーで元のレシートを復元すべきことを示し、クライアントに新しいリクエストを作らせるものではありません。終端状態の検証不足は、キーを変更したり再送信を繰り返したりしても、公開合格にはなりません。

人による業務権限

Agent が提供する instruction と宣言は Agent の入力であり、人によるポリシー署名ではありません。MODEL_AUTHOR、MODEL_PUBLISH、自動公開の委任、業務確認、公開鍵の信頼、予算およびソース ACL は、引き続き元のメカニズムにより決定されます。これらの事実をクライアントのフィールドで置き換えることはできません。

第 18 章

公開モデル、候補照会と参照クロージャ

厳密なバージョンで公開済みの業務知識を使用し、未公開候補の一時性を保持します。

dfc_ontology_graph の published_model、published_query、candidate_query は条件付きで提供される構造化設定であり、通常の search/neighbors の同義語ではありません。これらは table query および必要なモデリング読み取り権限により認可され、グラフの可視性でテーブル権限を代用することはできません。

公開済みモデルの読み取り

  1. ツールの action 列挙に実際に published_model が含まれる場合、実際の committed releaseId を送信します。
  2. v1 は認可されたクエリテンプレートを返します。v2 は厳密な PERSISTED 参照と releaseSelections を追加し、v3 は依存参照、厳密な domainRef およびコンパクトなバインディングテンプレートを追加します。
  3. オブジェクト、属性、Binding、scope、バージョンは実際の戻り値から選択し、RIDs を生成したり latest を使用したりしません。
  4. published_query の固定された型付きクエリを送信します。結果も現在のソースとフィールドの認可を通過する必要があります。

候補照会

candidate_query は、実際の workspaceId、revision、candidateHash および候補宣言を使用します。公開済み参照を混在させる場合は、対応する v2 の型付き LOCAL/PERSISTED 座標と厳密な選択を使用します。候補の結果は常に未公開かつ一時的なものであり、企業が確認済みの知識として扱いません。

部分的な保守とクロージャ

候補のルートに必要な推移依存のみを選択し、各公開済み参照に厳密な releaseSelections があることを保証します。公開済み本文の複製、一組の ID のみの送信、またはすべての過去リソースへの拡大は、現在の依存とソースの確認の代わりになりません。

図 A9 候補のルート、厳密な公開済み依存およびソースの認可。参照クロージャの概念図。

これらの action の query はバージョン化された型付きオブジェクトであり、SQL、物理テーブル ID またはソーステーブル名による業務参照の代用を受け付けません。メタデータテンプレートとグラフの結果自体には、事実としての引用適格性はありません。

第 19 章

オントロジー Agent タスクの委任

永続的なタスクと元の Grant で作業を復旧し、Agent の指示を人による承認として扱いません。

dfc_ontology_agent は、実際の Pi Runtime および関連する権限が利用可能な場合にのみ表示されます。QUERY は読み取り機能を使用し、AUTHORING はさらにモデリングロールと対応する authoring scope が必要です。制約のない別の実行エンジンを提供するものではありません。

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

厳密なパラメーターセット

start は contractVersion、action、ontologyId、mode、instruction、idempotencyKey を使用し、status/cancel は contractVersion、action、ontologyId、runId を使用します。サーバーは action に従って厳密なフィールドセットを検証します。instruction は最大 16000 文字、キーは 1~128 文字のサポート対象文字で、先頭は英数字である必要があります。

復旧とキャンセル

  1. 元の runId、Grant、mode および冪等キーを保持します。
  2. 同一のキーと同一の instruction で同一の run を復旧し、別のタスクを再送信しません。同一キーで instruction を変更すると拒否されます。
  3. status は元のタスクの状態を照会します。完了後も、そのテーブルクエリ、エビデンスまたは公開レシートを確認する必要があります。
  4. キャンセルには元の runId を使用し、実際のタスク状態で結果を確認します。

run の完了はモデル公開のレシートではありません。公開タスクは引き続き元の artifact の状態およびソースの確認により検証します。QUERY に暗黙の書き込み権または公開権はありません。

第 20 章

業務ワークスペース MCP

公開済みの業務契約に基づいてレコードを照会し、元の ActionPlan でコマンドを実行します。

/mcp/business は独立した protected resource と業務システムの選択を使用し、オントロジーの Grant を再利用して業務認可を代用することはできません。業務システムは公開済みで、Agent から呼び出し可能であり、元のセキュリティポリシーを満たし、現在のユーザーが実際のランタイムロールと機能を持つ必要があります。

Scopeツール境界
business-system:discoverdfb_systems dfb_system_describe今回認可され、現在呼び出し可能なシステムのみを検出
business-system:readdfb_query dfb_record dfb_work_items dfb_action_status現在のユーザーが読み取り可能なレコードと本人の計画
business-system:plandfb_action_plan不変の計画の作成のみ。実行しない
business-system:executedfb_action_execute独立した明示的な認可により、リスクと承認に従って実行
  1. dfb_systems が認可されたシステムを検出します。
  2. dfb_system_describe が現在の公開契約、releaseId およびすべてのハッシュ、クエリ、コマンドを読み取ります。
  3. dfb_query は公開済みの queryKey を使用し、必要に応じて objectKey、state、page および pageSize を指定します。任意の SQL ではありません。
  4. dfb_record と dfb_work_items が現在許可されているレコードと ToDo を読み取ります。
  5. 実行前に dfb_action_plan で実際の releaseId、releaseHash、canonicalIrHash、agentManifestHash、commandType、planIdempotencyKey と契約に従った payload を提供します。
  6. riskClass、requiresApproval および status を照合します。対象レコードが関係する場合は expectedRecordVersion を保持します。
  7. dfb_action_execute は、現在の接続が所有し、準備が完了している計画のみを実行します。人による承認が必要な場合の承認トークンは DataFocus が発行します。
  8. 失敗またはタイムアウト後、dfb_action_status で元の計画を復旧します。リトライは元の冪等セマンティクスを保持します。
図 A10 公開済み契約、計画、承認、およびアクション実行。概念図。

接続とバージョンのバインド

計画は現在の Grant の安定した分離 ID にバインドされます。Access Token を更新した後も同一接続の計画を処理でき、別の OAuth 接続がそれを引き継ぐことはできません。実行時に公開バージョン、IR/manifest ハッシュ、対象レコードバージョン、計画の有効期限、冪等性、および承認を再確認します。OAuth allowlist によって業務ガバナンスを回避することはできません。

第 21 章

業務ナレッジ入力と確認待ちの質問

対応する本番プロセッサが提供されている場合に業務入力を登録し、人による確認の境界を維持します。

以下の 4 つのツールは、公開 MCP コントローラーがインストール済みプロセッサと現在の scope の条件に応じて追加するものです。これらがベースカタログに常に表示されるとは限りません。宣言された Schema の存在は、インスタンスにプロセッサ、予算、権限が揃っていることを意味せず、必ず先に tools/list を確認する必要があります。

ツール用途生じない権限付与または効果
dfc_ontology_knowledge_input_propose既存のワークスペースへの元の業務入力の登録確認質問を生成しない・承認しない・公開しない
dfc_ontology_knowledge_input_preview元の入力からの質問ドラフトの一時プレビュー永続化しない・確認しない・本番レシートを作成しない
dfc_ontology_knowledge_question_submitauthored かつ未確認の質問の保存回答を自動マージしない・責任権限や公開権を取得しない
dfc_ontology_business_scope_initialize業務システムコンシューマースコープの明示的な初期化公開しない・有効化しない・ソースアクセス権を付与しない

入力とプレビュー

  1. 実際の準備作業から workspaceId、workspaceRevision、localRef、preparationDigest を取得します。
  2. propose は元の input 契約と安定した idempotencyKey で業務入力を登録します。同一キーは同一の入力にのみ対応できます。
  3. preview は元の入力の冪等キーと ontologyId を使用します。毎回サーバー側の revision と 60 秒のウィンドウを返すものであり、冪等な本番完了レシートではありません。
  4. 質問を保存する必要がある場合、question_submit は新しいコマンドキー、元の originalInputKey、明確な questionRevision、validFrom、validUntil、expectedRevision を使用します。作成時の expectedRevision は null です。

人による確認のエントリポイント

question_submit が返す knowledgeConfirmationPage は、元のログインページ上の相対的な位置指定であり、ある質問を事前入力するものです。Bearer を含まず、ページを自動的に開かず、ナレッジを確認することもありません。QUESTION_STORED_UNCONFIRMED は未確認であることを明示するものであり、回答内で「ナレッジは公開済み」と記述してはなりません。

コンシューマースコープの初期化

business scope initialize には、オントロジーの公開権限と、対象となる特定の業務システムの作成者権限または SourceManager 管理権限の両方が必要です。domainRid、domainRevisionId、businessSystemId の実際の座標を使用し、クライアントが任意の consumerScope や完了の証明を記入することは認められません。返される INITIALIZED と COMPLETED は引き続き published=false、activationAuthorized=false であることが明示されます。

これらのリクエストは、厳格な JSON、フィールド集合、バイト数および深度の検証も経由します。入力リクエストの上限は 1 MiB です。一部の特定操作にはより小さい上限があります。完全な入出力 Schema はツールリファレンスとともに提供され、一般的な MCP ラッパーの緩いパラメーターロジックをこれらの厳格な契約に適用することはできません。

第 22 章

レスポンス・エラーと安全なリトライ

エラーを階層的に解釈し、タスク座標と冪等セマンティクスを維持します。

階層確認内容処理原則
ネットワークと HTTP接続 TLS 401 403 400 404 405 など失敗レスポンスを通常のクエリ結果として扱わない
JSON-RPCerror.code message dataプロトコル・メソッド・パラメーター・認可の問題を区別する
MCP ツールresult.isError と structuredContentHTTP 200 でも失敗し得る
業務結果実際のステータス・完全性・失敗原因・nextAction受信または準備完了は完了を意味しない
事実としての適格性executionReceipt citationEligible contentComplete適格性のないコンテンツは位置特定やギャップの説明にのみ使用する

よくある HTTP の状況

  • 401:Bearer が欠落または無効です。現在の OAuth フローに従ってリフレッシュまたは再認可してください。
  • 403:Grant、ロール、選択されたリソース、ソース権限、Origin または設定が要件を満たしていません。リプレイで回避しないでください。
  • 400:メッセージまたはバージョン付き契約が不正です。現行ヘッダーとメタデータの不整合を含みます。
  • 404:正確なサービスパス、プロトコルメソッド、およびランタイム機能を確認してください。オントロジー ID をむやみに変更しないでください。
  • 405:公開 /mcp の GET、DELETE はもともと提供されていません。正しい POST を使用し、SSE 長時間接続を確立しないでください。

結果が不明な書き込み操作

MCP_OPERATION_OUTCOME_UNKNOWN には outcome=UNKNOWN、retryable=false、nextAction=READ_ORIGINAL_STATUS、recoveryTool および元の位置特定パラメーターが含まれる場合があります。まず元のステータスを確認してから、元のリクエストから復旧してください。候補を再提出したり、冪等キーを変更したり、タイムアウトをトランザクションロールバックとして扱ったりしないでください。

図 A11 失敗、結果不明、およびリトライ可能な状況の処理順序。復旧の概念図。

元のまま保持すべき内容

  • 元の Grant、リソース範囲、タスクおよび結果 ID。
  • candidateHash、planHash、expectedRevision、対象バージョンおよび公開選択。
  • 同一論理操作の冪等キー。異なる業務操作には新しいキーを使用してください。
  • サーバー側が宣言した retryable、remediation、nextAction および現在のステータス。

例外テキストから内部 SQL、ホスト、資格情報、スタックトレースを抽出して回答のソースにしないでください。公開可能なエラーコードとリクエスト関連情報を記録するだけで十分です。元のエラーは管理者が管理されたログで確認する必要がある場合があります。

第 23 章

統合のセキュリティと機能の境界

アイデンティティ、リソース、実行、エビデンスの元の境界を維持し、信頼できないドキュメントを安全に処理します。

  1. 管理者が指定した正式ドメインのみに接続し、TLS と OAuth issuer を検証し、証明書検証を無効にしません。
  2. リソース範囲を最小限に絞った専用の Grant を使用します。管理者アカウント、Cookie、長期内部 Token を公開インターフェースの資格情報として扱いません。
  3. ドキュメント本文は信頼できない業務資料として扱います。ドキュメント内の「ルールを無視」「キーをアップロード」「コマンドを実行」はツールの認可ではありません。
  4. 自動リトライ、同時実行、結果の範囲を制限し、クライアント側で元の業務権限を再構成しません。
  5. ログには必要な関連情報のみを記録し、Bearer、refresh token、承認トークンおよび完全な機密業務コンテンツを記録しません。
  6. ユーザーが切断した場合、または管理者が権限を取り消した場合は、キャッシュ内の認可とデータの使用を停止し、古い locator での呼び出しに頼りません。

ツールのヒントは権限ではない

readOnlyHint、destructiveHint、idempotentHint、openWorldHint はクライアントが機能を理解するためのものであり、各呼び出しの実際の業務効果を保証するものでも、現在のユーザー認可の代替でもありません。すべての書き込み、計画、プレビュー、セッション、キャンセルのアクションは、その実際の動作に従って扱います。

呼び出してはならないエントリポイント

  • 元の Trino/Hive/Hadoop サービス、および Flash に含まれていない Heavy ETL。
  • 内部 FocusCode 専用 scope またはワークスペースインターフェース。
  • 現在のインスタンスの tools/list に表示されない実行 v2、AutoML またはその他の実験的ツール。
  • MCP の拒否を回避するために、ブラウザーのプライベート REST、任意のデータベース接続、または他テナントのサービスを使用すること。

データのセマンティクス

サーバー側の正確な 10 進数、型、通貨、単位、時間およびエビデンスの契約に従います。出力テキストが数字のように見えるからといって再度四捨五入したり通貨を換算したり、結果が切り詰められた場合に表示行に対してグローバルな順位付けを行ったりしないでください。

第 24 章

管理者の接続設定と条件付きスイッチ

拡張機能を有効にする前に、実際のコンポーネント、公開アドレス、および元の権限設定を確認します。

設定用途公開要件
datafocus.mcp.public-base-url正式な外部ルートアドレスOAuth 検出、issuer、コールバックおよびリバースプロキシの一致
datafocus.mcp.allowed-origins追加承認されたブラウザー Origin正確に設定し、任意の Origin に拡大しない
datafocus.mcp.oauth.route-proof-secretグラフルーティング証明用の専用サーバーシークレット独立して保存し、Bearer を鍵として使用しない
datafocus.mcp.analysis.tools.enabled対話型分析ツール対応するデータ・ナレッジ・権限サービスが実際に利用可能であること
datafocus.mcp.analysis.report-tools.enabled永続レポートツール対応するストレージ worker と復旧チェーンが利用可能であること
datafocus.mcp.analysis.apps.enabledMCP Apps 表示クライアントがサポートを宣言し、返される _meta を確認すること
datafocus.mcp.authoring.enabledドラフトおよびモデリング契約元の管理者およびリソース権限を維持すること
datafocus.mcp.authoring.apply-enabled成果物の適用機能不変の計画・元の承認・現在のステータスの再検証
datafocus.mcp.ontology-published-query-enabled公開済みモデルとクエリ実際にコミット済みのバージョンとソースの認可
datafocus.mcp.ontology-candidate-query-enabled候補構造化クエリ候補の所有権・正確なバージョンおよび読み取り権限
datafocus.mcp.authoring.ontology-auto-publication-enabled自動公開の委任に関連する認可有効な元のポリシー・公開鍵の信頼・予算および公開権限

これらの名前は r56 の設定と実装に由来し、有効化できるかどうかは対応するサービスと元のリリースゲートに依存します。ブール値を変更するだけでは、欠落しているプロセッサ、データベース、検証予算、ポリシーは補われません。ナレッジ入力拡張および Pi タスクの表示は、実際にインストールされたコンポーネントによって決まります。

エッジプロキシ

Authorization、Content-Type、MCP-Protocol-Version、Mcp-Method、Mcp-Name、および承認された Origin を保持します。実際のサービス要件に従ってリクエストボディ、タイムアウト、TLS を設定し、公開 /mcp を管理ポートや別の製品に転送しないでください。

本番稼働前のチェック

  • 匿名での検出と保護された呼び出しのステータスが期待どおりであること。
  • 一般ユーザーは自身の認可範囲のみを検出でき、権限取り消し後の後続リクエストは拒否されること。
  • Search ネイティブセッション、SQL、原文およびオプションのレポートがそれぞれ実際の結果を持つこと。
  • 書き込みと公開の承認および冪等な復旧が元の動作を維持すること。
  • ログと公開ドキュメントに秘密鍵、Token、Cookie、パスワード、内部顧客情報が含まれていないこと。
第 25 章

実行可能クライアントと呼び出しサンプル

対応する最小クライアントでメッセージを検証し、OAuth または現在の認可を回避しません。

examples/flash_mcp.py は Python 標準ライブラリーのみに依存する最小プロトコルクライアントです。ログインせず、承認を代行せず、表示されないツールを自動呼び出しせず、現行および旧プロトコルをサポートし、HTTP、JSON-RPC、ツールエラーを階層的に処理して終了します。Token はプロセスの環境変数から入力され、スクリプトや説明ファイルに書き込まれません。

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

読み取りとクエリ

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

まずリクエストファイル内の ONTOLOGY_ID、TABLE_RESOURCE_ID などのプレースホルダーを、現在の認可が返した実際の値に置き換えてください。クライアントはプレースホルダーに遭遇すると実行を拒否します。SQL の例では、対応する CSV が元の列名どおりにインポート済みである必要があります。対応する schema がない場合は直接送信できません。

その他のシナリオ

  • 業務エントリポイント:--endpoint business を使用し、/mcp/business 向けの Grant を再度取得します。
  • 旧クライアント:--protocol 2025-11-25 を選択し、まず initialize してから、同一プロトコルで呼び出します。
  • 内蔵説明:resources または read-resource を使用して実際の URI を読み取ります。
  • オフライン自己診断:--self-test は現行ヘッダーとメタデータの構築を検証するもので、Token を必要とせず、製品サーバーにもリクエストを送りません。

サンプルの境界

クライアントはプロトコル接続の起点であり、モデリング候補の自動生成、Q&A の保存、公開の実行は行いません。上位の Agent が業務ステータスを照合できるよう、生の JSON を出力します。プロセスの終了コードのみに基づいて、ユーザーに照会・レポート・公開の完了を約束しないでください。

第 26 章

オントロジー対話画面の埋め込み

人間向けの対話ページを業務フロントエンドに埋め込み、ログインおよびブラウザーのセキュリティ境界を維持します。

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 はテナント ID のサンプル、1001 はオントロジー ID のサンプルであり、使用時には実際に権限のある座標に置き換えてください。単一オントロジーは path またはサポートされる query で指定でき、all モードでは @ で現在のユーザーがアクセス可能なオントロジーを選択できます。skillId はそのまま受け渡されるだけであり、これに基づいてスキルオーケストレーションが実行可能であると主張してはなりません。

認証とドメイン

現在の埋め込みページは実際の DataFocus ログイン状態に依存し、/uc/status を確認します。クロスサイト Cookie、SSO、CSP の frame-ancestors、およびゲートウェイ設定はいずれも埋め込みに影響します。MCP Bearer を URL に入れてログイン不要の経路とすることは受け付けません。未実装の outside 外部リンクを、設計案に基づいて独自に組み立ててはなりません。

MCP と iframe の違い

方式利用者アイデンティティと結果
Remote MCP外部 Agent またはサービス統合OAuth Grant と構造化ツールのレシート
オントロジー対話 iframe人間のエンドユーザー元のログイン状態と対話画面
MCP Apps拡張対応の MCP クライアント管理されたリソースと現在のツール結果であり、公開 iframe ログインの代替ではない
第 27 章

統合検収チェックリスト

インターフェースが 200 を返すことを確認するだけでなく、実際のインスタンス上で業務チェーン全体を証明します。

  1. 検出:実際にサポートされるバージョン、現在のツールカタログ、内蔵リソースを取得する。
  2. 認可:一般ユーザーには許可されたオントロジーと業務システムのみが表示され、scope のない操作は拒否される。
  3. テーブル構造:実際の表示名、列、型、権限が完全であること。
  4. SQL:単一次元、多次元、JOIN、日付、TopN および切り詰めチェックが実際の業務基準に合致していること。
  5. ナレッジ:位置特定、完全な原文、事実としての引用適格性が一致し、混合質問にはデータとドキュメントの両方の根拠があること。
  6. Search:model、init、提案、結果、クローズおよびバッファー完全性のチェックに合格すること。
  7. 任意の分析とレポート:複数ブランチの実際の状態、ページ送り、権限変更およびキャンセルが元の挙動を維持していること。
  8. 任意のモデリング:候補、計画、元の承認、実際の適用およびバージョン照会を段階ごとに確認すること。
  9. 業務アクション:公開ハッシュ、ターゲットバージョン、承認、冪等性および Grant 間の分離を確認すること。
  10. 復旧:ネットワークタイムアウト後に元の状態から復旧し、ソース更新後は古い位置特定情報が無効となり、新しいクエリを使用すること。

結果の記録

インスタンスバージョン、ユーザーロール、Grant 範囲、設定バージョン、実際の操作と結果を記録します。プロトコルクライアントのオフライン自己診断、サンプル CSV のオフライン期待値、静的な JSON Schema 検証、および実際のオンライン機能検収はそれぞれ別個にマークします。一つの段階の合格をすべての製品の合格に外挿してはなりません。

第 28 章

仕様リソースと保守

マニュアル付属の完全なツール Schema を使用し、インスタンスの実際の検出結果と同期を保ちます。

リソース内容
reference/mcp-tool-catalog.jsonオントロジー側 32 件および業務側 8 件の宣言入力 Schema。一部のツールには元の出力 Schema を含む
reference/locales.json21 件のオプションと 24 の互換 locale および UI 用語
reference/search-keywords.json明示的な locale を持つ 17 件の静的キーワードカタログ
reference/analysis-contract-manifest.json分析・ブランチ・ファクト・レシートおよびレポート関連のバージョン制約
examples/合成 CSV 基準説明、Top3 SQL 期待結果および最小プロトコルクライアント

内蔵説明リソース

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

resources/list および resources/read を利用するには、現在のユーザーが metadata、search operate、etl operate のいずれか一つ以上の読み取り資格を持っている必要があります。ETL ドキュメントは静的な製品横断リファレンスです。Flash の実行可能な機能は、明示的に報告された範囲のみです。

外部プロトコルリファレンス

MCP プロトコルと認可の背景については公式仕様を参照してください:https://modelcontextprotocol.io/specification/2026-07-28/basic および https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization 。本製品のエンドポイント、ツール、および条件付き挙動は、r56 の実装および現在のインスタンスの検出結果に準拠します。汎用プロトコルのサポートを、サーバーがすべてのオプション機能を提供することと同一視してはなりません。

アップグレードと保守

アップグレード時にはツールとバージョンを再検出し、入力 Schema、出力契約、および設定を比較します。旧 Grant が新しい scope を自動的に取得することはありません。参照、キャッシュ、レシートをソースバージョンに紐付けたまま維持し、互換性のない変更を確認した後はコンテキストを再取得し、古い位置特定情報を新しい業務ステータスに無理に適用しないでください。

第 29 章

ツールパラメーターリファレンス 基礎とネイティブ Search

完全な名称と入力フィールド。ツールごとにグループ化して参照します。

以下の表は、現在の r56 ツールの入力フィールドの閲覧用リファレンスです。完全なネスト型、oneOf、条件付き必須項目、パターン制約および一部の出力 Schema については reference/mcp-tool-catalog.json を参照してください。最終送信前には必ず現在の Grant の tools/list を読み取ってください。表内の「オプション」は、アクション内部の検証要件を免除するものではありません。

dfc_manual

パラメーター型要件意味と範囲
namesarrayオプションまたは条件付き必須検索対象の明示的な名称。1 回最大 32 件。 maxItems: 32
actionstringオプションまたは条件付き必須操作名。現在の列挙とアクション対応パラメーターに従って使用します。 enum: list, read, keywords, functions, etl_requests
localestringオプションまたは条件付き必須明示的な静的リファレンスカタログの locale。照会の既定言語ではありません。
uristringオプションまたは条件付き必須現在のツールが列挙する内蔵リソースの URI。 enum: datafocus://manuals/etl-formulas/v1, datafocus://manuals/search-keyword-queries/v1, datafocus://manuals/etl-functions/v1, datafocus://manuals/search-keywords/v1

dfc_search

パラメーター型要件意味と範囲
dataobjectオプションまたは条件付き必須元のアクションペイロード。機能検出およびアクションフィールド表を参照してください。
actionstring必須操作名。現在の列挙とアクション対応パラメーターに従って使用します。 enum: capabilities, model_create, model_read, open, request, poll, cancel, close

dfc_etl

パラメーター型要件意味と範囲
dataobjectオプションまたは条件付き必須元のアクションペイロード。機能検出およびアクションフィールド表を参照してください。
actionstring必須操作名。現在の列挙とアクション対応パラメーターに従って使用します。 enum: capabilities

dfc_ontologies

パラメーター型要件意味と範囲
pageSizeintegerオプションまたは条件付き必須1 ページあたりの件数。Schema の上限に従います。 minimum: 1; maximum: 100
pageintegerオプションまたは条件付き必須ページ番号。1 から開始。 minimum: 1

dfc_ontology_resources

パラメーター型要件意味と範囲
resourceTypesarrayオプションまたは条件付き必須返却が必要なリソース型の集合。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
pageSizeintegerオプションまたは条件付き必須1 ページあたりの件数。Schema の上限に従います。 minimum: 1; maximum: 100
pageintegerオプションまたは条件付き必須ページ番号。1 から開始。 minimum: 1
第 30 章

ツールパラメーターリファレンス テーブル・グラフ・ナレッジ

完全な名称と入力フィールド。ツールごとにグループ化して参照します。

以下の表は、現在の r56 ツールの入力フィールドの閲覧用リファレンスです。完全なネスト型、oneOf、条件付き必須項目、パターン制約および一部の出力 Schema については reference/mcp-tool-catalog.json を参照してください。最終送信前には必ず現在の Grant の tools/list を読み取ってください。表内の「オプション」は、アクション内部の検証要件を免除するものではありません。

dfc_ontology_graph

パラメーター型要件意味と範囲
relationTypesarrayオプションまたは条件付き必須リレーション型フィルター。
depthintegerオプションまたは条件付き必須隣接ノード走査の深度。 minimum: 1; maximum: 3
sourceTypesarrayオプションまたは条件付き必須ソース型フィルター。
queryobjectオプションまたは条件付き必須照会テキスト、または action に対応する正確なバージョン付き照会オブジェクト。
limitintegerオプションまたは条件付き必須返却件数の上限。 minimum: 1; maximum: 100
actionstring必須操作名。現在の列挙とアクション対応パラメーターに従って使用します。 enum: search, neighbors, published_model, published_query, candidate_query
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
nodeKeystringオプションまたは条件付き必須実際のグラフ結果からコピーしたノードキー。
keywordstringオプションまたは条件付き必須グラフ位置特定のキーワード。キーワード問い合わせ構文ではありません。
nodeTypesarrayオプションまたは条件付き必須ノード型フィルター。

dfc_ontology_query

パラメーター型要件意味と範囲
routeLocatorsarrayオプションまたは条件付き必須サーバーが発行した型付きルーティング位置特定を完全にコピーしたもの。 maxItems: 20
topKintegerオプションまたは条件付き必須リコール候補の上限。完全な網羅を証明するものではありません。 minimum: 1; maximum: 20
queryModestringオプションまたは条件付き必須ツールの列挙に従ってエビデンス照会モードを選択します。 enum: vector, hybrid, graph
fanoutPlanobjectオプションまたは条件付き必須制限付きブランチ検索計画。ネスト Schema に従います。
structuredPlanobjectオプションまたは条件付き必須完全なドキュメントテーブルに対するサーバー側契約にバインドされた計画。SQL ではありません。
knowledgeIdsarrayオプションまたは条件付き必須実際の knowledgeBindings 内のナレッジベース ID。
querystring必須照会テキスト、または action に対応する正確なバージョン付き照会オブジェクト。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。

dfc_knowledge_search

パラメーター型要件意味と範囲
topKintegerオプションまたは条件付き必須リコール候補の上限。完全な網羅を証明するものではありません。 minimum: 1; maximum: 20
minScorenumberオプションまたは条件付き必須最低マッチスコア。 minimum: 0; maximum: 1
knowledgeIdsarrayオプションまたは条件付き必須実際の knowledgeBindings 内のナレッジベース ID。
querystring必須照会テキスト、または action に対応する正確なバージョン付き照会オブジェクト。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
assetIdsarrayオプションまたは条件付き必須現在許可されているドキュメントアセット ID。
retrievalStrategystringオプションまたは条件付き必須実際にサポートされる検索戦略。 enum: auto, hybrid_stage2

dfc_knowledge_detail

パラメーター型要件意味と範囲
qdrantIdstring / integerオプションまたは条件付き必須実際の位置特定が返したインデックス識別子。
pageNointegerオプションまたは条件付き必須実際のページまたはページング番号。
evidenceIdstringオプションまたは条件付き必須同一ナレッジ位置特定が返したエビデンス ID。
actionstring必須操作名。現在の列挙とアクション対応パラメーターに従って使用します。 enum: chunk, document, page_context
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
documentIdstring / integerオプションまたは条件付き必須同一位置特定のドキュメント ID。
radiusintegerオプションまたは条件付き必須隣接ページ範囲。 minimum: 0; maximum: 3
chunkIdstringオプションまたは条件付き必須同一位置特定の実際のチャンク ID。

dfc_table

パラメーター型要件意味と範囲
maxRowsintegerオプションまたは条件付き必須返却行数の上限。クライアント側のランキング範囲ではありません。 minimum: 1; maximum: 200
actionstring必須操作名。現在の列挙とアクション対応パラメーターに従って使用します。 enum: detail, query
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
idstringオプションまたは条件付き必須実際のテーブルリソース ID。物理名または表示名ではありません。
sqlstringオプションまたは条件付き必須単一オントロジー範囲内の読み取り専用 Doris SQL。出力列を明示します。
第 31 章

ツールパラメーターリファレンス 分析とレポート

完全な名称と入力フィールド。ツールごとにグループ化して参照します。

以下の表は、現在の r56 ツールの入力フィールドの閲覧用リファレンスです。完全なネスト型、oneOf、条件付き必須項目、パターン制約および一部の出力 Schema については reference/mcp-tool-catalog.json を参照してください。最終送信前には必ず現在の Grant の tools/list を読み取ってください。表内の「オプション」は、アクション内部の検証要件を免除するものではありません。

dfc_analysis_ask

パラメーター型要件意味と範囲
questionstring必須自然言語の質問または互換性のある追加質問。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
languagestringオプションまたは条件付き必須明示的な回答または照会の locale。省略時は対応するツールのルールに従います。
sessionIdstringオプションまたは条件付き必須同一 Grant 配下の実際のセッション位置特定。

dfc_analysis_refine

パラメーター型要件意味と範囲
branchIdstringオプションまたは条件付き必須サーバーが発行した構造化ブランチの位置特定。
resultIdstring必須元々返された分析結果の位置特定。
questionstringオプションまたは条件付き必須自然言語の質問または互換性のある追加質問。
idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。
changeobjectオプションまたは条件付き必須自然言語の変更、または型付き filter_patch。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
languagestringオプションまたは条件付き必須明示的な回答または照会の locale。省略時は対応するツールのルールに従います。
sessionIdstring必須同一 Grant 配下の実際のセッション位置特定。
expectedRevisioninteger必須元の結果または業務ヘッダーのバージョン前提。質問作成時は null 可。 minimum: 1
visualIdstringオプションまたは条件付き必須ブランチに紐付いた可視化位置特定。

dfc_analysis_page

パラメーター型要件意味と範囲
branchIdstring必須サーバーが発行した構造化ブランチの位置特定。
resultIdstring必須元々返された分析結果の位置特定。
pageNointeger必須実際のページまたはページング番号。 minimum: 1; maximum: 10000
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
pageSizeinteger必須1 ページあたりの件数。Schema の上限に従います。 minimum: 1; maximum: 100
sessionIdstring必須同一 Grant 配下の実際のセッション位置特定。
expectedRevisioninteger必須元の結果または業務ヘッダーのバージョン前提。質問作成時は null 可。 minimum: 1

dfc_analysis_result_get

パラメーター型要件意味と範囲
resultIdstring必須元々返された分析結果の位置特定。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
sessionIdstring必須同一 Grant 配下の実際のセッション位置特定。

dfc_analysis_cancel

パラメーター型要件意味と範囲
resultIdstring必須元々返された分析結果の位置特定。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
sessionIdstring必須同一 Grant 配下の実際のセッション位置特定。

dfc_analysis_close

パラメーター型要件意味と範囲
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
sessionIdstring必須同一 Grant 配下の実際のセッション位置特定。

dfc_report_create

パラメーター型要件意味と範囲
goalstring必須レポートの分析ターゲット。
idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
languagestringオプションまたは条件付き必須明示的な回答または照会の locale。省略時は対応するツールのルールに従います。
titlestringオプションまたは条件付き必須オプションのレポートタイトル。

dfc_report_status

パラメーター型要件意味と範囲
reportIdstring必須現在の Grant の永続レポート位置特定。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。

dfc_report_cancel

パラメーター型要件意味と範囲
reportIdstring必須現在の Grant の永続レポート位置特定。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
第 32 章

ツールパラメーターリファレンス モデリングと元タスク

完全な名称と入力フィールド。ツールごとにグループ化して参照します。

以下の表は、現在の r56 ツールの入力フィールドの閲覧用リファレンスです。完全なネスト型、oneOf、条件付き必須項目、パターン制約および一部の出力 Schema については reference/mcp-tool-catalog.json を参照してください。最終送信前には必ず現在の Grant の tools/list を読み取ってください。表内の「オプション」は、アクション内部の検証要件を免除するものではありません。

dfc_ontology_agent

パラメーター型要件意味と範囲
modestringオプションまたは条件付き必須QUERY または AUTHORING。機能はそれぞれ個別に権限付与されます。 enum: QUERY, AUTHORING
instructionstringオプションまたは条件付き必須ユーザー要求テキスト。コンテキストと提出内容は一致させてください。 maxLength: 16000
idempotencyKeystringオプションまたは条件付き必須同一の論理操作で安定して再利用される冪等キー。 maxLength: 128
actionstring必須操作名。現在の列挙とアクション対応パラメーターに従って使用します。 enum: start, status, cancel
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
runIdstringオプションまたは条件付き必須同一オントロジーおよび Grant の元タスク ID。
contractVersionstring必須実際にサポートされる正確な契約バージョンを使用する必要があります。 enum: ontology-agent-task-v1

dfc_authoring_capabilities

このツールの入力ルートオブジェクトにはフィールドがありません。空の arguments オブジェクトを使用してください。

dfc_artifact_context

パラメーター型要件意味と範囲
artifactTypestring必須実際に有効化されている成果物またはオントロジー公開の型。 enum: CONTROL_PANEL_SPEC, VIEW_SPEC
scopeTypestringオプションまたは条件付き必須実際の成果物契約におけるリソース範囲タイプ。
ontologyIdstringオプションまたは条件付き必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
projectIdstringオプションまたは条件付き必須現在認可されているプロジェクト ID。
artifactIdstringオプションまたは条件付き必須既存の成果物を編集する際の実際の ID。
instructionstring必須ユーザー要求テキスト。コンテキストと提出内容は一致させてください。
variablesobjectオプションまたは条件付き必須返却された契約に従って提供される変数オブジェクト。
previewInputobjectオプションまたは条件付き必須契約に従って提供される上限付きのプレビュー入力。
viewportobjectオプションまたは条件付き必須元の契約で要求された表示ビューポート。

dfc_ontology_table_schema

パラメーター型要件意味と範囲
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
sourceAssetRefstring必須登録済みの構造化アセット参照(例:table:123)。
fieldsarray必須現在のソースのフィールドと任意の明示的な型宣言。 minItems: 1; maxItems: 64

dfc_artifact_preview

パラメーター型要件意味と範囲
proposalIdstring必須現在の Grant が作成した元の候補 ID。
candidateHashstring必須元のサーバー側候補の正確なハッシュ。
previewInputobject必須契約に従って提供される上限付きのプレビュー入力。

dfc_artifact_status

パラメーター型要件意味と範囲
proposalIdstringオプションまたは条件付き必須現在の Grant が作成した元の候補 ID。
planIdstringオプションまたは条件付き必須不変の適用計画 ID。

dfc_artifact_plan

パラメーター型要件意味と範囲
proposalIdstring必須現在の Grant が作成した元の候補 ID。
candidateHashstring必須元のサーバー側候補の正確なハッシュ。
expectedTargetVersioninteger必須現在の実際のターゲットバージョン前提。 minimum: 0
idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。

dfc_artifact_apply

パラメーター型要件意味と範囲
planIdstring必須不変の適用計画 ID。
planHashstring必須元の計画が返したハッシュ。
approvalTokenstring必須元のサーバーが発行した承認情報。独自に生成しないでください。
idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。

dfc_artifact_submit

パラメーター型要件意味と範囲
構成1 / artifactTypestring必須実際に有効化されている成果物またはオントロジー公開の型。 enum: CONTROL_PANEL_SPEC, VIEW_SPEC
構成1 / scopeTypestringオプションまたは条件付き必須実際の成果物契約におけるリソース範囲タイプ。
構成1 / ontologyIdstringオプションまたは条件付き必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
構成1 / projectIdstringオプションまたは条件付き必須現在認可されているプロジェクト ID。
構成1 / artifactIdstringオプションまたは条件付き必須既存の成果物を編集する際の実際の ID。
構成1 / instructionstring必須ユーザー要求テキスト。コンテキストと提出内容は一致させてください。
構成1 / variablesobjectオプションまたは条件付き必須返却された契約に従って提供される変数オブジェクト。
構成1 / previewInputobjectオプションまたは条件付き必須契約に従って提供される上限付きのプレビュー入力。
構成1 / viewportobjectオプションまたは条件付き必須元の契約で要求された表示ビューポート。
構成1 / contractVersionstring必須実際にサポートされている正確な契約バージョンを使用する必要があります。
構成1 / contextHashstring必須context が返した完全なコンテキストハッシュ。
構成1 / baseArtifactHashstring必須context が返したベース成果物のハッシュ。
構成1 / baseArtifactVersioninteger必須context が返したベースバージョン。 minimum: 0
構成1 / candidateobject必須現在返却されている契約に適合する候補オブジェクト。
構成1 / clientRequestIdstring必須現在の候補リクエストで安定して使用されるクライアント側冪等キー。
構成2 / artifactTypestring必須実際に有効化されている成果物またはオントロジー公開の型。 enum: ONTOLOGY_RELEASE
構成2 / contractVersionstring必須実際にサポートされている正確な契約バージョンを使用する必要があります。 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
構成2 / ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
構成2 / candidateHashstring必須元のサーバー側候補の正確なハッシュ。
構成2 / workspaceIdstring必須実際の候補ワークスペース座標。
構成2 / workspaceRevisionstring必須正確な候補バージョン。latest は使用しないこと。
構成2 / releasesobject必須オントロジー公開契約に従って提供される正確なバージョン選択。
構成2 / selectionobject必須明示的な業務選択座標のみを提供し、権限や完了証明は提供しないこと。
構成2 / idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。
構成3 / 構成1 / artifactTypestring必須実際に有効化されている成果物またはオントロジー公開の型。 enum: ONTOLOGY_RELEASE
構成3 / 構成1 / contractVersionstring必須実際にサポートされている正確な契約バージョンを使用する必要があります。 enum: ontology-workspace-create-mcp-submit-v1
構成3 / 構成1 / ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
構成3 / 構成1 / workspaceIdstring必須実際の候補ワークスペース座標。
構成3 / 構成1 / resourcesarray必須サーバー側でコンパイルされた元モデル宣言。 minItems: 1
構成3 / 構成1 / idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。
構成3 / 構成2 / artifactTypestring必須実際に有効化されている成果物またはオントロジー公開の型。 enum: ONTOLOGY_RELEASE
構成3 / 構成2 / contractVersionstring必須実際にサポートされている正確な契約バージョンを使用する必要があります。 enum: ontology-workspace-create-mcp-submit-v2
構成3 / 構成2 / ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
構成3 / 構成2 / workspaceIdstring必須実際の候補ワークスペース座標。
構成3 / 構成2 / resourcesarray必須サーバー側でコンパイルされた元モデル宣言。 minItems: 1
構成3 / 構成2 / idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。
構成3 / 構成2 / releaseSelectionsobject必須公開済み参照ごとの正確な releaseId と依存関係クロージャ。
構成4 / artifactTypestring必須実際に有効化されている成果物またはオントロジー公開の型。 enum: ONTOLOGY_RELEASE
構成4 / contractVersionstring必須実際にサポートされている正確な契約バージョンを使用する必要があります。 enum: ontology-initial-activation-retirement-submit-v1
構成4 / ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
構成4 / domainRidstring必須実際の業務ドメイン RID。
構成4 / consumerScopesarray必須サーバーが許可する正確なコンシューマー範囲。 minItems: 1; maxItems: 256
構成4 / idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。
第 33 章

ツールパラメーターリファレンス ナレッジ入力と範囲

完全な名称と入力フィールド。ツールごとにグループ化して参照します。

以下の表は、現在の r56 ツールの入力フィールドの閲覧用リファレンスです。完全なネスト型、oneOf、条件付き必須項目、パターン制約および一部の出力 Schema については reference/mcp-tool-catalog.json を参照してください。最終送信前には必ず現在の Grant の tools/list を読み取ってください。表内の「オプション」は、アクション内部の検証要件を免除するものではありません。

dfc_ontology_knowledge_input_propose

パラメーター型要件意味と範囲
requestobject必須元の業務入力リクエスト。完全なネスト Schema に従います。
idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。 minLength: 1; maxLength: 128

このツールにはネイティブの outputSchema もあります。出力の完全性、ステータス、および明示的に false とされている認可フィールドを確認し、完了の意味を自己判断で格上げしないこと。

dfc_ontology_knowledge_input_preview

パラメーター型要件意味と範囲
idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。 minLength: 1; maxLength: 128
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。

このツールにはネイティブの outputSchema もあります。出力の完全性、ステータス、および明示的に false とされている認可フィールドを確認し、完了の意味を自己判断で格上げしないこと。

dfc_ontology_knowledge_question_submit

パラメーター型要件意味と範囲
questionRevision$ref必須今回確認対象の質問の正確なバージョン。
idempotencyKey$ref必須同一の論理操作で安定して再利用される冪等キー。
originalInputKey$ref必須元のナレッジ入力に対応する冪等キー。
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。
validUntil$ref必須質問の有効期間の終了時刻。UTC 時間。
expectedRevisiononeOf必須元の結果または業務ヘッダーのバージョン前提。質問作成時は null 可。
validFrom$ref必須質問の有効期間の開始時刻。UTC 時間。

このツールにはネイティブの outputSchema もあります。出力の完全性、ステータス、および明示的に false とされている認可フィールドを確認し、完了の意味を自己判断で格上げしないこと。

dfc_ontology_business_scope_initialize

パラメーター型要件意味と範囲
domainRevisionIdstring必須正確な業務ドメインバージョン。 minLength: 1; maxLength: 128
idempotencyKeystring必須同一の論理操作で安定して再利用される冪等キー。 minLength: 1; maxLength: 128
businessSystemIdstring必須実際の業務システム ID。 minLength: 1
ontologyIdstring必須今回の認可範囲内の実際のオントロジー ID。文字列として保持します。 minLength: 1
domainRidstring必須実際の業務ドメイン RID。 minLength: 1; maxLength: 128

このツールにはネイティブの outputSchema もあります。出力の完全性、ステータス、および明示的に false とされている認可フィールドを確認し、完了の意味を自己判断で格上げしないこと。

第 34 章

ツールパラメーターリファレンス 業務ワークスペース

完全な名称と入力フィールド。ツールごとにグループ化して参照します。

以下の表は、現在の r56 ツールの入力フィールドの閲覧用リファレンスです。完全なネスト型、oneOf、条件付き必須項目、パターン制約および一部の出力 Schema については reference/mcp-tool-catalog.json を参照してください。最終送信前には必ず現在の Grant の tools/list を読み取ってください。表内の「オプション」は、アクション内部の検証要件を免除するものではありません。

dfb_systems

このツールの入力ルートオブジェクトにはフィールドがありません。空の arguments オブジェクトを使用してください。

dfb_system_describe

パラメーター型要件意味と範囲
systemIdstring / integer必須今回の業務 Grant で許可されたシステム ID。

dfb_query

パラメーター型要件意味と範囲
systemIdstring / integer必須今回の業務 Grant で許可されたシステム ID。
queryKeystring必須describe が返した公開済みクエリキー。
objectKeystringオプションまたは条件付き必須公開済みオブジェクトキー。
pageSizeintegerオプションまたは条件付き必須1 ページあたりの件数。Schema の上限に従います。 minimum: 1; maximum: 100
pageintegerオプションまたは条件付き必須ページ番号。1 から開始。 minimum: 1
statestringオプションまたは条件付き必須業務ステータスのフィルターまたはサーバー側ステータス。

dfb_record

パラメーター型要件意味と範囲
recordIdstring / integer必須現在読み取りが許可されている業務レコード ID。
systemIdstring / integer必須今回の業務 Grant で許可されたシステム ID。

dfb_work_items

パラメーター型要件意味と範囲
systemIdstring / integer必須今回の業務 Grant で許可されたシステム ID。

dfb_action_plan

パラメーター型要件意味と範囲
expectedRecordVersionintegerオプションまたは条件付き必須対象レコードの現在のオプティミスティックロックバージョン。 minimum: 1
systemIdstring / integer必須今回の業務 Grant で許可されたシステム ID。
commandTypestring必須公開済み契約におけるコマンドタイプ。
canonicalIrHashstring必須現在公開されている正規 IR ハッシュ。
releaseIdstring / integer必須実際に公開された契約バージョン ID。
payloadobject必須describe の現在のコマンド契約に適合するペイロード。
releaseHashstring必須実際に公開された契約ハッシュ。
targetRecordIdstring / integerオプションまたは条件付き必須操作対象となる実際のターゲットレコード。
agentManifestHashstring必須実際の Agent 機能 manifest ハッシュ。
planIdempotencyKeystring必須業務計画の安定した冪等キー。

dfb_action_status

パラメーター型要件意味と範囲
actionPlanIdstring / integer必須現在の業務 Grant が所有するアクション計画 ID。

dfb_action_execute

パラメーター型要件意味と範囲
approvalTokenstringオプションまたは条件付き必須元のサーバーが発行した承認情報。独自に生成しないでください。
actionPlanIdstring / integer必須現在の業務 Grant が所有するアクション計画 ID。