智能体

适用版本与权限

智能体管理适用于社区版、专业版和企业版。社区版最多管理 5 个智能体，专业版和企业版不限制数量。企业版用户需要对应的智能体查看或管理权限。

1Panel 在 AI -> 智能体 中集中安装和管理受支持的智能体应用。当前页面包含智能体列表、模型账号，以及按智能体类型和版本动态显示的配置能力。

1 使用前提

• Docker 服务和应用商店状态正常。
• 已准备要使用的模型服务及 API Key；也可以先在 AI -> 模型管理 -> 模型账号 中创建账号。
• 服务器可以访问智能体应用镜像和所需的软件源。
• 对外开放 WebUI 或频道前，已完成防火墙、域名、HTTPS 和访问控制配置。

2 安装智能体

1. 进入 AI -> 智能体。
2. 点击 安装，选择页面当前支持的智能体类型。
3. 填写名称、应用版本、WebUI 端口、认证信息和允许访问地址。
4. 选择或新建模型账号，并根据需要配置模型池和备用模型。
5. 确认参数后提交任务，在任务日志中查看安装结果。

访问地址

允许访问地址需要使用 http:// 或 https:// 开头的域名或 IP；只填写可信来源，避免把智能体管理界面直接暴露到公网。

3 日常管理

智能体列表支持查看状态和版本，并根据当前状态执行概览、配置、终端、对话、启动、停止、重启、升级和删除等操作。不同智能体类型支持的按钮可能不同。

3.1 概览

概览展示运行状态、主模型、频道数量、技能数量、定时任务数量和会话数量等摘要。页面数据取决于智能体类型及其版本是否支持对应接口。

3.2 模型

模型页用于选择主模型、维护可用模型和备用模型。修改模型账号时，可以选择是否同步更新关联智能体的配置文件。

3.3 频道

频道配置按智能体类型提供微信、企业微信、钉钉、飞书、QQ、Telegram、Discord 等接入项。实际可用频道、插件要求和字段由当前智能体版本决定；保存频道配置后，系统可能自动重启容器使配置生效。

3.4 技能与角色

• 技能：查看内置、外部和工作区技能，并从页面支持的技能来源搜索和安装。
• 角色：维护智能体工作区中的角色 Markdown 文件。保存后按页面提示重启容器。

3.5 设置

设置页包含安全、其他和配置文件等标签，可配置认证方式、时区、浏览器开关、NPM 源等。直接编辑配置文件前建议先备份；保存后需要重启的配置以页面提示为准。

4 多节点与批量操作

企业版能力

企业版可以对不同节点上的智能体执行批量任务，并向目标智能体下发 Skill。提交前应核对目标节点、目标版本和 Skill 来源，任务结果可在任务日志中查看。