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/