Agentic-Developer-Craftsmanship

# 代理开发者工艺 **构建专业代理系统 — 从人工智能历史到生产部署.** 本课程100%开源，指导您完成自主代理开发的概念和技术。每个章节包含： - **理论部分**，包含图表和解释 - **明确的前提条件**：开始前需要安装的内容 - **实践练习**，包含要创建的文件、要执行的命令和正确答案 - **验证检查清单**，用于检查进度 **特点：**无需API订阅。所有功能都使用`opencode`和免费模型`big-pickle`。 **主线：** 一个社交网络，其需求规格在[`项目/管理/ cdc.md`](项目/管理/cdc.md)中。每个实践练习都逐步构建该项目。 --- ## 课程和进度 课程分为**5个阶段**，需要按顺序完成： ``` 阶段 1 ──► 阶段 2 ──► 阶段 3 ──► 阶段 4 ──► 阶段 5 基础知识 与LLMs交互 内存和 生产 实践 (P1-P2) (P3-P4) 协作 (P7-P8) (P9-P10) ``` --- ## 一般前提条件 在开始**第一章**之前，请安装以下工具： ### Linux（Ubuntu/Debian） ```bash # 1. 更新软件包 sudo apt update # 2. 安装Python、pip、Git和Docker sudo apt install python3 python3-pip python3-venv git docker.io -y # 3. 允许当前用户在无需sudo的情况下运行Docker sudo usermod -aG docker "$USER" # 4. 重启会话，然后检查Docker docker --version docker run hello-world # 5. 安装opencode python3 -m pip install --user opencode # 6. 检查工具 python3 --version python3 -m pip --version git --version docker --version opencode --version # 7. 测试免费模型big-pickle opencode -m opencode/big-pickle -t "你好，你的角色是什么？" ``` ### macOS ```bash # 1. 安装Homebrew（如果需要）：https://brew.sh # 2. 安装Python、Git和Docker Desktop brew install python git brew install --cask docker # 3. 打开Docker Desktop，然后检查Docker open -a Docker docker --version docker run hello-world # 4. 安装opencode python3 -m pip install --user opencode # 5. 检查工具 python3 --version python3 -m pip --version git --version docker --version opencode --version # 6. 测试免费模型big-pickle opencode -m opencode/big-pickle -t "你好，你的角色是什么？" ``` ### Windows 10/11（PowerShell） ```powershell # 1. 使用winget安装Python、Git和Docker Desktop winget install Python.Python.3.12 winget install Git.Git winget install Docker.DockerDesktop # 2. 重启Windows，启动Docker Desktop，然后检查Docker docker --version docker run hello-world # 3. 安装opencode py -m pip install --user opencode # 4. 检查工具 py --version py -m pip --version git --version docker --version opencode --version # 5. 测试免费模型big-pickle opencode -m opencode/big-pickle -t "你好，你的角色是什么？" ``` > **预期结果：** Python、Git、Docker和opencode显示版本号。`docker run hello-world`显示成功消息。opencode代理用自我介绍作出回应。 ### 整个课程的命令约定 | 用途 | Linux/macOS | Windows PowerShell | |---|---|---| | 运行Python | `python3 script.py` | `py script.py` | | 安装包 | `python3 -m pip install package` | `py -m pip install package` | | 运行pytest | `python3 -m pytest tests/ -v` | `py -m pytest tests/ -v` | | Git命令 | `git ...` | `git ...` | | Docker命令 | `docker ...` | `docker ...` | | opencode命令 | `opencode ...` | `opencode ...` | 在章节中，如果命令以`python3`编写，请在Windows PowerShell中使用`py`。例如：`python3 agent.py`变为`py agent.py`。 ### 所有实践练习的文件夹约定 当实践练习以`mkdir mon-projet && cd mon-projet`等命令开始时，意味着： 1. 在您存放练习的文件夹中打开终端，例如Linux/macOS上的`~/agentic-labs`或Windows上的`C:\Users\YourName\agentic-labs`。 2. 使用`mkdir`创建**新的实践练习文件夹**。 3. 使用`cd`进入该文件夹。 4. 除非另有说明，否则所有指示的文件都应在该文件夹中创建。 Linux/macOS示例： ```bash mkdir -p ~/agentic-labs cd ~/agentic-labs mkdir mon-tp && cd mon-tp pwd ``` Windows PowerShell示例： ```powershell mkdir $HOME\agentic-labs cd $HOME\agentic-labs mkdir mon-tp cd mon-tp pwd ``` `pwd`的结果应显示当前实践练习的文件夹。就是在这个文件夹中，您创建`opencode.json`、`AGENTS.md`、Python文件和测试。 --- ## 课程的10个章节 --- ### 阶段 1 — 基础知识 #### [第 1 章 — 介绍](CHAPITRE-01-histoire-ia.md) | | | |---|---| | **理论** | 1950年至2026年：图灵、变换器、生成时代、代理时代 | | **实践练习** | 安装Python、Git、Docker、opencode、big-pickle — 首次运行代理 | | **⏱ 时长** | 1小时30分钟 | | **前提条件** | Linux、macOS或Windows，具备终端访问权限 | ```bash # 开始前检查 python3 --version && pip --version ``` --- #### [第 2 章 — LLM（大型语言模型）基础](CHAPITRE-02-fondations-llm.md) | | | |---|---| | **理论** | 分词、注意力、变换器架构、缩放定律 | | **实践练习** | 使用Python分词文本，视觉化代币 | | **⏱ 时长** | 1小时30分钟 | | **前提条件** | Python 3.10+，pip | ```bash # Linux/macOS python3 -m pip install tiktoken pytest # Windows PowerShell py -m pip install tiktoken pytest ``` --- ### 阶段 2 — 与LLMs交互 #### [第 3 章 — 提示工程和工具使用](CHAPITRE-03-prompt-tool-use.md) | | | |---|---| | **理论** | 系统提示、少样本、CoT（思维链）、ReAct（推理+行动）、函数调用 | | **实践练习** | 带有工具（天气、计算）的CLI（命令行界面）助手 | | **⏱ 时长** | 2小时 | | **前提条件** | Python 3.10+，pip，opencode | ```bash # 无额外依赖 — Python标准库足够 ``` --- #### [第 4 章 — 代理架构](CHAPITRE-04-architecture-agent.md) | | | |---|---| | **理论** | 代理循环、上下文、规划、生产 | | **实践练习** | 实现感知→推理→行动的代理循环 | | **⏱ 时长** | 2小时 | | **前提条件** | 第3章已完成，Python，opencode | ```bash # 无额外依赖 ``` --- ### 阶段 3 — 内存和协作 #### [第 5 章 — 内存和RAG（检索增强生成）](CHAPITRE-05-memoire-rag.md) | | | |---|---| | **理论** | 嵌入、向量存储、RAG（检索增强生成）、分块、长期记忆 | | **实践练习** | 具有持久内存（SQLite）的代理 | | **⏱ 时长** | 2小时 | | **前提条件** | 第4章已完成，Python，pip，opencode | ```bash # Linux/macOS python3 -m pip install chromadb sentence-transformers # Windows PowerShell py -m pip install chromadb sentence-transformers ``` --- #### [第 6 章 — 多代理编排](CHAPITRE-06-multi-agent.md) | | | |---|---| | **理论** | 监督者模式、扇出模式、辩论、弹性 | | **实践练习** | 使用opencode配置多代理团队 | | **⏱ 时长** | 2小时 | | **前提条件** | 第5章已完成，Python，opencode，git | ```bash # 检查git git --version ``` --- ### 阶段 4 — 生产 #### [第 7 章 — MCP（模型上下文协议）和标准](CHAPITRE-07-mcp-standards.md) | | | |---|---| | **理论** | MCP（模型上下文协议）、A2A（代理到代理）、互操作性 | | **实践练习** | 创建天气MCP（模型上下文协议）服务器，将其连接到opencode | | **⏱ 时长** | 2小时 | | **前提条件** | 第6章已完成，Python，pip，opencode | ```bash # Linux/macOS python3 -m pip install mcp # Windows PowerShell py -m pip install mcp ``` --- #### [第 8 章 — 代理的CI/CD（持续集成/持续部署）和DevOps](CHAPITRE-08-cicd-devops.md) | | | |---|---| | **理论** | 代理测试、CI/CD（持续集成/持续部署）管道、监控、代币成本 | | **实践练习** | 完整的CI/CD（持续集成/持续部署）管道 + GitHub Scrum Board | | **⏱ 时长** | 3小时 | | **前提条件** | 第7章已完成，Python，pip，opencode，git，GitHub账户 | ```bash # Linux/macOS python3 -m pip install pytest ruff bandit # Windows PowerShell py -m pip install pytest ruff bandit # 检查GitHub CLI gh --version ``` --- ### 阶段 5 — 实践 #### [第 9 章 — 代理安全性和安全性](CHAPITRE-09-securite.md) | | | |---|---| | **理论** | 提示注入、越狱、OWASP（开放式Web应用程序安全项目）十大LLM（大型语言模型）、权限 | | **实践练习** | 配置opencode权限、测试注入 | | **⏱ 时长** | 1小时30分钟 | | **前提条件** | 第8章已完成，Python，opencode，git | ```bash # 无额外依赖 ``` --- #### [第 10 章 — opencode 和实践](CHAPITRE-10-opencode-labs.md) | | | |---|---| | **理论** | opencode配置、代理团队、技能 | | **实验室1** | 使用2个代理的第一个opencode项目 | | **实验室2** | 具有CI/CD（持续集成/持续部署）和项目面板的完整团队 | | **实验室3** | 社交网络的完整开发 | | **⏱ 时长** | 4小时 | | **前提条件** | 所有第1-9章已完成，Python，opencode，git，GitHub | ```bash # 最终检查 python --version && opencode --version && git --version && gh --version ``` --- ## 技术栈 | 工具 | 角色 | 成本 | |---|---|---| | [opencode](https://opencode.ai) | 代理平台 | 免费 | | `opencode/big-pickle` | 免费LLM（大型语言模型）模型 | 免费 | | Python 3.10+ | 开发语言 | 免费 | | SQLite | 嵌入式数据库 | 免费 | | Docker | 容器化 | 免费 | | GitHub Actions | CI/CD（持续集成/持续部署） | 免费 | --- ## 如何使用本课程 1. **按照顺序** — 每章都假设有前一章的知识 2. **阅读理论** — 概念用图表和例子说明 3. **完成前提条件** — 每个章节的安装命令都在章节开头 4. **完成实践练习** — 创建文件、运行命令、预期结果 5. **使用检查清单验证** — 所有绿色？继续下一章 --- ## 主线项目 — 社交网络 每个实践练习都为最终项目做出贡献，该项目在 [**需求规格**](项目/管理/cdc.md)中定义。 | 章节 | 对项目的贡献 | |--------|----------------------| | P1 | 配置opencode环境 | | P2 | 了解代币和上下文 | | P3 | 带有工具的CLI（命令行界面）助手 | | P4 | 带有对话内存的代理循环 | | P5 | 持久内存（SQLite）存储事实 | | P6 | 具有主管和专业代理的多代理团队 | | P7 | MCP（模型上下文协议）服务器，用于公开工具 | | P8 | 测试和部署应用程序的CI/CD（持续集成/持续部署）管道 | | P9 | 代理权限和安全性 | | P10 | **由代理团队开发的完整项目** | --- ## 资源 - [Scrum Board — 进度跟踪](https://github.com/users/yugmerabtene/projects/13) - [opencode文档](https://opencode.ai) - [项目需求规格](项目/管理/cdc.md)