管理计划执行卡片
大多数团队会在大约 5 分钟内完成一张卡片的设置或更新。
当你想让一个区块稍后运行另一个区块时,使用本指南。 本指南也解释了为什么编辑和删除现在会使用稳定的计划身份。 带下划线的标签会保持不变。
前往: Bot Builder → Cards → Scheduled Execute
快速参考
| 设置 | 控制内容 | 需要检查什么 |
|---|---|---|
| Schedule Name | 你在编辑器中看到的标签 | 每个计划使用唯一名称 |
| Date Type | 精确、相对或重复的时间安排 | 与实际需要的时间一致 |
| Execute Block | 稍后运行的区块 | 选择正确的目标区块 |
| Identity | AVA 用于保存和删除的隐藏键 | 编辑时保持同一张卡片打开 |
| Save | 保存卡片和身份 | 每次编辑后都要保存 |
开始前
确认以下事项:
- 你可以编辑 Bot Builder 卡片
- 目标区块已经存在
- 你知道该计划是一次性执行还是重复执行
- 你希望每个计划动作都有唯一的 Schedule Name
AVA 现在会为每张 Scheduled Execute 卡片保留一个隐藏身份。 你在编辑器中仍然会看到显示名称。 如果你重新打开旧卡片,AVA 会在可行时恢复同一个身份。
了解计划报告重试
当计划报告的运行时返回结构化回退结果时,AVA 可以重试该报告。 带有部分属性失败的正常回答不会启动此重试流程。
| 发生的情况 | 你可以预期的结果 |
|---|---|
| 原始执行 | AVA 运行一次计划报告。 |
| 重试次数 | AVA 最多可以额外尝试三次。 |
| 重试时间 | 重试会在大约 30、60 和 120 秒后排队。 |
| 重试窗口 | 十分钟后,AVA 会停止重试。 |
| 常规计划 | 下一次重复运行仍然独立进行。 |
重试会保留原始提示、代理、报告时间和属性访问权限。 重试不会包含群组历史记录、精简记忆或引用的回复。
在活动中查看重试详情
-
打开 Settings → Communications → Chatbot。
-
打开代理的 Activity 标签页。
-
按计划名称查找计划报告。
-
检查尝试标签、预定时间和重试状态。
-
分别检查 Execution 和 Delivery。
✓ Original attempt 表示第一次运行。 ✓ Retry 1/3、Retry 2/3 或 Retry 3/3 表示一次重试。 ✓ Scheduled for 显示预定的报告时间。 ✓ 当 AVA 已将另一次尝试排队时,会显示 Next retry。 ✓ Execution 显示回答、提案、回退结果或待处理结果。 ✓ Delivery 显示 AVA 是否发送了生成的报告。
活动行可能显示 Retry queued、Completed、Retry publication failed、 Retries exhausted 或 Retry stopped。 每个目标群组都有自己的重试链。
| 活动详情 | 含义 |
|---|---|
| Schedule name | 与该尝试关联的计划报告 |
| Scheduled for | 原计划设定的报告时间 |
| Original attempt | 此报告的第一次执行 |
| Retry 1/3 至 Retry 3/3 | 后续的回退重试 |
| Execution | AVA 在此次尝试中生成的内容 |
| Delivery | AVA 发布结果时发生的情况 |
| Next retry | 下一次排队的重试时间(如有) |
发布错误会在显示于活动中之前经过清理。 这些信息可以帮助你识别投递问题,同时不会暴露报告指令或酒店数据。
计划报告仍然失败
你会看到: 活动显示 Retries exhausted、Retry stopped 或 Retry publication failed。
解决方法:
- 打开活动行,并记下 Execution 结果和原因。
- 如果显示了经过清理的发布错误,请查看该错误。
- 检查重试窗口期间计划或代理是否发生了变化。
- 确认目标群组仍有权接收该报告。
- 在受控的测试时间段内再次运行报告。
- 如果同一计划反复达到终止状态,请联系支持团队。
创建或编辑卡片
-
打开包含该卡片的机器人集合。
-
点击 Add Scheduled Execute Block。
-
选择 Exact Date、Relative Date 或 Repeating Date。
-
输入卡片上显示的计划详情。
-
填写 Schedule Name。
-
选择应该运行的 Execute Block。
-
点击 Save。
✓ 保存后卡片仍会留在列表中。 ✓ AVA 会分配或保留稳定的计划身份。
身份会让计划在编辑后仍然绑定到同一张卡片。 这样可以减少重复运行。 AVA 也会将可见标签与内部身份分开保留。 因此你可以重命名卡片,而不会改变计划。
删除卡片
-
打开你要移除的 Scheduled Execute 卡片。
-
点击 Remove Card。
-
如果卡片没有保存的身份,AVA 只会在匹配唯一时按标签匹配。
-
如果 AVA 显示重名警告,先重命名其中一张卡片。
-
保存已重命名的卡片。
-
再次尝试 Remove Card。
✓ AVA 会删除与该身份对应的已跟踪计划。 ✓ 它不会根据共享标签进行猜测。
故障排查
删除时提示标签有歧义
你会看到: AVA 提示 Scheduled Execute 标签有歧义。
解决方法:
- 打开匹配的卡片。
- 为每张卡片设置唯一的 Schedule Name。
- 保存这些卡片。
- 在正确的卡片上重试 Remove Card。
旧版删除卡片只有在匹配到一张 Scheduled Execute 卡片时,才能按标签解析。 如果匹配到多张卡片,AVA 会停止保存,并要求你消除歧义。
旧计划看起来仍然处于活动状态
你会看到: 你编辑了卡片,但之前的运行仍然存在。
解决方法:
- 确认卡片已成功保存。
- 重新打开卡片并检查更新后的时间安排。
- 如果卡片是在编辑器外创建的,请在此处打开并保存一次。
- 如果问题仍然存在,检查是否有同名的重复卡片。
带下划线的卡片名称看起来不对
你会看到: 编辑器显示的标签带下划线,但计划看起来不同。
解决方法:
- 在 Schedule Name 中使用你想要的显示名称。
- 再次保存卡片。
- 记住 AVA 会从第一个下划线开始读取标签。
- 不要只用标签来识别该计划。
AVA 会把显示标签和内部身份分开保存。 这样你就可以使用易读的标签,而不会改变已跟踪的计划。 它也会将第一个下划线之后的文本保留在可见标签中。
仍然无法解决?
如果出现以下情况,请联系 success@vouch-technologies.com:
- ❌ 将名称设为唯一后,Remove Card 仍然失败
- ❌ 已保存的卡片没有保留其时间安排
- ❌ 编辑或删除卡片后出现错误
建议附上:
- 机器人集合名称
- 计划名称
- 警告截图
- 你已经尝试过的步骤