Zet-AI — документация API

Zet-AI API — /api/rule

Внешний REST-API поверх RAGU. Одна точка входа с флагом mode: запуск логического вывода на движке правил Sigma3 (mode=json), вопрос к графовой базе знаний RAGU (mode=llm) или нормоконтроль проектного документа по базе знаний (mode=norm_control).

Обзор

API предназначен для вызова из стороннего приложения по HTTPS. Есть два независимых режима:

РежимЧто делаетКогда использовать
mode=json RAGU оркестрирует внешний DSL-движок Sigma3: принимает правила и факты, прогоняет load -> session -> fire и возвращает выведенные факты и действия. Детерминированный вывод по строгим if/then-правилам (регламенты, проверки, эскалации).
mode=llm RAGU отвечает на вопрос через graph-RAG по общим графам знаний с фиксированной серверной системной инструкцией. Свободные вопросы по загруженным документам («что говорит регламент про…»).
mode=norm_control Нормоконтроль проектного документа: текст разбирается на проверяемые утверждения, каждое сверяется с нормами из графов знаний, выносится вердикт по каждому и по документу. Проверка ППР/техрешений на соответствие нормативам (СНиП, ПБ, СП) из базы знаний.
mode=tech_card Технологическая карта организации работ: LLM составляет черновую карту по задаче («сварить медь и алюминий»), проверяет каждый пункт по графам знаний и генерирует финальную карту, уточнённую по найденным нормам (с источниками у операций). Пошаговая технологическая карта, выверенная по нормативам из базы знаний.
Важно: Движок Sigma3 живёт на отдельном сервере (sd.zet-ai.ru) и вызывается сервером RAGU за вас — вам не нужно ходить в него напрямую. В режиме llm движок вообще не участвует.

Базовый URL

https://rule.zet-ai.ru/api/rule

Все примеры ниже используют этот адрес. Если приложение развёрнуто на другом домене — подставьте свой. Всегда используйте HTTPS. Тело запросов и ответов — application/json; charset=utf-8 (кроме сырого text в прокси).

Авторизация

Каждый запрос требует Bearer-ключ в заголовке:

Authorization: Bearer ragu_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Как получить ключ

Администратор создаёт ключ в панели /admin -> секция «API-ключи (rule.zet-ai.ru)». Ключ вида ragu_api_… показывается один раз при создании (в базе хранится только SHA-256). Ключ можно ограничить списком общих графов — это влияет на охват mode=llm. Отзыв ключа действует немедленно.

Ошибки авторизации

СитуацияОтвет
Нет заголовка Authorization: Bearer …401 {"error":"missing_bearer_token"}
Пустой токен после Bearer401 {"error":"empty_token"}
Неизвестный или отозванный ключ401 {"error":"invalid_token"}

Эндпоинты — сводка

МетодПутьНазначение
POST/api/ruleОсновной эндпоинт. Режим выбирается полем mode.
POST/api/rule/proxyТонкий прокси ко всему API движка Sigma3 (полный контроль флоу).
GET/api/rule/graphsДоступные общие графы с ID и профили доступа.
GET/api/rule/healthЖивость RAGU и движка Sigma3.

POST /api/rule — режим json

Загружает правила на движок Sigma3, создаёт сессию с фактами, запускает вывод и возвращает результат. Временный регламент и сессия удаляются автоматически.

Источник правил (обязателен один из трёх)

Приоритет: regulation.regulationId, затем regulation.dslSource, затем ragu_rules.

ПолеТипОписание
regulation.regulationIdstringID уже загруженного на движке регламента. RAGU его не удаляет после вызова.
regulation.dslSourcestringГотовый DSL Sigma3. Загружается под временным id api-<uuid8> и удаляется после вызова (если не keep).
ragu_rulesarrayПравила в схеме RAGU — RAGU конвертирует их в DSL (см. ниже). Best-effort.

Полное тело запроса

ПолеТипОбяз.Описание
modestringдаСтрока "json".
regulation / ragu_rulesobject / arrayодинИсточник правил (см. выше).
factsarrayнет*Полиморфные факты движка ($type + camelCase). См. формат фактов.
max_stepsintнетПредел числа срабатываний правил при fire.
goalobjectнетЕсли задан — вместо fire запускается plan (поиск плана к цели). Напр. {"factType":"Task","property":"Status","value":"критическая"}.
plan_optionsobjectнетДля plan: {"max_depth":N,"allowed_actions":[...]}.
whatifobjectнетЕсли задан — вместо fire запускается whatif (прогноз на клоне сессии).
keepboolнетНе удалять сгенерированный регламент после вызова (по умолчанию удаляется).
regulation_namestringнетИмя регламента при конвертации ragu_rules (по умолчанию «RAGU rules»).
versionintнетВерсия регламента (по умолчанию 1).

