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 路由、提示、模型、工具、RAG、撰写、流式输出、渲染、语音）。在移动端，面板会折叠。

• 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？」→ 使用工具并引用语料库。

2. 「我有 15 分钟，Git 练什么好？」→ 材料中的练习。

3. 「什么是 ITIL？」→ 调用工具；RAG 可能标记无结果，Claude 仍然正常回答（不假装有互联网）。

4. 「给我一个千层面的食谱」→ 拒绝，不使用工具。

5. 相关主题标签 → 作为你的问题发送。

6. Chrome 中的麦克风 → 转写并发送。

7. 虚拟形象朗读摘要（有时浏览器需要先点击一次）。

限制（有意为之）

• 小而精选的语料库。

• 仅限 Chrome 中的听写。 Edge、Brave、Firefox 和 Arc 通常会失败（network），因为识别是厂商的服务，不是本应用的功能。文本始终可用。

• 无网络搜索。互联网节点已被移除，以免模拟不存在的来源。

• 信息图使用模型的结构化数据绘制，而非付费服务的图片。

• 插画虚拟形象，非逼真唇形同步。

• 无登录，无服务器端历史记录。

发布到 Vercel（可选）

Vercel 是 Next.js 开发者的托管平台。你上传仓库，他们构建应用并给你一个任何人都能打开的 https://….vercel.app URL。这是同一份代码；不需要你的笔记本电脑保持开机。

步骤（此仓库已完成）：项目已在 Vercel 上，带有 ANTHROPIC_API_KEY。URL：https://tecno-chatbot-portal.vercel.app。

手动重新发布：npx vercel --prod。要让每次 git push 自动部署，需要在 Vercel 仪表板中连接 GitHub（使用 GitHub 登录连接）。

哪些免费，哪些不免费