---

AIPrompt registry и versioning

---

НАЧАЛО >> Документация модуля AIPrompt >> AIPrompt registry и versioning📄 Скачать в DOCX

---

AIPrompt является владельцем prompt-шаблонов AI-сценариев. Production AI-операция должна ссылаться на stable prompt key и версию, а не хранить prompt в коде, произвольном JSON или пользовательском вводе.

1. Prompt Definition

AIPromptDefinition содержит:

• key - stable key prompt-шаблона.
• title, description, ownerModule, purpose - человекочитаемое назначение.
• type, language, origin, system - класс использования и источник.
• version, revision, compatibility - версионирование и совместимость.
• status - draft, published, deprecated, archived или blocked.
• responseFormat - ожидаемый формат результата: text, json, classification, ranking, draft, diff, extraction.
• variables - декларативный каталог переменных.
• systemPrompt и userPromptTemplate - template-тексты.
• whereUsed, helpRef, testARefs - диагностика использования и приемки.

Изменение смысла prompt-а, набора переменных, response format или instruction hierarchy должно приводить к новой версии или фиксируемому revision. Старые версии остаются доступны для audit/readback.

2. Lifecycle

Только published-версия используется production runtime. deprecated может обслуживать pinned operation до миграции и дает warning. blocked и archived блокируют render. draft доступен только в явно разрешенном preview/dry-run режиме.

3. Variables

Переменная описывает key, русское название, тип, required/optional, expected data class, allowed source kind, size limit, default policy и masking expectation. AIPrompt не читает поля записи, комментарии, вложения, FT или связанные записи напрямую. Render получает только prepared input package от AI input-profile runtime.

Если required-переменная отсутствует, data class несовместим, источник имеет неподходящий kind или чувствительное значение не было замаскировано, render возвращает explainable safe denial до вызова модели.

4. Safe Render

AIPrompt/RenderPrompt принимает:

• promptKey;
• version;
• inputPackage;
• variables, если нужно добавить already-safe значения;
• traceId;
• dryRun, includeDraft, previewDraft.

Ответ содержит render decision, prompt key/version/revision, used variables, missing optional variables, response format, diagnostic codes, safe rendered shape, render hash, audit summary и safe signals. Метод не вызывает модель, provider adapter, tool executor и не записывает доменные данные.

System prompt не должен строиться из пользовательского текста, вложений, FT-текста, Help-фрагментов или связанных записей. Такие данные могут попадать только в user-content placeholders и остаются недоверенным контентом.

5. Where-used И HealthCheck

AIPrompt/GetPromptWhereUsed показывает system definitions и AIOperationDefinition, которые ссылаются на prompt key/version. Блокировка или архивирование используемой версии должны требовать safe migration.

AIPrompt/CheckPromptHealth проверяет:

• пустой registry;
• отсутствующие обязательные поля;
• отсутствие template-текста;
• prompt без переменных, Help или TestA;
• required variables, не используемые в тексте;
• operation -> prompt references;
• использование deprecated/blocked prompt версий.

6. Границы Модулей

AIPrompt владеет registry, versions/revisions, lifecycle, переменными, response format, render contract, where-used, system definitions, export и provider-проверками HealthCheck/TestA.

AI владеет operation registry, governance policy, AISuggestion и общей точкой запуска. AIInputProfile владеет сбором данных, masking и consent. AIProvider/AIModel выбирают модель. AITool исполняет tools. Security, TraceContext, Observability, HealthCheck и TestA остаются общесистемными владельцами своих контрактов.

Доменные модули публикуют свои AI-операции и применяют подтвержденный результат, но не должны обходить AIPrompt прямыми строковыми prompt-ами в коде.