DATAFOCUS · OT FLASH · R56

Руководство по подключению Agent и MCP к OT Flash

Протокол, авторизация, контракты инструментов и полный процесс вызова

Создавайте отслеживаемые приложения для данных и знаний с использованием публичного Remote MCP OT Flash r56. В этом руководстве описаны OAuth, сообщения протокола, справочник параметров всех объявленных инструментов, правила доказательств, условные возможности и процессы восстановления, а также готовый к запуску клиент и примеры на синтетических данных.

Разработчики Agent, инженеры по интеграции и администраторы

В прилагаемых примерах названия отображаемых полей сохранены на китайском языке. Перевод языка интерфейса и пояснительного текста не изменяет фактические имена таблиц, столбцов, значения перечислений, названия инструментов или поля протокола.

Глава 1

Область подключения Agent и критерии завершения

Выберите точку входа авторизации и на основе квитанций сервера выполняйте запросы, сбор доказательств или контролируемую запись.

OT Flash r56 предоставляет внешним Agent через Remote MCP возможности работы с данными и знаниями в рамках онтологии, а также отдельную точку входа в Business Workspace. Agent должен определять, какие операции ему доступны, по фактическим tools/list, inputSchema, scope OAuth и текущим правам на ресурсы; по статическому руководству нельзя заключать, что в развёртывании включены все необязательные функции.

Рис. A1. Внешний Agent использует исходные возможности запросов, знаний и бизнеса через OAuth и MCP. Схема интерфейсных связей.
ВходНазначениеГраницы
/mcpОнтология, таблицы данных, документные знания, нативный Search и условно открытые анализ и моделированиеПересечение текущих прав пользователя и ресурсов, выбранных при данной авторизации
/mcp/businessОбнаружение бизнес-систем, запросы, планы действий, состояние и выполнениеОтдельная авторизация бизнес-систем и опубликованные контракты
Страница встраивания агента онтологииДиалог с онтологией в интерфейсе для пользователя-человекаТребует реального сеанса входа; это не точка обмена на MCP Token без входа в систему

Классификация возможностей

  • Базовое чтение: онтология и ресурсы, позиционирование на графе, поиск знаний и полный исходный текст, детали авторизованных таблиц и Doris SQL.
  • Отдельное делегирование: dfc_search требует search:operate, при этом по-прежнему действуют права исходного пользователя и модели.
  • Условно открытые: анализ, постоянные отчёты, черновики артефактов и их применение, запросы моделей онтологии и делегированные задачи Agent.
  • Недоступные возможности: dfc_etl для Flash только сообщает 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; Business Workspace использует /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": {}
    }
  }
}

Проверки перед подключением

  • Корневой адрес ресурса, issuer OAuth и внешний адрес обратного прокси совпадают.
  • Клиент поддерживает соответствующее поколение протокола, а не отправляет безусловно 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 JSONДинамическая регистрация public client
/oauth/authorizeGET или form POSTВход, выбор ресурса и подтверждение авторизации
/oauth/tokenPOST formОбмен кода авторизации и обновление с ротацией
/oauth/revokePOST formОтзыв Token
/oauth/grantsGETПросмотр авторизованных подключений вошедшим пользователем
/oauth/grants/revokePOST formОтзыв подключения по сценарию исходной страницы

Порядок авторизации

  1. Прочитайте метаданные защищённого ресурса и сервера авторизации. Ответ 401 на запрос без Token и заголовок WWW-Authenticate указывают на адрес обнаружения ресурса.
  2. Зарегистрируйте клиент или используйте существующую идентификацию клиента. В r56 при динамической регистрации public client используется token_endpoint_auth_method=none; нельзя заменять PKCE клиентским секретом.
  3. Сгенерируйте случайные state и code_verifier, вычислите code_challenge S256.
  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 только для Bearer-аутентификации MCP. Для обновления используйте исходный процесс 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"]
}

Обратный вызов веб-клиента использует HTTPS; нативные клиенты могут использовать поддерживаемые loopback-адреса. При авторизации и обмене на Token обратный вызов должен точно совпадать с зарегистрированным. Один Grant относится к одному protected resource; не смешивайте scope онтологии и Business Workspace в одном подключении.

Жизненный цикл Token

По умолчанию на сервере r56 access token — 3600 секунд, refresh token — 2592000 секунд, код авторизации — 300 секунд; развёртывание может переопределить эти значения. Клиент должен ориентироваться на expires_in из ответа token и на фактические ошибки, не зашивая значения по умолчанию в код. После обновления замените сохранённый Token; отзыв роли, прав на ресурс или Grant приводит к отклонению последующих вызовов.

Глава 4

Scope, границы ресурсов и права в реальном времени

Авторизованный scope лишь делегирует существующие права: он не повышает роль и не делает бизнес-состояние общим для разных Grant.

ScopeТипичные возможностиВажные ограничения
ontology.metadata:readОнтология, ресурсы, структура таблицОнтология и таблицы должны входить в авторизацию и быть доступны для чтения в данный момент
ontology.graph:readПоиск по графу и соседиВозвращается информация о позиционировании, а не доказательства фактов
ontology.knowledge:readПозиционирование знаний и полный исходный текстСохраняются исходные права баз знаний и документов
ontology.table:querySQL-запросы к таблицам онтологии и запросы к опубликованным моделямДля запроса таблицы также нужен scope metadata; действуют фактические источники и права на столбцы
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 требует двух scope чтения: graph и knowledge. dfc_knowledge_search/detail требует knowledge. published_model/published_query используют table:query; candidate_query дополнительно требует authoring.artifact:read. Инструменты анализа также проверяют разрешённые scope доказательств; постоянные отчёты требуют metadata и table query.

