2025.10.24

README.md

@@ -1,2 +1,85 @@
-# ai-agent-knowledege
-AI知识仓库，包含博客配套展示代码
+# 💻 Agent Craft
+
+> 智能体开发教学库 | A beginner-friendly guide to building AI agents
+
+
+🔥 从零开始上手agent智能体，掌握langchain、rag、prompt、langgraph等核心技术栈
+
+本仓库专注于 AI Agent 开发的学习与实践，通过系统化的案例和详细的代码注释，帮助开发者快速掌握从基础LLM调用到复杂Agent构建的完整技能栈。
+
+💡 项目将持续更新，目标是构建一个系统、实用的 AI Agent 学习案例库。
+
+📘 本仓库开箱即用，仅需配置 API_KEY。
+
+✍️ 代码可与博客配套使用，博客会重点讲解Agent知识构建与流程解析。
+
+博客同步发布：
+
+👉 [我的CSDN主页](https://blog.csdn.net/2401_87328929)
+
+👉 [CSDN对应专栏](https://blog.csdn.net/2401_87328929/category_12970267.html)
+
+🙋‍♂️ 技术交流 / 更新 / 答疑：微信 **a19731567148**（备注 GitHub）
+
+---
+## 🚅 目录跳转
+
+| 仓库                                                | 博客                                             | 技术栈              | 知识点                  | 难度 |
+|---------------------------------------------------|------------------------------------------------|------------------|----------------------|-----|
+| [01 Agent 入门 & 快速运行](01%20Agent%20入门%20&%20环境搭建/) | [🏠](01%20Agent%20入门%20&%20环境搭建/Agent-demo.py) | 基础LLM            | Agent概念              | ⭐ |
+| [02 LLM基础与调用](02%20LLM基础与调用/1.%20llm基础调用.py)      | [🏠](02%20LLM基础与调用/1.%20llm基础调用.py)            | LLM/API调用/Prompt | 调用模型接口、初识prompt、多轮对话 | ⭐ |
+
+
+---
+
+## 🚀 快速开始
+
+### 1️⃣ 环境准备
+
+```bash
+# 克隆项目
+git clone https://github.com/Annyfee/agent-craft.git
+cd agent-craft
+
+# 安装依赖
+pip install -r requirements.txt
+```
+
+### 2️⃣ API Key 配置
+
+```bash
+# 复制环境变量模板
+cp .env.example .env
+```
+
+在 `.env` 文件中配置：
+```env
+OPENAI_API_KEY=your_deepseek_api_key_here
+```
+
+> 💡 **获取API Key**: 访问 [DeepSeek官网](https://platform.deepseek.com/) 注册并获取API Key
+
+### 3️⃣ 运行示例
+
+```bash
+python "01 Agent 入门 & 环境搭建/Agent-demo.py"
+```
+---
+
+## 📚 学习路径
+
+### 🎯 第一章：Agent 入门 & 快速运行
+- **核心技能**: 运行Agent-demo
+- **学习目标**: 了解Agent是什么，怎么用
+- **技术要点**: 环境配置
+
+### 🎯 第二章：LLM基础与调用
+- **核心技能**: 多轮对话Agent构建
+- **学习目标**: 实现智能对话系统
+- **技术要点**: 对话历史、上下文管理、角色设定
+
+## 🤝 贡献指南
+欢迎贡献代码 / 提交 Issue / Pull Request
+- Fork 仓库  
+- 创建分支进行修改  
+- 提交 PR 并描述修改内容