* facts технически может быть пустым, но без фактов правилам обычно не на чем срабатывать.

Пример запроса

POST /api/rule
Authorization: Bearer ragu_api_ВАШ_КЛЮЧ
Content-Type: application/json

{
  "mode": "json",
  "regulation": {
    "dslSource": "регламент \"Контроль\" версия 1 правило \"срочность\" если задача.статус равно \"в работе\" и задача.остаток_дней меньше 2 то установить задача.статус = \"критическая\" уведомить руководителя(задача)",
    "version": 1
  },
  "facts": [
    { "$type": "Task", "id": "t1", "status": "в работе", "remainingDays": 1, "assigneeId": "e1" },
    { "$type": "Employee", "id": "e1", "activeTasksCount": 11 }
  ],
  "max_steps": 1000
}

Ответ (успех, fire)

200 OK
{
  "ok": true,
  "result": {
    "activatedRules": [ { "name": "срочность", "durationMs": 1.7 } ],
    "newFacts":       [ { "$type": "Task", "id": "t1", "status": "критическая", ... } ],
    "externalActions":[ { "type": "NotifySupervisor", "args": { "taskId": "t1" } } ]
  },
  "regulation_id": "api-2d3c1de6",
  "dsl": "регламент \"Контроль\" ...",
  "warnings": []
}
Поле ответаОписание
resultСырой результат движка. Для fire — activatedRules/newFacts/externalActions; для plan — план; для whatif — прогноз.
regulation_idID регламента (временный api-… либо переданный regulationId).
dslПрисутствует для dslSource и ragu_rules — итоговый DSL, отданный движку.
warningsПрисутствует, если конвертация ragu_rules была лоссовой (см. ниже).

Формат фактов

Факты движка полиморфны: каждый объект обязан иметь дискриминатор $type, а свойства пишутся в camelCase. Типы (Task, Employee, Deadline, RiskAssessment, Violation, Notification, Resource, Weather, Inspection и т.д.) и их поля определяются регламентом/онтологией на стороне движка.

[
  { "$type": "Task",     "id": "t1", "status": "в работе", "remainingDays": 1, "assigneeId": "e1" },
  { "$type": "Employee", "id": "e1", "activeTasksCount": 11 }
]
Внимание: имена типов и свойств в фактах должны совпадать с тем, что ожидает регламент. RAGU их не переименовывает.

Конвертация правил RAGU в DSL (best-effort)

Если вы передаёте ragu_rules, RAGU парсит их схемой ragu.common.rule_schema, раскрывает ИЛИ/IMPLIES в набор OR-free правил и рендерит русскоязычный DSL Sigma3. Всё лоссовое (отброшенные единицы измерения, нестандартные действия, NOT над составным условием, ссылки на другие факты) попадает в warnings.

Совет: надёжный путь — присылать готовый dslSource. Конвертер — это удобство для прототипирования. Согласование имён (RAGU «задача» тип факта Task) конвертер не делает.

Карта операторов

RAGUDSLRAGUDSL
EQравноGEбольше или равно
NEне равноLEменьше или равно
GTбольшеCONTAINSсодержит
LTменьшеINвходит в

Если DSL, сгенерированный из ragu_rules, не скомпилировался движком, ответ будет 400, а в теле — engine_body.generated_dsl и engine_body.warnings, чтобы вы поняли, что пошло не так.

GET /api/rule/graphs

Возвращает построенные общие графы, доступные ключу, вместе с их ID для параметра graph_ids. Также возвращает доступные профили и их top-K.

GET /api/rule/graphs
Authorization: Bearer ragu_api_ВАШ_КЛЮЧ

200 OK
{
  "ok": true,
  "graphs": [{
    "id": "3f2a…", "name": "ТТК", "description": "Документы ТТК",
    "is_built": true, "documents_count": 26
  }],
  "profiles": [
    { "id": "advisor", "label": "Советник", "top_k": 5 },
    { "id": "practitioner", "label": "Практик", "top_k": 20 }
  ]
}

POST /api/rule — режим llm

