Визначити приватний портал і перевірюваний результат
Визначити приватний портал і перевірюваний результат — Створити й передати малий приватний AI-портал. Один вузький сценарій; Навчальні документи з власниками; Контракт до сторінки. Практичне завдання: Визначити приватний портал і перевірюваний результат.
Демо-версія. Матеріали проходять редакторську перевірку.
Що розглянемо
- Один вузький сценарій
- Навчальні документи з власниками
- Контракт до сторінки
Один вузький сценарій
Побудуємо приватний навчальний портал: два користувачі бачать лише дозволені документи й ставлять запитання до їхнього тексту. Браузер показує відповідь і джерела, backend перевіряє доступ, а model-adapter відділений від обох. Перший adapter — детермінована локальна заглушка, яка повертає витяг, не справжня LLM. Вона дає змогу перевірити весь шлях без платного API або завантаження великих ваг. Не називай такий режим «AI-модель працює»: познач stub-extractive в інтерфейсі. Пізніше adapter можна замінити лише після окремої перевірки ресурсів, даних і оцінювання. Сфера цього проєкту — read-only knowledge, без upload, пошти, платежів чи shell-інструментів. Сервіс слухає тільки 127.0.0.1. Така межа дає конкретний результат: Alice отримує дозволену довідку з посиланням, але не може прочитати приватний документ Bob, навіть вгадавши ID.
Навчальні документи з власниками
Створи portal-lab і knowledge.json із наведеними вигаданими англійськими фактами. Вони навмисно короткі: можна вручну встановити правильну відповідь. Документ returns належить Alice, budget — Bob, support доступний обом через owner=shared. Поле source — внутрішня мітка, не зовнішній URL; воно показує походження тексту без відкриття довільних адрес. Version потрібна, щоб джерело відповіді не виглядало актуальним після зміни правил. Запит receipt має знайти лише дозволений returns, а запит payroll — повернути недостатність джерел, бо такого тексту немає. У реальному проєкті knowledge вводить уповноважений адміністратор; користувач не має змоги змінити owner у браузері. Файл із приватними фактами лежить поза public. Не додай його до статичного маршруту навіть для зручного debug. Фікстура навчає ізоляції даних, не описує справжній магазин.
[
{"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, чужий або невідомий docId — однаковий 404, завеликий body — 413. Відповідь містить status, text, citations та mode=stub-extractive. Source citation має бути серед фактично знайдених дозволених passages, а не довільним рядком моделі. Відсутність джерела — нормальний status=insufficient_sources, не привід придумати відповідь. Статичні / та /app.js не містять knowledge і можуть відкриватися до входу. Для цього прототипу credential — приватний bearer-token, що вводиться вручну й не зберігається у localStorage. Це навчальний loopback-механізм, не готовий публічний identity-provider. Спочатку перевір контракт тестами, потім розширюй сценарій.
Практичне завдання
Визначити приватний портал і перевірюваний результат
Перейти до навчання