MarxSphere

Cookbook：真实任务示例

按真实任务组织的可复用案例（对标 Sciverse Cookbook 思路）。每个案例：场景 → 调用链 → 提示语 → 预期输出。

案例 1：多跳推理分析（文献综述）

场景：需要综合分析”资本下乡”对农户的多维影响，跨多篇论文推理。

调用链：sag_reason（52 步推理，自动多源检索）

对 Agent 的提示语：

用 sag_reason 分析：工商资本下乡对农户土地流转行为的影响机制是什么？
要求：结合至少 3 篇论文的证据，指出不同研究结论的分歧点。

预期输出（结构化）：

• 答案正文（带来源标记：（PG实体·高 / Cognee·中 来源））
• entities：抽取的实体（如 资本下乡、土地流转、农户）
• retrievalSources：本次用了哪些检索源

注意：单次 1-10 分钟（52 步链路），适合深度分析，不适合快速问答。

案例 2：快速证据查证（RAG）

场景：需要快速找到”某个政策/概念在论文原文中的说法”，不推理。

调用链：sag_search（多源语义检索，秒级）

对 Agent 的提示语：

用 sag_search 找关于"非粮化"的论文片段，要求包含来源论文标题。

预期输出（JSON 数组）：

[
  {
    "title": "工商资本下乡\"非粮化\"现象的诱因及长效对策",
    "heading": "（三）非粮化现象的治理",
    "text": "切片内容（最多 800 字）...",
    "score": 0.93,
    "source": "cognee-chunk"
  }
]

用途：事实查证、引用支持、快速浏览文献。

案例 3：论文入库（知识库扩充）

场景：拿到一篇新论文文本，入库后所有 Agent 都能检索到。

调用链：sag_ingest（自动切片 + 向量化 + 实体抽取）

对 Agent 的提示语：

用 sag_ingest 把下面这篇论文入库：
标题：XXXX
内容：<论文正文>

预期输出：

{ "ok": true, "documentId": "uuid", "chunkCount": 12, "eventCount": 5 }

注意：

• 同标题会覆盖更新（幂等）
• 内容 ≤ 5MB
• 入库后可用 sag_search 验证能否检索到

案例 4：知识库盘点（数据审计）

场景：确认当前知识库覆盖范围，看缺什么主题。

调用链：sag_documents

对 Agent 的提示语：

用 sag_documents 列出知识库全部文档，按主题分组，指出覆盖的领域和缺口。

预期输出：文档列表（标题 + 状态），Agent 汇总主题分布。

组合链路示例

研究流程（多步）

1. sag_documents        → 盘点现有知识库
2. sag_ingest           → 补入缺失主题论文
3. sag_search           → 快速检索相关证据
4. sag_reason           → 深度推理综合分析
5. （Claude 自行）      → 写作 / 总结 / 引用整理

评测驱动迭代

1. sag_reason           → 用评测题跑推理
2. 检查 hypothesis 质量  → 低分时反思（questionId 联动归因）
3. sag_ingest           → 补知识库后重测

This site is open source. Improve this page.