创建订阅器
本指南介绍如何创建和配置订阅器，实现 AI 任务的自动化执行。
📋 创建流程
步骤 1：进入创建页面
- 点击左侧导航栏的 Feed
- 点击 新建订阅器 按钮
步骤 2：填写基本信息
| 字段 | 必填 | 说明 |
|---|---|---|
| 名称 | ✅ | 订阅器的显示名称，如"每日汇报" |
| 描述 | ❌ | 简要描述订阅器的用途 |
| 任务类型 | ✅ | 信息采集类或执行类 |
| 智能体 | ✅ | 选择执行任务的智能体 |
任务类型说明
| 类型 | 说明 | 适用场景 |
|---|---|---|
| 信息采集类 | 收集和汇总信息 | 新闻摘要、数据报告、监控分析 |
| 执行类 | 执行任务和操作 | 代码审查、文档更新、自动化测试 |
步骤 3：配置触发方式
选择订阅器的触发方式：
| 触发方式 | 说明 | 示例 |
|---|---|---|
| 定时计划 | 使用 Cron 表达式 | 每天上午 9 点 |
| 固定间隔 | 按固定时间间隔 | 每 2 小时 |
| 一次性定时 | 指定时间执行一次 | 明天下午 3 点 |
| 事件触发 | Webhook 或 Git Push | 收到 Webhook 请求时 |
📖 详细说明请参阅 触发方式
步骤 4：编写 Prompt 模板
在 Prompt 模板中描述要执行的任务：
请帮我汇总今天（{{date}}）的科技新闻，包括：
1. AI 领域的重要进展
2. 大型科技公司的动态
3. 值得关注的创业公司
请以简洁的要点形式呈现。
支持的变量
| 变量 | 说明 | 示例值 |
|---|---|---|
{{date}} | 当前日期 | 2024-01-15 |
{{time}} | 当前时间 | 09:00:00 |
{{datetime}} | 日期时间 | 2024-01-15 09:00:00 |
{{subscription_name}} | 订阅器名称 | 每日新闻摘要 |
{{webhook_data}} | Webhook 请求数据 | {"event": "push"} |
步骤 5：高级配置（可选）
代码仓库设置
如果选择了编程类智能体，需要配置代码仓库：
- 选择仓库：从已连接的仓库中选择
- 选择分支：指定要操作的分支
模型设置
可以覆盖智能体的默认模型：
- 点击模型选择器
- 选择要使用的模型
- 如果智能体未配置模型，此项为必填
执行配置
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 失败重试次数 | 执行失败后的重试次数 | 0（不重试） |
| 执行超时时间 | AI 完成任务的最大时间 | 10 分钟 |
| 保留对话历史 | AI 可以看到之前的执行记录 | 关闭 |
群聊按需静默与 @ 指定用户
订阅器绑定群聊后，可以要求 AI 根据本次结果控制群通知。该能力适用于 Chat、ClaudeCode、Codex、Agno、Dify 等 Shell；系统会在执行 Prompt 末尾追加控制说明。该规则只控制群聊通知路由，不改变私聊通知；仅对已启用且支持群聊投递的通知渠道，默认必须向已绑定群聊发送通知。钉钉群聊投递需要配置 AI 卡片模板（card_template_id）；未配置模板的旧版渠道不会发送群聊通知，私聊仍按已有配置处理。只有任务或用户明确要求本次不通知群聊时，AI 才可输出 【静默】 或 【silent】；需要 @ 指定用户时可使用独立的 @ 标记。所有控制标记都必须在回答最后单独一行输出，并放在【】中：
【静默】或【silent】：本次私聊通知照常发送，但不发送到绑定的群聊。【@列表:1234,1235】或【mention:1234,1235】：本次群聊 @ 这些钉钉 staffId 对应用户；多个 staffId 可用中文或英文逗号分隔，列表后的冒号可用中文或英文冒号。
无需在通知设置中预先维护 @ 用户列表，每次由消息末尾决定。需要正常发送但不 @ 用户时，不应输出任何控制标记；需要 @ 用户时只能填写明确指定或能从任务上下文确定的实际 staffId，不得编造。两种标记可以同时输出，此时以静默为准。控制标记只用于通知路由，发送前会从群消息、Webhook 内容和执行记录中清理。群聊静默不得影响私聊，群通知控制也不应通过 silent_exit 代替。
可见性设置
| 可见性 | 说明 |
|---|---|
| 私有 | 仅自己可见 |
| 公开 | 其他用户可以发现和关注 |
| 市场 | 其他用户可以租用 |
步骤 6：保存订阅器
- 确认 启用订阅器 开关已打开
- 点击 创建 按钮
- 订阅器将按设定的触发条件自动执行
✏️ 编辑订阅器
修改配置
- 在订阅器列表中找到目标订阅器
- 点击 编辑 按钮（铅笔图标）
- 修改需要更改的配置
- 点击 保存
启用/禁用
使用订阅器右侧的开关可以快速启用或禁用：
- 启用：订阅器将按触发条件执行
- 禁用：订阅器暂停执行，但保留配置
立即执行
点击 立即执行 按钮（播放图标）可以手动触发一次执行，不影响正常的定时计划。
🗑️ 删除订阅器
- 点击订阅器的 删除 按钮（垃圾桶图标）
- 在确认对话框中点击 删除
⚠️ 删除操作无法撤销，执行历史也会被删除
💡 最佳实践
1. 清晰的命名
使用描述性的名称，便于识别：
- ✅ "每日科技新闻摘要"
- ✅ "周一代码质量检查"
- ❌ "订阅器1"
2. 详细的 Prompt
提供足够的上下文和明确的要求：
# 好的 Prompt
请分析最近一周的用户反馈数据，重点关注：
1. 用户满意度趋势
2. 常见问题分类
3. 改进建议
输出格式：Markdown 表格 + 简要总结
# 不好的 Prompt
分析用户反馈
3. 合理的触发频率
根据任务性质选择合适的频率：
| 任务类型 | 建议频率 |
|---|---|
| 新闻摘要 | 每天 1-2 次 |
| 数据监控 | 每小时或每 2 小时 |
| 周报生成 | 每周一次 |
| 紧急告警 | 使用 Webhook 实时触发 |
4. 使用对话历史
对于需要追踪变化的任务，启用"保留对话历史"：
- AI 可以对比之前的执行结果
- 识别数据变化趋势
- 避免重复报告相同内容
⚠️ 常见问题
Q1：订阅器创建后没有执行？
检查项：
- 确认订阅器已启用（开关为开启状态）
- 检查触发时间是否已到
- 确认智能体配置正确
Q2：执行失败怎么办？
解决方案：
- 查看执行记录中的错误信息
- 检查 Prompt 是否清晰
- 确认智能体和模型配置正确
- 适当增加超时时间
Q3：如何复制订阅器？
目前不支持直接复制，可以：
- 记录现有订阅器的配置
- 创建新订阅器并填入相同配置