Как пользоваться разделом «Admin: prompts»

О чём этот раздел

Управляет versioned prompt files и связывает их со scenarios без хранения секретов.

Перед началом

Нужны доступ к IAM.Docs, правильный tenant/workspace и право изменять эту конфигурацию. Подготовьте безопасное тестовое значение, например contract-answer-v1.

Кнопки и формы

Основной путь через интерфейс

1. Откройте приложение по ссылке выше и войдите с минимально необходимой для раздела ролью.
2. Выберите нужный tenant или workspace. Не продолжайте, если в шапке отображается другой контур.
3. В навигации нажмите Admin: prompts. Ожидаемый адрес: https://app.iamdocs.ru/admin?tab=prompts.
4. Нажмите Создать prompt. Введите документированные безопасные значения: contract-answer-v1. Production-секрет в текстовое поле не вставляйте.
5. Перед финальным действием Сохранить, Запустить, Опубликовать или Подтвердить перепроверьте все поля. Если есть preview или validation, сначала выполните его.
6. Проверьте сообщение валидации или изменившуюся строку. Результат должен соответствовать назначению раздела: Управляет versioned prompt files и связывает их со scenarios без хранения секретов.
7. Только после этого переходите к зависимому разделу. Сохраните request/correlation ID, если интерфейс его показывает.

Второй путь: прямая ссылка и CLI/API

1. Откройте прямую ссылку https://app.iamdocs.ru/admin?tab=prompts вместо перехода через sidebar.
2. После загрузки ещё раз проверьте tenant/workspace: прямая ссылка не должна незаметно менять scope.
3. Перед автоматизацией API-пути выполните продуктовую read-only команду или проверку. Она подтверждает доступность, но не обходит права приложения:

export IAM_DOCS_API=https://api.iamdocs.ru
curl --fail --silent --show-error "$IAM_DOCS_API/health"

Как проверить результат

Prompt version immutable после публикации, scenario указывает её явно.

Если не получилось