docs: 添加 ag-ui 和 crewai 项目 skills 及更新文档

2026-03-02 17:02:09 +08:00
parent 6fdbc34526
commit ca1ce3d84a
43 changed files with 56074 additions and 3 deletions
@@ -0,0 +1,93 @@
+---
+name: crewai
+description: CrewAI framework for multi-agent orchestration. Use when building multi-agent systems, agent collaboration, task automation, crew orchestration, agent teams, delegation, or any CrewAI-related development.
+---
+
+# CrewAI Skills
+
+CrewAI 框架开发权威指南。**必须使用**场景：构建多 Agent 协作系统、编排 Agent 团队、任务自动化、工具集成、知识管理、LLM 应用开发。提供完整模块索引与源文件行号映射。
+
+## 何时使用
+
+**必须使用**的场景：
+- 创建和管理 AI Agent 团队
+- 实现 Agent 间的协作和任务委托
+- 编排多步骤工作流和任务流程
+- 集成 RAG、向量存储和知识管理
+- 配置和管理 LLM 提供商
+- 构建自动化任务和工具
+- 实现 Agent 记忆和推理能力
+- 训练和微调 Agent 性能
+
+**查询模式**：
+- "如何创建 crewai agent"
+- "agent collaboration 委托任务"
+- "crew kickoff 执行流程"
+- "crewai tools 集成"
+- "knowledge RAG 配置"
+- "llm 多模型切换"
+
+## 模块索引
+
+按功能模块查看源文件对应章节：
+
+| 模块 | 作用 | 源文件行号 |
+|------|------|------------|
+| [agents](modules/agents.md) | Agent 概念、属性、创建、高级特性 | 1-1276 |
+| [collaboration](modules/collaboration.md) | Agent 协作、委托、层级管理 | 1277-1655 |
+| [crews](modules/crews.md) | Crew 概念、创建、执行流程 | 1656-2658 |
+| [flows](modules/flows.md) | Flow 流程控制、状态管理 | 2659-3712 |
+| [knowledge](modules/knowledge.md) | 知识管理、向量存储、RAG | 3713-4838 |
+| [llms](modules/llms.md) | LLM 配置、多模型支持 | 4839-6469 |
+| [memory](modules/memory.md) | Memory 记忆系统 | 6470-7341 |
+| [planning](modules/planning.md) | Planning 任务规划 | 7342-7729 |
+| [reasoning](modules/reasoning.md) | Reasoning 推理和反思 | 7730-7877 |
+| [tasks](modules/tasks.md) | Task 概念、属性、执行流程 | 7878-9005 |
+| [tools](modules/tools.md) | Tool 概念、创建、内置工具 | 9006-9292 |
+| [training](modules/training.md) | Training 训练和微调 | 9293-12843 |
+| [installation](modules/installation.md) | 安装、配置、项目创建 | 12844-14875 |
+| [quickstart-tools](modules/quickstart-tools.md) | **快速开始 + 50+ 工具参考** | 14876-53221 |
+
+## 源文件
+
+- `llms-full.md` - CrewAI 完整文档（唯一信源，53221 行）
+
+## 核心概念速查
+
+| 概念 | 说明 | 详见 |
+|------|------|------|
+| **Agent** | 自主单元，执行任务、使用工具、协作 | [agents](modules/agents.md) |
+| **Task** | Agent 完成的具体任务 | [tasks](modules/tasks.md) |
+| **Crew** | Agent 团队，协作完成任务 | [crews](modules/crews.md) |
+| **Tool** | Agent 可用的能力或功能 | [tools](modules/tools.md) |
+| **Flow** | 工作流编排和状态管理 | [flows](modules/flows.md) |
+| **Knowledge** | 知识存储和 RAG 检索 | [knowledge](modules/knowledge.md) |
+
+## 快速路径
+
+**新手入门**：
+1. [installation](modules/installation.md) - 安装和项目创建
+2. [agents](modules/agents.md) - 理解 Agent 核心概念
+3. [tasks](modules/tasks.md) - 创建第一个 Task
+4. [crews](modules/crews.md) - 组建 Crew 并执行
+5. [quickstart-tools](modules/quickstart-tools.md) - 完整快速开始示例
+
+**实现功能**：
+- Agent 协作 → [collaboration](modules/collaboration.md) (委托、层级)
+- 任务编排 → [crews](modules/crews.md) + [flows](modules/flows.md)
+- 知识管理 → [knowledge](modules/knowledge.md) (RAG、向量存储)
+- 工具集成 → [tools](modules/tools.md) + [quickstart-tools](modules/quickstart-tools.md)
+- LLM 配置 → [llms](modules/llms.md)
+
+**高级特性**：
+- Agent 记忆 → [memory](modules/memory.md)
+- 任务规划 → [planning](modules/planning.md)
+- 推理能力 → [reasoning](modules/reasoning.md)
+- 性能优化 → [training](modules/training.md)
+
+## 建议使用方式
+
+1. 先阅读 [installation](modules/installation.md) 了解安装和项目结构
+2. 根据需求查看核心概念模块（agents/tasks/crews/tools）
+3. 高级功能参考对应模块（collaboration/knowledge/flows）
+4. 工具集成参考 [quickstart-tools](modules/quickstart-tools.md)
@@ -0,0 +1,18 @@
+# Agents
+
+**作用**: 介绍 CrewAI 中 Agent 的概念、属性、创建方式和高级特性。
+
+**源文件**: `llms-full.md`
+**行号范围**: 1-1276
+
+**内容索引**:
+- Overview of an Agent - Agent 定义和核心能力 (行 6-22)
+- Agent Attributes - 完整属性表 (行 37-68)
+- Creating Agents (行 70-741):
+  - YAML Configuration (推荐) (行 74-115)
+  - Direct Code Definition (行 117-155)
+  - 完整参数示例 (行 156-357)
+  - Tools 配置 (行 358-365)
+  - Context Management (行 366-543)
+  - Structured Output (行 578-741)
+- CLI - 命令行工具 (行 742-1276)
@@ -0,0 +1,20 @@
+# Collaboration
+
+**作用**: 介绍 Agent 间的协作机制，包括任务委托、层级管理和最佳实践。
+
+**源文件**: `llms-full.md`
+**行号范围**: 1277-1655
+
+**内容索引**:
+- Enable collaboration for agents - 启用协作 (行 1291-1323)
+- Delegation Tools - 委托工具 (行 1325-1343):
+  - Delegate work to coworker (行 1326)
+  - Ask question to coworker (行 1335)
+- Implementation Examples (行 1345-1445):
+  - Collaborative agents 示例 (行 1345-1386)
+  - Hierarchical crew 示例 (行 1447-1481)
+- Best Practices (行 1495-1597):
+  - 角色定义 (行 1495-1514)
+  - 任务依赖 (行 1525-1545)
+  - 常见问题和解决方案 (行 1556-1597)
+- Collaboration Guidelines (行 1598-1655)
@@ -0,0 +1,20 @@
+# Crews
+
+**作用**: 介绍 Crew 的概念、创建方式、执行流程和高级特性。
+
+**源文件**: `llms-full.md`
+**行号范围**: 1656-2658
+
+**内容索引**:
+- Crew Overview - Crew 定义 (行 1656-1891)
+- Example crew execution - 执行示例 (行 1892-1900)
+- Accessing crew output (行 1901-1918)
+- Save crew logs (行 1919-1938)
+- Usage metrics (行 1939-1954)
+- Execution Methods (行 1955-2024):
+  - kickoff() - 同步执行 (行 1955-1988)
+  - kickoff_for_each() - 批量执行 (行 1989-2010)
+  - kickoff_async() - 异步执行 (行 1995-2024)
+  - Streaming - 流式输出 (行 2025-2073)
+- Event Listeners - 事件监听器 (行 2074-2245)
+- Files - 文件处理 (行 2387-2658)
@@ -0,0 +1,13 @@
+# Flows
+
+**作用**: 介绍 Flow 的概念、状态管理、流程控制和与 Crew 的集成。
+
+**源文件**: `llms-full.md`
+**行号范围**: 2659-3712
+
+**内容索引**:
+- Flow Overview - Flow 定义和用途 (行 2659-3293)
+- Structured Output - 结构化输出 (行 3294-3371)
+- Usage example (行 3372-3379)
+- Run the flow (行 3380-3538)
+- Streaming - 流式输出 (行 3539-3712)
@@ -0,0 +1,13 @@
+# Installation
+
+**作用**: 介绍 CrewAI 的安装、配置和项目创建。
+
+**源文件**: `llms-full.md`
+**行号范围**: 12844-14875
+
+**内容索引**:
+- Installation Guide - 安装指南 (行 12844-12944)
+- Creating a CrewAI Project - 项目创建 (行 12945-13047)
+- What is CrewAI? - 框架介绍 (行 13053-13179)
+- MCP Integration - MCP 集成 (行 13763-14450)
+- Quickstart Guide - 快速开始 (行 14876-15252)
@@ -0,0 +1,17 @@
+# Knowledge
+
+**作用**: 介绍 Knowledge 的概念、知识源、向量存储和 RAG 集成。
+
+**源文件**: `llms-full.md`
+**行号范围**: 3713-4838
+
+**内容索引**:
+- Knowledge Overview - 知识管理概念 (行 3713-3750)
+- Vector Stores - 向量存储 (行 3751-3780):
+  - ChromaDB (默认) (行 3751-3755)
+  - Qdrant (行 3756-3760)
+- Knowledge Sources (行 3781-3952):
+  - 创建知识源 (行 3781-3824)
+  - Web content (行 3825-3835)
+  - Agent-level vs Crew-level (行 3953-4000)
+- Advanced Usage (行 4001-4838)
@@ -0,0 +1,11 @@
+# LLMs
+
+**作用**: 介绍 LLM 配置、多模型支持、自定义 LLM 和最佳实践。
+
+**源文件**: `llms-full.md`
+**行号范围**: 4839-6469
+
+**内容索引**:
+- LLM Overview - LLM 配置概念 (行 4839-6281)
+- Supported Providers - 支持的 LLM 提供商 (行 6282-6469)
+- Custom LLM Integration (行 6990-7496)
@@ -0,0 +1,11 @@
+# Memory
+
+**作用**: 介绍 Memory 的概念、类型、配置和使用场景。
+
+**源文件**: `llms-full.md`
+**行号范围**: 6470-7341
+
+**内容索引**:
+- Memory Overview - 记忆系统概念 (行 6470-7341)
+- Memory Types - 记忆类型 (行 6470-7341)
+- Configuration and Usage (行 6470-7341)
@@ -0,0 +1,10 @@
+# Planning
+
+**作用**: 介绍 Planning 功能、任务规划和自动化流程设计。
+
+**源文件**: `llms-full.md`
+**行号范围**: 7342-7729
+
+**内容索引**:
+- Planning Overview - 任务规划概念 (行 7342-7571)
+- Flow-First Mindset - 流程优先思维 (行 7572-7729)
@@ -0,0 +1,52 @@
+# Quickstart & Tools Reference
+
+**作用**: 快速开始指南和完整的工具集成参考。
+
+**源文件**: `llms-full.md`
+**行号范围**: 14876-53221
+
+**内容索引**:
+- Quickstart Guide - 快速开始 (行 14876-15252)
+- Core Tools (行 15253-16645):
+  - AI Mind Tool (行 15253-15338)
+  - Code Interpreter (行 15373-15582)
+  - DALL-E Tool (行 15583-15635)
+  - LangChain Tool (行 15636-15694)
+  - LlamaIndex Tool (行 15695-15841)
+  - RAG Tool (行 15906-16595)
+  - Vision Tool (行 16596-16645)
+- Cloud & Database Tools (行 16646-18003):
+  - MongoDB Vector Search (行 16698-16864)
+  - MySQL RAG Search (行 16865-16934)
+  - NL2SQL Tool (行 16935-17104)
+  - PG RAG Search (行 17105-17187)
+  - Qdrant Vector Search (行 17188-17542)
+  - SingleStore Search (行 17543-17602)
+  - Snowflake Search (行 17603-17732)
+  - Weaviate Vector Search (行 17806-17973)
+- File Tools (行 17974-18868):
+  - CSV RAG Search (行 17974-18051)
+  - Directory Read (行 18052-18105)
+  - Directory RAG Search (行 18106-18175)
+  - DOCX RAG Search (行 18176-18255)
+  - File Read (行 18256-18300)
+  - File Write (行 18301-18351)
+  - JSON RAG Search (行 18352-18427)
+  - MDX RAG Search (行 18428-18499)
+  - OCR Tool (行 18500-18684)
+  - PDF Text Writing (行 18685-18759)
+  - PDF RAG Search (行 18760-18868)
+  - TXT RAG Search (行 18869-18966)
+  - XML RAG Search (行 18967-19044)
+- Search & Research Tools (行 19045-20000+):
+  - Tools Overview (行 19045-19128)
+  - Arxiv Paper Tool (行 19151-19262)
+  - Brave Search (行 19263-19341)
+  - Code Docs RAG Search (行 19360-19445)
+  - Databricks SQL Query (行 19446-19524)
+  - EXA Search Web Loader (行 19525-19579)
+  - Github Search (行 19580-19666)
+  - Linkup Search (行 19667-19737)
+  - SerpApi Tools (行 19738-20000+)
+
+**注**: 此章节包含 50+ 工具的详细文档，按类别组织
@@ -0,0 +1,10 @@
+# Reasoning
+
+**作用**: 介绍 Reasoning 功能、反思机制和任务执行前的规划。
+
+**源文件**: `llms-full.md`
+**行号范围**: 7730-7877
+
+**内容索引**:
+- Reasoning Overview - 推理和反思概念 (行 7730-7877)
+- Configuration (行 7730-7877)
@@ -0,0 +1,20 @@
+# Tasks
+
+**作用**: 介绍 Task 的概念、属性、创建方式、执行流程和高级特性。
+
+**源文件**: `llms-full.md`
+**行号范围**: 7878-9005
+
+**内容索引**:
+- Task Overview - Task 定义 (行 7883-7902)
+- Task Execution Flow - 执行流程 (行 7904-7919)
+- Task Attributes - 完整属性表 (行 7921-7994)
+- Creating Tasks (行 7995-8277):
+  - YAML Configuration (行 7995-8125)
+  - Direct Code Definition (行 8126-8161)
+  - Markdown formatting (行 8162-8277)
+- Advanced Features (行 8278-9005):
+  - Guardrails - 任务护栏 (行 8396-8547)
+  - Callbacks (行 8548-8657)
+  - Output files (行 8658-8773)
+  - Execute tasks (行 9112-9227)
@@ -0,0 +1,13 @@
+# Tools
+
+**作用**: 介绍 Tool 的概念、创建方式、内置工具和自定义工具。
+
+**源文件**: `llms-full.md`
+**行号范围**: 9006-9292
+
+**内容索引**:
+- Tools Overview - 工具概念 (行 9006-9292)
+- Creating Custom Tools (行 9006-9292)
+- Built-in Tools List (行 9006-9292)
+
+**注**: 完整的工具集成文档见 Quickstart 章节 (行 14876-53221)
@@ -0,0 +1,12 @@
+# Training
+
+**作用**: 介绍 Training 功能、模型训练、微调和性能优化。
+
+**源文件**: `llms-full.md`
+**行号范围**: 9293-12843
+
+**内容索引**:
+- Training Overview - 训练概念 (行 9293-9494)
+- Training Methods (行 9495-12843)
+- Best Practices (行 9616-9725)
+- Custom Templates (行 9953-10166)