Не зашивайте авторизацию по умолчанию

Набор scope онтологии по умолчанию для r56 включает table query; Search и ETL требуют явного делегирования. Окончательным критерием остаются метаданные обнаружения, страница авторизации, фактический scope Token и tools/list. Утверждения из старой документации о том, что «у онтологии по умолчанию заведомо нет SQL» или «только шесть инструментов», не отражают текущую реализацию.

Изоляция состояний

Сеансы, отчёты, кандидаты и планы действий имеют собственных владельцев и области действия. Обновление access token не передаёт работу исходного Grant другому Grant. Не объединяйте с текущим подключением sessionId, reportId, planId, токены утверждений или Token источников, возвращённые другим подключением.

Глава 5

Сообщения HTTP и современного MCP

Правильно отправляйте метаданные по каждому запросу и соответствующие заголовки маршрутизации; раздельно обрабатывайте HTTP и результаты инструментов.

ПараметрПоведение r56
Транспорт Stateless 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Не предоставляются этими двумя публичными точками входа MCP
Кэширование каталогаОтветы современного обнаружения и списков содержат ttlMs=60000 и cacheScope=private
Обычный результатСовременный результат содержит resultType=complete и метаданные идентификации сервиса

Содержимое, которое должно совпадать

  • MCP-Protocol-Version совпадает с io.modelcontextprotocol/protocolVersion в params._meta.
  • Mcp-Method совпадает с методом JSON-RPC.
  • Mcp-Name для tools/call совпадает с 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 Token в URL, в параметры JSON или в ключи кэша.

Чтение результата

Сначала обработайте статус HTTP, затем проверьте JSON-RPC error; при наличии result продолжите проверку isError. Успешный результат инструмента обычно предоставляет structuredContent, а также text-содержимое с тем же бизнес-JSON; отдавайте приоритет структурированному каналу и не учитывайте text и structuredContent дважды как два независимых набора фактов. HTTP 200 может содержать ошибку инструмента.

Публичные ресурсы и UI

Встроенный ресурс с инструкциями не зависит от MCP Apps. При этом точке входа Business Workspace ресурс с описанием онтологии не предоставляется. Клиенты с поддержкой визуализации должны обнаруживать соответствующий UI через фактически объявленные возможности и tool _meta и не угадывать 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_* и инструменты артефактовОтдельно проверяйте кандидатов, планы, утверждения и фактическое применение
Выполнение бизнес-командdfb_* для /mcp/businessОпубликованный контракт и квитанция исходного 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. Вызовите dfc_ontology_resources с реальным ontologyId; при необходимости выберите 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 другой онтологии
ID табличного ресурсаСписок tables или надёжный контекстphysicalName или отображаемое имя таблицы
tblDisplayName colDisplayNameМетаданные текущей таблицы и столбцовУгаданный физический идентификатор SQL
knowledgeIdknowledgeBindings или фактическая квитанция поиска знанийID документного ресурса
assetId documentId chunkId evidenceIdОдна и та же фактическая квитанция позиционированияПоля, собранные из разных результатов позиционирования
rid revisionId releaseIdОпубликованная модель или серверный контекст кандидатаСамостоятельно сгенерированный ID или latest

Соглашения о точности

Все 64-битные идентификаторы ресурсов предпочтительно передавать как десятичные строки, без преобразования через Number в JavaScript. Некоторые бизнес-схемы допускают 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, colDisplayName в columns и авторитетный 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

  • Используйте отображаемые имена таблиц и столбцов, заключая идентификаторы в двойные кавычки. Запрос должен быть одним запросом 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

DATE('now', ...) в SQLite — это не контракт дат Doris для данного входа. Не переносите в рабочий SQL способ офлайн-проверки на SQLite из примеров документации.

Чтение квитанции запроса v8

evidenceRows — единственный канал, по которому Agent получает построчные данные; raw data для Agent недоступны. Числа в SQL кодируются как точные десятичные строки JSON; их числовой и бизнес-тип определяйте по resultColumnContracts, и их не следует интерпретировать как VARCHAR только потому, что в JSON значение передаётся строкой. Читайте 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

Поиск в знаниях: полный исходный текст и пригодность доказательств

Разделяйте позиционирование, чтение и цитирование фактов, сохраняя источник и полноту.

Два распространённых пути

ПутьНазначениеКлючевые моменты
dfc_ontology_queryПоиск в привязанных к онтологии знаниях с возможной маршрутизацией по графуПроверка полного canonical answerContextItems и пригодности доказательств
dfc_knowledge_search → фрагмент dfc_knowledge_detailЯвный поиск для позиционирования, затем чтение выбранного фрагментаПредпросмотр поиска не является фактом; читайте полный исходный текст по тому же позиционированию
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, позиция в графе, поисковые сводки и предпросмотр не заменяют канонический исходный текст.
  • В первую очередь копируйте evidenceId; когда требуются chunkId и documentId, они должны быть взяты из одного и того же результата позиционирования; не склеивайте и не придумывайте их.

Маршрутизация по графу

Результат search/neighbors — это информация о позиционировании. В query онтологии передавайте только объекты routeLocator, полностью возвращённые сервером, включая привязки, версии и поля подтверждения подлинности. Не упаковывайте самостоятельно assetId или knowledgeId в подобие выданного сервером locator и не передавайте обратно заявленные моделью подтверждения источника.

