Multi Agent Research POC

🚀 兼容AutoGen的多智能体研究概念验证项目（使用Ollama和BraveSearch）

本项目是一个本地优先的多智能体系统概念验证，借助Ollama和Brave Search等技术，实现了本地LLM的运用、工具调用检测以及网络搜索等功能，为多智能体研究提供了实践范例。

🚀 快速开始

克隆项目

git clone <your-repo-url>
cd 多智能体研究POC

安装依赖项

pip install -r requirements.txt

设置你的 .env

echo "BRAVE_API_KEY=your_brave_api_key_here" > .env

获取你的 Brave API 密钥：https://developer.brave.com/api-search/

在本地运行 Ollama

ollama run llama3:8b

⚠️ 重要提示

如果使用 Docker，请确保将主机设置为 http://host.docker.internal:11434

运行程序

python main.py

你应该会看到：

• Searcher 代理的响应
• 工具调用触发
• 从 Brave 获取的搜索结果
• Synthesizer 代理生成的最终摘要

✨ 主要特性

• 🤖 使用 Ollama 的本地 LLM
• 🧩 think... 语法进行工具调用检测
• 🔍 通过 Brave Search API 或 Brave MCP 插件服务器 进行网络搜索
• 🧠 两个协作代理：Searcher 和 Synthesizer

📦 安装指南

克隆项目

git clone <your-repo-url>
cd 多智能体研究POC

安装依赖项

pip install -r requirements.txt

设置环境变量

echo "BRAVE_API_KEY=your_brave_api_key_here" > .env

获取你的 Brave API 密钥：https://developer.brave.com/api-search/

运行 Ollama

ollama run llama3:8b

💻 使用示例

基础用法

# 克隆项目
git clone <your-repo-url>
cd 多智能体研究POC

# 安装依赖项
pip install -r requirements.txt

# 设置环境变量
echo "BRAVE_API_KEY=your_brave_api_key_here" > .env

# 运行 Ollama
ollama run llama3:8b

# 运行程序
python main.py

高级用法

切换到 API 和 MCP 插件之间

选项 1：Brave 搜索 API（默认）

通过以下方式使用：

"BraveSearch": call_brave_api

选项 2：Brave MCP 插件服务器

1. 启动插件服务器：

npx @modelcontextprotocol/server-brave-search

2. 更新 tools/tool_registry.py：

# "BraveSearch": call_brave_api,
"BraveSearch": call_brave_mcp_server

📚 详细文档

文件结构

多智能体研究POC/
├── main.py                   # 入口点
├── agents/
│   ├── searcher.py           # 基于 Ollama 的研究代理
│   └── synthesizer.py        # 摘要生成器代理
├── tools/
│   ├── tool_parser.py        # 工具调用检测逻辑
│   └── tool_registry.py      # 工具分发器（API 或 MCP）
├── .env                      # 包含 BRAVE_API_KEY
└── requirements.txt          # Python 依赖项

示例输出

# 搜索部分
搜索结果：[...] 与查询相关的结果 [...]

# 摘要生成部分
总结： [...] 关键信息提取和整理 [...]

更多详细输出示例请参考项目文档。

🔧 技术细节

下一步改进

📄 许可证

本项目仅为研究用途，不涉及任何商业用途。相关数据和结果请遵守适用的法律法规和隐私政策。

致谢

感谢以下项目的贡献：

• Ollama - https://ollama.ai/
• AutoGen - https://github.com/HuggingFace/auto-gpt2
• Brave Search - https://brave.com/search/