XAgent

English • 中文 • 日本語

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

📖 简介

XAgent 是一个开源的、由大语言模型（LLM）驱动的实验性自主智能体（Autonomous Agent），能够自动解决各类任务。 它被设计为一种通用的智能体，适用于广泛的任务场景。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（执行器）：负责执行动作以实现目标并完成子任务。执行器利用各种工具来解决子任务，并能与人类协作完成任务。

（此处应有 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 的详细信息，请参考这里。

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

docker compose pull

或者

docker compose build

🎮 设置并运行 XAgent

设置好 ToolServer 后，就可以开始运行 XAgent 了。

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

pip install -r requirements.txt

• 配置 XAgent

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