Восстановление структурированных документов

structuredPlan для dfc_ontology_query — это ограниченное восстановление с детерминированной проверкой, предназначенное специально для таблиц нестандартной структуры в документах. Используйте план, объявленный сервером, только после возврата текущего executionContractSha256, tableIndex, столбцов и полной таблицы. Обычные уже импортированные бизнес-таблицы должны обрабатываться через dfc_tableSQL; не используйте восстановление Markdown-таблиц как способ обойти авторизацию табличных запросов.

Рис. A6. Цепочка доказательств от результата позиционирования к цитируемому исходному тексту. Схема.

Стратегия поиска

knowledgeIds обычно опускается, чтобы охватить текущие включённые привязки; если параметр передаётся, используйте только реальные ID баз знаний из knowledgeBindings. Не указывайте ID ресурса документа как ID базы знаний. Для каждого нерешённого вопроса выполняйте новый ограниченный поиск и избегайте точных повторов, не дающих новых доказательств.

Глава 13

Соглашения по языку и регионам

Сохраняйте границы между UI locale, словарём запросов, языком ответа и именами исходных полей.

Приоритет: явно запрошенный язык, язык прикладной системы, locale фактического исполняющего узла. Отсутствующее значение, null, пустая строка и строка из пробелов не приводят к безусловному откату на китайский. Значения регионов в 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-USID региона в продукте — 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Не разбивать на слова по пробелам, как в английском
Арабский (Саудовская Аравия и ОАЭ)ar-SA ar-AEПояснения интерфейса поддерживают RTL; идентификаторы протокола не инвертируются

Использование каталога ключевых слов

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

Статический каталог ключевых слов dfc_manual содержит только явно перечисленные locale; если locale не указан, используется английская справочная версия — это справочное значение по умолчанию, а не правило разбора языка запросов. Если для регионального варианта статический каталог не предоставлен, получайте фактические предложения через assist текущего сеанса; не придумывайте псевдонимы и резервные результаты. За один вызов в names — не более 32 элементов.

Что не переводится

  • Таблицы, столбцы, значения перечислений, имена клиентов, имена формул и прочие фактические строки модели.
  • Имена инструментов, action, scope, поля Schema, коды ошибок и значения состояний.
  • ID ресурсов, хеши, opaque locator и ссылки, выданные сервером.

Например, вопрос на немецком языке может обращаться к столбцу с китайским отображаемым именем «销售金额». Замена его на немецкое имя столбца создала бы другой идентификатор, а не перевод интерфейса. После смены языка заново инициализируйте или обновите сеанс по исходному протоколу и заново получите предложения и кандидатов для устранения неоднозначности.

Глава 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Получение одной страницы серверной ветвиИсходная ветвь и версия результата 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. Проверяйте статус, полноту, политику уровня строк и источник каждой структурированной ветви по отдельности; завершение одной ветви не означает полноту всего анализа.
  3. Проверьте документальные доказательства, реестр фактов, пригодность для цитирования и ограничения. Сгенерированный моделью текст не может самостоятельно повысить пригодность доказательств.
  4. Для уточняющего вопроса опирайтесь на последний полный результат и передавайте expectedRevision; при повторной попытке того же изменения используйте тот же ключ идемпотентности.
  5. Перед закрытием убедитесь, что в сеансе больше не выполняется работа; отмена и закрытие — разные действия.

Управляемая фильтрация и разбиение на страницы

filter_patch использует предоставленные сервером branchId, fieldRef, valueRef и допустимые операторы; текущий типизированный фильтр объявляет только EQ. Запрещается заменять непрозрачные ссылки сырым SQL, tableId, columnId или самодельным деревом фильтров на стороне клиента. Постраничный параметр pageNo начинается с 1, максимум 10000; pageSize — максимум 100.

Рис. A7. Привязка ветвей, версий и страниц; после изменения источника или версии выполните запрос повторно, чтобы получить новое позиционирование. Схема.

Подсказки о возможностях и поведение

Аннотации инструментов (annotations) являются подсказками для клиента, а не механизмом авторизации. Некоторые универсальные шаблоны используют readOnlyHint, что не заменяет оценку фактического действия; отмена, закрытие и создание отчётов изменяют соответствующее рабочее состояние. Всегда выполняйте действия в соответствии с семантикой инструмента, целями пользователя и правами доступа на стороне сервера.

Глава 15

Постоянные визуальные отчёты и MCP Apps

Создавайте восстанавливаемые отчёты и читайте их результаты и интерактивный интерфейс согласно текущим правам доступа.

dfc_report_* управляется через datafocus.mcp.analysis.report-tools.enabled и требует scope metadata и table query. В отличие от сеансов 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. При создании используйте стабильный idempotencyKey длиной от 8 до 128 поддерживаемых символов.
  2. Сохраните reportId, опрашивайте status и проверяйте фактические состояния: завершено, сбой, частично завершено или отменено.
  3. При чтении результатов проверяйте структурированные ветви, визуализации, источники фактов, ссылки на документы и полноту.
  4. Для отмены незавершённого отчёта используйте исходный reportId; не создавайте вместо отмены другой отчёт.
  5. После сетевого тайм-аута сначала прочитайте состояние исходного отчёта; повторная отправка с исходным ключом идемпотентности должна сохранять то же бизнес-намерение.

