XAgent

English • 中文 • 日本語

教程 • 演示 • 博客 • 文档 • 引用

📖 简介

XAgent 是一个开源的实验性大语言模型（LLM）驱动的自主智能体，能够自动解决各种任务。它旨在成为一个通用的智能体，适用于广泛的任务场景。XAgent 目前仍处于早期阶段，我们正在努力不断改进。

🏆 我们的目标是创建一个能够解决任何给定任务的超级智能体！

我们欢迎各种形式的合作，包括全职、兼职等。如果您对智能体的前沿领域感兴趣，并希望加入我们共同实现真正的自主智能体，请通过 xagentteam@gmail.com 与我们联系。

XAgent 概览。

XAgent

XAgent 的设计具备以下特性：

• 自主性 (Autonomy)：XAgent 可以在无需人工参与的情况下自动解决各种任务。
• 安全性 (Safety)：XAgent 的设计确保了运行安全，所有操作都被限制在 Docker 容器内。尽管运行吧！
• 可扩展性 (Extensibility)：XAgent 具有极强的可扩展性，您可以轻松添加新工具来增强智能体的能力，甚至添加新的智能体！
• GUI：XAgent 为用户提供了一个友好的图形用户界面（GUI）来与智能体交互。当然，您也可以使用命令行界面（CLI）与智能体进行交互。
• 人机协作 (Cooperation with Human)：XAgent 可以与您合作完成任务。它不仅有能力在执行复杂任务时遵循您的指导，还可以在遇到挑战时主动寻求您的协助。

XAgent 由三部分组成：

• 🤖 Dispatcher（调度器）：负责动态实例化任务并将任务分发给不同的智能体。这使我们能够添加新的智能体并不断提升其能力。
• 🧐 Planner（规划器）：负责为任务生成和修订计划。它将任务拆解为子任务并设置里程碑，从而使智能体能够循序渐进地解决问题。
• 🦾 Actor（执行者）：负责执行行动以实现目标并完成子任务。Actor 利用各种工具来处理子任务，并能与人类协作完成任务。

XAgent 工作流程。

🧰 ToolServer

ToolServer 是为 XAgent 提供强大且安全工具以解决任务的服务端。它是一个 Docker 容器，为 XAgent 的运行提供了安全环境。 目前，ToolServer 提供以下工具：

• 📝 File Editor（文件编辑器）：提供文本编辑工具，用于读写和修改文件。
• 📘 Python Notebook：提供交互式 Python Notebook，可用于运行 Python 代码以验证想法、绘制图表等。
• 🌏 Web Browser（网页浏览器）：提供网页浏览器用于搜索和访问网页。
• 🖥️ Shell：提供 Bash Shell 工具，可以执行任何 Shell 命令，甚至包括安装程序和托管服务。
• 🧩 Rapid API：提供从 Rapid API 获取并调用 API 的工具，为 XAgent 提供了海量的 API 资源。更多信息请参见 ToolBench。 您也可以轻松地向 ToolServer 添加新工具，以增强 XAgent 的能力。

✨ 快速开始

🛠️ 构建并设置 ToolServer

ToolServer 是 XAgent 执行操作的场所。它是一个提供安全运行环境的 Docker 容器。 因此，您首先需要安装 docker 和 docker-compose。 接着，您需要构建 ToolServer 镜像。可以通过以下任一方式进行构建：

通过运行以下命令从 Docker Hub 拉取镜像：

docker compose up

通过运行以下命令从本地源码构建镜像：

docker compose build
docker compose up

这将构建 ToolServer 镜像并启动容器。如果您希望在后台运行容器，请使用 docker compose up -d。 详细信息请参考 这里。

如果 ToolServer 有更新，您需要重新拉取或重新构建镜像：

docker compose pull

或者

docker compose build

🎮 设置并运行 XAgent

设置好 ToolServer 后，即可开始运行 XAgent。

• 安装依赖（需要 Python >= 3.10）

pip install -r requirements.txt

• 配置 XAgent

1. 在运行前，您需要在 assets/config.yml 中配置 XAgent。
2. 至少需要在 assets/config.yml 中提供一个 OpenAI Key，用于访问 OpenAI API。 我们强烈建议使用……