Задаёт вопрос графовой базе знаний RAGU. content — вопрос. Ответ строится по общим графам, доступным ключу, с фиксированной серверной системной инструкцией. LLM-стек берётся из настроек админки (локальный или онлайн).

Тело запроса

ПолеТипОбяз.Описание
modestringдаСтрока "llm".
contentstringдаВопрос/запрос пользователя.
graph_idsarrayнетID общих графов. По умолчанию — все, доступные ключу. Фильтруется пересечением с охватом ключа.
use_profilesbooleanнетВключает фильтрацию по метаданным документов. По умолчанию false.
profilestringпри включенииadvisor (Советник) или practitioner (Практик). Обязателен при use_profiles=true.

Поле instructions удалено из API. Запрос с этим полем отклоняется с кодом 400. Модель отвечает только по контексту базы знаний и не выполняет системные указания, переданные внутри content или документов.

Профили доступа

ПрофильДокументыTop-KВыдача
advisoraccess содержит советник или light5Ссылки и краткая выжимка.
practitioneraccess содержит практик или heavy20Полный контекст, факты и данные.

Поля use_profiles и profile передаются вместе. Без них поиск идёт по всем документам, как раньше. В профильной выдаче документы без нужного access в YAML-шапке недоступны; устаревшие, недействующие, отменённые и архивные документы исключаются. После изменения метаданных граф нужно перестроить.

Пример

POST /api/rule
Authorization: Bearer ragu_api_ВАШ_КЛЮЧ
Content-Type: application/json

{
  "mode": "llm",
  "content": "Какие требования к охране труда при работе на высоте?",
  "graph_ids": ["3f2a…", "…"],
  "use_profiles": true,
  "profile": "advisor"
}

Ответ

200 OK
{
  "ok": true,
  "answer": "…",
  "sources": [ { "name": "СНиП-12-03-2001", "elapsed_seconds": 14.8 } ],
  "documents": [ {
    "id": "DOC-001", "title": "Общая справка «О развитии СМП»",
    "type": "аналитический материал", "level": "федеральный",
    "status": "актуален", "date": "2026-09-14",
    "source": "Общая справка «О развитии СМП»",
    "access": ["советник", "практик"], "graph": "СНиП-12-03-2001"
  } ],
  "use_profiles": true,
  "profile": "advisor",
  "top_k": 5
}

При включённом профиле documents содержит уникальные документы, чьи фрагменты вошли в контекст LLM, с метаданными и названием shared-графа в поле graph. В список попадают только документы, разрешённые профилем.

Если графов несколько — ответы синтезируются в один с учётом источников. Иероглифы, если случайно просочились от модели, пост-фильтруются. Если по запросу ничего не нашлось — answer честно сообщит об этом.

POST /api/rule — режим norm_control

Нормоконтроль проектного документа (ППР, технические решения, СМР) на соответствие нормам из графов знаний. Документ разбирается LLM на проверяемые утверждения (проектные решения с параметрами: глубины, откосы, расстояния, толщины, классы материалов), каждое сверяется с контекстом норм и правилами графа, по каждому выносится статус, по документу — общий вердикт.

Тело запроса

ПолеТипОбяз.Описание
modestringдаСтрока "norm_control".
contentstringодин из двухТекст документа для проверки.
file_base64 + filenamestringодин из двухФайл документа в base64 (.txt, .md, .pdf, .docx). Текст извлекается на сервере.
graph_idsarrayнетID общих графов. По умолчанию — все, доступные ключу. Фильтруется пересечением с охватом ключа.

Если переданы и content, и file_base64 — проверяется их конкатенация. Графы — только общие (shared), как в mode=llm: чтобы проверять по графу чата, сначала опубликуйте его как общий. Лимит извлечённого текста — 200 000 символов.

Время: режим делает десятки LLM-вызовов (извлечение утверждений + проверка каждого) — ответ на типовой ППР занимает 1–3 минуты на быстрой модели. Выставляйте таймаут клиента соответственно.

Пример

POST /api/rule
Authorization: Bearer ragu_api_ВАШ_КЛЮЧ
Content-Type: application/json

{
  "mode": "norm_control",
  "content": "Котлован глубиной 2,0 м в песке выполняется с крутизной откоса 1:0,5 ...",
  "graph_ids": ["3f2a…"]
}

Ответ

