> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep Research 智能体入门项目

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">需要帮助？</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>在 Discord 提问</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>提交 GitHub Issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/zh-Hans/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>支持指南</span>
    </a>
  </div>
</div>

## 概要

这个入门项目将 deep-research 案例研究转化为一个小型项目骨架，
聚焦于规划、证据收集以及带有引用感知的综合整理。

## 状态

`starter`

源代码：[case-studies/examples/deep-research-agent-starter](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/case-studies/examples/deep-research-agent-starter)

## 存在的原因

Deep research 是本仓库中的旗舰智能体产品形态。一个小型入门项目
可以让后续贡献 traces、artifacts 和评估想法变得更容易，而无需复制
完整的外部实现。

## 相关 Lab 页面

* [Deep Research Agents](/zh-Hans/case-studies/deep-research-agents)
* [案例研究概览](/zh-Hans/case-studies)

## 文件夹结构

```text theme={null}
deep-research-agent-starter/
├── index.mdx
└── src/
    ├── citation_formatter.py
    ├── research_loop.py
    └── research_review.py
```

## 快速开始

这是一个入门项目，不是成品。该代码草图聚焦于核心
循环，并将传输、UI 和持久化排除在范围之外。要在仓库层面做一次
快速检查，请在仓库根目录运行 `python3 scripts/verify_example_projects.py`。

## 包含的示例文件

* `src/research_loop.py`：最小化的规划、证据和草稿报告循环
* `src/citation_formatter.py`：一个很小的参考接口，用于将证据
  行转换为可读的引用
* `src/research_review.py`：一个简短的研究后质量检查，用于在发布前
  检查证据覆盖情况

## 限制

* 尚未实现搜索适配器。
* 引用格式仅用于说明。
* 尚未接入 artifact 持久化。

## 下一步

* 添加一个真实的证据存储。
* 添加一个报告 artifact 写入器。
* 为缺失或薄弱证据添加评估用例。