# 创建与配置智能体

> 分组：AI智能体
> 更新时间：2026-10-11
> 原文：https://www.chenra.com/docs/manual-ai-agent-create-config

智能体是辰予 AI 中 AI 自动回复的"角色"载体，按**微信号维度**创建：在某个微信号下创建的智能体，只作用于该微信号下的联系人。下面介绍完整的创建与配置流程。

## 入口：微信号详情 → 智能体

- 在左侧微信列表中选中目标微信号，打开**微信号详情**（抽屉）

- 在顶部 Tab 中切换到**"智能体 (Agent)"**（需拥有 ai.agent.view 权限）

- 该 Tab 内嵌完整的智能体管理页，新建、编辑、删除、刷新都在这里完成

智能体没有独立的全局菜单，所有智能体均挂在对应微信号详情下管理，天然按微信号隔离。

## 新建智能体

- 进入"智能体"Tab 后，**列表末尾**有一张**虚线边框卡片**（而非页面右上角按钮），点击卡片的 ➕ 与"新建智能体"文字即进入创建表单

- 表单打开后，页面左侧收窄为智能体侧栏（头像 + 名称 + 创建时间），右侧为表单；点击侧栏中的其他卡片可切换编辑目标

## 表单总览

创建/编辑表单包含 5 个 Tab：**提示词、知识库、话术库、生效范围、其他配置**。表单底部固定一排操作：**启用/禁用开关、保存、关闭**。

### Tab1 提示词

#### 智能体名称

- **必填**，例如"售前客服""售后技术支持""销售顾问"

- 仅用于系统内区分不同智能体，不会对外展示

#### 大模型

- **必填**。下拉选项按**厂商分组**展示，支持输入**搜索**快速定位

- 系统自动预选被标记为**默认模型**的选项，新建时无需手动挑选即可使用默认模型

- 模型列表包含团队共享模型，对应选项会带**"团队"**标签

- **编辑**智能体时，若原模型已被**下架**（不在当前可选列表中），选择框会自动清空，需要重新选择

若列表卡片上的模型徽章显示红色"-未配置模型-"，说明该智能体没有有效的模型，需进入编辑重新选择。

#### AI 生成提示词

提示词可以完全手写，也可以交给 AI 自动生成（需 ai.agent.generate 权限）：

- **一键生成全部提示词**：根据"角色背景"信息，**流式**生成全部类型的提示词并逐类填充，生成过程中可实时看到内容写入

- **覆盖确认**：若已有部分提示词内容，一键生成前会弹出确认"已有部分提示词内容，一键生成将覆盖全部提示词，是否继续？"，确认后才开始覆盖

- **单类型 AI 生成**：每类提示词标题旁都有独立的"AI 生成"按钮，只重新生成该类型；生成时会参考该智能体其他类型已有的提示词，保持人设与风格一致

- 生成过程中相关按钮会变为"生成中..."状态并禁止重复触发

#### 角色背景

- 点击提示词区域的**"角色背景"**，打开"设置角色背景信息"弹窗

- 弹窗内填写智能体的**角色身份、业务背景、目标用户**等信息（如角色称呼、角色定位、行业领域、企业背景、沟通风格），AI 将据此生成全部提示词，**越详细生成的提示词越精准**

- **未填写背景就点生成**：会提示"请先设置角色背景信息！"并**自动弹出角色背景弹窗**；在弹窗内填写后可直接点"一键生成"

#### 各类提示词说明

每类提示词标题旁有悬停问号（什么是该提示词）与**期望字数**提示。目前包含以下类型：

类型
说明
期望字数

对话提示词
决定智能体如何与用户聊天，是智能体的"人设灵魂"
800-3000字

图片/视频视觉理解提示词
告诉 AI 如何理解用户发送的图片和视频内容
200-500字

提示词类型由系统配置决定，后续新增的类型会自动出现在表单中。

### Tab2 知识库

- 点击"添加知识库"打开知识库选择器，可多选

- 已选知识库以卡片展示（名称 + 简介），鼠标悬停出现删除按钮可移除

- 绑定后 AI 回复时自动检索相关知识，回答专业领域问题

### Tab3 话术库

- 在**"话术库"Tab** 内点击"添加话术库"打开选择器，可多选

- 已选话术库同样以卡片展示，可悬停删除

- 绑定后高频标准问题优先命中标准问答对，保证回复统一

### Tab4 生效范围

生效范围决定该智能体对哪些联系人可用，包含三部分：

- **指定标签**：联系人**包含任意指定标签**即可使用该智能体；没有指定标签的联系人不可使用

未指定任何标签的智能体可作为**兜底**，对所有联系人可用

- **范围设置**（两个独立开关）：

**一键开启所有群聊**：该微信号下所有群聊联系人默认匹配该智能体

- **一键开启所有视频号联系人**：所有视频号联系人默认匹配

- **指定联系人 / 排除指定联系人**（随范围设置**动态切换**）：

未开启任何"一键开启"时，此处为**"指定联系人"**模式——仅列表中勾选的联系人可使用

- 开启任一"一键开启"后，自动切换为**"排除指定联系人"**模式——对应类型联系人默认全部匹配，下方勾选的联系人将被**排除**（例如个别群聊不适用），页面会同步给出提示

- 未指定任何联系人的智能体可作为**兜底**

联系人选择面板支持好友、群聊、视频号三类联系人。

### Tab5 其他配置

- **检索词生成数量**（**1-10**，默认 10）：AI 回复前从用户问题中扩展生成的检索词个数

- 检索词用于知识库/话术库搜索，从**意图上扩展用户问题**，可以增加检索的覆盖面

## 启用 / 禁用

- 表单底部提供**启用/禁用开关**，**新建时默认启用**（status=1）

- 只有"启用"状态的智能体才参与消息匹配（详见《智能体的生效与匹配》）

- 列表卡片上**没有**启用开关，调整状态需进入编辑表单

## 草稿自动保存与恢复

- 表单内容（名称、提示词、绑定的知识库/话术库、生效范围等）会**自动保存为草稿**，误关页面也不丢失

- 新建与编辑的草稿**分开存放**，互不串号

- 再次进入表单时，若检测到未保存的草稿，顶部提示"发现未保存的草稿"，可**立即恢复**或**放弃草稿**

- 保存成功后草稿自动清除

## 列表管理与操作

列表卡片展示：名称首字头像、创建时间、名称、标签（展示前 1 个 + 标签总数徽章）、联系人头像组（最多展示 21 个）、模型徽章；卡片下方为操作按钮：

操作
说明

修改
进入编辑表单，可修改全部配置

删除
弹窗二次确认后删除

刷新
点击列表底部虚线"刷新"条，拉取最新智能体列表
