创建并配置智能体

什么时候用

需要一个新的对话机器人时--无论是客服、翻译、代码助手还是业务问答，都从「创建智能体」开始。智能体定义了它的人设（系统提示词）、用哪个模型、会哪些技能、以及什么情况下被触发。

你需要准备

• 至少一个已配置好的模型（详见「接入模型供应商」）。如果智能体不绑定具体模型，会回退到默认模型--但若两者都没有，调用时会报 503。
• 如果要给智能体绑定技能，先确保技能已就绪（详见「启用市场技能」）。

操作步骤

第 1 步：进入智能体管理

左侧菜单 -> 智能体管理 -> 我的智能体。

页面以卡片网格展示你已有的智能体。点击右上角「新增智能体」按钮，进入创建表单。

第 2 步：填写基础信息

表单顶部有步骤导航条，第一步是「基础信息」：

写 System Prompt 的建议（表单里也有提示）：

• 独立型：明确人设 -> 专业领域 -> 回答风格 -> 边界约束
• 编排型：明确智能体定位 -> 说明委派原则 -> 定义输出格式；避免亲自执行子智能体的任务

模型与模型组互斥：两者只能选一个。模型组按优先级策略自动路由到组内不同模型。

填完点「下一步」。

第 3 步：关联技能

在「选择技能」下拉里搜索并多选要绑定的技能。关联后，这些技能作为智能体可调用的工具，由 LLM 在对话中自主决定是否使用。

如果暂时不需要技能，直接留空点「下一步」。

如果第 2 步选了「编排」类型，这里会多出一步「编排配置」，编排型的完整说明见「编排型智能体」。

第 4 步：配置关键词匹配（可选）

这一步配置智能体的自动触发规则：

输入后回车添加。例如给「翻译专家」设精确关键词「翻译」，用户发"翻译一下这段话"就会自动命中。

关键词不是必填。不配关键词的智能体仍可被手动指定或作为默认智能体使用。但两个智能体不要设相同的关键词，否则触发会混乱。

第 5 步：保存

最后一步点「保存」。成功后自动跳回智能体列表，新智能体出现在卡片网格里。

怎么验证成功了

1. 回到「我的智能体」列表，能看到刚创建的智能体卡片
2. 点击卡片上的「编辑」能看到配置完整保留
3. 给该智能体分配一个用户并创建 API Key，用 OpenAI SDK 调用 /openai/v1/chat/completions，能正常返回对话

常见问题

保存时报 422「不能同时指定 model_id 和 model_group_id」

模型和模型组互斥。回到第 2 步，确认只选了一个。选模型会自动清空模型组，反之亦然--如果你手动同时传了两个，系统会拒绝。

调用智能体时报 503 service_unavailable

智能体没绑定模型，且也没设默认模型。两种解法：

• 编辑智能体，在第 2 步绑定一个具体模型
• 或在「设置」里设默认模型（详见「设置默认模型」）

智能体调用了不该调的技能

检查第 3 步关联的技能列表。技能由 LLM 自主决定调用，如果绑定了不该绑的技能，移除即可。

两个智能体设了相同关键词，触发混乱

关键词需唯一归属。编辑其中一个，移除冲突的关键词。

深入

核心概念

Agent 是什么

Agent（智能体）是 LLM 应用的核心载体。它定义了：

• 对话行为：通过系统提示词（system prompt）设定角色和回答风格
• 绑定的模型：指定哪个模型来处理对话
• 触发方式：支持关键词匹配（exact_keywords、regex_patterns），让用户在对话中自动触发指定的 Agent
• 附加能力：可以绑定技能（skills）和分类（categories）

Agent 类型

• standalone（默认）：独立 Agent，单独处理对话，不依赖其它 Agent
• orchestrator：编排型 Agent，可以将任务分发给多个子 Agent（workers）协作完成
• image：图片生成型 Agent

市场机制

• 平台管理员创建的系统 Agent（tenant_id = 0，且 is_market_item = True）会出现在市场中
• 所有租户都可以从市场浏览和克隆（clone）Agent
• 克隆后的 Agent 归属当前租户，名称自动追加「（副本）」，is_market_item 变为 False
• 平台没有 is_public 字段，市场可见性由 tenant_id = 0 + is_market_item = True 共同决定

编排型 Agent

编排型 Agent 可以将复杂任务拆解为多个子任务，分发给不同的子 Agent 执行。创建编排型 Agent 时必须：

1. 设置 agent_type = orchestrator
2. 填写 orchestration_config，包含以下内容：
   • workers：非空列表，每个 worker 必须包含：
     • agent_id：子 Agent 的 ID
     • alias：子 Agent 的别名（同一编排内不能重复）
     • description：子 Agent 的任务描述
   • parallel_mode / strategy：只能取以下值之一——auto、sequential、parallel_only、parallel

权限边界

常见坑

• 没有 is_public 字段：如果你想把自己的 Agent 公开给其它租户，需要联系平台管理员
• 克隆其它租户的 Agent 会被拒绝：只允许克隆市场 Agent（tenant_id = 0）或本租户自己的 Agent
• model_id 和 model_group_id 互斥：两者不能同时设置，同时设置会返回 422
• 编排型 Agent 的校验比较严格：创建编排型 Agent 时，如果 orchestration_config 格式不对、workers 为空、alias 重复等，都会返回 422
• 删除编排型 Agent 会自动删除子 Agent：这是一个向上级联删除（删除父 Agent 时连带删除子 Agent）
• 关键词冲突：两个 Agent 设置了相同的 exact_keywords 或 regex_patterns 可能导致触发混乱

排错速查

• 想用现成的智能体模板？见「从市场克隆智能体」
• 想让一个智能体协调多个子智能体？见「编排型智能体」