Appearance
Agent 管理:给 AI 办入职,不是写死一段 Prompt
在 Agent 运行时中的位置:一切开始之前——创建 Agent、挂载能力、调试发布,是 Agent 的**「生命周期」入口**。
主线 → Agent 运行时 · 步骤 ①
先搞清楚:Agent 管理是什么?(纯概念)
很多人以为「搭建一个 AI 助手」就是写一段 Prompt,丢给大模型,完事。
但实际上的 Agent 管理,更像是 给一个新人办入职:
| 入职步骤 | Agent 管理对应 |
|---|---|
| 定岗位职责 | 写 System Prompt(「你是母婴顾问」) |
| 选大脑型号 | 配模型(GLM-4 / DeepSeek 等) |
| 给电脑和工具 | 挂 Plugin / Tool Skill |
| 发培训资料 | 挂知识库(KB) |
| 教工作流程 | 挂 Workflow Skill |
| 开系统权限 | 开内存(memory) / 意图路由(scene) |
| 签合同上岗 | 发布 → API 调用 |
专业定义:
Agent 管理 = 创建 AI 智能体并为其配置 Prompt、模型、知识库、插件、工作流等能力的完整生命周期操作。
一句话:Agent 不是写出来的,是配出来的。
那在晨悦里,它是怎么玩的?(通俗理解)
晨悦要搭一个「晨悦母婴馆小悦」,流程是这样的:
第 1 步:创建 Agent,取名「晨悦母婴馆小悦」
第 2 步:写 System Prompt →「你是温柔的母婴顾问,叫小悦」
第 3 步:选模型 → GLM-4
第 4 步:挂知识库 → 育儿百科 KB
第 5 步:挂插件 → 商品 API 插件包
第 6 步:挂 Skill → Prompt / Knowledge / Tool / Workflow 四件套
第 7 步:开开关 → memory_enabled(记住用户偏好)、scene_enabled(高频问题本地答)
第 8 步:调试 → flow-admin 对话面板里聊几句看看效果
第 9 步:发布 → status: published → 外部通过 API 调用了全程不需要改代码,在 flow-admin 界面上点几下就完成了。
晨悦的 Agent 管理 = 表单操作 + 挂载选择。 这个设计哲学是:让 PM 也能配 Agent,而不是只有开发能碰。
三个核心操作:创建 → 挂载 → 发布
创建 Agent
| 配置项 | 说明 |
|---|---|
| Agent 名称 | 任意,建议带角色(如「晨悦母婴馆小悦」) |
| System Prompt | 角色设定,越具体越好 |
| 模型 | GLM-4 / DeepSeek 等 |
| Temperature | 控制回答随机性(0=严谨,1=天马行空) |
挂载能力
Agent 创建出来后只会聊天,干活靠挂载。通过 config_json 统一管理:
| 挂载类型 | 配置字段 | 效果 |
|---|---|---|
| 知识库 | kb_ids | Agent 能查资料回答 |
| 插件 | mounted_plugins | Agent 能调外部 API |
| Skills | mounted_skills | 全套能力包(Prompt+KB+Tool+Workflow) |
| 记忆 | memory_enabled | 记住用户偏好 |
| 意图路由 | scene_enabled | 高频问题本地直出 |
渐进式配置
先让 Agent 能对话,跑通了再逐步挂 KB → Plugin → Workflow。不要一口气全挂上去,出问题都不知道是哪个环节炸的。
发布
- 设置
status: published - 外部通过
POST /api/agents/{id}/chat调用 - 商用原则:垂直 Agent 用平台 seed 固定 ID,禁止 C 端批量创建
⚡ 常见误区(配 Agent 最容易翻车的几个坑)
| 误区 | 后果 | 正确姿势 |
|---|---|---|
| Prompt 写太短 | Agent 答非所问,没有角色感 | 角色 + 语气 + 行为边界,至少 3 段 |
| 一口气挂满所有能力 | 链路乱、排查难、不知道谁在干活 | 渐进式:先对话 → 加 KB → 加 Plugin → 加工 Workflow |
| 不调试就发布 | 上线后用户收到胡编的答案 | flow-admin 对话面板先聊 10 句 |
| 把 temperature 设成 1 | 交易型 Agent 价格、库存数字乱编 | 交易型 0.1~0.3,创意型可以 0.7~1 |
看看两个真实的 Agent 怎么配
晨悦母婴馆小悦
名称 → 晨悦母婴馆小悦
Prompt → 温柔母婴顾问 + 不提烟酒 + 建议带出处
模型 → GLM-4
Temperature → 0.3(交易型,不能乱编价格)
KB → 育儿百科 KB
Plugins → 商品 API 插件包
Skills → Prompt / Knowledge / Tool / Workflow 全挂
memory → 开启(记住宝宝月龄、过敏信息)
scene → 开启(高频问题如「有券吗」直接回)AgentPM(产品经理助手)
名称 → AgentPM
Prompt → SDAD 方法论节选
模型 → GLM-4
Temperature → 0.5(创意和专业平衡)
KB → PRD 规范库
Plugins → 无(不做交易)
Skills → Prompt / Knowledge / Workflow(不挂 Tool Skill)
memory → 关闭(每次都是新需求,上下文反而干扰)
scene → 仅基础兜底核心差异:晨悦母婴馆小悦是交易型(高频、固定范式、需要 Tool),AgentPM 是创意型(非标、每次不同、不需要调 API)。Agent 配置没有标准答案,取决于业务。
5 分钟动手
- 打开 flow-admin → Agent 列表 → 新建
- 写一段 System Prompt:
「你是一个幽默的程序员,每句话里都要带一个技术梗」 - 选模型 GLM-4,temperature = 0.7
- 保存后进对话面板聊 5 句,看风格对不对
- 回到编辑页,勾选
memory_enabled,再聊一聊看上一条记忆有没有带入
→ 更多实操:Lab 0 · 快速上手
思维导图
相关文档
- 平台总览 — 六大模块导航
- Agent 运行时 — 创建后的完整对话链路
- Agent Skills — 四种 Skill 详解
- 接入层 — API 发布与调用