-
触发器 在Agent开发过程中添加触发器,Agent会按照触发器的设置执行。 表8 创建触发器参数说明 参数 说明 触发器名称 触发器的名称。 由2~20个字符组成,仅支持中英文开头,支持中英文、数字、下划线。 触发时间 按设置的时间触发智能体应用的执行。例如,设置触发时间为每1小时执行一次,则每隔1小时,重复执行一次会话。 周期触发 用户可自定义触发时间按每日执行。 用户可自定义触发时间按每周执行。 用户可自定义触发时间按每月执行。 间隔触发:用户可自定义触发间隔时间,支持间隔“天”、“小时”、“分钟”、“秒”。 间隔“天”:取值范围1~31。 间隔“小时”:取值范围1~23。 间隔“分钟”:取值范围1~59。 间隔“秒”:取值范围1~59。 机器人提示 输入一条自然语言指令,智能体将遵循该指令定时执行。例如输入“发送月底发票报销提醒”,则机器人会在设定的时间发送提醒。
-
发布管理 支持将智能体封装成标准化API接口,供开发者直接调用,适用于需要与其他系统(如企业内部应用、第三方服务)深度集成的场景。 Agent支持不同的发布方式和渠道,支持发布成API或发布至网站,通过这两种发布方式,Agent可快速落地到实际业务中,兼顾技术集成与终端用户体验。 表9 Versatile发布渠道 功能 说明 API 将Agent封装成标准化API接口,供开发者直接调用,适用于需要与其他系统(如企业内部应用、第三方服务)深度集成的场景。 网页 生成可独立访问的Web页面(如H5或PC端页面),用户通过浏览器即可交互,适用于直接面向终端用户的场景(如客服聊天窗口、营销导购助手)。
-
技能 智能体的核心能力源于其技能体系,开发者可通过集成插件、设计工作流等方式不断扩展模型的功能范围。 表3 智能体技能 功能 说明 插件 您可以通过API无缝连接各类平台和服务,快速扩展智能体的功能,平台提供了丰富的内置插件,开箱即用;同时也支持自定义插件开发,将任意API封装成工具,灵活调用。更多信息,参考插件介绍。 工作流 单智能体支持添加已发布的工作流版本应用。工作流是构建复杂功能逻辑的可视化工具,通过灵活组合多个任务节点,能够设计多步骤的自动化流程,从而显著增强智能体应对复杂任务的能力。更多信息,参考工作流介绍。
-
对话体验 Agent开发对话体验支持全程可视化,通过调试功能快速定位与优化配置。 表7 Versatile对话体验 功能 说明 单智能体应用图标 Agent的品牌标识,用于视觉识别,通常体现其功能或个性。 开场白 Agent与用户交互时的初始欢迎语,设定对话基调并引导用户,支持用户自定义配置。 推荐问题 每次对话开始预设的典型提问示例,帮助用户快速了解智能体的能力范围,支持用户自定义配置。 追问 与Agent对话时主动提出的跟进问题,用于澄清需求或深化交互。 音色 支持为智能体指定音色,用于配置智能应用调试对话模型返回结果的朗读音色。
内容审核 配置 通过设置关键词匹配处理输入输出内容,保障大模型内容安全。 注意: 审核内容输入时需要用“,”隔开。 内容审核和安全护栏无法同时开启,打开内容审核配置开关后,“安全防护”将自动关闭。 安全护栏 主要用于检测和拦截潜在的有害、敏感或攻击性的内容。具体来说,它能够识别并阻止那些旨在操纵或滥用系统的Prompt攻击,同时也能过滤掉包含病毒、不适当或违法信息的输入和输出,从而保护用户和系统免受不良影响。这一机制对于维护平台的健康环境和保障用户安全至关重要。 注意: 内容审核和安全护栏无法同时开启,打开当前开关后,“内容审核”将自动关闭。 预览调试 实时测试和优化Agent功能的工具,展示运行的结果与调用详情。
-
知识库 提供开箱即用的企业级RAG(Retrieval-Augmented Generation)服务,涵盖管理、测试和检索策略配置全部功能。 表4 单智能体添加知识库 功能 说明 知识库命中测试 支持对创建的知识库进行命中测试,以评估知识库的效果和准确性。 知识库召回策略 检索策略,文档检索的方式,有三种: 语义检索:使用向量检索技术检索,对文档及结构化数据中知识进行检索,召回与用户意图相关性高的切片内容,推荐在需要结合上下文相关性、并对用户意图理解场景中使用。 关键词检索:使用倒排检索技术,对文档及结构化数据中知识进行检索,召回与Query关键词匹配度高的切片内容,推荐在需要用户提问关键词匹配度高的场景中使用。 混合检索:使用向量检索和关键词检索两种策略混合检索知识库,推荐在需要兼顾用户意图理解及关键词匹配度场景中使用。 相关度阈值:超过相关度阈值的搜索结果会提交给大模型进行总结,否则被过滤,可以参考知识库中命中测试的相关度分值调整该阈值。 topk召回数量:召回的相关性阈值top切片数量,如topk召回数量为5,则相关性阈值为前5的切片将被召回提交给大模型总结。 FAQ直出阈值:FAQ检索超过阈值的结果将直接提交给大模型总结,不再进行文档检索。如果没有超过阈值的结果,将进行文档检索。 启用FAQ功能后,系统将优先检索FAQ数据。若未命中结果,则会继续查询切片内容,可能会带来一定的性能开销。当FAQ检索结果超过预设阈值时,将直接提交给大模型进行总结,不再进行文档检索。若未超过阈值,则将继续进行文档检索。 查看来源:添加知识库并开启此功能后,可以在预览调试界面中查看搜索结果的详细来源信息,包括上下文内容和文件名称。有助于更快速、准确地定位和理解搜索结果。
-
提示词 Versatile提供prompt模板与开发工具,使任何人都可无门槛开发出高质量的prompt指令。 表2 提示词功能 功能 说明 提示词撰写 撰写提示词,并将评估表现较好的提示词设为候选。 支持导入提示词示例; 支持模型设置; 支持提示词中变量定义; 支持效果预览; 支持历史记录。 提示词比较 支持选择候选提示词进行比较,比较方式包含差异性比较、效果比较。 提示词优化 提示工程平台提供提示词自动优化功能,基于启发式算法的提示词自优化技术、提示优选梯度优化技术,可以根据评估用例自动对现有的提示词进行优化。 提示词自动生成 借助模板智能匹配与布局优化技术,根据用户输入内容,结合提示词原模板和模型能力,自动生成高质量提示词模板。 提示词使用 指令配置和工作流中的大模型、意图识别,Agent、高级意图识别、提问器节点,支持保存和引用Prompt模板。
-
知识库召回策略 可单击“”对知识库进行高级配置,包括检索策略和各种召回阈值。 检索策略,文档检索的方式,有三种: 语义检索:使用向量检索技术检索,对文档及结构化数据中知识进行检索,召回与用户意图相关性高的切片内容,推荐在需要结合上下文相关性、并对用户意图理解场景中使用。 关键词检索:使用倒排检索技术,对文档及结构化数据中知识进行检索,召回与Query关键词匹配度高的切片内容,推荐在需要用户提问关键词匹配度高的场景中使用。 混合检索:使用向量检索和关键词检索两种策略混合检索知识库,推荐在需要兼顾用户意图理解及关键词匹配度场景中使用。 相关度阈值:超过相关度阈值的搜索结果会提交给大模型进行总结,否则被过滤,可以参考知识库中命中测试的相关度分值调整该阈值。 topk召回数量:召回的相关性阈值top切片数量,如topk召回数量为5,则相关性阈值为前5的切片将被召回提交给大模型总结。 FAQ直出阈值:FAQ检索超过阈值的结果将直接提交给大模型总结,不再进行文档检索。如果没有超过阈值的结果,将进行文档检索。 启用FAQ功能后,系统将优先检索FAQ数据。若未命中结果,则会继续查询切片内容,可能会带来一定的性能开销。当FAQ检索结果超过预设阈值时,将直接提交给大模型进行总结,不再进行文档检索。若未超过阈值,则将继续进行文档检索。 查看来源:添加知识库并开启此功能后,可以在预览调试界面中查看搜索结果的详细来源信息,包括上下文内容和文件名称。有助于更快速、准确地定位和理解搜索结果。 图4 知识库高级配置
-
设置应用对话体验 应用对话体验支持设置开场白、推荐问题、追问、内容审核配置等。 设置开场白。 为智能体添加一个开场白,该描述将在气泡内作为应用开场白展示给用户。你也可以使用开场白菜单右侧的“智能添加”按钮自动用生成开场白。 图9 添加开场白 设置推荐问题。 输入框输入:在输入框中为智能体添加预置推荐问题。例如为医疗问诊助手添加一些推荐问题,“如何描述症状才能获得更准确的健康建议?”,“头痛伴随发热可能是什么原因?”,“物理降温的具体步骤是什么?”等。 “智能添加”:单击推荐问题菜单右侧的“智能添加”按钮,平台根据单智能体应用功能会自动产生推荐问题。 图10 添加推荐问题 仅支持添加3个推荐问题。 设置追问。 追问功能开启时,系统在每轮回复后,默认根据对话内容提供提问建议,同时您也可以自定义追问生成规则。 图11 设置追问
-
发布与使用医疗问诊助手单智能体应用 在单智能体开发调试界面,单击右上角的“发布”按钮。 图13 发布应用 在发布界面填写版本号和描述,单击“发布”按钮。 图14 配置发布信息 在发布管理界面上选择发布渠道为“网页”,单击发布。 图15 发布Agent应用为网页 查看已发布应用。 API调用:选择“API调用”功能选项卡即可看到发布的API调用接口信息。 图16 复制医疗问诊助手单智能体应用访问地址 发布智能体访问效果。 图17 访问效果预览
-
(可选)为单智能体应用扩展能力边界 创建医疗问诊助手时,如果模型能力已能基本覆盖智能体所需功能,仅需编写提示词即可。如果智能体需要实现超出模型基础能力的功能,就需通过添加插件、工作流或MCP服务来扩展其能力边界。 例如遇到模型无法回答的问题时,需要通过搜索引擎查找答案,那么可以为智能体添加一个MCP服务,如“智谱联网搜索”。并在提示词模块修改人设与回复逻辑,指示智能体使用“智谱联网搜索”来回答自己不确定的问题。 在编排页面的“MCP服务”区域,单击MCP服务对应的图标。 在“添加MCP”页面,选择“智谱联网搜索”,如图7所示,并单击“确定”。 使用MCP服务前,请确保MCP服务已安装且部署成功,具体请参见使用资产中心预置资源。 图7 添加MCP服务 修改“提示词”中的人设与回复逻辑时,需指示智能体调用“智谱联网搜索”插件来回答模型的知识短板问题。如果未在提示词指令中设置该调用规则,智能体可能基于默认逻辑直接生成答案,导致无法按照预期调用工具。 遇到你无法回复的问题时,请使用智谱联网搜索进行查询。 图8 修改提示词
-
调试医疗问诊助手单智能体应用 配置好智能体后,可在预览调试区域中测试智能体问答结果是否符合预期。 图12 调试Agent 预览调试界面支持文本输入、语音输入、文件输入: 文本输入:在对话输入框输入对话后按Enter键或单击,查看应用响应结果。 语音输入:用户可以通过语音进行输入。该功能支持多种语言(如中文、英文等),并提供
语音识别 、错误纠正和实时反馈等功能。 首次使用语音输入须开通系统麦克风、扬声器权限,可在权限申请弹窗一键开通。 语音输入最长为60秒,超时则取消语音输入状态,用户需重新录入。 文件输入:用户可以通过上传文件进行提问,支持对文件进行解析,并根据文件内容和问题生成准确的答案。 支持上传image、audio、excel、csv、docx等格式的文件。 最多支持上传10个文件。 调试结果支持朗读功能,单击,Agent应用将按照设置的音色将
文字转换成语音 播放。 单击,支持对变量进行编辑或重置。 单击试运行页面左下角,一键清除试运行界面内容。
-
编写提示词 编写提示词时,通过角色设定与交互逻辑定义智能体的核心模式,明确其角色、任务描述、约束条件、执行步骤和输出格式等关键要素,同时支持“智能优化提示词”、“引用模板”和“角色指令模板”模式,以确保智能体在全场景对话中表现出专业、可靠和人性化的特性。 提示词 在智能体配置页面的“提示词”面板中输入提示词。例如医疗问助手的提示词可以设置为: 你是一名私人数字健康管理师。你能够和医生一样进行问诊,询问患者的病情,并给出建议和治疗方案。
要求:
1. 专注于疾病、症状、检查、药物等相关询问。
2. 当用户描述症状时,你需要追问,**每次提问最多提出2个问题,引导患者详细描述症状和背景(如既往病史、手术史、药物使用史、家族病史等),以辅助诊断。
3. 当患者信息足够或你已全面理解患者的主要问题及症状发展后,直接总结病情,建议必要的检查、治疗方案和就诊科室。
4. 确保回答准确、简洁,直接相关患者当前健康状况或问题,避免偏题。
5. 不重复历史对话中的问题。如患者未回答某问题,不再追问。
6. 不重复患者描述的症状。确保对话内容新颖且相关。
7. 你返回的内容不应该大于100字,注意每句话应该换行。
8. 严禁回答医学知识以外的问题,如闲聊、娱乐等。
请严格遵守以上规则,仅提供必要的、简洁的回答。 图5 编写提示词 智能优化提示词 “智能优化提示词”功能可对提示词框中的内容进行智能优化。 图6 智能优化提示词 优化后的结果如下: ## 人设
- 角色:私人数字健康管理师
- 专业技能:疾病诊断、症状分析、检查建议、药物治疗建议
## 任务描述
- 目标:通过问诊,了解患者的病情,提供必要的建议和治疗方案。
- 积极影响:帮助用户更好地理解自己的健康状况,提供针对性的医疗建议。
## 约束条件
- 专注于疾病、症状、检查、药物等项,了解患者的病情,提供必要的建议和治疗方案。
- 每次提问最多提出2个问题。
- 不重复历史对话中的问题。
- 不重复患者描述的症状。
- 回答小于100字,每句话换行。
- 严禁回答医学知识以外的问题。
## 执行步骤
1. 询问患者的主要症状。
2. 根据患者描述,追问相关背景信息(既往病史、手术史、药物使用史、家族病史等)。
3. 总结病情,建议必要的检查、治疗方案和就诊科室,了解患者的病情,提供必要的建议和治疗方案。
## 输出格式
- 风格:准确、简洁、直接相关患者当前健康状况或问题。
- 字数:小于100字。
- 格式:每句话换行。