200 OK
{
  "ok": true,
  "verdict": "failed",
  "summary": "Проверено утверждений: 13; соответствуют: 1; нарушения: 5; не удалось проверить: 7.",
  "violations": [
    {
      "claim": "В песчаном грунте крутизна незакрепленного откоса при глубине 2,0 м принята 1:0,5.",
      "status": "нарушение",
      "norm": "СНиП 12-04-2002, табл. 1",
      "quote": "Песчаные | 1:0,5 | 1:1",
      "explanation": "для песка при глубине до 3,0 м крутизна откоса — не более 1:1",
      "graph": "нормативы",
      "details": [ ... ]
    }
  ],
  "unchecked": [ ... ],   // утверждения, по которым в базе нормы не нашлось (status="нет данных")
  "items": [ ... ],       // все утверждения со статусами (соответствует / нарушение / нет данных)
  "sources": [ { "name": "нормативы" } ],
  "elapsed_seconds": 117.3
}
Поле ответаОписание
verdictpassed — нарушений не найдено; failed — есть хотя бы одно нарушение.
items[].statusсоответствует / нарушение / нет данных — вердикт по каждому утверждению.
items[].norm, quoteДокумент и пункт нормы + дословная цитата (пусто при «нет данных»).

Ошибки режима

КодКогда
400Нет content/file_base64, неподдерживаемый формат файла, нет доступных графов, документ больше лимита.
502LLM недоступна (извлечение утверждений не выполнено).
Чат: тот же режим доступен в веб-чате — чекбокс « Нормоконтроль» + прикрепление файла к сообщению (POST /api/chats/<id>/messages, multipart: norm_control=true, file, message). В ответе — markdown-отчёт в response и тот же JSON в поле norm_control.

POST /api/rule — режим tech_card

Технологическая карта организации работ, выверенная по базе знаний. Пайплайн: LLM составляет черновую карту по задаче («нужно сварить две детали — медь и алюминий») из своих профессиональных знаний → каждый пункт черновика верифицируется по графам знаний (ретрив норм + вердикт «соответствует» / «нарушение» / «нет данных» с нормой и цитатой) → по собранным нормам LLM генерирует финальную, более точную карту: подтверждённые пункты уточнены (с источником), противоречия исправлены, неподтверждённые оставлены из черновика. Режим предметно-нейтральный — работает с любой областью, покрытой графом знаний.

Тело запроса

ПолеТипОбяз.Описание
modestringдаСтрока "tech_card".
contentstringдаОписание задачи/работ для карты (до 10 000 символов).
graph_idsarrayнетID общих графов. По умолчанию — все, доступные ключу. Фильтруется пересечением с охватом ключа.

Пример

POST /api/rule
Authorization: Bearer ragu_api_ВАШ_КЛЮЧ
Content-Type: application/json

{
  "mode": "tech_card",
  "content": "Нужно сварить две детали: медь и алюминий",
  "graph_ids": ["3f2a…"]
}

Ответ

200 OK
{
  "ok": true,
  "title": "Сварка меди с алюминием",
  "summary": "Соединение выполняется аргонодуговой сваркой через ...",
  "equipment": [ "аргонодуговая горелка", "..." ],
  "materials": [ "присадочная проволока ...", "..." ],
  "operations": [
    {
      "step": 1,
      "name": "Подготовка кромок",
      "description": "Зачистить кромки деталей до металлического блеска ...",
      "parameters": "обезжирить ацетоном; зазор не более ...",
      "source": "ГОСТ 5264-80, п. 2.1"    // норма из базы; пусто, если не подтверждено
    }
  ],
  "quality_control": [ "визуальный контроль шва ...", "..." ],
  "safety": [ "работы выполнять в ...", "..." ],
  "sources": [ "ГОСТ 5264-80, п. 2.1", "..." ],   // документы, подтвердившие пункты карты
  "verification": { "total": 18, "confirmed": 11, "contradicted": 1, "no_data": 6 },
  "report": "## 🛠 Технологическая карта: Сварка меди с алюминием\n...",  // markdown для отображения
  "graphs": [ "нормативы" ],
  "elapsed_seconds": 96.4
}

Итоговая карта — чистая, без значков проверки. Сводка верификации черновика — в verification; если no_data > 0, в конце report будет предупреждение: эти пункты основаны на общих знаниях модели и требуют ручной проверки. Если по базе не подтвердилось ни одного пункта — карта возвращается в версии черновика (без источников).

Время: режим делает вызов на черновик + по вызову на проверку каждого пункта (обычно 15–25) + вызов на финальную генерацию — ответ занимает 1–3 минуты на быстрой модели. Выставляйте таймаут клиента соответственно.

