Определить частный портал и проверяемый результат
Определить частный портал и проверяемый результат — Создать и передать небольшой частный AI-портал. Один узкий сценарий; Учебные документы с владельцами; Контракт до страницы. Практическое задание: Определить частный портал и проверяемый результат.
Демо-версия. Материалы проходят редакторскую проверку.
Что рассмотрим
- Один узкий сценарий
- Учебные документы с владельцами
- Контракт до страницы
Один узкий сценарий
Построим частный учебный портал: два пользователя видят разрешённые документы и спрашивают об их тексте. Browser показывает ответ/источники, backend проверяет доступ, model-adapter отделён. Первый adapter — детерминированная локальная заглушка с выдержкой, не LLM. Она проверяет весь путь без paid API и больших весов. Не называй это рабочей моделью: покажи stub-extractive. Замена adapter требует отдельной проверки ресурсов, данных и качества. Scope read-only knowledge без upload, почты, платежей, shell. Слушаем только 127.0.0.1. Результат: Alice получает разрешённую справку с источником, не читает приватный документ Bob при угаданном ID. Авторизация проверяется сервером, не скрытием ссылки в browser.
Учебные документы с владельцами
Создай portal-lab/knowledge.json с вымышленными английскими фактами. Короткие тексты дают ручной эталон. returns принадлежит Alice, budget Bob, support обоим через shared. source — внутренняя метка, не внешний URL. Version связывает ответ с редакцией правил. receipt должен найти разрешённый returns; payroll — недостаток источников, такого текста нет. В настоящем проекте knowledge редактирует уполномоченный администратор, не browser-поле owner. Файл вне public и не доступен статическим маршрутом даже для debug. Фикстура учит изоляции, не описывает реальный магазин. Сохраняй копию исходного набора для тестов, чтобы последующее изменение 14 дней на другой срок не изменило ожидания незаметно.
[
{"id":"returns","owner":"alice","title":"Returns","version":1,"source":"training:returns-v1","text":"Returns require a receipt within 14 days."},
{"id":"budget","owner":"bob","title":"Budget","version":1,"source":"training:budget-v1","text":"The internal budget is 500 units."},
{"id":"support","owner":"shared","title":"Support","version":1,"source":"training:support-v1","text":"Support opens at 09:00."}
]
Контракт до страницы
API: GET /healthz только ok; GET /api/docs требует credential и возвращает разрешённые id/title/version/source; POST /api/answer получает question и опциональные docIds. Нет credential —401, чужой/неизвестный ID одинаково404, большой body413. Ответ status/text/citations/mode=stub-extractive. Citation только среди найденных разрешённых passages. Нет источника — insufficient_sources, не выдумка. / и /app.js статичны без knowledge. Credential учебного прототипа — частный bearer token, вводимый вручную без localStorage. Это loopback-механизм, не публичный identity-provider. Сначала тесты контракта, затем расширение. Владелец документа не выбирается в request body: его устанавливает backend по проверенному credential.
Практическое задание
Определить частный портал и проверяемый результат
Перейти к обучению