Tech Mentor (Nodi)

Мини-агент по технологиям для учебного курса. Выполняет лабораторную работу с одним инструментом: Claude решает, когда вызвать consultar_conocimiento_tech; Node выполняет его по локальному корпусу Markdown (RAG). Чат — текстовый или голосовой, аватар читает короткое резюме, а панель показывает, как обрабатывается каждый запрос.

Охватывает только темы технологий. Всё остальное отклоняется и перенаправляется к теме.

Онлайн-демо: https://tecno-chatbot-portal.vercel.app
Локально: npm run dev → http://localhost:3000

Архитектура

Navegador (Next.js)
  │  texto o Web Speech (STT, Chrome)
  │  POST /api/chat  { messages }  →  stream NDJSON
  ▼
API route (servidor, Node)
  │  ANTHROPIC_API_KEY (nunca llega al cliente)
  │  Claude Haiku: system prompt + tools
  │  loop de tool_use
  ▼
consultar_conocimiento_tech  (única tool)
  │  búsqueda léxica en knowledge/*.md
  ▼
stream de la respuesta  →  Markdown + infografía + temas
  │
  ▼
Web Speech TTS  →  avatar lee el resumen

Никакого MCP или отдельного бэкенда. Лабораторная требовала одну функцию; корпус находится в knowledge/.

Related MCP server: docrag

Что демонстрирует курс

Интерфейс

• Иллюстрированный женский аватар (закреплён сверху): моргает, жестикулирует и двигает ртом при речи.

• Как отвечает Nodi: 10 узлов, которые подсвечиваются (ввод, API route, промпт, модель, tool, RAG, формулировка, streaming, рендер, голос). На мобильных панель сворачивается.

• Ответы в Markdown (списки, код, жирный шрифт).

• Инфографика шагов, сравнения или концепций, когда тема этого требует.

• 3–5 связанных тем в конце каждого ответа, по которым можно кликнуть.

• Микрофон (Chrome) и системный TTS без дополнительных затрат.

Требования

• Node.js 20+

• Ключ от Anthropic / Claude

Как запустить

npm install
cp .env.example .env.local
# Edita .env.local y pega ANTHROPIC_API_KEY
npm run dev

Откройте http://localhost:3000.

npm test
npm run build

Рекомендуемые тесты

1. «Что такое RAG?» → использует tool и цитирует корпус.

2. «У меня 15 минут, что попрактиковать по Git?» → упражнение из материала.

3. «Что такое ITIL?» → вызывает tool; RAG может пометить без результатов, и Claude всё равно отвечает (не имитируя интернет).

4. «Дай мне рецепт лазаньи» → отказ, без tool.

5. Чип связанных тем → отправляется как ваш вопрос.

6. Микрофон в Chrome → транскрибирует и отправляет.

7. Аватар озвучивает резюме (иногда браузер требует предварительный клик).

Ограничения (намеренные)

• Небольшой курируемый корпус.

• Диктовка в Chrome. Edge, Brave, Firefox и Arc обычно не работают (network), потому что распознавание — это сервис производителя, а не этого приложения. Текст работает всегда.

• Без веб-поиска. Узел интернета удалён, чтобы не имитировать несуществующий источник.

• Инфографика рисуется по структурированным данным модели, а не по изображениям платного сервиса.

• Иллюстрированный аватар, а не фотореалистичный lip-sync.

• Без логина и истории на сервере.

Публикация на Vercel (опционально)

Vercel — это хостинг от создателей Next.js. Вы загружаете репозиторий, они собирают приложение и дают вам URL https://….vercel.app, который может открыть любой. Это тот же код; ваш ноутбук не должен быть включён.

Шаги (уже выполнены в этом репозитории): проект находится на Vercel с ANTHROPIC_API_KEY. URL: https://tecno-chatbot-portal.vercel.app.

Чтобы опубликовать вручную заново: npx vercel --prod. Чтобы каждый git push разворачивался автоматически, нужно подключить GitHub в дашборде Vercel (Login Connection с GitHub).

Что бесплатно, а что нет