Cognee 中的《Python 之禅》工程实践指南从代码规范到知识图谱记忆【免费下载链接】cogneeCognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.项目地址: https://gitcode.com/GitHub_Trending/co/cognee导读本文以 Cognee 综合示例comprehensive example的数据文件 zen_principles.md 为核心系统解读 Python 之禅Tim Peters 的《The Zen of Python》即import this在真实工程中的落地方法并深入讲解这份 Markdown 文档在 Cognee 开源 AI 记忆平台中如何被remember→visualize_graph→memify→recall完整流水线加工为知识图谱记忆。读完本文你既能获得一套可直接用于日常设计、编码与代码评审的 Python 风格检查清单也能掌握在 Cognee 中把编码规范文档 工程师对话记录转化为可检索、可推理的长期记忆的具体方案。一、文档定位一份可执行的 Python 风格清单原文档开篇即点明其用途The Zen of Python (Tim Peters, import this) captures Pythons philosophy. Use these principles as a checklist during design, coding, and reviews.也就是说Python 之禅不只是哲学格言而应作为设计、编码、评审三阶段的可执行检查表。在 Cognee 仓库中这份文档并非孤立存在它是 comprehensive_example 演示的三种数据源之一与另外两份数据共同构成一个开发者知识库数据文件内容在示例中的节点集node_setzen_principles.mdPython 之禅工程实践指南principles_datacopilot_conversations.json工程师与 AI 助手的真实对话async 爬虫、Pydantic 校验、pytest 测试等developer_databasic_ontology.owl自定义领域本体公司、汽车、云服务等分类体系全局本体示例脚本中通过node_set参数将规范类文档与对话类数据分隔入库再借助本体文件约束实体抽取结构——这正是用知识图谱管理开发者规范的典型范式。二、十九条原则的工程化解读原文档逐条给出了 Python 之禅的实践指引下面结合示例数据中的真实代码片段逐条展开。1. Beautiful is better than ugly优美胜于丑陋Prefer descriptive names, clear structure, and consistent formatting.工程落点使用具有描述性的命名、清晰的结构与一致的格式化。在 copilot_conversations.json 展示的AsyncWebScraper中即可看到体现类名AsyncWebScraper、方法fetch_url/scrape_urls、字段max_concurrent全部采用自解释命名。2. Explicit is better than implicit显式胜于隐式Be clear about behavior, imports, and types.原文档给出了标准示例——显式导入与类型注解from datetime import datetime, timedelta def get_future_date(days_ahead: int) - datetime: return datetime.now() timedelta(daysdays_ahead)工程落点避免from module import *造成的命名空间污染函数签名用类型注解明确入参与返回值。这与### 19. 命名空间条相互呼应——显式导入是命名空间纪律的基础。3. Simple is better than complex简单胜于复杂Choose straightforward solutions first.工程落点优先选择直截了当的方案。示例对话中助理对高并发抓取给出的第一个建议就是使用 asyncio aiohttp 信号量限流这一标准组合而非引入重量级框架——这正是先简单、后复杂的体现。4. Complex is better than complicated复杂胜于繁乱When complexity is needed, organize it with clear abstractions.工程落点当复杂度不可避免时用清晰的抽象组织它。AsyncWebScraper通过__aenter__/__aexit__将会话生命周期管理这一复杂职责封装为上下文管理器让调用方只需三行代码。5. Flat is better than nested扁平胜于嵌套Use early returns to reduce indentation.工程落点用提前返回early return降低缩进深度。示例爬虫的fetch_url内异常通过except Exception捕获后直接返回错误字典而非深层嵌套保证了主路径的扁平可读。6. Sparse is better than dense疏胜于密Give code room to breathe with whitespace.工程落点用空行与空格给代码呼吸空间。PEP 8 规定顶级函数/类之间空两行、方法之间空一行逻辑块之间用空行分隔。7. Readability counts可读性至上Optimize for human readers; add docstrings for nontrivial code.工程落点代码首先服务于人类读者。对非平凡逻辑补充 docstring 与注释例如对话数据中code_context字段专门记录了讨论涉及的patterns_discussed便于后续检索时还原上下文。8. Special cases arent special enough to break the rules特例不足以破坏规则Stay consistent; exceptions should be rare and justified.工程落点保持一致性优先特例必须稀少且有充分理由。例如项目内统一使用async def风格与asyncio.run(main())入口不因个别场景随意切换同步/异步范式。9. Although practicality beats purity实用胜过纯粹Prefer practical solutions that teams can maintain.工程落点优先选择团队可长期维护的实用方案。示例对话中助理明确建议API 开发用 Pydantic 做运行时校验、内部简单结构用 dataclass 保持标准库轻量这就是实用主义取舍。10. Errors should never pass silently错误不应被静默忽略Handle exceptions explicitly; log with context.工程落点显式处理异常并带上下文日志。AsyncWebScraper.fetch_url中每个失败请求都返回{url: url, error: str(e)}将错误信息与请求 URL 绑定而非吞掉异常。11. Unless explicitly silenced除非显式静默Silence only specific, acceptable errors and document why.工程落点只对特定且可接受的错误进行静默并注释说明原因。示例中asyncio.gather(*tasks, return_exceptionsTrue)显式声明异常作为返回值收集这就是显式静默的教科书用法。12. In the face of ambiguity, refuse the temptation to guess面对歧义拒绝猜测Require explicit inputs and behavior.工程落点要求显式输入与行为。Pydantic 模型的字段约束如username: str Field(..., min_length3, max_length50)正是拒绝歧义的工程化表达——数据不合法就直接报错而不是猜测修正。13. There should be one obvious way to do it应该只有一种显而易见的做法Prefer standard library patterns and idioms.工程落点优先标准库模式与惯用法。原文档的datetime.now() timedelta(...)、示例中的asyncio.Semaphore、asyncio.gather都是社区公认的唯一显而易见写法。14. Although that way may not be obvious at first除非这种做法初看并不显而易见Learn Python idioms; embrace clarity over novelty.工程落点持续学习 Python 惯用法idioms以清晰性而非炫技为准则。上下文管理器、生成器、async with等惯用法初看不直观但掌握后是表达力最强的工具。15 16. Now is better than never / Never is often better than right now现在胜于不做 / 不做往往胜过盲目去做Iterate, but dont rush broken code.工程落点以小步迭代推进但不仓促提交残缺代码。在示例数据中每次对话都附有follow_up_questions如如何为失败请求加重试体现先交付可用版本、再按问题清单迭代的节奏。17 18. Hard to explain is bad; easy to explain is good难以解释的是坏的 / 易于解释的是好的Prefer designs you can explain simply.工程落点优先选择能三句话讲清的设计。示例对话中助理用一句信号量控制并发以保护目标服务器、上下文管理器保证资源清理、TCPConnector 提供连接池就讲完了爬虫核心设计。19. Namespaces are one honking great idea命名空间是个绝妙的主意Use modules/packages to separate concerns; avoid wildcard imports.工程落点用模块/包隔离关注点禁止通配符导入。这也是前述第 2 条显式胜于隐式在导入层面的延伸。三、现代 Python 特性与三条原则的天然契合原文档在 Modern Python Tie-ins 一节总结了三个现代特性与 Python 之禅的对应关系类型提示Type hints强化显式性对应第 2 条Explicit is better than implicit。Cognee 自身代码大量采用类型注解例如remember()的签名将入参类型明确限定为Union[BinaryIO, list[BinaryIO], str, list[str], DataItem, ...]见 remember.py这在库层面同样是显式原则的践行。上下文管理器Context managers强制安全的资源处理对应第 4 条与第 10 条。async with aiohttp.ClientSession(...)保证会话必然关闭async with self.semaphore保证并发限额必然生效。数据类Dataclasses提升数据容器的可读性对应第 7 条Readability counts。对话数据中明确对比了内部数据结构用 dataclass、外部校验用 Pydantic的取舍。四、快速审查清单原文档以一份可操作的检查清单收尾可直接用于编码评审Is it readable and explicit?是否可读且显式Is this the simplest working solution?这是否是最简单的可用方案Are errors explicit and logged?错误是否显式处理并记录日志Are modules/namespaces used appropriately?模块与命名空间使用是否恰当在此基础上结合示例场景可扩展两条评审问题命名是否自解释第 1 条是否引入了不必要的嵌套第 5 条五、实战场景把《Python 之禅》文档变成知识图谱记忆原文档在 Cognee 中的实际用途是 comprehensive example 的输入数据。核心脚本 cognee_comprehensive_example.py 演示了完整流程async def main(): await cognee.forget(everythingTrue) await cognee.remember(developer_intro, node_set[developer_data], self_improvementFalse) await cognee.remember( human_agent_conversations, node_set[developer_data], self_improvementFalse, ) await cognee.remember( python_zen_principles, node_set[principles_data], self_improvementFalse, ) initial_graph_visualization_path os.path.join( os.path.dirname(__file__), artifacts_path, graph_visualization_nodesets_and_ontology.html ) await cognee.visualize_graph(initial_graph_visualization_path) await cognee.memify() enhanced_graph_visualization_path os.path.join( os.path.dirname(__file__), artifacts_path, graph_visualization_after_memify.html ) await cognee.visualize_graph(enhanced_graph_visualization_path) results await cognee.recall( query_textHow does my AsyncWebScraper implementation align with Pythons design principles?, query_typecognee.SearchType.GRAPH_COMPLETION, ) print(Python Pattern Analysis:, results) results await cognee.recall( query_textHow should variables be named?, query_typecognee.SearchType.GRAPH_COMPLETION, node_name[principles_data], ) print(Filtered search result:, results)5.1 环境准备配置顺序是关键脚本顶部有两处关键环境变量设置且都强调必须在import cognee之前完成因为 Cognee 在导入时即读取环境变量源码注释见 cognee_comprehensive_example.pyos.environ[LLM_API_KEY] your_api_key # 提供 LLM 密钥 os.environ[ONTOLOGY_FILE_PATH] ontology_path # 指向 basic_ontology.owlONTOLOGY_FILE_PATH指向 basic_ontology.owl该本体定义了Company、CarManufacturer、TechnologyCompany、produces/develops等类与对象属性用于约束实体抽取的类别体系。5.2 remember写入长期记忆add cognifyremember()在未提供session_id时执行永久记忆模式即add()数据入库cognify()构建知识图谱两步流水线。其源码注释明确说明remember.pypermanent 模式运行add()cognify()构建知识图谱session 模式提供session_id时写入会话缓存供快速检索。示例中的关键参数node_set将文档归入指定节点集principles_data/developer_data为后续按集合过滤检索打基础self_improvementFalse关闭自动improve()增强以便先观察初始图谱、再手动执行memify()对比效果。从源码看remember()还支持run_in_background后台任务、dry_run返回 token 用量与成本估算而不实际调用 LLM、chunk_size/chunker分块策略默认TextChunker等参数返回值是 Promise 风格的RememberResult可直接打印、await等待或检查.status/.dataset_name/.elapsed_seconds等属性remember.py。5.3 visualize_graph可视化节点集与本体结构remember之后脚本调用cognee.visualize_graph(initial_graph_visualization_path)将含节点集与本体结构的初始图谱导出为 HTML 可视化文件graph_visualization_nodesets_and_ontology.html。该接口支持full、query、seed_node_ids、recall_result等参数见 visualize.py用于聚焦子图或联动检索结果展示。5.4 memify图谱记忆增强memify()是 Cognee 的图谱增强流水线它读取已构建的图谱若未提供data则自动通过get_memory_fragment获取整个图谱或按node_type/node_name过滤的子图再运行提取任务与增强任务。其核心执行路径memify.pyresolved_extraction_tasks resolve_memify_tasks(extraction_tasks) resolved_enrichment_tasks resolve_memify_tasks(enrichment_tasks) # 未提供时使用默认任务 resolved_extraction_tasks get_default_memify_extraction_tasks() resolved_enrichment_tasks get_default_memify_enrichment_tasks() ... memory_fragment await get_memory_fragment(node_typenode_type, node_namenode_name)默认 memify 流水线包含实体合并、跨实体连接、三元组嵌入、全局上下文索引等任务见 memify_pipelines 与 memify_task_registry.py。执行memify()后文档与对话中的实体关系会被合并、交叉连接并生成语义索引这正是记忆增强的底层机制。脚本随后再次visualize_graph生成graph_visualization_after_memify.html用于对比增强前后的图谱差异。5.5 recall跨文档知识检索与按节点集过滤示例演示了两种recall用法均使用cognee.SearchType.GRAPH_COMPLETION检索类型。SearchType枚举定义于 SearchType.py除GRAPH_COMPLETION外还包括SUMMARIES、CHUNKS、RAG_COMPLETION、HYBRID_COMPLETION、TRIPLET_COMPLETION、TEMPORAL等十余种检索策略。跨文档综合分析查询How does my AsyncWebScraper implementation align with Pythons design principles?让图谱关联developer_data爬虫对话与principles_dataPython 之禅两个节点集输出代码实现与设计原则的对齐分析节点集过滤查询How should variables be named?并传入node_name[principles_data]将检索范围限定在规范文档节点集内第 1 条优美的命名即可命中。recall()的完整签名recall.py还提供top_k默认 15、datasets/dataset_ids、auto_route省略query_type时自动路由检索策略、system_prompt/system_prompt_path、only_context、session_id等丰富参数其中node_name_filter_operator默认为OR用于控制多节点集过滤的并集/交集语义。5.6 forget重置记忆脚本开头调用cognee.forget(everythingTrue)清空全部既有记忆确保每次演示从干净状态开始。forget()还支持data_id、dataset、dataset_id、memory_only等定向删除参数见 forget.py。六、一条完整的学习路径阅读 zen_principles.md把十九条原则当作编码与评审清单结合 copilot_conversations.json 中的真实代码片段逐条印证原则的工程形态运行 cognee_comprehensive_example.py需先配置LLM_API_KEY与可选的ONTOLOGY_FILE_PATH观察规范文档如何被加工为知识图谱对比 memify 前后的两张 HTML 图谱可视化理解记忆增强的效果修改recall的查询文本与node_name参数体验跨文档综合检索与按节点集过滤两种能力。这套流程的价值在于规范不再只是停留在 README 里的文本而是可以被 AI Agent 检索、引用、并用于对齐分析的长期记忆——这正是 Cognee 知识图谱引擎在开发者知识管理场景下的典型应用。【免费下载链接】cogneeCognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.项目地址: https://gitcode.com/GitHub_Trending/co/cognee创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Cognee 中的《Python 之禅》工程实践指南从代码规范到知识图谱记忆【免费下载链接】cogneeCognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.项目地址: https://gitcode.com/GitHub_Trending/co/cognee导读本文以 Cognee 综合示例comprehensive example的数据文件 zen_principles.md 为核心系统解读 Python 之禅Tim Peters 的《The Zen of Python》即import this在真实工程中的落地方法并深入讲解这份 Markdown 文档在 Cognee 开源 AI 记忆平台中如何被remember→visualize_graph→memify→recall完整流水线加工为知识图谱记忆。读完本文你既能获得一套可直接用于日常设计、编码与代码评审的 Python 风格检查清单也能掌握在 Cognee 中把编码规范文档 工程师对话记录转化为可检索、可推理的长期记忆的具体方案。一、文档定位一份可执行的 Python 风格清单原文档开篇即点明其用途The Zen of Python (Tim Peters, import this) captures Pythons philosophy. Use these principles as a checklist during design, coding, and reviews.也就是说Python 之禅不只是哲学格言而应作为设计、编码、评审三阶段的可执行检查表。在 Cognee 仓库中这份文档并非孤立存在它是 comprehensive_example 演示的三种数据源之一与另外两份数据共同构成一个开发者知识库数据文件内容在示例中的节点集node_setzen_principles.mdPython 之禅工程实践指南principles_datacopilot_conversations.json工程师与 AI 助手的真实对话async 爬虫、Pydantic 校验、pytest 测试等developer_databasic_ontology.owl自定义领域本体公司、汽车、云服务等分类体系全局本体示例脚本中通过node_set参数将规范类文档与对话类数据分隔入库再借助本体文件约束实体抽取结构——这正是用知识图谱管理开发者规范的典型范式。二、十九条原则的工程化解读原文档逐条给出了 Python 之禅的实践指引下面结合示例数据中的真实代码片段逐条展开。1. Beautiful is better than ugly优美胜于丑陋Prefer descriptive names, clear structure, and consistent formatting.工程落点使用具有描述性的命名、清晰的结构与一致的格式化。在 copilot_conversations.json 展示的AsyncWebScraper中即可看到体现类名AsyncWebScraper、方法fetch_url/scrape_urls、字段max_concurrent全部采用自解释命名。2. Explicit is better than implicit显式胜于隐式Be clear about behavior, imports, and types.原文档给出了标准示例——显式导入与类型注解from datetime import datetime, timedelta def get_future_date(days_ahead: int) - datetime: return datetime.now() timedelta(daysdays_ahead)工程落点避免from module import *造成的命名空间污染函数签名用类型注解明确入参与返回值。这与### 19. 命名空间条相互呼应——显式导入是命名空间纪律的基础。3. Simple is better than complex简单胜于复杂Choose straightforward solutions first.工程落点优先选择直截了当的方案。示例对话中助理对高并发抓取给出的第一个建议就是使用 asyncio aiohttp 信号量限流这一标准组合而非引入重量级框架——这正是先简单、后复杂的体现。4. Complex is better than complicated复杂胜于繁乱When complexity is needed, organize it with clear abstractions.工程落点当复杂度不可避免时用清晰的抽象组织它。AsyncWebScraper通过__aenter__/__aexit__将会话生命周期管理这一复杂职责封装为上下文管理器让调用方只需三行代码。5. Flat is better than nested扁平胜于嵌套Use early returns to reduce indentation.工程落点用提前返回early return降低缩进深度。示例爬虫的fetch_url内异常通过except Exception捕获后直接返回错误字典而非深层嵌套保证了主路径的扁平可读。6. Sparse is better than dense疏胜于密Give code room to breathe with whitespace.工程落点用空行与空格给代码呼吸空间。PEP 8 规定顶级函数/类之间空两行、方法之间空一行逻辑块之间用空行分隔。7. Readability counts可读性至上Optimize for human readers; add docstrings for nontrivial code.工程落点代码首先服务于人类读者。对非平凡逻辑补充 docstring 与注释例如对话数据中code_context字段专门记录了讨论涉及的patterns_discussed便于后续检索时还原上下文。8. Special cases arent special enough to break the rules特例不足以破坏规则Stay consistent; exceptions should be rare and justified.工程落点保持一致性优先特例必须稀少且有充分理由。例如项目内统一使用async def风格与asyncio.run(main())入口不因个别场景随意切换同步/异步范式。9. Although practicality beats purity实用胜过纯粹Prefer practical solutions that teams can maintain.工程落点优先选择团队可长期维护的实用方案。示例对话中助理明确建议API 开发用 Pydantic 做运行时校验、内部简单结构用 dataclass 保持标准库轻量这就是实用主义取舍。10. Errors should never pass silently错误不应被静默忽略Handle exceptions explicitly; log with context.工程落点显式处理异常并带上下文日志。AsyncWebScraper.fetch_url中每个失败请求都返回{url: url, error: str(e)}将错误信息与请求 URL 绑定而非吞掉异常。11. Unless explicitly silenced除非显式静默Silence only specific, acceptable errors and document why.工程落点只对特定且可接受的错误进行静默并注释说明原因。示例中asyncio.gather(*tasks, return_exceptionsTrue)显式声明异常作为返回值收集这就是显式静默的教科书用法。12. In the face of ambiguity, refuse the temptation to guess面对歧义拒绝猜测Require explicit inputs and behavior.工程落点要求显式输入与行为。Pydantic 模型的字段约束如username: str Field(..., min_length3, max_length50)正是拒绝歧义的工程化表达——数据不合法就直接报错而不是猜测修正。13. There should be one obvious way to do it应该只有一种显而易见的做法Prefer standard library patterns and idioms.工程落点优先标准库模式与惯用法。原文档的datetime.now() timedelta(...)、示例中的asyncio.Semaphore、asyncio.gather都是社区公认的唯一显而易见写法。14. Although that way may not be obvious at first除非这种做法初看并不显而易见Learn Python idioms; embrace clarity over novelty.工程落点持续学习 Python 惯用法idioms以清晰性而非炫技为准则。上下文管理器、生成器、async with等惯用法初看不直观但掌握后是表达力最强的工具。15 16. Now is better than never / Never is often better than right now现在胜于不做 / 不做往往胜过盲目去做Iterate, but dont rush broken code.工程落点以小步迭代推进但不仓促提交残缺代码。在示例数据中每次对话都附有follow_up_questions如如何为失败请求加重试体现先交付可用版本、再按问题清单迭代的节奏。17 18. Hard to explain is bad; easy to explain is good难以解释的是坏的 / 易于解释的是好的Prefer designs you can explain simply.工程落点优先选择能三句话讲清的设计。示例对话中助理用一句信号量控制并发以保护目标服务器、上下文管理器保证资源清理、TCPConnector 提供连接池就讲完了爬虫核心设计。19. Namespaces are one honking great idea命名空间是个绝妙的主意Use modules/packages to separate concerns; avoid wildcard imports.工程落点用模块/包隔离关注点禁止通配符导入。这也是前述第 2 条显式胜于隐式在导入层面的延伸。三、现代 Python 特性与三条原则的天然契合原文档在 Modern Python Tie-ins 一节总结了三个现代特性与 Python 之禅的对应关系类型提示Type hints强化显式性对应第 2 条Explicit is better than implicit。Cognee 自身代码大量采用类型注解例如remember()的签名将入参类型明确限定为Union[BinaryIO, list[BinaryIO], str, list[str], DataItem, ...]见 remember.py这在库层面同样是显式原则的践行。上下文管理器Context managers强制安全的资源处理对应第 4 条与第 10 条。async with aiohttp.ClientSession(...)保证会话必然关闭async with self.semaphore保证并发限额必然生效。数据类Dataclasses提升数据容器的可读性对应第 7 条Readability counts。对话数据中明确对比了内部数据结构用 dataclass、外部校验用 Pydantic的取舍。四、快速审查清单原文档以一份可操作的检查清单收尾可直接用于编码评审Is it readable and explicit?是否可读且显式Is this the simplest working solution?这是否是最简单的可用方案Are errors explicit and logged?错误是否显式处理并记录日志Are modules/namespaces used appropriately?模块与命名空间使用是否恰当在此基础上结合示例场景可扩展两条评审问题命名是否自解释第 1 条是否引入了不必要的嵌套第 5 条五、实战场景把《Python 之禅》文档变成知识图谱记忆原文档在 Cognee 中的实际用途是 comprehensive example 的输入数据。核心脚本 cognee_comprehensive_example.py 演示了完整流程async def main(): await cognee.forget(everythingTrue) await cognee.remember(developer_intro, node_set[developer_data], self_improvementFalse) await cognee.remember( human_agent_conversations, node_set[developer_data], self_improvementFalse, ) await cognee.remember( python_zen_principles, node_set[principles_data], self_improvementFalse, ) initial_graph_visualization_path os.path.join( os.path.dirname(__file__), artifacts_path, graph_visualization_nodesets_and_ontology.html ) await cognee.visualize_graph(initial_graph_visualization_path) await cognee.memify() enhanced_graph_visualization_path os.path.join( os.path.dirname(__file__), artifacts_path, graph_visualization_after_memify.html ) await cognee.visualize_graph(enhanced_graph_visualization_path) results await cognee.recall( query_textHow does my AsyncWebScraper implementation align with Pythons design principles?, query_typecognee.SearchType.GRAPH_COMPLETION, ) print(Python Pattern Analysis:, results) results await cognee.recall( query_textHow should variables be named?, query_typecognee.SearchType.GRAPH_COMPLETION, node_name[principles_data], ) print(Filtered search result:, results)5.1 环境准备配置顺序是关键脚本顶部有两处关键环境变量设置且都强调必须在import cognee之前完成因为 Cognee 在导入时即读取环境变量源码注释见 cognee_comprehensive_example.pyos.environ[LLM_API_KEY] your_api_key # 提供 LLM 密钥 os.environ[ONTOLOGY_FILE_PATH] ontology_path # 指向 basic_ontology.owlONTOLOGY_FILE_PATH指向 basic_ontology.owl该本体定义了Company、CarManufacturer、TechnologyCompany、produces/develops等类与对象属性用于约束实体抽取的类别体系。5.2 remember写入长期记忆add cognifyremember()在未提供session_id时执行永久记忆模式即add()数据入库cognify()构建知识图谱两步流水线。其源码注释明确说明remember.pypermanent 模式运行add()cognify()构建知识图谱session 模式提供session_id时写入会话缓存供快速检索。示例中的关键参数node_set将文档归入指定节点集principles_data/developer_data为后续按集合过滤检索打基础self_improvementFalse关闭自动improve()增强以便先观察初始图谱、再手动执行memify()对比效果。从源码看remember()还支持run_in_background后台任务、dry_run返回 token 用量与成本估算而不实际调用 LLM、chunk_size/chunker分块策略默认TextChunker等参数返回值是 Promise 风格的RememberResult可直接打印、await等待或检查.status/.dataset_name/.elapsed_seconds等属性remember.py。5.3 visualize_graph可视化节点集与本体结构remember之后脚本调用cognee.visualize_graph(initial_graph_visualization_path)将含节点集与本体结构的初始图谱导出为 HTML 可视化文件graph_visualization_nodesets_and_ontology.html。该接口支持full、query、seed_node_ids、recall_result等参数见 visualize.py用于聚焦子图或联动检索结果展示。5.4 memify图谱记忆增强memify()是 Cognee 的图谱增强流水线它读取已构建的图谱若未提供data则自动通过get_memory_fragment获取整个图谱或按node_type/node_name过滤的子图再运行提取任务与增强任务。其核心执行路径memify.pyresolved_extraction_tasks resolve_memify_tasks(extraction_tasks) resolved_enrichment_tasks resolve_memify_tasks(enrichment_tasks) # 未提供时使用默认任务 resolved_extraction_tasks get_default_memify_extraction_tasks() resolved_enrichment_tasks get_default_memify_enrichment_tasks() ... memory_fragment await get_memory_fragment(node_typenode_type, node_namenode_name)默认 memify 流水线包含实体合并、跨实体连接、三元组嵌入、全局上下文索引等任务见 memify_pipelines 与 memify_task_registry.py。执行memify()后文档与对话中的实体关系会被合并、交叉连接并生成语义索引这正是记忆增强的底层机制。脚本随后再次visualize_graph生成graph_visualization_after_memify.html用于对比增强前后的图谱差异。5.5 recall跨文档知识检索与按节点集过滤示例演示了两种recall用法均使用cognee.SearchType.GRAPH_COMPLETION检索类型。SearchType枚举定义于 SearchType.py除GRAPH_COMPLETION外还包括SUMMARIES、CHUNKS、RAG_COMPLETION、HYBRID_COMPLETION、TRIPLET_COMPLETION、TEMPORAL等十余种检索策略。跨文档综合分析查询How does my AsyncWebScraper implementation align with Pythons design principles?让图谱关联developer_data爬虫对话与principles_dataPython 之禅两个节点集输出代码实现与设计原则的对齐分析节点集过滤查询How should variables be named?并传入node_name[principles_data]将检索范围限定在规范文档节点集内第 1 条优美的命名即可命中。recall()的完整签名recall.py还提供top_k默认 15、datasets/dataset_ids、auto_route省略query_type时自动路由检索策略、system_prompt/system_prompt_path、only_context、session_id等丰富参数其中node_name_filter_operator默认为OR用于控制多节点集过滤的并集/交集语义。5.6 forget重置记忆脚本开头调用cognee.forget(everythingTrue)清空全部既有记忆确保每次演示从干净状态开始。forget()还支持data_id、dataset、dataset_id、memory_only等定向删除参数见 forget.py。六、一条完整的学习路径阅读 zen_principles.md把十九条原则当作编码与评审清单结合 copilot_conversations.json 中的真实代码片段逐条印证原则的工程形态运行 cognee_comprehensive_example.py需先配置LLM_API_KEY与可选的ONTOLOGY_FILE_PATH观察规范文档如何被加工为知识图谱对比 memify 前后的两张 HTML 图谱可视化理解记忆增强的效果修改recall的查询文本与node_name参数体验跨文档综合检索与按节点集过滤两种能力。这套流程的价值在于规范不再只是停留在 README 里的文本而是可以被 AI Agent 检索、引用、并用于对齐分析的长期记忆——这正是 Cognee 知识图谱引擎在开发者知识管理场景下的典型应用。【免费下载链接】cogneeCognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.项目地址: https://gitcode.com/GitHub_Trending/co/cognee创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
