Super Agent Party 项目安装与配置完全指南

项目概述

Super Agent Party 是一个功能强大的智能体管理与交互平台，提供了多种部署方式和丰富的配置选项。本文将详细介绍该项目的安装部署方法以及核心功能配置指南，帮助开发者快速上手使用。

安装部署方案

Windows桌面版安装（推荐新手使用）

对于Windows用户，最简便的方式是直接下载安装桌面版应用程序。该版本提供了图形化安装向导，只需双击安装包并按照提示完成安装即可立即使用。

Docker容器化部署（推荐生产环境使用）

Docker部署是最为推荐的方案，具有环境隔离、部署简单等优势：

1. 获取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
     

   • 或从源码构建：

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

2. 访问服务：http://localhost:3456/

源码部署（适合开发者）

1. 获取源码：

   git clone 项目仓库地址
   cd super-agent-party
   

2. 安装依赖：

   • Windows: 执行install.bat
   • macOS/Linux: 执行install.sh
   • 或手动创建虚拟环境并安装：

     python -m venv .venv
     source .venv/bin/activate  # Linux/macOS
     pip install -r requirements.txt
     npm install
     

3. 启动服务：

   • 使用开发脚本：
     • Windows: start_with_dev.bat
     • macOS/Linux: start_with_dev.sh
   • 或手动启动：

     npm run dev
     

核心功能配置指南

1. 基础系统设置

在左侧边栏可设置：

• 系统语言（支持多语言切换）
• 主题风格（亮色/暗色模式）

2. 模型服务配置

模型服务接口：

• 配置云服务提供商（如OpenAI、DeepSeek等）
• 填写API密钥后，点击右上角搜索按钮获取可用模型列表
• 选择需要的模型完成配置

主模型与推理模型：

• 主模型需具备工具调用能力
• 推理模型需具备推理能力
• 默认选择服务商的第一个模型

视觉模型：

• 为无视觉能力的模型添加图像处理能力
• 自动缓存发送的图像以节省token

3. 智能体套件配置

智能体接口：

• 配置系统提示词（决定智能体行为）
• 创建智能体时会快照当前所有配置

MCP服务：

• 支持两种调用方式：
  • 标准输入/输出（需配置MCP服务器参数）
  • Server-Sent Events (SSE)（需配置服务器地址）

A2A服务：

• 配置A2A服务器地址即可使用

LLM工具：

• 支持自定义智能体接入（兼容Ollama/OpenAI格式）

4. 工具套件配置

基础工具：

• 当前时间查询
• 深度研究功能
• 伪推理能力
• 语言锁定设置

互联网功能：

• 支持多种搜索引擎：
  • DuckDuckGo（无需配置）
  • SearxNG（需配置Docker地址）
  • Tavily（需API密钥）
• 网页转Markdown工具：
  • Jina（无需配置）
  • Crawl4AI（需Docker地址）

知识库：

• 配置前需先完成词嵌入模型设置
• 支持文档索引与检索

5. 调用方式

支持OpenAI格式调用：

• 使用super-model调用当前配置的智能体
• 使用智能体ID或名称调用特定智能体

最佳实践建议

1. 开发环境：推荐使用Docker部署，避免环境冲突
2. 生产环境：考虑使用反向代理（如Nginx）增强安全性
3. 模型选择：根据任务类型合理分配主模型和推理模型
4. 知识库：定期更新索引以提高检索准确性
5. 工具链：结合互联网功能与知识库实现更强大的应用场景

通过以上配置，Super Agent Party可以成为一个功能完备的智能体开发与交互平台，满足从简单对话到复杂任务处理的各种需求。