Skip to content

搭建一个低代码智能体 ​

本页介绍从创建项目到发布的完整快速上手流程。示例界面和可选能力可能随项目类型、平台版本与账号权限变化,请以当前页面实际显示为准。

开始前准备 ​

在创建智能体前,先明确以下内容:

  • 智能体面向哪些用户,主要解决什么问题。
  • 哪些问题可以回答,哪些问题需要拒绝或转人工处理。
  • 是否需要查询企业知识、实时数据或调用业务接口。
  • 是否需要保存用户偏好或业务状态。
  • 计划发布到哪个运行入口或开放接口。

步骤 1:创建低代码智能体 ​

  1. 登录平台并切换到目标工作空间。
  2. 在左侧导航栏中进入新建项目。
  3. 在低代码项目区域选择智能体开发。
  4. 输入智能体名称和功能介绍,并设置头像。
  5. 确认创建,进入智能体编排页面。

创建低代码智能体

填写智能体名称与功能介绍后,可按需关联项目分类并选择图标;必填项完成后单击“确认”创建智能体。

如果创建页面提供 AI 创建,也可以直接描述智能体的用途、目标用户和主要能力,由平台生成初始配置。生成后仍需检查提示词、模型、技能和权限,不应未经验证直接发布。

创建完成后,编辑器通常包含以下区域:

区域作用
基础设置或编排区配置模式、模型、人设、变量及其他全局能力
技能与资源区添加插件、工作流、知识、数据库和记忆库
预览与调试区发起测试对话,查看调用过程和运行结果

步骤 2:选择编排模式 ​

根据任务特点选择单 Agent、多 Agent 或对话流模式。

模式适用场景
单 Agent一个角色即可完成理解、调用和回复,适合大多数问答与助手场景
多 Agent需要多个专业角色分工、转交和汇总的复杂任务
对话流每轮对话都必须按固定流程执行,例如标准化客服、信息采集和分支问答

建议首次搭建时从单 Agent 开始。模式切换可能影响已配置的技能和节点,切换前应记录现有配置并查看页面提示。详细说明参见低代码智能体基础设置。

步骤 3:编写人设与回复逻辑 ​

人设与回复逻辑会持续影响智能体在所有会话中的行为。建议使用结构化提示词,至少包括:

text
# 角色
说明智能体的身份、目标和服务对象。

# 任务
列出应完成的任务、处理顺序和判断条件。

# 能力使用规则
说明何时查询知识、何时调用插件或工作流。

# 回复要求
约定语言、语气、格式、长度和引用方式。

# 限制
说明拒答范围、数据不足和工具失败时的处理方式。

如果编辑器提供提示词模板、资源引用、AI 生成或自动优化,可以用于生成初稿,但必须使用真实问题检查结果,避免提示词内部规则冲突。

提示词库

提示词库支持按模板类型筛选。选择模板后先在右侧预览内容,确认适用后再插入人设与回复逻辑编辑器。

步骤 4:设置模型 ​

根据任务对推理质量、响应速度、上下文长度、多模态能力和成本的要求选择模型。设置后至少验证:

模型设置

选择模型和协议后,可使用生成预设,或根据任务需要自定义温度、Top P 和惩罚参数。参数调整应结合实际测试结果进行。

  • 简单问题能否快速、准确回答。
  • 长内容或复杂问题是否会丢失关键信息。
  • 需要图片、文件或工具调用时,模型是否具备相应能力。
  • 调整生成多样性等参数后,结果是否仍然稳定。

不要仅根据模型名称判断效果,应使用同一组测试问题对比后再确定配置。

步骤 5:按需添加能力 ​

如果模型和提示词已经能够完成任务,不必为智能体堆叠额外能力。只有在业务确实需要时再添加:

  • 技能:通过插件查询实时信息,通过工作流执行多步任务,通过触发器定时或按事件执行。
  • 知识:为专业问答提供文档、表格或图片资料。
  • 记忆:通过变量、数据库或记忆库保存状态和长期信息。
  • 对话体验:设置开场白、问题建议、快捷指令、头像或语音等。

添加能力后,应同步修改提示词,明确调用条件、参数来源、结果用途和失败处理方式。

步骤 6:预览与调试 ​

在预览区与智能体对话,先验证主流程,再测试边界和失败场景:

  1. 使用典型问题检查回答是否符合人设和格式要求。
  2. 检查知识召回内容是否与问题相关。
  3. 检查插件或工作流是否在正确条件下调用,输入参数是否准确。
  4. 连续追问,确认上下文和记忆符合预期。
  5. 测试信息不足、无匹配知识、工具失败和越权请求。
  6. 打开调试详情查看调用树、输入输出和错误位置。

详细方法参见预览与调试。

步骤 7:发布智能体 ​

完成调试后,在编辑器的发布入口创建发布版本:

提交与发布入口

填写发布版本和更新说明;可按需上传最多三张展示截图。选择可用的企业项目、模板商店、API、Chat SDK 等渠道,确认授权状态后再发布。

先单击 提交 保存当前编排配置,再单击 发布 创建可用版本。仅提交不会更新线上正在使用的版本;发布前应确认预览测试已经通过。

  1. 填写本次发布说明。
  2. 选择正确的运行环境和发布渠道。
  3. 检查插件、工作流、知识库、数据库和记忆库权限。
  4. 确认接口凭据、回调地址和渠道配置有效。
  5. 发布后从真实入口完成一次端到端验证。

可用渠道取决于当前环境和权限,可能包括企业运行入口、API 或 SDK。后续修改配置时,应重新执行关键场景回归测试,并按平台要求更新发布版本。

下一步 ​