microagents 项目介绍
项目概述
microagents 框架是一个创新性的实验平台,它用于动态创建能够自我提升的代理(agent)。这些代理大小如同微服务,因此称为“微代理”(microagents)。它们根据用户赋予的任务被动态生成,经过功能性评估后,通过验证的代理会被存储以备日后重复使用。这样的设计不仅能让系统在聊天过程中进行学习,还能自主推导出执行任务的方法。
构建技术
microagents 项目主要依赖以下技术:
- Python:作为项目的主要编程语言。
- OpenAI 的 GPT-4 Turbo:用于自然语言处理。
- Text-Embedding-Ada-002:用于文本嵌入处理。
开始使用
若要在本地运行 microagents 项目,只需按照以下步骤操作。
前提条件
- OpenAI 帐户:确保您拥有能够访问
gpt-4-turbo
和text-embedding-ada-002
的 OpenAI 帐户。
安装步骤
-
克隆代码库:
git clone https://github.com/aymenfurter/microagents.git
-
安装 Python 包:
pip install -r requirements.txt
-
设置环境变量:
对于使用 OpenAI API 的情况:
export OPENAI_KEY='your_api_key_here'
若使用 Azure OpenAI 并带有 API key:
export AZURE_OPENAI_API_KEY='your_api_key_here' export AZURE_OPENAI_ENDPOINT='https://my_endpoint_name_here.openai.azure.com/'
若使用 Azure OpenAI 并带有 Entra ID (AAD):
export AZURE_OPENAI_ENDPOINT='https://my_endpoint_name_here.openai.azure.com/' export AZURE_OPENAI_USE_AAD='true'
使用指南
注意:microagents 直接执行 Python 代码,目前不在沙箱中操作。强烈建议在如 GitHub Codespaces 或 Docker(参见 README-Docker.md)等隔离环境中运行,以限制潜在风险。请注意使用 OpenAI 服务的成本。
演示运行命令:
python main.py
进行互动聊天体验:
python app.py
要移除所有代理,仅需删除 "agents.db" 文件。
演示
microagents 项目提供了一些示例代理,如获取天气预报代理和基于 IP 的位置获取代理。这些代理通过 Python 代码进行相应的操作,以实现相应功能。
项目更新日志
版本 v0.1.0(2024年1月21日)
此版本是 microagents 的首次发布,包含以下主要更新:
- 提交请求:项目已收到六个拉取请求,展示了社区的兴趣。
- 两个用户界面:提供命令行界面(CLI)和基于 Gradio 的网页界面。
- 并行化支持:在创建新代理时,三个代理会并行生成,成功完成任务的代理将被保留。
- 预训练代理:引入了28个预训练代理,涵盖多种任务。
- 验证阶段:新增“Judge”验证阶段,保证代理功能完善。
- 持久化代理存储:代理可在程序运行过程中被存储,使用 SQLite。
- 改进的代理记忆:增强了代理创建的稳健性,避免执行时不必要的变化。
这些更新显著提升了 microagents 的功能,未来期待社区的进一步贡献。
贡献
项目鼓励开源社区的贡献,任何形式的贡献都非常感谢。
许可证
此项目基于 MIT 许可证进行分发,详细信息请参阅 LICENSE
。