> ## 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.

# 示例项目

<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>

入门项目是附属于手册各个赛道的小型、仓库自有代码示例。它们让读者
读完概念页后可以看到可检查的文件、清晰的边界和明确的下一步，同时
不会把自己包装成生产应用。

在打开单个项目指南或 GitHub 文件夹之前，先用这个页面作为入口。

## 当前入门项目

| 赛道           | 项目指南                                                                                                        | 源代码                                                                                                                                       | 状态        | 重点                                   |
| ------------ | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | --------- | ------------------------------------ |
| Patterns     | [Agent Memory Retrieval Starter](/zh-Hans/patterns/examples/agent-memory-retrieval-starter)                 | [GitHub 文件夹](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/patterns/examples/agent-memory-retrieval-starter)           | `starter` | 活动笔记、工作记忆、检索输入和持久化工件                 |
| Patterns     | [Prompt Cache Agent Starter](/zh-Hans/patterns/examples/prompt-cache-agent-starter)                         | [GitHub 文件夹](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/patterns/examples/prompt-cache-agent-starter)               | `starter` | 稳定提示词前缀、动态记忆边界、缓存读取、缓存写入，以及小型成本和延迟对比 |
| Systems      | [Weather MCP Server Starter](/zh-Hans/systems/examples/weather-mcp-server-starter)                          | [GitHub 文件夹](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/systems/examples/weather-mcp-server-starter)                | `starter` | 请求验证和面向协议的工具边界                       |
| Ecosystem    | [LangGraph Starter](/zh-Hans/ecosystem/examples/langgraph-starter)                                          | [GitHub 文件夹](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/ecosystem/examples/langgraph-starter)                       | `starter` | 一个最小的图状计划、路由、综合流程                    |
| Case Studies | [Deep Research Agent Starter](/zh-Hans/case-studies/examples/deep-research-agent-starter)                   | [GitHub 文件夹](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/case-studies/examples/deep-research-agent-starter)          | `starter` | 规划、证据收集，以及感知引用的综合                    |
| Case Studies | [Customer Support Email Agent Starter](/zh-Hans/case-studies/examples/customer-support-email-agent-starter) | [GitHub 文件夹](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/case-studies/examples/customer-support-email-agent-starter) | `starter` | 邮件分诊、本地策略约束，以及安全回复草拟                 |

## 如何使用这些 starter

* 从每个项目索引链接到的相关实验室页面开始。
* 在本地运行 starter 代码检查之前，先使用 [环境设置](/zh-Hans/reading-paths/environment-setup)。
* 从仓库根目录运行 `python3 scripts/verify_example_projects.py` 来
  对当前示例代码进行冒烟测试。

## 它们为什么在这里

这些项目是公开的 starter 示例，不是隐藏的内部草稿，也不是上游项目
移植。它们用本仓库自己的语境说明系统形态、代码边界和扩展点。

它们也有意保持不完整：

* 当前仓库中的任何示例项目都不能声称自己是已完成的生产应用
* 一些示例会验证核心 Python 行为，但尚未连接真实的
  框架、协议传输、搜索适配器或持久化层
* 每个项目索引都应清楚说明该项目是 `starter`、
  `partial` 还是 `runnable`

## 未来入门项目应放置的位置

未来的入门项目应保持在各自赛道内：

* `patterns/examples/`
* `systems/examples/`
* `ecosystem/examples/`
* `case-studies/examples/`