腾讯云智能体开发平台 应用发布概述

当你在测试环境中完成应用配置、知识库导入与效果验证后，即可通过 应用发布 功能，一次性将当前的应用配置、知识库内容等同步到正式环境并对外提供服务。你可以在此处查看历史智能体应用的历史修改记录。

你也可以进入 控制台，在 应用发布 页面对 待发布、发布历史、服务状态、发布渠道和触发器 进行统一管理。

一、待发布

1. 单击待发布，界面中将显示应用的所有待发布内容，包括文档、问答、待发布设置、待发布标签等。

2. 单击右上角发布，将弹出发布详情确认窗口，窗口将会展示本次发布涉及的各类待发布内容数量，方便你核对。

3. 确认无误后，再次单击发布，后台将进入发布流程。发布完成后，你将收到站内信通知，也可通过应用发布下的发布历史查看本次发布的详细信息。发布完成后系统也会自动生成唯一的版本号，在发布历史页面可以查看其版本号。

二、发布历史

在 发布历史 页签，你可以查看每一次发布的详细记录，便于追溯应用在正式环境中所作出的变更历史。

三、发布历史与版本还原

在 发布历史 页面，你可以查看应用历次发布的详细记录。当你需要找回旧版本的配置时，可以使用版本还原功能。

注意：版本还原不会直接改变当前的线上服务。系统会将选定版本的配置覆盖你当前的调试/编辑界面。

四、步骤 1：版本还原入口

在应用发布 > 发布历史界面中，你可以单击对应版本的还原到调试态，将该版本的各项可还原组件和设置还原到当前调试版本。

五、步骤 2：版本还原二次确认

系统将弹出二次确认窗口。请仔细阅读提示，确认后单击确认还原。

六、步骤 3：版本还原后异常情况处理

1. 如果当前平台版本新增了某些旧版本不存在的配置项，回退后系统将自动填充默认值。

2. 如果旧版本引用的全局资源（如某个连接器与工具或知识库）已被彻底删除，回退后该组件将显示失效，你需要重新配置或删除。

七、随版本回退的内容说明

应用的各项组件和设置是否可以随版本回退情况如下表所示：

八、服务状态

成功发布之后，在服务状态页面，你可以获取应用在正式环境下的体验入口和 API 接口接入信息。

·体验链接

体验链接用于在网页端快速体验你搭建的智能体应用。

·单击立即体验，可通过腾讯云账号登录访问。

·单击分享链接或分享二维码，可通过邮箱验证码登录访问，适合对外邀请试用或灰度放量。

·API 管理

如需在业务系统中集成并调用该智能体应用，需要在此页获取 AppKey，建议按以下步骤使用：

1. 进入 API 管理

在控制台打开目标应用，进入 应用发布 > 服务状态 ，在页面下方找到 API 管理区域。

2. 查看/创建 AppKey

·这里会展示当前应用已创建的 AppKey（名称、创建时间等）。

·同一个应用最多支持创建 两个 AppKey。

·如需新增调用密钥，可在此创建新的 AppKey，并在创建后立即复制保存。

3. 在业务系统中配置调用

将获取到的 AppKey 配置到业务系统，用于调用应用相关接口（具体调用方式参考接口文档）。

4. 密钥轮换与风险处理

如需轮换密钥，可先创建新 AppKey，业务系统切换到新 AppKey 后，停用旧的密钥并删除。若怀疑 AppKey 泄露，请立即停用该密钥，并创建新的 AppKey 来替换。

注意：说明：

注意：AppKey 为敏感信息，请避免在前端代码、公开代码仓库或明文日志中暴露。

九、发布渠道

应用成功发布后，通过简单授权/配置，即可将配置好的应用发布到微信服务号、微信订阅号、微信客服、微信小程序、企业微信应用和企微智能机器人。发布后，服务号、订阅号、企业微信应用等可以使用应用回复用户消息，助力运营。

十、调试渠道

如需在真实渠道中验证应用的调试效果，可以在新建发布渠道时将其设置为调试渠道。调试渠道使用应用当前的调试配置，不影响正式发布渠道。

1. 进入目标应用，选择“应用发布 > 发布渠道”，单击“新建”，并选择需要接入的渠道类型。

2. 完成渠道连接和机器人绑定后，在“渠道设置”中将“生效环境”设置为“仅用于调试”，然后保存渠道。

