探索 3D AI 桌面伴侣 Agent Party:功能、安装与使用全指南

你是否想象过拥有一个既能陪你聊天、又能帮你控制智能家居,甚至还能一键部署到微信、QQ 的 AI 桌面伙伴?今天我们要介绍的 Agent Party,正是这样一款功能强大、玩法多样的 3D 版 AI 桌面伴侣。它不仅集成了知识库、实时联网、永久记忆等企业级功能,还支持多模态交互和跨平台部署,真正实现了“一个智能体,无限可能”。


一、什么是 Agent Party?

Agent Party 是一款开源的 3D AI 桌面伴侣项目,旨在为用户提供高度可定制、功能丰富的智能体体验。它支持多种模块化功能,无需编写代码即可增强现有语言模型的能力,适用于个人娱乐、企业服务、开发测试等多种场景。

主要功能亮点

功能类别 说明
能力增强 支持知识库集成、实时联网搜索、永久记忆、多模态(视觉/语音/绘图)等
多平台部署 可一键部署到微信、QQ、Bilibili 直播、VRM 虚拟桌宠等
生态集成 兼容 Dify/ComfyUI/MCP/A2A 等第三方工作流和工具
标准化接口 提供 OpenAI API 兼容接口和 MCP 协议支持,方便开发者集成
全平台支持 支持 Windows、macOS、Linux,并提供 Docker 部署方式

二、如何安装 Agent Party?

Agent Party 提供了多种安装方式,无论你是普通用户还是开发者,都能找到适合自己的部署方法。

🖥️ Windows 用户安装指南

Windows 用户可以选择安装版或免安装版:

  • 安装版点击下载安装程序
    安装时请选择“仅为当前用户安装”,否则启动时需要管理员权限。

  • 免安装版下载整合包
    解压后双击一键启动(start).bat即可运行,也可通过一键更新(update).bat更新版本。

🍎 macOS 用户安装指南

  1. 下载 DMG 文件
  2. 将 App 文件拖入“应用程序”文件夹
  3. 打开终端,执行以下命令以解除安全限制:
sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app

🐧 Linux 用户安装指南

Linux 用户可选择两种安装方式:

🐳 Docker 部署(推荐用于服务器环境)

如果你习惯使用 Docker,可以通过以下命令快速部署:

docker pull ailm32442/super-agent-party:latest
docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest

部署完成后,访问 http://localhost:3456/ 即可使用。所有数据都会保存在本地的 ./super-agent-data 目录中,确保隐私安全。

📦 源码部署(适合开发者)

如果你希望从源码构建,可以按照以下步骤操作:

Windows 系统:

git clone https://github.com/heshengtao/super-agent-party.git
cd super-agent-party
uv sync
npm install
start_with_dev.bat

Linux/Mac 系统:

git clone https://github.com/heshengtao/super-agent-party.git
cd super-agent-party
uv sync
npm install
chmod +x start_with_dev.sh
./start_with_dev.sh

三、Agent Party 的核心功能展示

1. 多服务商支持

Agent Party 允许你连接多种模型服务,无论是本地部署的 Ollama、Dify,还是云端 API,都能无缝集成。

多服务商支持

2. 丰富的工具生态

内置知识库、联网搜索、智能家居控制、浏览器操作等工具,所有工具支持异步调用,不会阻塞 AI 的响应速度。

海量工具

3. VRM 虚拟桌宠

你可以上传自定义的 VRM 模型,打造独一无二的桌面伴侣形象,让交互更加生动。

VRM桌宠

4. 角色卡与记忆系统

支持导入 Tavern 角色卡,并具备长期记忆能力,让 AI 更懂你。

酒馆角色卡

5. 微信/QQ 机器人部署

一键将智能体部署到微信或 QQ,实现非侵入式的聊天机器人服务,避免账号风控。

微信机器人
QQ机器人

6. 开发者友好接口

提供 OpenAI API 兼容接口和 MCP 协议支持,方便开发者进行二次开发和集成。

开发者接口

7. ComfyUI 工作流集成

可将 ComfyUI 工作流转换为智能体工具,并支持多服务器负载均衡。

ComfyUI集成

四、硬件要求与兼容性

Agent Party 的设计非常轻量,硬件要求极低:

  • CPU:2 核及以上
  • 内存:2GB 及以上

因为所有模型都是可选的,你可以完全使用云端服务,也可以在本地运行轻量模型。甚至在 2核2G 的云服务器上通过 Docker 部署也能流畅运行。


五、如何使用 Agent Party?

基本使用

  • 桌面端:安装后直接点击图标启动即可使用。
  • Web/Docker 版:启动后访问 http://localhost:3456/
  • API 调用:如果你是一名开发者,可以通过以下代码调用 Agent Party 的 API:
from openai import OpenAI

client = OpenAI(
  api_key="super-secret-key",
  base_url="http://localhost:3456/v1"
)

response = client.chat.completions.create(
  model="super-model",
  messages=[
      {"role": "user", "content": "什么是 Agent Party?"}
  ]
)

print(response.choices[0].message.content)

MCP 协议调用

你还可以通过 MCP 协议将 Agent Party 集成到其他支持 MCP 的系统中。只需在配置文件中添加:

{
  "mcpServers": {
    "super-agent-party": {
      "url": "http://127.0.0.1:3456/mcp"
    }
  }
}

六、常见问题解答(FAQ)

❓ Agent Party 是免费的吗?

是的,Agent Party 是一个开源项目,遵循 AGPLv3 协议,可以免费使用。但如果用于闭源商业用途,需要获取商业授权。

❓ 是否支持自定义模型?

支持。你可以接入本地部署的模型(如 Ollama),也可以使用云端 API(如 OpenAI、Dify 等)。

❓ 数据会上传到服务器吗?

不会。所有数据都存储在本地,除非你主动配置了云端服务。

❓ 是否支持语音交互?

支持。Agent Party 具备多模态能力,包括语音输入和输出。

❓ 如何更新版本?

Windows 免安装版可通过 一键更新(update).bat 更新,其他版本请关注项目 Release 页面下载最新版本。


七、结语与支持

Agent Party 作为一款集成了多种强大功能的 AI 桌面伴侣,无论是用于学习、开发还是娱乐,都能提供出色的体验。其模块化设计和多平台支持,让它成为了目前最灵活的 AI 应用框架之一。