手把手搭建第一个 create-context-graph 应用:从脚手架到图可视化的 15 分钟教程
【免费下载链接】create-context-graphAI agents with graph based reasoning memory, scaffolded in seconds项目地址https://gitcode.com/gh_mirrors/cr/create-context-graph点击查看免费下载create-context-graph是一个开源的上下文图context graph应用脚手架工具一条命令就能为你生成一个带 AI 智能体、Neo4j 知识图谱和交互式图可视化的完整全栈应用。本文带你从零开始在约 15 分钟内完成从脚手架生成、数据注入到在浏览器里拖拽查看关系图谱的全过程适合想入门图 大模型应用的新手。 开始前的准备工作环境要求检查清单在动手之前确认你的电脑满足以下要求用终端快速验证即可依赖版本要求验证命令Python3.11python3 --versionNode.js18node --versionDocker任意新版可选docker --versionuv推荐安装uv --version另外你还需要一个Anthropic API Key供 AI 智能体使用写入.env文件即可。整个教程不需要任何数据库手动配置——Docker 会自动帮你跑起 Neo4j。 如果你完全不想装 Docker也可以使用免费的 Neo4j Aura 云端实例或neo4j-local相关说明见 docs/docs/how-to/use-docker.md。 第一步一条命令生成项目脚手架打开终端执行下面这条命令uvx会自动下载并运行 create-context-graph无需预先安装uvx create-context-graph my-health-app \ --domain healthcare \ --framework pydanticai \ --demo-data参数说明my-health-app项目目录名可随意改--domain healthcare行业领域内置 27 个领域医疗、金融、法律、科研……用--list-domains查看全部--framework pydanticaiAI 智能体框架可选 PydanticAI、Strands、LangGraph 等 8 种--demo-data自动生成一套医疗领域的演示数据。如果你更喜欢交互式体验直接运行uvx create-context-graph不带任何参数向导会依次问你项目名、领域、框架、API Key 等 6 个问题回车确认即可。生成完成后你会得到my-health-app/目录里面是一个完整应用FastAPI 后端、Next.js 前端、Neo4j 图和演示数据。它的目录结构与各文件职责可以在 docs/docs/reference/generated-project-structure.md 中查到。脚手架是如何无中生有的这一切由一个小小的魔法驱动一个领域的 YAML 本体ontology文件经过 Jinja2 模板引擎渲染出整个项目。比如医疗领域的本体定义在这里healthcare.yaml本体校验逻辑在 ontology.py。 第二步启动 Neo4j 并注入演示数据进入项目目录用生成的 Makefile 一步步启动cd my-health-app # 1. 安装前后端依赖 make install # 2. 用 Docker 拉起本地 Neo4j make docker-up # 3. 注入演示数据医疗领域约 85 个实体、180 条关系、25 份文档 make seed # 4. 启动后端8000 端口 前端3000 端口 make startmake seed执行时会输出类似这样的内容说明知识图谱已经就绪✓ Seeded 85 entities, 180 relationships, 25 documents, 4 decision traces这些make命令背后是模板 Makefile.j2数据注入脚本则来自 generate_data.py.j2。⚠️ 常见问题如果make seed报连接错误先运行make test-connection检查 Neo4j 是否已启动、.env里的账号密码是否正确。 第三步打开浏览器体验图可视化浏览器访问 http://localhost:3000你会看到一个经典的三栏布局这也是 create-context-graph 生成的每个应用的默认界面左栏 · 聊天区Chat用自然语言提问比如输入Show me all patients currently diagnosed with Type 2 Diabetes。回答通过 SSE 流式返回工具调用Cypher 查询会实时显示为带转圈动画的时间线。多轮对话有记忆——智能体会记得你上一句在问谁。中栏 · 上下文图视图Context Graph View这是最让人眼前一亮的部分一张可交互的 NVL 关系图谱节点按类型着色。点击任意节点右侧弹出实体详情面板显示所有属性双击节点可扩展出它的邻居关系支持拖拽、缩放边线清晰展示DIAGNOSED_WITH、VISITED等类型化关系。右栏 · 决策追踪 文档Decision Traces / DocumentsDecision Traces页签展示智能体的逐步推理链思考 → 行动 → 观察每一步都可展开查看输入输出Documents页签可以浏览预置的领域文档出院小结、化验报告等并支持按模板类型过滤。 为什么叫上下文图三种记忆帮你理解图视图里每一个节点都不孤立。create-context-graph 的智能体背后是三种记忆类型短期记忆对话消息、长期记忆POLEO 知识图谱、推理记忆决策追踪它们共同存放在 Neo4j 中。其中推理记忆在图里的样子是一条链DecisionTrace -HAS_STEP- TraceStep 1 -NEXT- TraceStep 2 ...每个步骤记录 thought/action/observation。这就是上下文图区别于普通 RAG 的地方——智能体不只是检索文本而是在结构化知识图谱上推理并且每个结论都能追溯来源。 进阶玩法换领域、导入真实数据、连接 Claude Desktop跑通第一个应用后你几乎可以零成本切换赛道换领域重建比如换成软件工程领域uvx create-context-graph eng-app \ --domain software-engineering \ --framework pydanticai \ --demo--demo是--reset-database --demo-data --ingest的快捷方式一步完成重建。导入真实数据脚手架支持 13 个 SaaS 连接器GitHub、Slack、Jira、Notion、Linear、Google Workspace甚至本地 Claude Code 会话历史和 ChatGPT 导出文件只需在生成时追加--connectoruvx create-context-graph my-app --domain personal-knowledge \ --framework pydanticai --self-hosted \ --connector github --connector slack之后进入项目执行make import即可增量重新导入。各连接器源码位于 src/create_context_graph/connectors/。让 Claude Desktop 共用同一张图加上--with-mcp参数生成的mcp/目录可直接接入 Claude Desktop网页应用与桌面端共享同一张知识图谱。 更多入口与常见问题速查问题解决方案聊天时提示ANTHROPIC_API_KEY not set将 Key 追加到.envecho ANTHROPIC_API_KEYsk-ant-... .env端口 8000/3000 被占用停止占用进程或在.env中修改BACKEND_PORT/FRONTEND_PORT想看后端 API 文档浏览器访问 http://localhost:8000/docsFastAPI 自动生成的 Swagger UI想直接查 Cypher打开 http://localhost:7474 的 Neo4j BrowserDocker 模式账号neo4j/ 密码password继续深入学习的官方文档入口快速上手docs/docs/quick-start.md完整 CLI 参数表docs/docs/reference/cli-options.md27 个领域目录docs/docs/reference/domain-catalog.md定制你自己的领域本体docs/docs/how-to/add-custom-domain.md架构与生成原理src/create_context_graph/generator.py、docs/docs/explanation/why-context-graphs.md15 分钟你手里已经有了一个能聊天、能推理、能可视化关系图谱的 AI 应用。下一步试着把你的真实业务领域描述成一句话用--custom-domain让 LLM 帮你生成专属本体吧赞分享【免费下载链接】create-context-graphAI agents with graph based reasoning memory, scaffolded in seconds项目地址https://gitcode.com/gh_mirrors/cr/create-context-graph点击查看免费下载相关推荐5 分钟用 create-plugin 脚手架做出人生第一个 Cursor 插件官方仓库手把手教学5 分钟用 create plugin 脚手架做出人生第一个 Cursor 插件官方仓库手把手教学 Cursor 的插件生态最近热度持续走高官方插件仓从早期AI 技能AI 插件开发工具代码评审代码质量插件系统5分钟上手Flowgram.ai从0到1搭建可视化流程图应用5分钟上手Flowgram.ai从0到1搭建可视化流程图应用 你是否还在为复杂的流程图应用开发而烦恼从环境配置到组件开发每一步都充满挑战。本文将带你使用F工作流自动化前端后端AI 应用低代码Davinci 快速上手从零搭建你的第一个数据可视化应用Davinci 快速上手从零搭建你的第一个数据可视化应用 本指南以 DavinciDVsaaS 数据可视化即服务平台官方文档“第一个应用”为核心脉络带你数据可视化数据分析后端前端上一篇Silex-Skeleton调试工具使用教程WebProfiler与Monolog日志的高效排查方案下一篇Python通达信数据获取终极指南让股票数据分析变得前所未有的简单创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考