创建成功后，调试渠道将在发布渠道列表中显示“仅用于调试”标签，用于与正式发布渠道进行区分。

发布渠道列表中的调试渠道：

十一、触发器

触发器将应用执行模式从用户主动触发升级为定时自动执行、事件被动拉起两种智能化触发方式。触发器触发时相当于一个虚拟用户以指定内容向应用发起一次对话，应用按正常链路处理，并将结果推送到配置的渠道。

在应用发布 > 触发器页面管理应用的全部触发器。触发器支持两种类型：

·定时触发：按预设时间规则周期或单次执行。例如每天 9:00 自动生成数据日报并推送到企业微信群。

·事件触发：外部系统通过 HTTP 请求（Webhook）驱动执行。例如监控系统告警时自动拉起应用分析。

注意：说明：触发器需在应用发布后才会实际运行。若应用尚未发布，进入触发器页面将展示空态提示「应用尚未发布，触发器需要基于已发布版本运行」，页面提供前往发布应用按钮，完成发布并上线后方可使用触发器功能。

十二、新建触发器

入口：进入目标应用后，在顶部 Tab 栏中单击 应用发布，再切换到 触发器 子 Tab 即可管理触发器。

当应用发布后，触发器页面左上角提供新建按钮，单击后弹出新建触发器弹窗，顶部通过 触发器类型 Radio 单选切换 定时触发 / 事件触发，下方字段根据所选类型联动展开。

公共字段（两种触发类型均需配置）：

注意：说明：

十三、新建定时触发

选择定时触发后，除公共字段外还需配置：

五种执行频率的配置方式：

注意：说明：

注意：所有定时规则按应用所属企业的设置时区解析（默认 Asia/Shanghai，UTC+8）。

十四、新建事件触发

选择事件触发后，除公共字段外还需配置：

触发执行

向配置页生成的 Webhook URL（即下方示例中的 YOUR-WEBHOOK-URL）发送一个 POST 请求即可触发一次执行，请求体为 JSON 格式的请求参数（对应触发器配置的请求参数列表，传入的值会传递给关联的 API 参数，供应用或工作流执行时使用）：

curl -X POST –location 'YOUR-WEBHOOK-URL' \\ -H "Content-Type: application/json" \\ -H "Authorization: Bearer YOUR-WEBHOOK-TOKEN" \\ -d '{ "aaa": "aaa variable" }'

请求受理成功后，接口会返回本次触发的执行实例 ID（instance_id），用于后续查询该次执行的处理情况。

查询执行情况

携带上一步返回的 instance_id，向同一个 Webhook URL（即 YOUR-WEBHOOK-URL）发送 GET 请求，即可查询该次触发的执行状态与结果：

curl -X GET –location 'YOUR-WEBHOOK-URL?instance_id=YOUR-TRIGGER-INSTANCE-ID' \\ -H "Content-Type: application/json" \\ -H "Authorization: Bearer YOUR-WEBHOOK-TOKEN"

注意：说明：

注意：将 YOUR-WEBHOOK-URL、YOUR-WEBHOOK-TOKEN 替换为触发器配置页复制的实际 Webhook URL 和 Bearer Token；YOUR-TRIGGER-INSTANCE-ID 替换为触发时返回的 instance_id。

十五、管理触发器

触发器列表每行右侧的操作菜单支持以下操作：

十六、查看执行详情

在触发器列表中单击某个触发器卡片，右侧将弹出该触发器的详情面板，包含以下信息：

·任务详情：显示触发类型（定时触发 / 事件触发）、指令或工作流配置内容。

·运行日志：按时间倒序列出每次执行的记录，每条显示执行时间与状态（绿点表示成功，红点表示失败），以及一行简短的执行结果摘要。

详见如下截图：

十七、查看执行日志详情

在触发器详情的运行日志中单击任意一条日志，将打开该次执行的完整对话详情页面，展示：

·完整的用户指令与应用回复内容。

·信息源引用（如有）。

·应用输出的全文。

·此页面与普通用户手动触发的对话详情格式一致，方便排查具体执行结果。

详情见如下截图：

十八、在应用运营中统一查看

除触发器页面的单卡片查看外，你还可以在应用运营 > 对话记录中查看所有触发器驱动的任务执行情况：

1. 进入目标应用，切换到应用运营 Tab，选择对话记录子 Tab。

2. 在调用方式筛选下拉框中选择 触发器，即可筛选出所有由触发器发起的对话记录。

详情见如下：