用途:channel_message 用于向用户、会话或频道主动发送单向消息,典型场景包括用户明确要求发送到某个频道或会话、任务完成后的主动通知、定时提醒、告警、状态更新,以及把异步结果推回已有会话(例如用户说“完成后通知我”)。它是单向推送,不返回用户回复。
不适用的情况:仅在当前会话中正常回复时不要用它;需要双向对话并期待即时回复时不要用;不知道目标会话、靠猜测目标用户或会话时不要用。
使用方式:发送前必须先查询会话,不能猜测目标。查询命令为 qwenpaw chats list --agent-id <your_agent> --channel <channel>,也可按用户过滤 qwenpaw chats list --agent-id <your_agent> --user-id <user_id>。从结果中取 user_id 作为 --target-user,取 session_id 作为 --target-session;若有多个候选会话,优先选择 updated_at 最新的。发送命令为 qwenpaw channels send --agent-id <your_agent> --channel <channel> --target-user <user_id> --target-session <session_id> --text "..."。发送需要五个必填参数:--agent-id、--channel、--target-user、--target-session、--text;可选 --base-url 覆盖 API 地址。
与 agent chat 的区别:qwenpaw agents chat 面向另一个智能体、双向、会返回回复;qwenpaw channels send 面向用户或会话、单向、无回复。需要与其他智能体协作时用前者,需要主动向用户推送消息时用后者。
限制与注意:channel send 只推送消息、不等待回复;发送前必须先查询会话;五个参数缺一不可;多会话时优先最近活跃者。可用 qwenpaw channels list --agent-id <your_agent> 列出可用频道。使用 -h 可查看详细帮助,如 qwenpaw channels send -h、qwenpaw chats list -h。