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

# 教程

> 通过实践示例和实用指南学习 Shannon

## 欢迎来到 Shannon 教程

通过实用的动手教程学习如何使用 Shannon 构建强大的 AI 代理应用程序。每个教程都包含完整的可运行代码、分步说明和最佳实践。

<Note>
  本部分正在积极开发中。我们会根据社区反馈和常见用例定期添加新教程。
</Note>

## 可用教程

### 构建代理

<CardGroup cols={2}>
  <Card title="深度研究代理" icon="magnifying-glass" href="/cn/tutorials/research-assistant">
    构建一个具有记忆、引用、验证和自适应模式的多源研究代理

    <br />

    **状态**: ✅ 可用
  </Card>
</CardGroup>

### 扩展与集成

<CardGroup cols={2}>
  <Card title="添加自定义工具" icon="wrench" href="/cn/tutorials/custom-tools">
    扩展 Shannon 与 MCP、OpenAPI 和内置 Python 工具的完整指南

    <br />

    **状态**: ✅ 可用
  </Card>

  <Card title="供应商适配器" icon="plug" href="/cn/tutorials/vendor-adapters">
    使用适配器模式为特定领域的 API 构建供应商特定的集成

    <br />

    **状态**: ✅ 可用
  </Card>

  <Card title="工作流模板" icon="file-code" href="/cn/tutorials/templates">
    使用 YAML 模板创建确定性、零令牌消耗的工作流，支持 DAG

    <br />

    **状态**: ✅ 可用
  </Card>

  <Card title="扩展 Shannon" icon="puzzle-piece" href="/cn/tutorials/extending-shannon">
    探索所有扩展方法：模板、工具、供应商适配器和自定义分解

    <br />

    **状态**: ✅ 可用
  </Card>
</CardGroup>

## 你将学到什么

通过这些教程，你将学习：

* **代理设计**：如何构建代理任务和工作流
* **工具集成**：将代理连接到外部 API 和服务
* **会话管理**：构建有状态的多轮对话
* **错误处理**：生产环境代理的健壮模式
* **成本优化**：预算管理和 token 效率
* **监控**：跟踪代理性能和行为

## 先决条件

在开始这些教程之前，请确保你已经：

1. **安装 Shannon**：遵循[安装指南](/cn/quickstart/installation)
2. **基础 Python 知识**：熟悉 Python 3.9+
3. **API 密钥**：至少一个 LLM 提供商的 API 密钥（OpenAI、Anthropic 等）
4. **Docker**：用于在本地运行 Shannon 服务

## 教程结构

每个教程都遵循一致的结构：

1. **概述**：你将构建什么以及为什么
2. **先决条件**：所需的设置和依赖项
3. **分步指南**：详细的实现指南
4. **代码示例**：可以运行的完整代码
5. **测试**：如何验证你的实现
6. **下一步**：扩展教程的想法

## 贡献教程

有教程的想法？我们欢迎社区贡献！

1. 查看现有的 [GitHub issues](https://github.com/Kocoro-lab/Shannon/issues?q=label%3Atutorial)
2. 在 [GitHub Discussions](https://github.com/Kocoro-lab/Shannon/discussions) 中提出新教程
3. 遵循我们的[贡献指南](https://github.com/Kocoro-lab/Shannon/blob/main/CONTRIBUTING.md)提交教程 PR

## 获取帮助

如果你在任何教程中遇到困难：

* 在 [GitHub Discussions](https://github.com/Kocoro-lab/Shannon/discussions) 中搜索类似问题
* 如果发现错误或不清楚的说明，请提交 issue

## 下一步？

<CardGroup cols={2}>
  <Card title="快速开始" icon="rocket" href="/quickstart">
    初次使用 Shannon？从这里开始
  </Card>

  <Card title="核心概念" icon="book" href="/cn/quickstart/concepts/agents">
    了解 Shannon 的基础知识
  </Card>

  <Card title="API 参考" icon="code" href="/cn/api/overview">
    探索 REST API
  </Card>

  <Card title="Python SDK" icon="python" href="/cn/sdk/python/quickstart">
    在你的应用程序中使用 SDK
  </Card>
</CardGroup>