shopkeeper-agent

电商数仓智能问数，学 LangGraph 实战首选

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署 智能体 🍴 复刻 151 🐛 待处理 3 👀 关注 1
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 523
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目，MIT许可证，代码免费，可自行部署，配套免费教程。

项目预览

shopkeeper-agent 项目界面预览图
图片来源：GitHub 官方仓库名片

项目数据

分类智能体
开发团队didilili
官网地址https://didilili.github.io/ai-agents-from-zero/#/%E5%AE%9E%E6%88%98%E9%A1%B9%E7%9B%AE-%E7%94%B5%E5%95%86%E9%97%AE%E6%95%B0/0-%E5%89%8D%E8%A8%80
GitHubhttps://github.com/didilili/shopkeeper-agent
定价模式🏷️完全免费
价格说明开源项目，MIT许可证，代码免费，可自行部署，配套免费教程。
访问状态🔧 仅开源项目，无在线服务，需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agent-workflow,ai-agent,elasticsearch,fastapi,langchain,langgraph,llm,nl2sql,qdrant,rag,vector-database
GitHub 星标★ 523
上线时间2026-04-16 00:00:00
代码更新2026-11-06
仓库体积5.1 MB
本站数据更新2026-11-10
维护状态活跃
收录时间2026-08-09
浏览次数7

项目介绍

shopkeeper-agent 是一个面向电商数仓的智能问数 AI Agent，旨在解决业务人员无法直接使用 SQL 查询数据、数据分析门槛高的问题。它基于 LangGraph 构建完整的 Agent 工作流，整合了元数据知识库、混合检索（Qdrant 向量库与 Elasticsearch 全文检索）、NL2SQL 生成与校验、SQL 执行及流式结果展示等核心能力。项目采用 FastAPI 作为后端框架，前端使用 React，前后端代码完整且可运行，支持 Docker 一键部署。除了工程实现，项目还配套了免费的 ai-agents-from-zero 教程和分章节代码分支，非常适合系统学习 LangGraph、RAG、NL2SQL 等大模型应用开发，以及企业级 AI 工程落地实践。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 523

使用教程

难度：进阶 约 60 分钟 部署方式：容器部署 5 步

环境要求

  • Docker
  • Python 3.10+
  • Node.js
  • 模型凭据

安装与启动步骤

  1. 1拉仓库

    它把依赖服务都收在容器编排里。

    git clone https://github.com/didilili/shopkeeper-agent.git

  2. 2起依赖服务

    数据库与检索引擎都在编排文件里。

    docker compose -f docker/docker-compose.yaml up -d

  3. 3构建元知识

    这一步把业务语义灌进检索。

    uv run python -m app.scripts.build_meta_knowledge -c conf/meta_config.yaml

  4. 4装前端依赖

    界面单独构建。

    pnpm install

  5. 5起界面

    起来后可以自然语言问数。

    pnpm dev

如何确认成功

用自然语言问一个业务指标，返回的数值与直接在数据库里执行对应查询的结果一致

注意事项

  • 它是电商问数的实战项目，串起了智能体、向量检索、关系库与接口服务。
  • 依赖服务多，容器编排省掉手动装数据库的麻烦。
  • 元知识构建这一步决定检索能不能对上业务语义。
  • 数值类问答一定要与直查结果对账。

核心亮点

  • 完整实现从元数据管理、混合检索到 NL2SQL 生成校验的端到端 Agent 流程，代码结构清晰，便于学习
  • 前后端全栈可跑，Docker 一键部署，降低上手门槛，配套免费教程与章节分支，学习路径明确
  • 技术栈前沿且实用，覆盖 LangGraph、FastAPI、Qdrant、Elasticsearch 等主流工具，贴近企业级应用

不足之处

  • 早期项目，GitHub 星标仅 277，社区生态和文档完善度有待观察
  • 依赖多个外部服务（Qdrant、Elasticsearch、MySQL），本地调试环境搭建相对复杂

适用场景

  • 电商业务人员通过自然语言查询销售、库存等数据，无需编写 SQL
  • 数据分析师快速验证 NL2SQL 与 RAG 结合的技术方案
  • 开发者系统学习 LangGraph 与 Agent 工作流工程化实现

替代项目

Vanna AI、DB-GPT、LangChain SQL Agent

上一篇：get-job.skill

下一篇：plamen

同类项目推荐

kapso 开源

用知识图谱喂饱大模型，让AI自动写代码并持续优化

Kapso by Leeroo: an engine that runs experiments toward an objective, deploys the be···

★ 139 2026-08-09
ai-jail 开源

给 AI 智能体套上沙箱，跑代码不毁机器

Multi-OS sandbox to run AI agents with better constraints (it is not 100% secure, bu···

★ 1495 2026-10-11
MyClaw 开源

自建 AI 代理服务器，代码全掌控，技能无限扩展

Your personal AI server. Full code control. Unlimited possibilities. Powered by MyCl···

★ 140 2026-08-09
gbase 开源

让 AI 代理自我进化，越用越聪明

GBase — Recursive Self-Improvement Agent Framework. Memory, evolution, quality gate···

★ 115 2026-08-09
agentic-ai 开源

一站式找全智能体AI资源，省去全网搜索时间

Agentic AI research papers, benchmarks, frameworks, and tools curated across 24 doma···

★ 191 2026-08-09
Adrian 开源

实时拦截智能体恶意行为，让 AI 安全落地

Open-source runtime AI agent security tool - monitors and controls AI agents, catchi···

★ 589 2026-08-09
fastagent 开源

把本地智能体一键变成在线服务，接入多平台。

Vibe first. Then FastAgent — turn a local agent directory into a live service: in y···

★ 66 2026-08-09
ToolUniverse 开源

让每个科研人员都能拥有AI科学家助手，自动跑实验、分析数据

Democratizing AI scientists with ToolUniverse

★ 1780 2026-08-09
go-agent 开源

用 Go 构建带图记忆和多智能体协作的生产级 AI 应用

An agent framework for Go with graph-aware memory, UTCP-native tools, and multi-agen···

★ 263 2026-08-09