Skip to content

Latest commit

 

History

History
238 lines (169 loc) · 8.19 KB

README_zh.md

File metadata and controls

238 lines (169 loc) · 8.19 KB

🦉 OWL: Optimized Workforce Learning for General Multi-Agent Assistance in Real-World Task Automation 🦉 OWL: 优化劳动力学习的通用智能体,用于处理现实世界的自动化任务

文档 Discord X Reddit 微信 微信 Hugging Face Star 软件许可证


🏆 OWL 在 GAIA 基准测试中取得 58.18 平均分,在开源框架中排名 🏅️ #1! 🏆

🦉 OWL 是一个前沿的多智能体协作框架,推动任务自动化的边界,构建在 CAMEL-AI Framework

我们的愿景是彻底变革 AI 智能体协作解决现实任务的方式。通过利用动态智能体交互,OWL 实现了跨多领域更自然、高效且稳健的任务自动化。


📋 目录

🔥 新闻

  • [2025.03.07]: 我们开源了 🦉 OWL 项目的代码库。

🎬 演示视频

371254613005d51d73c82424e56a1d22.mp4
d106cfbff2c7b75978ee9d5631ebeb75.mp4

✨️ 核心功能

  • 在线搜索:使用维基百科、谷歌搜索等,进行实时信息检索
  • 多模态处理:支持互联网或本地视频、图片、语音处理
  • 浏览器操作:借助Playwright框架开发浏览器模拟交互,支持页面滚动、点击、输入、下载、历史回退等功能
  • 文件解析:word、excel、PDF、PowerPoint信息提取,内容转文本/Markdown
  • 代码执行:编写python代码,并使用解释器运行

🛠️ 安装

克隆 Github 仓库

git clone https://github.com/camel-ai/owl.git
cd owl

设置环境

使用 Conda(推荐):

conda create -n owl python=3.11
conda activate owl

使用 venv(备用):

python -m venv owl_env
# Windows 系统
owl_env\Scripts\activate
# Unix 或 MacOS 系统
source owl_env/bin/activate

安装依赖

python -m pip install -r requirements.txt

设置环境变量

owl/.env_template 文件中,你可以找到所有必要的 API 密钥以及各服务的注册网址。要使用这些 API 服务,请按照以下步骤操作:

  1. 复制并重命名: 复制 .env_example 文件,并将副本重命名为 .env
  2. 填写你的密钥: 打开 .env 文件,在相应字段中填入你的 API 密钥。
  3. 如需使用更多其他模型:请参考我们CAMEL的models文档:https://docs.camel-ai.org/key_modules/models.html#supported-model-platforms-in-camel

注意:为获得最佳性能,我们强烈建议使用 OpenAI 模型。我们通过测试发现,其他模型在处理复杂任务和基准测试时可能会导致性能显著降低。

🚀 快速开始

运行以下最小示例:

python owl/run.py

你可以通过修改 run.py 来运行自定义任务的 OWL 智能体:

# Define your own task
question = "Task description here."

society = construct_society(question)
answer, chat_history, token_count = run_society(society)

logger.success(f"Answer: {answer}")

你可以尝试以下示例任务:

  • "查询苹果公司的最新股票价格"
  • "分析关于气候变化的最新推文情绪"
  • "帮我调试这段 Python 代码:[在此粘贴你的代码]"
  • "总结这篇研究论文的主要观点:[论文URL]"

🧪 实验

我们提供了一个脚本用于复现 GAIA 上的实验结果。
你可以查看 run_gaia_roleplaying.py 文件,并运行以下命令:

python run_gaia_roleplaying.py

⏱️ 未来计划

  • 撰写一篇技术博客,详细介绍我们在现实任务中多智能体协作方面的探索与见解。
  • 通过引入更多针对特定领域任务的专业工具,进一步完善工具生态系统。
  • 开发更复杂的智能体交互模式和通信协议

📄 许可证

源代码采用 Apache 2.0 许可证。

🖊️ 引用

如果你觉得这个仓库对你有帮助,请引用:

@misc{owl2025,
  title        = {OWL: Optimized Workforce Learning for General Multi-Agent Assistance in Real-World Task Automation},
  author       = {{CAMEL-AI.org}},
  howpublished = {\url{https://github.com/camel-ai/owl}},
  note         = {Accessed: 2025-03-07},
  year         = {2025}
}

🔥 社区

加入我们,参与更多讨论!

❓ 常见问题

Q: 为什么我的Chrome浏览器显示空白页面,但控制台有输出结果?

A: 这是预期的行为。当OWL判断某个任务可以使用非浏览器工具(如搜索、代码分析等)完成时,浏览器窗口可能保持空白。浏览器仅在需要网页交互时才会被激活。我们计划在未来的更新中实现延迟加载以改善这一用户体验。