Определить границы и создать интерфейс
Определить границы и создать интерфейс — Создать локальный 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, квоты, политику хранения и мониторинг. Локальное демо не доказывает наличие этих средств, даже если выглядит как готовый сервис.
Практическое задание
Доказательства лабораторной работы
Перейти к обучению