创建与编排 Agent
配置模型、提示词、变量、知识库、工具并发布 Agent
Agent 编辑器把核心编排和最终呈现分开:主区域配置提示词、变量、知识库和能力;Agent 设置配置名称、模型、对话呈现与迭代上限。
当前团队必须已授权一个启用的 chat 模型。创建需要 agent:create;发布需要 agent:publish。
创建 Agent
- 前往应用,选择创建应用 > Agent。
- 填写名称。名称为
1-100字符;描述最多500字符。 - 进入编排页后选择右上角 Agent 设置,选择模型并配置名称、图标、开场消息、建议问题和可见性。
- 可见性选择私有或团队。

编写提示词与变量
- 在提示词中明确角色、任务、约束、工具使用条件和失败处理。
- 输入
{打开变量选择器。{query}为当前用户消息。 - 在变量中添加用户输入字段。变量名最长
50字符;可配置显示名、必填、隐藏、默认值、选项、数值范围或最大长度。 - 在右侧预览中填入变量,确认替换结果。
关联知识库
- 在知识库区域选择添加。
- 选择知识库以及
vector、fulltext或hybrid检索方式。 - 设置 Top K(
1-100,默认5)和阈值(0-1,默认0.3)。 - 设置整体 RAG 模式:Agentic RAG、Naive RAG或关闭。
添加工具和能力
在工具区域选择内置工具、自定义工具、MCP 或 Skill。工具显示“需要配置”时,先前往能力完成凭据。启用附件、用户输入请求、记忆、生图或生视频时,分别检查对应的限制和默认模型。
保存、调试与发布
- 选择保存。验证错误会列出具体字段。
- 在调试与预览发送覆盖正常和失败路径的问题。
- 有工具时验证工具参数、失败提示与最大迭代终止行为。
- 选择发布。发布后可打开公开页面、嵌入和访问 API。

常见问题
- 模型列表为空:团队未获对话模型授权,或模型已禁用。
- 工具未调用:检查模型函数调用能力、工具是否启用,以及提示词是否定义调用条件。
- 发布失败:确认拥有发布权限,且模型、变量引用和能力配置有效。
- 公开页无法访问:确认 Agent 已发布;私有/团队可见性仍受登录和团队访问控制影响。
这篇文章对你有帮助吗?