Ошибки режима

КодКогда
400Пустой content, нет доступных графов, задача больше лимита.
502LLM недоступна (генерация карты не выполнена).
Чат: тот же режим доступен в веб-чате — чекбокс « Технологическая карта» — сообщение уходит с флагом tech_card=true на POST /api/chats/<id>/messages. В ответе — markdown-отчёт в response и тот же JSON в поле tech_card.

POST /api/rule/proxy

Тонкий прокси ко всему API движка Sigma3 — для случаев, когда вы хотите сами вести полный флоу (load -> sessions -> fire -> …).

ПолеТипОписание
opstringПуть после /api/v1/, напр. sessions/<id>/fire или regulations.
methodstringHTTP-метод. По умолчанию POST при наличии body/text, иначе GET.
bodyobjectJSON-тело запроса к движку.
queryobjectQuery-параметры.
textstringСырое тело text/plain (для *-text эндпоинтов движка).
POST /api/rule/proxy
Authorization: Bearer ragu_api_ВАШ_КЛЮЧ
Content-Type: application/json

{ "op": "sessions/abc123/fire", "method": "POST", "body": { "maxSteps": 1000 } }

# 200 { "ok": true, "status": 200, "body": <сырой ответ движка> }

GET /api/rule/health

Проверка живости RAGU и движка Sigma3 (тоже требует Bearer-ключ).

GET /api/rule/health
Authorization: Bearer ragu_api_ВАШ_КЛЮЧ

# 200 { "ragu": "ok", "engine": { "status": 200, "body": "" } }

POST /api/db/query — вопрос к подключаемой БД

Отдельная фича (к графам знаний и основной БД RAGU отношения не имеет): вы задаёте вопрос на естественном языке, RAGU интроспектирует схему целевой БД, LLM строит по ней SELECT-запрос, RAGU выполняет его и возвращает строки в JSON. Целевая БД — любая, подключаемая: либо передаётся в каждом запросе полем database_url (SQLAlchemy-URL), либо один раз настраивается на сервере (настройка db_query_url или переменная окружения DB_QUERY_URL).

ПолеТипОбяз.Описание
questionstringдаВопрос на естественном языке, напр. «Покажи всех пациентов старше 30 лет».
database_urlstringнет*SQLAlchemy-URL целевой БД: sqlite:///path/file.db, postgresql+psycopg2://user:pass@host:5432/dbname, mysql+pymysql://…. Переопределяет серверный дефолт.
limitintнетМаксимум строк в ответе (по умолчанию 500, потолок 5000). При обрезке выставляется truncated:true.

* Если database_url не передан и серверный дефолт не настроен — 400 no_database.

Безопасность: выполняются только SELECT-запросы (один стейтмент, без DDL/DML-ключевых слов). Всё остальное отклоняется с 422 unsafe_sql. Учётной записи целевой БД всё равно рекомендуется выдать права read-only.

Пример запроса и ответа

POST /api/db/query
Authorization: Bearer ragu_api_ВАШ_КЛЮЧ
Content-Type: application/json

{ "question": "Покажи всех пациентов старше 30 лет",
  "database_url": "postgresql+psycopg2://reader:secret@db.internal:5432/clinic" }

# 200 {
#   "ok": true,
#   "question": "Покажи всех пациентов старше 30 лет",
#   "sql": "SELECT * FROM patients WHERE age > 30",
#   "dialect": "postgresql",
#   "columns": ["id", "full_name", "age", ...],
#   "rows": [ {"id": 3, "full_name": "Иванов Иван Иванович", "age": 54, ...}, ... ],
#   "row_count": 66,
#   "truncated": false
# }

Ошибки режима

КодerrorКогда
400empty_question / no_database / bad_limitНекорректный запрос.
422no_sqlLLM не смогла выразить вопрос запросом по этой схеме.
422unsafe_sqlLLM сгенерировала не-SELECT (в ответе есть поле sql).
502sql_execution_failed / db_query_failedЦелевая БД недоступна или сгенерированный SQL не выполнился (в ответе есть sql и detail).

POST /api/db/schema

Возвращает текстовую схему целевой БД (та, что уходит в промпт LLM) — удобно для отладки, какие таблицы и колонки «видит» генератор SQL. Тело: {"database_url": "…"} (опционально, как и в /query).

# 200 { "ok": true, "dialect": "sqlite",
#   "schema": "appointments(id INTEGER, patient_id INTEGER, ...)\ndoctors(...)\npatients(...)" }

