[Bug] active_agent cron job does not push messages when AI has no active session

[Blueteemo]

问题描述

active_agent 类型的定时任务在触发时如果 AI 没有活跃会话，任务会在数据库标记为 completed、last_run_at 正常更新，但实际不会调用 send_message_to_user 向群推送消息。

复现步骤

1. 通过 future_task 工具或 WebUI 创建一个 active_agent 类型的定时任务（如每天早上 09:45 推送 AI 早报）
2. 确保触发时刻 AI 没有活跃会话（即没有用户在跟 bot 聊天）
3. 等待 cron 触发

实际表现

• 数据库 cron_jobs 表中 status 显示为 completed
• last_run_at 正常更新为触发时间
• 群里收不到任何消息
• 触发器日志中没有报错

预期表现

即使用户没有活跃会话，定时任务也应该能正常调用 send_message_to_user 推送到群。

影响

该 bug 导致所有 active_agent 定时任务在 AI 空闲时段无法正常工作，需要用户手动补跑。删旧重建可以暂时恢复，但问题会复发。

[dosubot]

@Blueteemo 这是一个多次报告的问题（#6103, #7494, #8284），根本原因已确认：

核心问题：定时任务触发时，LLM 返回 finish_reason='stop'（纯文本回复）而不是 finish_reason='tool_calls'，导致 Agent 没有调用 send_message_to_user 工具。任务在数据库中标记为 completed，但消息只写入了对话数据而未实际推送 [1] [2]。

这不是调度逻辑的 bug，而是模型行为问题——在没有活跃会话的 cron 上下文中，某些模型倾向于直接输出文本而非调用发送工具。

解决方案：

1. 在任务描述中强调工具调用：加上类似"你必须使用 send_message_to_user 工具将内容发送给用户，禁止直接输出文本回复"——有用户反馈加上后成功率达 100% [2]
2. 换用 function call 能力更强的模型（如 Claude、GPT-4o），较小的模型在 cron 场景下 tool call 稳定性较差
3. 检查 provider 的 modalities 配置是否包含 "tool_use"，否则工具会被静默移除

可以开启 DEBUG 日志确认：如果触发时日志中 stop_reason 是 end_turn/stop 且无 send_message_to_user 工具调用记录，即为此问题。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[Blueteemo]

感谢 dosubot 的分析，原来根因是 LLM 在没有活跃会话的 cron 上下文中倾向于输出纯文本而不是调用 send_message_to_user 工具。

我已经按照建议在 cron 任务的描述中加上了强制使用工具调用的 prompt，现在任务状态正常（enabled=1, next_run_time 正常），明天 09:45 会再测试一次，看看加了强制 prompt 后能否正常推送。

如果有结果会在这里更新。