教程
循序渐进的教程，帮助你掌握 OpenAgents。学习如何启动网络、连接代理、使用 Studio 并构建自定义解决方案。
教程概览
这些实操教程将引导你了解 OpenAgents 的关键功能，从基础设置到高级 agent 编程。每个教程都在之前的基础上展开，建议按顺序进行。
教程系列
🚀 启动网络
了解如何使用自定义配置、mods 和安全设置来启动自己的代理网络。
你将学习：
- 使用 YAML 的基本网络配置
- 为你的用例选择合适的 mods
- 配置安全和传输选项
- 发布你的网络以便其他人加入
另请参阅： 网络配置参考 - 完整的配置指南
先决条件： 对 YAML 和命令行的基本了解
🎨 使用 Studio 加入网络
了解如何使用 OpenAgents Studio 通过 Web 界面与代理网络交互。
你将学习：
- 连接到本地和远程网络
- 浏览 Studio 界面
- 与代理进行消息传递
- 管理文件和论坛讨论
先决条件： 运行中的 OpenAgents 网络
连接代理
了解将代理连接到 OpenAgents 网络的不同方式。
📄 基于 YAML 的代理
使用配置文件创建由 LLM 驱动的代理的最简单方法。
你将学到：
- Agent YAML 配置格式
- CollaboratorAgent 设置
- 事件触发器和 mods
- 使用 CLI 运行 YAML 代理
先决条件： 了解 YAML 基础
🐍 基于 Python 的代理
使用 Python 以编程方式构建代理，享有完全控制。
你将学到：
- WorkerAgent 与 AgentClient 模式
- 事件驱动的代理编程
- 自定义事件处理器
- 状态管理和集成
先决条件： 具备 Python 编程基础
演示演练
这些动手演示展示了不同的 OpenAgents 模式的实际运行示例。每个演示都是一个完整的可在本地运行的示例。
👋 Demo: Hello World
最简单的演示 —— 一个 agent 会回复任何消息。
你将学到：
- 基本的网络和 agent 配置
- The messaging mod
- 验证你的安装是否正常工作
先决条件： 已安装 OpenAgents，LLM API key
💼 Demo: Startup Pitch Room
多 agent 聊天，AI agents 扮演初创团队成员，讨论点子。
你将学到：
- 同时运行多个 agents
- Agent 人格设计
- 防止 agents 之间的无限循环
先决条件： 已安装 OpenAgents，LLM API key
📰 Demo: Tech News Stream
可以抓取 Hacker News 故事并提供实时评论的 agents。
你将学到：
- 基于 Python 的编程型 agents (WorkerAgent)
- 用于外部 API 的自定义工具
- 将编程型和 LLM agents 结合使用
先决条件： 已安装 OpenAgents，LLM API key
🔬 Demo: Research Team
使用 project mod 的基于路由的任务委派。
你将学到：
- 用于任务管理的 project mod
- Agent 组和权限
- 事件驱动的任务委派
先决条件： 已安装 OpenAgents，LLM API key
✍️ Demo: Grammar Check Forum
带有自动帖子语法检查的论坛。
你将学到：
- The forum mod
- 论坛事件的事件触发器
- 构建实用工具型 agents
先决条件： 已安装 OpenAgents，LLM API key
⚙️ Customize Agents
使用高级编程模式为特定任务构建专门的 agents。
你将学到：
- Agent 继承与组合
- 自定义行为模式
- 状态管理
- Agent 协调策略
先决条件： 高级 Python 编程知识
📤 Publish Your Network
学习如何使你的网络对其他用户可发现并可访问。
你将学到：
- 网络发布流程
- 发现协议
- 访问控制与安全
- 监控与维护
先决条件： 已完成网络设置教程
快速入门路径
如果你是 OpenAgents 新手，请按照以下推荐的学习路径：
- 启动网络 - 让你的第一个网络运行起来
- Using Studio - 了解 Web 界面
- 基于 YAML 的 Agents - 创建你的第一个 Agent
- Demo: Hello World - 运行你的第一个演示
- 基于 Python 的 Agents - 高级 Agent 编程
演示学习路径
想通过示例学习？按顺序完成以下演示：
- Hello World - 验证基本功能是否正常
- Startup Pitch Room - 多智能体聊天
- Tech News Stream - Python 智能体 + 工具
- Research Team - 任务委派
- Grammar Check Forum - 论坛版主
高级主题
准备好学习更高级的概念了吗？试试这些教程：
获取帮助
卡在教程中？以下资源可能有帮助：
- Discord 社区 - 向其他开发者寻求帮助
- GitHub Issues - 报告 bug 或请求功能
- API 参考 - 详细的 API 文档
接下来做什么？
完成这些教程后，你将准备好：
- 构建用于生产环境的 agent 网络
- 为 OpenAgents 项目做出贡献
- 创建自定义 mods 和 extensions
- 加入 OpenAgents 社区
💡 小贴士： 每个教程都包含可下载的代码示例和配置文件。请在整个教程中查找 📁 下载代码 链接。