# 智能体大脑

> 「智能体大脑」是支撑声量一切自动化的运行核心，它包含四块：智能体、接入 IM、运行时、模型设置。
> 
> 

对业务用户来说，日常主要打交道的是 **智能体** 和 **接入 IM**；**运行时** 和 **模型设置** 偏底座配置，多数情况下由系统托管或一次配好即可，不必频繁操作。

## 一、智能体

智能体是帮你干活的「AI 员工」。每个智能体基于一个模板创建，专精某类任务，并绑定到具体品牌。

![智能体列表：按模板创建的 AI 员工及其运行状态](/manual/agent/assets/agent-list.webp)

### 1.1 创建智能体

点击「新建智能体」，表单分三部分：

**① 选择模板**

- 按平台标签页浏览模板，或选「空白智能体」（「干净的初始智能体，不预置任何模板文件」）。

- 需要品牌的模板会有「需绑定品牌」标记。

**② 基本信息**

|**字段**|**提示 / 说明**|
|---|---|
|Gateway 连接|选择运行实例；没有时提示先去「运行时」创建|
|智能体名称|如 `xiaohongshu` / `ops`；仅支持字母 / 数字 / 下划线 / 连字符，长度 1-32|
|品牌|选择要绑定的品牌（模板要求时必填）；「还没有品牌？去创建 →」|
|使用模型|选「跟随全局默认」用 Gateway 默认模型；也可为这个智能体单独指定模型|
|备注|说明这个智能体的用途 / 责任人|

填好点「创建」，成功提示「智能体创建成功」。

> ⚠️ 若提示「还没有可用的 Gateway 连接 —— 新建智能体需要先有一个 Gateway 连接」，先去「运行时」创建一个再回来（或用新手向导的「自动部署」）。
> 
> 

![创建智能体弹窗：选择模板、关联品牌与 Gateway 连接](/manual/agent/assets/agent-create-dialog.webp)

### 1.2 智能体详情

点开一个智能体，可在多个标签页里了解和管理它：

|**标签页**|**内容**|
|---|---|
|**概览**|平台、智能体 ID、关联品牌、是否默认、连接状态、最近同步、运行时、模式、健康状态、工作区路径、首选 / 使用模型、输出频道、路由规则、Providers（已配置 / 未配置）、Identity、技能数、渠道数、定时任务数|
|**文件**|工作区文件浏览：AGENTS / SOUL / TOOLS / IDENTITY / USER / HEARTBEAT / MEMORY 等——即智能体的「人设与说明书」；文件为空会提示「点『编辑』开始填写」|
|**技能**|已安装技能列表及就绪状态（就绪 / 未就绪 / 内置 / 已禁用），可「只看已就绪」，可「上传 zip」|
|**定时任务**|关联的营销计划 / 定时任务（启用 / 已暂停、最近运行、连续失败）|

![智能体详情页：概览、文件、技能、定时任务等标签页](/manual/agent/assets/agent-detail-tabs.webp)

### 1.3 编辑与删除

- **编辑**：只改私有字段（显示名、图标、标签、备注、置顶）。「置顶」会让它在列表中靠前显示。

- **删除**：此操作会同时删除运行时的智能体 + workspace，不可恢复。如果该 Agent 关联了定时任务，删除会被拒绝。

### 1.4 安装技能（Skill）

技能是给智能体扩展的额外能力包。在「技能」标签页点「上传 zip」：

- 上传一个含 `SKILL.md` 的 zip 包，安装到默认智能体 workspace。

- 填写 Slug（skill 目录名，须由小写字母 / 数字 / 短横线组成，以字母或数字开头）。

- 可勾选「强制覆盖已有同名 skill」。

- 点「上传并安装」。

![安装技能弹窗：填写 Skill 目录名并上传安装包](/manual/agent/assets/agent-skill-install.webp)

## 二、接入 IM

把声量智能体接到团队常用的即时通讯工具里，团队成员就能直接在聊天窗口里和智能体对话、下指令、收结果。副标题：「把声量智能体接到飞书 / 微信 / 企业微信 / 钉钉，团队成员在群聊或私聊中即可直接对话」。

支持的平台与接入方式：

|**平台**|**说明**|**接入方式**|
|---|---|---|
|**微信（个人）**|扫码登录后在微信里与智能体直接对话，像拥有一个私人助理，可远程操控电脑里的声量智能体|扫码|
|**飞书**|团队在飞书群聊 / 私聊里与智能体对话，衔接办公流程|扫码 或 App ID / App Secret 凭据|
|**企业微信**|员工在企微群聊 / 私聊里与智能体协作（AI Bot）|扫码 或 Bot ID / Secret 凭据|
|**钉钉**|团队在钉钉群聊 / 私聊里与智能体交互（Stream 模式双向通信）|扫码 或 Client ID / Client Secret 凭据|

![接入 IM：微信、飞书、企业微信、钉钉的扫码绑定入口](/manual/agent/assets/agent-im-binding.webp)

## 三、运行时



运行时是承载智能体运行的「机房」。一个运行实例（Gateway 连接）就是一台干活的机器，智能体都跑在它上面。副标题：「智能体大脑的运行核心 —— 负责任务调度、动作执行与模型调用」。

> 💡 **业务用户通常无需手动配置运行时**：新手向导里点「自动部署」，系统会托管式地创建并管理运行实例。
> 
> 

## 四、模型设置

智能体干活要调用大模型。模型设置就是配置「用哪家模型、用哪个 Key」的地方。

![模型设置页面：配置智能体调用的大模型与 API Key](/manual/agent/assets/agent-model-settings.webp)

### 4.1 接入模型服务商

1. 在服务商列表找到目标 Provider（未接入显示「尚未接入」），点「接入」。

2. 填写：

    - **API Key**（明文写入，将通过 secrets 体系加密存储）。

    - **Base URL**：通常用默认值；自托管 / 反代场景填新地址（需 `http://` 或 `https://` 开头，如 `https://your-llm.example.com/v1`）。

3. 保存，成功提示「{provider} 已接入」。

### 4.2 管理模型

- 在 Provider 详情看「可用模型（N）」和「主推模型」。

- 对某个模型点「设为默认」（提示「已将 {model} 设为默认模型」）。

- 「重新接入」更新凭据；「断开」清除该 Provider：「API Key 将被清除，引用该 Provider 模型的智能体会回退到默认模型。」

- 每个 Provider 弹窗都有「查看 {provider} 接入文档」链接。

> ⚠️ 模型配置同样存放在运行实例上，需先有运行实例。托管场景下通常已预置可用模型，无需额外配置。
> 
>