GET /api/db/health

Живость text-to-SQL фичи (требует Bearer-ключ): 200 {"ok": true}

Коды ошибок

КодКогдаТело
200Успех{"ok":true, …}
400Неверный mode, нет источника правил, некорректный факт, не скомпилировался DSL{"ok":false,"error":…,"engine_status":…,"engine_body":…}
401Проблема с Bearer-ключом{"error":"missing_bearer_token" | "empty_token" | "invalid_token"}
500Не удалось инициализировать движки поиска (mode=llm){"ok":false,"error":…}
502Движок Sigma3 недоступен / сетевой сбой; LLM недоступна (mode=norm_control, mode=tech_card){"ok":false,"error":…,"engine_status":…}

Готовые примеры (curl)

1. json — готовый DSL + факты

curl -s https://rule.zet-ai.ru/api/rule \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{
    "mode":"json",
    "regulation":{"dslSource":"регламент \"П\" версия 1 правило \"к\" если задача.статус равно \"в работе\" и задача.остаток_дней меньше 2 то установить задача.статус = \"критическая\"","version":1},
    "facts":[{"$type":"Task","id":"t1","status":"в работе","remainingDays":1}]
  }'

2. json — правила RAGU (конвертация)

curl -s https://rule.zet-ai.ru/api/rule \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{
    "mode":"json",
    "ragu_rules":[{"target_entity":"задача","conditions":{...},"consequences":[...]}],
    "facts":[{"$type":"Task","id":"t1","status":"в работе","remainingDays":1}]
  }'

3. llm — вопрос по графу

curl -s https://rule.zet-ai.ru/api/rule \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{
    "mode":"llm","content":"Требования к охране труда?"
  }'

4. norm_control — проверка документа на нормоконтроль

curl -s https://rule.zet-ai.ru/api/rule \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{
    "mode":"norm_control",
    "content":"Котлован глубиной 2,0 м в песке выполняется с крутизной откоса 1:0,5 ..."
  }'

# или файлом:
curl -s https://rule.zet-ai.ru/api/rule \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d "{
    \"mode\":\"norm_control\",
    \"filename\":\"ppr.docx\",
    \"file_base64\":\"$(base64 -w0 ppr.docx)\"
  }"

5. tech_card — технологическая карта по задаче

curl -s https://rule.zet-ai.ru/api/rule \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{
    "mode":"tech_card",
    "content":"Нужно сварить две детали: медь и алюминий"
  }'

6. health

curl -s https://rule.zet-ai.ru/api/rule/health -H "Authorization: Bearer $KEY"

7. text-to-SQL — вопрос к подключаемой БД

curl -s https://rule.zet-ai.ru/api/db/query \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{
    "question":"Покажи всех пациентов старше 30 лет",
    "database_url":"postgresql+psycopg2://reader:secret@db.internal:5432/clinic"
  }'

FAQ / готчи

Где взять ключ?

В /admin — «API-ключи». Плейнтекст показывается один раз — сохраните сразу.

Чем json отличается от llm и norm_control?

json — детерминированный логический вывод по правилам (движок Sigma3, без LLM). llm — ответ языковой модели по документам (graph-RAG, без движка). norm_control — построчная проверка проектного документа: LLM разбирает текст на утверждения и сверяет каждое с нормами графа, выдаёт вердикт по каждому пункту и по документу. tech_card — наоборот, построение: LLM составляет черновую технологическую карту под описанную задачу и затем проверяет каждый её пункт по нормам графа (подтверждено / противоречит / нет данных).

Нужно ли мне самому ходить в Sigma3?

Нет. В mode=json RAGU сам делает load -> session -> fire -> cleanup. Прямой доступ нужен только через /api/rule/proxy, если хотите вести флоу вручную.

Регламент удаляется после вызова?

Временный (из dslSource/ragu_rules) — да, если не передать keep:true. Переданный по regulationId — не удаляется.

Почему мой mode=llm отвечает «нет данных»?

Ключ не имеет доступа ни к одному построенному общему графу, либо graph_ids не пересекаются с охватом ключа. Проверьте охват ключа и что графы построены.

Есть ли ретраи у ответа?

Нет. Один запрос — один ответ. Идемпотентность (напр. при таймаутах) обеспечивайте на своей стороне.

Машиночитаемые контракты — в репозитории: docs/ru/rule_api.md; спецификация движка — docs/sigma3_swagger.json.