多智能体网络研究系统（基于YAML）

一个利用Google ADK构建的复杂多智能体系统，采用Firecrawl MCP工具进行网页抓取，并在专门的研究与摘要智能体之间实现协调。

架构

本系统由以下部分组成：

1. 主协调智能体 (root_agent.yaml) - 负责整个工作流的编排
2. 研究智能体 (research_agent.yaml) - 使用Firecrawl MCP工具进行网页抓取和内容分析
3. 摘要智能体 (summary_agent.yaml) - 生成全面的报告和摘要
4. Firecrawl MCP集成 - 高级网页抓取，配备恰当的子智能体配置

特性

• 高级网页抓取：使用Firecrawl MCP工具实现可靠的内容提取
• 智能内容分析：研究智能体提取洞察、模式和关键数据
• 全面报告生成：摘要智能体创建结构化的报告和建议
• 多智能体协调：主智能体无缝协调整个工作流
• 安全API管理：通过环境变量管理Firecrawl API密钥
• ⚡ 子智能体MCP支持：子智能体中正确配置的MCP工具

设置

先决条件

1. 安装Google ADK：

   pip install google-adk
   ​

2. 从firecrawl.dev获取Firecrawl API密钥

3. 在.env文件中设置环境变量：

   选项A：Google AI Studio（开发推荐）

   GOOGLE_GENAI_USE_VERTEXAI=0
   GOOGLE_API_KEY=<your-google-gemini-api-key>
   FIRECRAWL_API_KEY=<your-firecrawl-api-key>
   ​

   选项B：Vertex AI（生产推荐）

   GOOGLE_GENAI_USE_VERTEXAI=1
   GOOGLE_CLOUD_PROJECT=<your-gcp-project-id>
   GOOGLE_CLOUD_LOCATION=us-central1
   FIRECRAWL_API_KEY=<your-firecrawl-api-key>
   ​

   获取API密钥：

   • Google AI Studio：从Google AI Studio获取API密钥
   • Vertex AI：使用Google Cloud认证进行身份验证
   • Firecrawl：从Firecrawl获取API密钥

安装

1. 导航到智能体目录：

   cd ai_agent_framework_crash_course/google_adk_crash_course/adk_yaml_examples/multi_agent_web_research_team/multi_agent_web_researcher
   ​

2. 验证ADK安装：

   adk --version
   ​

使用

运行智能体

选择以下任一方法运行您的智能体：

1. Web界面（测试推荐）：

   adk web
   ​

2. 命令行：

   adk run
   ​

3. API服务器（用于集成）：

   adk api_server
   ​

智能体配置

主智能体 (root_agent.yaml)

负责协调的智能体：

• 将任务委派给专门的子智能体
• 协调研究和摘要智能体
• 综合最终的全面报告
• 向子智能体提供清晰的指令

研究智能体 (research_agent.yaml)

专门用于网页抓取和内容分析：

• Firecrawl MCP工具：使用firecrawl_scrape and firecrawl_search
• Content Analysis: Extracts key findings and insights
• Pattern Recognition: Identifies trends and relationships
• Data Extraction: Highlights important quotes and data points
• Research Suggestions: Suggests areas for further investigation

Available Firecrawl Tools:

• firecrawl_scrape: Scrape content from single URLs
• firecrawl_search: Search the web for relevant content
• firecrawl_batch_scrape: Scrape multiple URLs efficiently
• firecrawl_map: Discover URLs on websites
• firecrawl_crawl：全面的网站爬虫功能

摘要智能体 (summary_agent.yaml)

专门用于报告生成：

• 创建执行摘要
• 按主题组织信息
• 生成关键要点
• 提供可操作的建议

工作流

1. 输入：用户提供URL或研究主题
2. 委派：主智能体向研究智能体传递清晰指令
3. 网页抓取：研究智能体使用Firecrawl MCP工具提取内容
4. 分析：研究智能体分析抓取的内容以获取洞察
5. 总结：摘要智能体生成全面报告
6. 综合：主智能体将发现整合为最终报告

环境变量

Google AI Studio配置

Vertex AI Configuration

Authentication Methods

Google AI Studio:

• Simple API key authentication
• Best for development and testing
• No Google Cloud setup required

Vertex AI:

• Enterprise-grade authentication
• Best for production deployments
• Requires Google Cloud Project setup
• Supports advanced features like grounding and safety settings

Example Usage

Web Interface

1. Run adk web
2. 打开浏览器访问提供的URL
3. 输入一个URL或研究主题（例如，“抓取并分析https://example.com”或“研究AI趋势”）
4. 观看多智能体系统处理您的请求

命令行

adk run
# Enter your research query when prompted
​

故障排除

常见问题

1. API密钥错误：确保所有必需的API密钥已在.env中设置
   • 项目ID：确认您的Google Cloud项目ID对Vertex AI正确

参考资料

• Google ADK文档
• 智能体配置参考
• Firecrawl文档
• MCP工具

免责声明：
本文档采用基于机器的 AI 翻译服务进行翻译。尽管我们力求准确，但请注意，自动翻译可能存在错误或不准确之处。应以原文语言版本的文档作为权威依据。如需获取关键信息，建议使用专业的人工翻译。对于因使用本翻译而产生的任何误解或误读，我们概不负责。