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 составляет черновую карту по задаче («сварить медь и алюминий»), проверяет каждый пункт по графам знаний и генерирует финальную карту, уточнённую по найденным нормам (с источниками у операций). | Пошаговая технологическая карта, выверенная по нормативам из базы знаний. |
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"} |
Пустой токен после Bearer | 401 {"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.regulationId | string | ID уже загруженного на движке регламента. RAGU его не удаляет после вызова. |
regulation.dslSource | string | Готовый DSL Sigma3. Загружается под временным id api-<uuid8> и удаляется после вызова (если не keep). |
ragu_rules | array | Правила в схеме RAGU — RAGU конвертирует их в DSL (см. ниже). Best-effort. |
Полное тело запроса
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
mode | string | да | Строка "json". |
regulation / ragu_rules | object / array | один | Источник правил (см. выше). |
facts | array | нет* | Полиморфные факты движка ($type + camelCase). См. формат фактов. |
max_steps | int | нет | Предел числа срабатываний правил при fire. |
goal | object | нет | Если задан — вместо fire запускается plan (поиск плана к цели). Напр. {"factType":"Task","property":"Status","value":"критическая"}. |
plan_options | object | нет | Для plan: {"max_depth":N,"allowed_actions":[...]}. |
whatif | object | нет | Если задан — вместо fire запускается whatif (прогноз на клоне сессии). |
keep | bool | нет | Не удалять сгенерированный регламент после вызова (по умолчанию удаляется). |
regulation_name | string | нет | Имя регламента при конвертации ragu_rules (по умолчанию «RAGU rules»). |
version | int | нет | Версия регламента (по умолчанию 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_id | ID регламента (временный 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 в DSL (best-effort)
Если вы передаёте ragu_rules, RAGU парсит их схемой ragu.common.rule_schema,
раскрывает ИЛИ/IMPLIES в набор OR-free правил и рендерит русскоязычный DSL Sigma3.
Всё лоссовое (отброшенные единицы измерения, нестандартные действия, NOT над составным
условием, ссылки на другие факты) попадает в warnings.
dslSource. Конвертер — это удобство для прототипирования. Согласование имён
(RAGU «задача» тип факта Task) конвертер не делает.Карта операторов
| RAGU | DSL | RAGU | DSL |
|---|---|---|---|
| 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-стек берётся из настроек админки (локальный или онлайн).
Тело запроса
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
mode | string | да | Строка "llm". |
content | string | да | Вопрос/запрос пользователя. |
graph_ids | array | нет | ID общих графов. По умолчанию — все, доступные ключу. Фильтруется пересечением с охватом ключа. |
use_profiles | boolean | нет | Включает фильтрацию по метаданным документов. По умолчанию false. |
profile | string | при включении | advisor (Советник) или practitioner (Практик). Обязателен при use_profiles=true. |
Поле instructions удалено из API. Запрос с этим полем отклоняется с кодом
400. Модель отвечает только по контексту базы знаний и не выполняет системные
указания, переданные внутри content или документов.
Профили доступа
| Профиль | Документы | Top-K | Выдача |
|---|---|---|---|
advisor | access содержит советник или light | 5 | Ссылки и краткая выжимка. |
practitioner | access содержит практик или heavy | 20 | Полный контекст, факты и данные. |
Поля 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 на проверяемые утверждения (проектные решения с параметрами: глубины, откосы, расстояния, толщины, классы материалов), каждое сверяется с контекстом норм и правилами графа, по каждому выносится статус, по документу — общий вердикт.
Тело запроса
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
mode | string | да | Строка "norm_control". |
content | string | один из двух | Текст документа для проверки. |
file_base64 + filename | string | один из двух | Файл документа в base64 (.txt, .md, .pdf, .docx). Текст извлекается на сервере. |
graph_ids | array | нет | ID общих графов. По умолчанию — все, доступные ключу. Фильтруется пересечением с охватом ключа. |
Если переданы и content, и file_base64 — проверяется их конкатенация.
Графы — только общие (shared), как в mode=llm: чтобы проверять по графу чата,
сначала опубликуйте его как общий. Лимит извлечённого текста — 200 000 символов.
Пример
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
}| Поле ответа | Описание |
|---|---|
verdict | passed — нарушений не найдено; failed — есть хотя бы одно нарушение. |
items[].status | соответствует / нарушение / нет данных — вердикт по каждому утверждению. |
items[].norm, quote | Документ и пункт нормы + дословная цитата (пусто при «нет данных»). |
Ошибки режима
| Код | Когда |
|---|---|
400 | Нет content/file_base64, неподдерживаемый формат файла, нет доступных графов, документ больше лимита. |
502 | LLM недоступна (извлечение утверждений не выполнено). |
POST /api/chats/<id>/messages, multipart: norm_control=true, file, message).
В ответе — markdown-отчёт в response и тот же JSON в поле norm_control.POST /api/rule — режим tech_card
Технологическая карта организации работ, выверенная по базе знаний. Пайплайн: LLM составляет черновую карту по задаче («нужно сварить две детали — медь и алюминий») из своих профессиональных знаний → каждый пункт черновика верифицируется по графам знаний (ретрив норм + вердикт «соответствует» / «нарушение» / «нет данных» с нормой и цитатой) → по собранным нормам LLM генерирует финальную, более точную карту: подтверждённые пункты уточнены (с источником), противоречия исправлены, неподтверждённые оставлены из черновика. Режим предметно-нейтральный — работает с любой областью, покрытой графом знаний.
Тело запроса
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
mode | string | да | Строка "tech_card". |
content | string | да | Описание задачи/работ для карты (до 10 000 символов). |
graph_ids | array | нет | 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 будет предупреждение: эти пункты основаны на общих знаниях
модели и требуют ручной проверки. Если по базе не подтвердилось ни одного
пункта — карта возвращается в версии черновика (без источников).
Ошибки режима
| Код | Когда |
|---|---|
400 | Пустой content, нет доступных графов, задача больше лимита. |
502 | LLM недоступна (генерация карты не выполнена). |
tech_card=true на POST /api/chats/<id>/messages.
В ответе — markdown-отчёт в response и тот же JSON в поле tech_card.POST /api/rule/proxy
Тонкий прокси ко всему API движка Sigma3 — для случаев, когда вы хотите сами вести полный флоу
(load -> sessions -> fire -> …).
| Поле | Тип | Описание |
|---|---|---|
op | string | Путь после /api/v1/, напр. sessions/<id>/fire или regulations. |
method | string | HTTP-метод. По умолчанию POST при наличии body/text, иначе GET. |
body | object | JSON-тело запроса к движку. |
query | object | Query-параметры. |
text | string | Сырое тело 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).
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
question | string | да | Вопрос на естественном языке, напр. «Покажи всех пациентов старше 30 лет». |
database_url | string | нет* | SQLAlchemy-URL целевой БД: sqlite:///path/file.db, postgresql+psycopg2://user:pass@host:5432/dbname, mysql+pymysql://…. Переопределяет серверный дефолт. |
limit | int | нет | Максимум строк в ответе (по умолчанию 500, потолок 5000). При обрезке выставляется truncated:true. |
* Если database_url не передан и серверный дефолт не настроен — 400 no_database.
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 | Когда |
|---|---|---|
400 | empty_question / no_database / bad_limit | Некорректный запрос. |
422 | no_sql | LLM не смогла выразить вопрос запросом по этой схеме. |
422 | unsafe_sql | LLM сгенерировала не-SELECT (в ответе есть поле sql). |
502 | sql_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.