microagents

microagents 项目介绍

项目概述

microagents 框架是一个创新性的实验平台，它用于动态创建能够自我提升的代理（agent）。这些代理大小如同微服务，因此称为“微代理”（microagents）。它们根据用户赋予的任务被动态生成，经过功能性评估后，通过验证的代理会被存储以备日后重复使用。这样的设计不仅能让系统在聊天过程中进行学习，还能自主推导出执行任务的方法。

构建技术

microagents 项目主要依赖以下技术：

• Python：作为项目的主要编程语言。
• OpenAI 的 GPT-4 Turbo：用于自然语言处理。
• Text-Embedding-Ada-002：用于文本嵌入处理。

开始使用

若要在本地运行 microagents 项目，只需按照以下步骤操作。

前提条件

• OpenAI 帐户：确保您拥有能够访问 gpt-4-turbo 和 text-embedding-ada-002 的 OpenAI 帐户。

安装步骤

1. 克隆代码库：

   git clone https://github.com/aymenfurter/microagents.git

2. 安装 Python 包：

   pip install -r requirements.txt

3. 设置环境变量：

   对于使用 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。