iX - 自主 GPT-4 代理平台

在浩瀚宇宙中翻滚的沙尘间，Ix 如一颗神秘而璀璨的宝石，人类智慧的光辉在禁忌之知识的边缘翩然起舞，为整个银河系投下一层充满谜团的阴影。

－ 阿特雷德书记官，《伊克尼亚创新编年史》

🌌 关于

构建 AI 驱动的工作流：

• 质疑问答聊天机器人
• 代码生成
• 数据提取
• 数据分析
• 数据增强
• 研究助理

核心功能

🧠 模型

• OpenAI
• Google PaLM（实验性）
• Anthropic（实验性）
• Llama（实验性）

⚒️ 无代码代理编辑器

无代码编辑器，用于创建并测试代理。该编辑器提供了一个界面，可将节点拖拽并连接成图，从而构建代理的认知逻辑。聊天功能内嵌于编辑器中，方便快速测试与调试。

https://github.com/kreneskyp/ix/assets/68635/f43923b9-7bce-4b64-b30e-3204eb1673e4

💬 多代理聊天接口

创建属于您的代理团队，并通过单一界面与它们互动。聊天室支持多代理同时参与对话。默认情况下，会包含 IX 主持人代理，负责将任务委派给其他代理。您还可以通过“@提及”特定代理来完成任务。

https://github.com/kreneskyp/ix/assets/68635/d1418c23-afb5-4aed-91c7-bf99b1c165d5

💡 智能输入

智能输入栏可自动补全代理的“@提及”，并自动填充由任务生成的文件与数据“{artifacts}”。

https://github.com/kreneskyp/ix/assets/68635/27cf7085-7349-4641-9327-d31a3041a94c

⚡ 消息队列驱动的代理工作者

代理运行器后端采用 Docker 方式部署，并通过 Celery 消息队列触发。这一机制使后端能够横向扩展，以支持并行运行的代理集群。

⚙️ 组件配置层

IX 实现了组件配置层，将 LangChain 组件映射至配置图。该配置层为众多其他系统与功能提供了强大支持。例如，组件字段与连接器定义可用于在无代码编辑器中动态渲染节点与表单。

🛠️ 入门指南

前置条件

Agent-IX CLI

启动 IX 的最快方式是使用 Agent-IX CLI。CLI 会启动一个预先配置好的 Docker 集群，并通过 Docker-compose 进行管理。它会自动下载所需镜像，并启动应用集群。

pip install agent-ix
ix up

通过 scale 命令对代理工作者进行扩展。每个工作者将并行运行代理进程。工作者数量的上限取决于可用内存和 CPU 能力。

ix scale 5

客户端可以启动特定版本，包括基于 master 分支构建的不稳定版 dev 镜像。

ix up --version dev

它是如何工作的

基本用法

您与代理进行对话，代理将根据您的指令展开调查、制定计划并完成各项任务。这些代理能够搜索网络、编写代码、生成图像、与各类 API 和服务交互。只要可以编程实现，就有机会打造代理来协助您完成任务。

1. 设置好服务器，并访问 http://0.0.0.0:8000，系统会自动创建一个新的聊天室，并配备默认代理。

2. 输入请求后，IX 主持人会将任务委派给最适合完成该响应的代理。或者，您可以“@提及”某个代理，请求指定的代理来完成任务。

3. 根据需要，您可以添加或移除自定义代理，以更好地处理您的任务。

创建自定义代理与链

IX 提供了主持人代理 IX、编码器代理以及其他示例代理。您可以使用链编辑器或 Python API 来构建自定义代理。

链编辑器

1. 导航至 链编辑器
2. 点击根连接器，打开组件搜索界面
3. 将代理、链、工具及其他组件拖拽至编辑器中
4. 将各组件连接起来，构建一条链
5. 打开测试聊天，体验其功能！

Python API

链 Python API 文档

🧙 开发环境搭建

1. 前置条件

在开始之前，请确保您的系统已安装以下软件：

2. 克隆仓库

git clone https://github.com/kreneskyp/ix.git
cd ix

3. 设置环境变量

在 .env 文件中配置环境变量。

cp .env.template .env

OPENAI_API_KEY=YOUR_KEY_HERE

4. 构建并初始化 IX 集群

在大多数情况下，镜像会自动构建。若需跳过镜像的重新构建，请将 NO_IMAGE_BUILD=1 设置为真。

使用 image 目标来构建并启动 IX 镜像。dev_setup 目标将构建前端并初始化数据库。更多用于管理开发环境的命令，请参阅“开发者工具”部分。

make dev_setup

5. 运行 IX 集群

IX 集群通过 Docker Compose 运行。它会启动 Web 服务器、应用服务器、代理工作者、数据库、Redis 以及其他辅助服务的容器。

make cluster

6. 查看日志

Web 和应用容器的日志：

make server

代理工作者容器的日志：

make worker

7. 打开用户界面

访问 http://0.0.0.0:8000 即可进入用户界面。在此界面中，您可以创建并编辑代理和链。 平台会根据需要自动启动代理进程，以完成各项任务。

