Бесплатный урок

Определить границы и создать интерфейс

Определить границы и создать интерфейс — Создать локальный 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. Проверить приложение и развёртывание