# crewAI-examples

**Repository Path**: javahui/crewAI-examples

## Basic Information

- **Project Name**: crewAI-examples
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-31
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CrewAI 完整示例

## 简介
欢迎来到**完整 CrewAI 应用**的官方合集。本仓库包含端到端的实现，展示如何使用 CrewAI 框架编排 AI 智能体来构建真实世界的应用。

> **🍳 想查找特定功能的教程？** 请查看 [CrewAI Cookbook](https://github.com/crewAIInc/crewAI-cookbook)，其中包含针对 CrewAI 特定功能和模式的专项指南。

## 你将在这里找到什么

这些是**完整的应用**，它们展示了：
- 完整的项目结构和组织方式
- 真实世界的集成模式（API、数据库、外部服务）
- 包含错误处理的全面代码实现
- 从输入到输出的端到端工作流
- 跨多个领域的行业特定实现

每个示例都是一个独立的应用程序，你可以直接运行、修改和部署。

**注意**：所有示例均使用 **CrewAI 版本 0.152.0** 和 **UV 包管理**，以获得最佳性能和开发者体验。

## 📁 仓库结构

下面按**学习顺序**（从易到难）排列所有示例，帮助你循序渐进。

### 🟢 阶段一：Crew 基础入门（理解框架核心概念）

传统的 CrewAI 实现，展示多智能体协作。从最简单的结构开始，逐步加深。

- [Starter Template](crews/starter_template) - 用于新建 CrewAI 项目的基础模板（学习 agents/tasks/crew 三者如何组装）
- [Game Builder Crew](crews/game-builder-crew) - 设计并构建 Python 游戏的多智能体团队（标准串行协作流程，推荐精读）
- [Job Posting](crews/job-posting) - 自动化职位描述创建（直观的业务用例）
- [Instagram Post](crews/instagram_post) - 创意社交媒体内容生成（简单内容创作）

### 🟡 阶段二：进阶（多智能体协作、工具与外部集成）

深入多智能体分工、自定义工具，以及与 API / 数据源的集成。

- [Marketing Strategy](crews/marketing_strategy) - 全面的营销活动策划（多智能体协作）
- [Stock Analysis](crews/stock_analysis) - 集成 SEC 数据的财务分析（外部 API 集成）
- [Recruitment](crews/recruitment) - 自动化候选人筛选与评估（自定义 selenium 工具）
- [Match Profile to Positions](crews/match_profile_to_positions) - 基于向量搜索的简历与职位匹配
- [Meta Quest Knowledge](crews/meta_quest_knowledge) - 基于 PDF 的问答系统（知识源集成）
- [Markdown Validator](crews/markdown_validator) - 自动化 Markdown 校验与修正
- [Screenplay Writer](crews/screenplay_writer) - 将文本/邮件转换为剧本格式
- [Landing Page Generator](crews/landing_page_generator) - 从概念创建完整的落地页
- [Surprise Trip](crews/surprise_trip) - 个性化的惊喜旅行规划
- [Trip Planner](crews/trip_planner) - 目的地比较与行程优化
- [Prep for a Meeting](crews/prep-for-a-meeting) - 会议准备的研究与策略
- [Industry Agents](crews/industry-agents) - 行业特定智能体实现

### 🔵 阶段三：高级（Flows 状态编排与框架集成）

使用 CrewAI Flows 进行高级编排，适用于带有状态管理的复杂工作流，以及与其他框架的集成。

- [Self Evaluation Loop Flow](flows/self_evaluation_loop_flow) - 带自我审查的迭代式内容改进（Flows 迭代循环入门）
- [Write a Book with Flows](flows/write_a_book_with_flows) - 支持章节并行生成的自动化书籍写作（Flows 并行执行）
- [Lead Score Flow](flows/lead-score-flow) - 带有"人机协作"审查的潜在客户资格评估（human-in-the-loop）
- [Meeting Assistant Flow](flows/meeting_assistant_flow) - 集成 Trello/Slack 的会议纪要处理
- [Email Auto Responder Flow](flows/email_auto_responder_flow) - 自动化邮件监控与回复生成
- [CrewAI-LangGraph](integrations/CrewAI-LangGraph) - 与 LangGraph 框架的集成
- [Azure Model](integrations/azure_model) - 将 CrewAI 与 Azure OpenAI 结合使用
- [NVIDIA Models](integrations/nvidia_models) - 与 NVIDIA AI 生态系统的集成

### 📓 [Notebooks](/Notebooks)
用于交互式探索和学习的 Jupyter notebook 示例。

## 🚀 快速开始

1. **克隆仓库**
   ```bash
   git clone https://github.com/crewAIInc/crewAI-examples.git
   cd crewAI-examples
   ```

2. **选择示例类别**
   - 多 Crew 编排 → 查看 `/flows`
   - 标准 Crew → 查看 `/crews`
   - 平台集成 → 查看 `/integrations`

3. **进入特定示例**
   ```bash
   cd crews/marketing_strategy  # 或其他任何示例
   ```

4. **使用 UV 安装依赖**
   ```bash
   uv sync  # 安装所有依赖并创建虚拟环境
   ```

5. **遵循示例的 README**
   每个示例都包含特定的配置说明和使用指南

## 📚 学习路径

### 初学者
从以下内容开始：
1. [Starter Template](crews/starter_template) - 基础的 crew 结构
2. [Instagram Post](crews/instagram_post) - 简单的内容创作
3. [Job Posting](crews/job-posting) - 直观的业务用例

### 进阶
探索：
1. [Marketing Strategy](crews/marketing_strategy) - 多智能体协作
2. [Self Evaluation Loop Flow](flows/self_evaluation_loop_flow) - 迭代式工作流
3. [Stock Analysis](crews/stock_analysis) - 外部 API 集成

### 高级
深入研究：
1. [Content Creator Flow](flows/content_creator_flow) - 带动态路由的多 Crew 编排
2. [Write a Book with Flows](flows/write_a_book_with_flows) - 复杂的并行执行
3. [Lead Score Flow](flows/lead-score-flow) - 人机协作模式
4. [CrewAI-LangGraph](integrations/CrewAI-LangGraph) - 框架集成

## 🛠 常见模式

- **配置**：大多数示例使用 YAML 文件定义智能体/任务
- **工具**：示例展示与 API、数据库和文件系统的集成
- **Flows**：高级示例演示状态管理和编排
- **训练**：部分示例包含智能体训练能力

## 📝 贡献

我们欢迎贡献！请随时提交展示新用例或对现有示例进行改进的示例。

## 📄 许可证

本仓库由 CrewAI 团队维护。请查看各个示例以了解具体的许可信息。

---

## 🔗 相关资源

- **[CrewAI 框架](https://github.com/crewAIInc/crewAI)** - CrewAI 主仓库
- **[CrewAI Cookbooks](https://github.com/crewAIInc/crewAI-cookbook)** - 功能聚焦的教程和指南
- **[CrewAI 文档](https://docs.crewai.com)** - 全面的文档
- **[CrewAI 社区](https://community.crewai.com)** - 加入我们的社区讨论