MCP Apps

Клиенты с поддержкой UI-расширений считывают страницы отчётов через _meta инструмента и фактическое обнаружение ресурсов. Страница постоянного отчёта для r56 — ui://datafocus/analysis-report/v16/index.html, интерактивный анализ использует соответствующие ссылки на серверные ресурсы; клиент не должен жёстко прописывать эти значения вместо возвращаемых инструментом. Без UI-расширения структурированные результаты по-прежнему доступны для чтения.

Привязка к источнику (Origin)

При чтении отчёта повторно проверяются Grant, онтология, привязка Origin запроса и текущие права доступа к таблице. Кросс-доменная (cross-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 и другие предоставляйте в соответствии с возвращённым контрактом; не придумывайте внутреннюю структуру кандидата.

Параллелизм и повторные попытки

План привязан к целевой версии, хешу кандидата и ключу идемпотентности. После изменения цели старый план не может быть применён; перечитайте контекст и обработайте фактический конфликт. Тайм-аут транспорта не доказывает сбой: сначала с помощью dfc_artifact_status запросите исходный proposalId или planId. READY — это не APPLIED.

Утверждение и автоматическая политика

Для универсальных планов артефактов требуется исходное ручное утверждение. Планы, соответствующие политике автоматической публикации онтологии, обрабатываются согласно approvalMode; от пользователя не требуется дополнительно подписывать придуманное агентом утверждение. approvalToken — это материал, выпущенный сервером, и его нельзя заменить строкой, написанной Agent; фактический inputSchema и квитанция плана определяют обязательные поля.

Глава 17

Контракты создания кандидатов онтологии и публикации

Используйте декларации онтологии и конфигурацию публикации с собственным версионированием; не применяйте к публикации моделей контракты обычных артефактов отображения.

Создание кандидата

Контейнер онтологии должен уже существовать и входить в Grant. Используйте dfc_ontology_table_schema для проверки текущих полей структурированного источника и отпечатка v4 Binding; для поля можно указать только sourceField — тип будет определён автоматически. При явной декларации DECIMAL нужны текущие точность и число знаков после запятой; для других типов эти два поля не передаются.

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. Сохраните proposalId, возвращённый submit, и исходный 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 означает, что следует восстановить исходную квитанцию по исходным координатам и исходному ключу, а не создавать новый запрос со стороны клиента. Пробелы, выявленные итоговой проверкой, нельзя превратить в успешную публикацию сменой ключа или повторной отправкой.

Бизнес-полномочия человека

instruction и декларации, предоставленные Agent, являются входными данными Agent, а не утверждением политики человеком. MODEL_AUTHOR, MODEL_PUBLISH, делегирование автоматической публикации, бизнес-подтверждение, доверие к открытым ключам, бюджеты и ACL источников по-прежнему определяются исходными механизмами. Недопустимо заменять эти факты полями клиента.

Глава 18

Опубликованные модели: запрос кандидатов и замыкание ссылок

Используйте опубликованные бизнес-знания по точным версиям и сохраняйте временный характер неопубликованных кандидатов.

published_model, published_query и candidate_query в dfc_ontology_graph — это условно открытые структурированные конфигурации, а не синонимы обычных search/neighbors. Они авторизуются по table query и необходимым правам на чтение моделей; видимость в графе не заменяет прав доступа к таблицам.

Чтение опубликованных моделей

  1. Когда перечисление action инструмента фактически содержит published_model, отправляйте реальный зафиксированный (committed) releaseId.
  2. v1 возвращает шаблоны авторизованных запросов; v2 добавляет точные ссылки PERSISTED и releaseSelections; v3 добавляет ссылки на зависимости, точные domainRef и компактные шаблоны привязки.
  3. Выбирайте объекты, атрибуты, Binding, scope и версии из фактических возвращаемых значений; не генерируйте RID самостоятельно и не используйте latest.
  4. Отправляйте фиксированные типизированные запросы published_query; результаты всё равно проходят проверку текущих прав на источник и поля.

Запрос кандидатов

candidate_query использует фактический workspaceId, revision, candidateHash и декларации кандидата. Если наряду с ними используются опубликованные ссылки, применяйте соответствующие типизированные координаты v2 LOCAL/PERSISTED и точный выбор. Результаты по кандидату всегда остаются неопубликованными и временными; не считайте их подтверждёнными знаниями организации.

Локальное сопровождение и замыкание

Выбирайте только транзитивные зависимости, необходимые корню кандидата, и обеспечьте точные releaseSelections для каждой опубликованной ссылки. Копирование содержимого публикации, отправка только набора идентификаторов или расширение на все исторические ресурсы не заменяют проверку текущих зависимостей и источников.

Рис. A9. Корень кандидата, точные опубликованные зависимости и авторизация источников. Схема замыкания ссылок.

Параметр query этих action — версионированный типизированный объект; он не принимает SQL, физические идентификаторы таблиц или имена исходных таблиц вместо бизнес-ссылок. Шаблоны метаданных и результаты графа сами по себе непригодны для цитирования как факты.

Глава 19

Делегирование задач агенту онтологии

Возобновляйте работу через постоянные задачи и исходный Grant; не считайте инструкции Agent утверждением человека.

dfc_ontology_agent отображается только при фактической доступности Pi Runtime и соответствующих прав. QUERY использует возможности чтения; AUTHORING дополнительно требует роль моделирования и соответствующий scope authoring. Инструмент не открывает доступ к какому-либо другому движку выполнения без ограничений.

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 не является квитанцией публикации модели. Задача публикации по-прежнему подтверждается через состояние исходного артефакта и проверки источников; QUERY не даёт подразумеваемых прав на запись или публикацию.

Глава 20

Business Workspace 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 считывают текущие разрешённые записи и задачи.
  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. После обновления Access Token планы того же подключения по-прежнему можно обрабатывать, а другое подключение OAuth не может их перехватить. При выполнении повторно проверяются опубликованная версия, хеши IR/manifest, версия целевой записи, срок действия плана, идемпотентность и утверждение. Allowlist OAuth не позволяет обойти бизнес-управление.

Глава 21

Ввод бизнес-знаний и вопросы на подтверждение

Регистрируйте бизнес-ввод, когда открыты соответствующие рабочие обработчики, и сохраняйте границу подтверждения человеком.

Следующие четыре инструмента добавляются публичным контроллером MCP в зависимости от установленных обработчиков и текущих scope. Они не всегда присутствуют в базовом каталоге. Наличие объявленной Schema не означает, что для экземпляра настроены обработчики, бюджеты или права; сначала проверьте tools/list.

ИнструментНазначениеКакие права или эффекты не возникают
dfc_ontology_knowledge_input_proposeРегистрация исходного бизнес-ввода для существующего рабочего пространстваНе генерирует вопросы для подтверждения, не утверждает, не публикует
dfc_ontology_knowledge_input_previewВременный предпросмотр черновиков вопросов из исходного вводаНе сохраняет, не подтверждает, не формирует квитанцию рабочей среды
dfc_ontology_knowledge_question_submitСохранение составленных (authored) и неподтверждённых вопросовНе объединяет ответы автоматически, не даёт прав ответственного лица или прав публикации
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.

Точка подтверждения человеком

knowledgeConfirmationPage, возвращаемый question_submit, — это лишь относительная ссылка на исходную страницу входа с предзаполненным вопросом. Он не содержит Bearer, не открывает страницу автоматически и не подтверждает знание. QUESTION_STORED_UNCONFIRMED явно указывает, что подтверждение ещё не выполнено; в ответе нельзя писать, что «знание опубликовано».

Инициализация области потребителей

business scope initialize требует одновременно права публикации онтологии и прав создателя либо прав управления SourceManager для конкретной бизнес-системы. Он использует реальные координаты domainRid, domainRevisionId и businessSystemId; клиент не может подставить произвольные consumerScope или доказательство завершения. Возвращаемые INITIALIZED и COMPLETED по-прежнему явно содержат published=false и activationAuthorized=false.

Эти запросы также проходят строгую проверку JSON, набора полей, байтов и глубины. Лимит входного запроса — 1 MiB; у отдельных конкретных операций лимиты меньше. Полные схемы ввода и вывода поставляются вместе со справочником инструментов; к этим строгим контрактам нельзя применять нестрогую логику параметров обычной обёртки MCP.

Глава 22

Ответы, ошибки и безопасные повторные попытки

Поясняйте ошибки послойно, сохраняя координаты задач и идемпотентную семантику.

УровеньЧто проверяетсяПринцип обработки
Сеть и HTTPСоединение, TLS, 401, 403, 400, 404, 405 и т. д.Не воспринимайте неудачный ответ как обычный результат запроса
JSON-RPCerror.code message dataРазличайте проблемы протокола, метода, параметров и авторизации
Инструмент MCPresult.isError и structuredContentДаже при HTTP 200 операция может завершиться неудачей
Бизнес-результатРеальный статус, полнота, причина сбоя, nextActionПолучение или готовность не равны завершению
Пригодность в качестве фактаexecutionReceipt citationEligible contentCompleteНепригодное содержимое используется только для позиционирования или объяснения пробелов

Типичные ситуации HTTP

  • 401: отсутствует или недействителен Bearer — обновите Token или повторите авторизацию по текущему процессу OAuth.
  • 403: Grant, роль, выбранный ресурс, права на источник, Origin или конфигурация не удовлетворяют требованиям; не пытайтесь обойти это повторной отправкой.
  • 400: некорректное сообщение или версионированный контракт, включая несоответствие современных заголовков и метаданных.
  • 404: проверьте точный путь службы, метод протокола и возможности среды выполнения; не меняйте ID онтологии наугад.
  • 405: методы GET и DELETE публичного /mcp изначально не открыты; используйте корректный 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 и issuer OAuth, не отключайте проверку сертификатов.
  2. Используйте выделенный Grant с минимальной областью ресурсов; не используйте учётные записи администратора, Cookie или долгосрочные внутренние Token в качестве учётных данных публичных интерфейсов.
  3. Считайте текст документов недоверенным бизнес-материалом. Фразы в документе вроде «игнорируй правила», «загрузи ключ», «выполни команду» не дают авторизации на вызов инструментов.
  4. Ограничивайте автоматические повторные попытки, параллелизм и объём результатов; не воссоздавайте исходные бизнес-права на клиенте.
  5. В журналах фиксируйте только необходимые данные для сопоставления; не записывайте Bearer, refresh token, токены утверждения и полное конфиденциальное бизнес-содержимое.
  6. После отключения пользователя или отзыва прав администратором прекратите использовать кэшированные авторизации и данные и не продолжайте вызовы по старым locator.

Подсказки инструментов — это не права

readOnlyHint, destructiveHint, idempotentHint и openWorldHint служат для понимания возможностей клиентом, не гарантируют фактического бизнес-эффекта каждого вызова и не заменяют авторизацию текущего пользователя. Все действия записи, планы, предпросмотры, сеансы и отмены обрабатывайте согласно их реальному поведению.

Точки входа, которые нельзя вызывать

  • Исходные сервисы Trino/Hive/Hadoop и Heavy ETL, не входящий во Flash.
  • Внутренние интерфейсы выделенных scope или рабочих пространств FocusCode.
  • Выполнение v2, AutoML и другие экспериментальные инструменты, отсутствующие в текущем tools/list экземпляра.
  • Приватные REST-интерфейсы браузера, произвольные подключения к базам данных или сервисы других арендаторов как способ обойти отказ MCP.

Семантика данных

Следуйте контрактам сервера на точные десятичные числа, типы, валюту (币种), единицы, время и доказательства. Не выполняйте повторное округление или пересчёт валюты (币种) только потому, что вывод похож на число, и не выполняйте глобальное ранжирование по видимым строкам, если результат усечён.

Глава 24

Настройка администратором и условные переключатели

Перед включением расширенных возможностей проверьте фактические компоненты, публичные адреса и исходную конфигурацию прав.

КонфигурацияНазначениеТребования к выпуску
datafocus.mcp.public-base-urlОфициальный внешний корневой адресСогласованность обнаружения OAuth, issuer, обратных вызовов и обратного прокси
datafocus.mcp.allowed-originsДополнительные одобренные источники (Origin) браузераТочная конфигурация без расширения до произвольных источников
datafocus.mcp.oauth.route-proof-secretВыделенный секрет сервера для подтверждения маршрутизации графаХранится отдельно; Bearer не используется в качестве ключа
datafocus.mcp.analysis.tools.enabledИнструменты интерактивного анализаРеальная доступность сопутствующих служб данных, знаний и прав
datafocus.mcp.analysis.report-tools.enabledИнструменты постоянных отчётовДоступность сопутствующего хранилища, worker и цепочки восстановления
datafocus.mcp.analysis.apps.enabledОтображение MCP AppsЗаявленная поддержка клиентом и проверка возвращаемого _meta
datafocus.mcp.authoring.enabledКонтракты черновиков и моделированияСохранение исходных прав администратора и ресурсов
datafocus.mcp.authoring.apply-enabledВозможность применения артефактовНеизменяемый план, исходные утверждения и повторная проверка текущего статуса
datafocus.mcp.ontology-published-query-enabledОпубликованные модели и запросыРеально зафиксированная (committed) версия и авторизация источника
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 был импортирован с исходными именами столбцов; без соответствующей схемы отправлять его как есть нельзя.

Другие сценарии

  • Бизнес-точка входа: используйте --endpoint business, чтобы заново получить Grant для /mcp/business.
  • Старые клиенты: выберите --protocol 2025-11-25, сначала выполните initialize, затем вызывайте по тому же протоколу.
  • Встроенные описания: используйте resources или read-resource для чтения фактического URI.
  • Автономная самопроверка: --self-test проверяет построение современных заголовков и метаданных; Token не нужен, сервер продукта не запрашивается.

Границы примеров

Клиент — это отправная точка протокольного подключения, он не генерирует кандидатов моделирования, не сохраняет ответы и не выполняет публикацию автоматически. Он выводит исходный JSON, чтобы вышестоящий Agent мог сверить бизнес-статус; не обещайте пользователю завершение запроса, отчёта или публикации только по коду выхода процесса.

Глава 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: модель, init, предложения, результаты, закрытие и проверки целостности буфера пройдены.
  7. Необязательные анализ и отчёты: реальные состояния нескольких ветвей, переход по страницам, изменение прав и отмена работают как в исходной системе.
  8. Необязательное моделирование: кандидат, план, исходное утверждение, фактическое применение и запрос версии проверяются поэтапно.
  9. Бизнес-действия: хеш публикации, целевая версия, утверждение, идемпотентность и изоляция между Grant проверены.
  10. Восстановление: после сетевого тайм-аута восстанавливается исходное состояние, после обновления источника старое позиционирование перестаёт действовать и используется новый запрос.

Запись результатов

Записывайте версию экземпляра, роль пользователя, область Grant, версию конфигурации, фактические операции и результаты. Отдельно помечайте офлайн-самопроверку клиента протокола, ожидаемые значения для примеров CSV, рассчитанные офлайн, статическую проверку по схеме JSON и реальную функциональную приёмку в рабочей среде. Не экстраполируйте успешное прохождение одного этапа на успешное прохождение всего продукта.

Глава 28

Нормативные ресурсы и сопровождение

Используйте прилагаемые к руководству полные схемы инструментов и сверяйте их с фактическими результатами обнаружения на экземпляре.

РесурсыСодержание
reference/mcp-tool-catalog.jsonОбъявленные входные Schema для 32 инструментов онтологии и 8 бизнес-инструментов; для части инструментов есть и исходные выходные Schema
reference/locales.json21 доступный для выбора вариант, 24 совместимых locale и термины UI
reference/search-keywords.jsonСтатические каталоги ключевых слов для 17 явно указанных locale
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, operate для search или operate для ETL. Документация ETL является статическим межпродуктовым справочником; исполняемые возможности Flash по-прежнему ограничены тем, о чём он явно сообщает.

Внешние справочные материалы по протоколу

По протоколу MCP и вопросам авторизации обращайтесь к официальным спецификациям: https://modelcontextprotocol.io/specification/2026-07-28/basic и https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization. Конечные точки, инструменты и условное поведение данного продукта определяются реализацией r56 и фактически обнаруженными на экземпляре результатами; общую поддержку протокола нельзя приравнивать к наличию на сервере всех необязательных возможностей.

Обновление и сопровождение

При обновлении заново выполняйте обнаружение инструментов и версий, сравнивайте входные схемы, выходные контракты и конфигурацию; старые Grant автоматически не получают новых scope. Сохраняйте привязку ссылок, кэша и квитанций к версии источника; после подтверждения несовместимых изменений заново получайте контекст и не применяйте старое позиционирование к новому бизнес-состоянию.

Глава 29

Справочник параметров инструментов: базовые инструменты и нативный Search

Полные имена и поля ввода, сгруппированные по инструментам.

Приведённые ниже таблицы — справочник по полям ввода текущих инструментов r56. Полные вложенные типы, oneOf, условно обязательные поля, ограничения pattern и часть выходных Schema см. в reference/mcp-tool-catalog.json; перед финальной отправкой всё равно считайте tools/list текущего Grant. Пометка «опционально» в таблице не отменяет внутренних требований валидации действия.

dfc_manual

ПараметрТипТребованиеЗначение и диапазон
namesarrayОпционально или условно обязательноИскомые явные имена, не более 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Опционально или условно обязательноКоличество записей на странице; в пределах лимита Schema. minimum: 1; maximum: 100
pageintegerОпционально или условно обязательноНомер страницы, начиная с 1. minimum: 1

dfc_ontology_resources

ПараметрТипТребованиеЗначение и диапазон
resourceTypesarrayОпционально или условно обязательноНабор типов возвращаемых ресурсов.
ontologyIdstringОбязательноРеальный ID онтологии в рамках текущей авторизации, сохраняемый как строка.
pageSizeintegerОпционально или условно обязательноКоличество записей на странице; в пределах лимита Schema. minimum: 1; maximum: 100
pageintegerОпционально или условно обязательноНомер страницы, начиная с 1. minimum: 1
Глава 30

Справочник параметров инструментов: таблицы, граф и знания

Полные имена и поля ввода, сгруппированные по инструментам.

Приведённые ниже таблицы — справочник по полям ввода текущих инструментов r56. Полные вложенные типы, oneOf, условно обязательные поля, ограничения pattern и часть выходных Schema см. в reference/mcp-tool-catalog.json; перед финальной отправкой всё равно считайте tools/list текущего Grant. Пометка «опционально» в таблице не отменяет внутренних требований валидации действия.

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Опционально или условно обязательноID базы знаний из фактических knowledgeBindings.
querystringОбязательноТекст запроса или точный версионированный объект запроса, соответствующий action.
ontologyIdstringОбязательноРеальный ID онтологии в рамках текущей авторизации, сохраняемый как строка.

dfc_knowledge_search

ПараметрТипТребованиеЗначение и диапазон
topKintegerОпционально или условно обязательноВерхний предел возвращаемых кандидатов; не гарантирует полноту покрытия. minimum: 1; maximum: 20
minScorenumberОпционально или условно обязательноМинимальный балл совпадения. minimum: 0; maximum: 1
knowledgeIdsarrayОпционально или условно обязательноID базы знаний из фактических knowledgeBindings.
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Опционально или условно обязательноОдин SQL-запрос Doris только на чтение в рамках онтологии, с явными выходными столбцами.
Глава 31

Справочник параметров инструментов: анализ и отчёты

Полные имена и поля ввода, сгруппированные по инструментам.

Приведённые ниже таблицы — справочник по полям ввода текущих инструментов r56. Полные вложенные типы, oneOf, условно обязательные поля, ограничения pattern и часть выходных Schema см. в reference/mcp-tool-catalog.json; перед финальной отправкой всё равно считайте tools/list текущего Grant. Пометка «опционально» в таблице не отменяет внутренних требований валидации действия.

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ОбязательноКоличество записей на странице; в пределах лимита 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, условно обязательные поля, ограничения pattern и часть выходных Schema см. в reference/mcp-tool-catalog.json; перед финальной отправкой всё равно считайте tools/list текущего Grant. Пометка «опционально» в таблице не отменяет внутренних требований валидации действия.

dfc_ontology_agent

ПараметрТипТребованиеЗначение и диапазон
modestringОпционально или условно обязательноQUERY или AUTHORING; права на эти возможности предоставляются по отдельности. enum: QUERY, AUTHORING
instructionstringОпционально или условно обязательноТекст запроса пользователя; в context и submit он должен совпадать. maxLength: 16000
idempotencyKeystringОпционально или условно обязательноКлюч идемпотентности, стабильно используемый для одной и той же логической операции. maxLength: 128
actionstringОбязательноИмя операции. Используется в соответствии с текущим перечислением и параметрами соответствующего действия. enum: start, status, cancel
ontologyIdstringОбязательноРеальный ID онтологии в рамках текущей авторизации, сохраняемый как строка.
runIdstringОпционально или условно обязательноID исходной задачи той же онтологии и того же Grant.
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ОбязательноТекст запроса пользователя; в context и submit он должен совпадать.
variablesobjectОпционально или условно обязательноОбъект переменных, предоставляемый согласно возвращённому контракту.
previewInputobjectОпционально или условно обязательноОграниченный ввод предпросмотра, предоставляемый согласно контракту.
viewportobjectОпционально или условно обязательноОбласть просмотра (viewport), требуемая исходным контрактом.

dfc_ontology_table_schema

ПараметрТипТребованиеЗначение и диапазон
ontologyIdstringОбязательноРеальный ID онтологии в рамках текущей авторизации, сохраняемый как строка.
sourceAssetRefstringОбязательноЗарегистрированная ссылка на структурированный актив, например table:123.
fieldsarrayОбязательноПоля текущего источника с необязательными явными объявлениями типов. minItems: 1; maxItems: 64

dfc_artifact_preview

ПараметрТипТребованиеЗначение и диапазон
proposalIdstringОбязательноID исходного кандидата, созданного в рамках текущего Grant.
candidateHashstringОбязательноТочный хеш исходного кандидата, выданного сервером.
previewInputobjectОбязательноОграниченный ввод предпросмотра, предоставляемый согласно контракту.

dfc_artifact_status

ПараметрТипТребованиеЗначение и диапазон
proposalIdstringОпционально или условно обязательноID исходного кандидата, созданного в рамках текущего Grant.
planIdstringОпционально или условно обязательноID неизменяемого плана применения.

dfc_artifact_plan

ПараметрТипТребованиеЗначение и диапазон
proposalIdstringОбязательноID исходного кандидата, созданного в рамках текущего Grant.
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ОбязательноТекст запроса пользователя; в context и submit он должен совпадать.
Конфигурация 1 / variablesobjectОпционально или условно обязательноОбъект переменных, предоставляемый согласно возвращённому контракту.
Конфигурация 1 / previewInputobjectОпционально или условно обязательноОграниченный ввод предпросмотра, предоставляемый согласно контракту.
Конфигурация 1 / viewportobjectОпционально или условно обязательноОбласть просмотра (viewport), требуемая исходным контрактом.
Конфигурация 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, условно обязательные поля, ограничения pattern и часть выходных Schema см. в reference/mcp-tool-catalog.json; перед финальной отправкой всё равно считайте tools/list текущего Grant. Пометка «опционально» в таблице не отменяет внутренних требований валидации действия.

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

Справочник параметров инструментов: Business Workspace

Полные имена и поля ввода, сгруппированные по инструментам.

Приведённые ниже таблицы — справочник по полям ввода текущих инструментов r56. Полные вложенные типы, oneOf, условно обязательные поля, ограничения pattern и часть выходных Schema см. в reference/mcp-tool-catalog.json; перед финальной отправкой всё равно считайте tools/list текущего Grant. Пометка «опционально» в таблице не отменяет внутренних требований валидации действия.

dfb_systems

Корневой объект ввода этого инструмента не содержит полей; используйте пустой объект arguments.

dfb_system_describe

ПараметрТипТребованиеЗначение и диапазон
systemIdstring / integerОбязательноID систем, разрешённых текущим бизнес-Grant.

dfb_query

ПараметрТипТребованиеЗначение и диапазон
systemIdstring / integerОбязательноID систем, разрешённых текущим бизнес-Grant.
queryKeystringОбязательноОпубликованный ключ запроса, возвращённый describe.
objectKeystringОпционально или условно обязательноКлюч опубликованного объекта.
pageSizeintegerОпционально или условно обязательноКоличество записей на странице; в пределах лимита Schema. minimum: 1; maximum: 100
pageintegerОпционально или условно обязательноНомер страницы, начиная с 1. minimum: 1
statestringОпционально или условно обязательноФильтр бизнес-статуса или статус на стороне сервера.

dfb_record

ПараметрТипТребованиеЗначение и диапазон
recordIdstring / integerОбязательноID бизнес-записи, разрешённой к чтению в данный момент.
systemIdstring / integerОбязательноID систем, разрешённых текущим бизнес-Grant.

dfb_work_items

ПараметрТипТребованиеЗначение и диапазон
systemIdstring / integerОбязательноID систем, разрешённых текущим бизнес-Grant.

dfb_action_plan

ПараметрТипТребованиеЗначение и диапазон
expectedRecordVersionintegerОпционально или условно обязательноТекущая версия оптимистичной блокировки целевой записи. minimum: 1
systemIdstring / integerОбязательноID систем, разрешённых текущим бизнес-Grant.
commandTypestringОбязательноТип команды из опубликованного контракта.
canonicalIrHashstringОбязательноХеш канонического IR текущей опубликованной версии.
releaseIdstring / integerОбязательноФактический ID версии опубликованного контракта.
payloadobjectОбязательноПолезная нагрузка, соответствующая текущему контракту команды в describe.
releaseHashstringОбязательноФактический хеш опубликованного контракта.
targetRecordIdstring / integerОпционально или условно обязательноРеальная целевая запись, над которой требуется выполнить операцию.
agentManifestHashstringОбязательноФактический хеш manifest возможностей Agent.
planIdempotencyKeystringОбязательноСтабильный ключ идемпотентности бизнес-плана.

dfb_action_status

ПараметрТипТребованиеЗначение и диапазон
actionPlanIdstring / integerОбязательноID плана действий, принадлежащего текущему бизнес-Grant.

dfb_action_execute

ПараметрТипТребованиеЗначение и диапазон
approvalTokenstringОпционально или условно обязательноМатериалы утверждения, выданные исходным сервером; генерировать их самостоятельно запрещено.
actionPlanIdstring / integerОбязательноID плана действий, принадлежащего текущему бизнес-Grant.