项目简介
KunSpace AI 助手「小 Kun」是跑在个人网站管理后台里的 Agent Demo,把博客系列里讲的 RAG、Skills、ReAct 循环做成了一个能演示的完整功能。
搭建全过程见博客:在 KunSpace 里从零搭建 AI 助手「小 Kun」。
访问 /admin/assistant(需站长密码),即可用自然语言:
- 查 部署文档(国内服务器更新、Redis 配置等)
- 看 访客统计(PV/UV、热门页、最近访客)
- 列 博客文章(含 slug 与私密状态)
架构
用户提问 → Agent 循环(最多 6 轮)
→ search_docs / get_analytics_summary / list_blog_posts
→ 大模型组织回答 + 可展开的执行日志
| 模块 | 说明 |
|---|---|
search_docs |
关键词检索 docs、博客 Markdown(轻量 RAG) |
get_analytics_summary |
读取现有 Redis/本地访客统计 |
list_blog_posts |
读取 content/blog 文章列表 |
| LLM | DeepSeek / OpenAI 兼容 API(Function Calling) |
技术栈
Next.js 15 · TypeScript · DeepSeek API · Upstash Redis · 现有 analytics / markdown 模块
演示提纲
- 背景:个人站运维常要翻部署文档、看访客,我想用 Agent 统一问答
- 架构:三个 Skill + ReAct 循环,回答必须基于工具结果
- 演示:问「国内服务器怎么更新?」→ 看日志里
search_docs→ 读分步回答
配置
在 .env.local 设置 LLM_API_KEY(DeepSeek 申请:https://platform.deepseek.com/api_keys),重启 npm run dev 即可。