扩展工作者数量

使用 scale 目标调整活跃代理工作者的数量。默认情况下，系统会启动 1 个代理工作者来处理任务。代理的数量没有硬性限制，但工作者的数量受可用内存和 CPU 资源的限制。

make scale N=5

开发者工具

以下是一些对开发者非常有帮助的命令，可用于设置和管理开发环境：

运行：

• make up / make cluster：以开发模式启动应用程序，地址为 http://0.0.0.0:8000。
• make server：实时监控 Web 和应用容器的日志。
• make worker：实时监控代理工作者容器的日志。

构建：

• make image：构建 Docker 镜像。
• make frontend：重新构建前端（GraphQL、Relay、Webpack）。
• make webpack：仅重新构建 JavaScript。
• make webpack-watch：在文件变更时自动重新构建 JavaScript。
• make dev_setup：构建前端并生成数据库。
• make node_types_fixture：为组件类型定义生成数据库 fixture。

数据库

• make migrate：执行 Django 数据库迁移。
• make migrations：生成新的 Django 数据库迁移文件。

实用工具

• make bash：在 Docker 容器中打开 Bash shell。
• make shell：打开 Django shell_plus 会话。

代理 fixture

使用 dump_agent Django 命令导出 fixture。该命令会收集并导出代理和链，包括组件图。

1. make bash
   

2. ./manage.py dump_agent -a alias
   

iX 自主 AI 智能体平台快速上手指南

iX 是一个用于设计和部署由大语言模型（LLM）驱动的自主及半自主智能体与工作流的平台。它支持无代码编辑、多智能体协作聊天以及横向扩展的任务处理能力。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：
  • Linux / macOS：原生支持。
  • Windows：必须安装并启用 WSL (Windows Subsystem for Linux)。
    • 在 PowerShell 中运行：wsl --install
• Docker：需安装 Docker Desktop 以运行容器化服务。
  • 下载地址：Docker Desktop
• Python：CLI 工具需要 Python 3.8 或更高版本（应用本身的 Python 环境由 Docker 镜像管理）。
• 开发工具（仅源码开发模式需要）：git 和 make。
  • Mac: brew install git make
  • Linux/WSL: apt install git make

安装步骤

您可以根据需求选择 快速启动（推荐） 或 源码开发 两种方式进行安装。

方式一：使用 CLI 快速启动（推荐）

这是最简单的启动方式，会自动下载所需的 Docker 镜像并配置集群。

1. 安装 CLI 工具

   pip install agent-ix
   

2. 启动服务 运行以下命令启动预配置的 Docker 集群：

   ix up
   

3. （可选）扩展工作节点 如果需要并行处理更多任务，可以扩展 Agent 工作节点数量（受限于内存和 CPU）：

   ix scale 5
   

4. （可选）指定版本 如需体验最新开发版（基于 master 分支）：

   ix up --version dev
   

方式二：源码开发模式

如果您需要修改代码或贡献项目，请按以下步骤操作：

1. 克隆仓库

   git clone https://github.com/kreneskyp/ix.git
   cd ix
   

2. 配置环境变量 复制模板文件并填入您的 API Key（主要是 OpenAI）：

   cp .env.template .env
   

   编辑 .env 文件，设置：

   OPENAI_API_KEY=YOUR_KEY_HERE
   

3. 构建与初始化 构建前端并初始化数据库：

   make dev_setup
   

4. 启动集群 启动 Web 服务器、应用服务器、Agent 工作节点、数据库及 Redis 等服务：

   make cluster
   

5. 查看日志（可选）

   • 查看 Web/App 日志：make server
   • 查看 Agent 工作节点日志：make worker

6. 扩展工作节点（可选）

   make scale N=5
   

基本使用

安装完成后，即可通过浏览器访问平台进行交互。

1. 访问界面 打开浏览器访问：http://0.0.0.0:8000 系统将自动创建一个包含默认智能体（如 IX 协调员、代码编写员等）的新聊天室。

2. 发起任务

   • 自动分配：直接在输入框输入自然语言指令（例如：“帮我分析这份数据”或“写一个 Python 脚本抓取网页”）。IX 协调员（Moderator）会自动将任务分配给最适合的智能体。
   • 指定智能体：使用 @ 符号提及特定智能体来指派任务（例如：@coder 请帮我修复这个 bug）。

3. 智能输入辅助 输入栏支持自动补全：

   • 输入 @ 可自动联想可用的智能体。
   • 输入 { 可自动联想任务生成的文件或数据产物（Artifacts）。

4. 创建自定义智能体（无代码）

   • 导航至 Chain Editor。
   • 点击根连接器打开组件搜索。
   • 拖拽智能体、链、工具等组件到画布中。
   • 连接组件以构建逻辑链。
   • 打开内置的测试聊天窗口进行调试。

提示：iX 支持多种模型后端（OpenAI, Google PaLM, Anthropic, Llama 等），部分实验性模型需在配置中启用。