Безкоштовний урок

Визначити межі й створити інтерфейс

Визначити межі й створити інтерфейс — Створити локальний AI-чат. Закріпити endpoint на сервері; Зберегти index.html; Визначити видимі стани. Практичне завдання: Докази лабораторної роботи.

Демо-версія. Матеріали проходять редакторську перевірку.

Що розглянемо

  • Закріпити endpoint на сервері
  • Зберегти index.html
  • Визначити видимі стани

Закріпити endpoint на сервері

Браузер викликає /api/chat на тому самому origin. Лише Node звертається до 127.0.0.1:11434. Не проксіюйте довільні адреси від відвідувачів.

Браузер показує повідомлення, сервер застосунку перевіряє запити, Ollama генерує текст. Розділіть обов’язки, щоб браузер не вибирав довільні endpoint моделей і не читав серверні файли. Під час розробки використовуйте синтетичні питання майстерні. Відповідь моделі є згенерованим текстом, а не перевіреною порадою. Локальна межа зменшує зовнішнє передавання, але не захищає від усіх локальних користувачів, браузерних розширень чи налаштованих інтеграцій.

Зберегти index.html

Створіть підписане поле й кнопки stop/clear. Відповідь буде звичайним текстом. Спільний технічний приклад інтерфейсу подано англійською.

Адреси upstream взагалі немає в JSON запиту: так застосунок не стає завантажувачем довільних URL. Згодом сервер може дати малий список моделей, але має відображати дозволені назви у фіксовані конфігурації, а не приймати повну адресу від браузера.

Створіть названі файли в одному навчальному каталозі й запускайте Node звідти. У прикладі модель і адреса бекенду закріплені на сервері. До потоку перевірте вхід і статус upstream; після початку помилка має передаватися записом потоку або видимим станом переривання. Розрізняйте ліміт байтів, повідомлень і контексту моделі: вони контролюють різні ресурси. Перевіряйте кожен окремо, зберігаючи конкретний запит, що відтворює відмову.

<!doctype html><html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Local chat lab</title><style>body{font:1.1rem/1.6 system-ui;max-width:55rem;margin:2rem auto;padding:1rem}textarea{width:100%;font:inherit}pre{white-space:pre-wrap;overflow-wrap:anywhere}button{font:inherit;margin:.3rem}:focus-visible{outline:3px solid #9b4300}</style><main><h1>Local chat lab</h1><p>Generated answers can be wrong. Synthetic data only.</p><form id="chat"><label for="prompt">Message</label><textarea id="prompt" maxlength="2000" required></textarea><button id="send">Send</button></form><button id="stop" type="button">Stop</button><button id="clear" type="button">Clear session</button><p id="status" role="status"></p><div id="log"></div></main><script src="app.js" defer></script></html>

Визначити видимі стани

Передбачте idle, receiving, complete, interrupted, failed. Вимкнена Send запобігає повторному кліку під час потоку; серверні ліміти все одно потрібні.

Перевірте успішну відповідь, зупинений сервіс, переривання й завеликий вхід. Частковий текст позначайте частковим, а не завершеним. Історія живе лише в пам’яті інтерфейсу, її можна очистити; це не стирає журнали ОС або зовнішні копії. До публічного розгортання додайте автентифікацію, авторизацію, TLS, квоти, політику зберігання й моніторинг. Локальне демо не доводить наявності цих засобів, навіть якщо виглядає як готовий сервіс.

Практичне завдання

Докази лабораторної роботи

Перейти до навчання

Програма курсу

  1. Визначити межі й створити інтерфейс
  2. Запустити вузький локальний сервер
  3. Проксіювати обмежений потік моделі
  4. Розбирати потік у браузері
  5. Обмежити сесію, вхід і ресурси
  6. Перевірити застосунок і розгортання