2026年3月26日AI 功能大约 10 分钟
AI 机器人配置指南
TaskPyro 专业版支持将 AI 助手集成到主流即时通讯平台，让您和团队成员可以通过飞书、钉钉、企业微信随时随地与系统交互，查询系统状态、管理任务、接收告警通知。
功能特性
- 即时通讯集成：支持飞书、钉钉、企业微信三大平台
- 🤖 智能对话：AI 助手在聊天界面中回答各种问题
- 数据查询：查询项目、任务、环境、执行记录等
- 时间预测：预测系统空闲时间段，辅助任务调度
- 📱 移动办公：随时随地通过手机管理任务系统
- 🔔 消息推送：接收任务告警和执行结果通知
使用场景
飞书机器人
在飞书群聊中与 AI 助手对话，查询系统信息：
典型对话示例：
@TaskPyro-AI 助手 你能为我做什么？AI 助手会详细列出能提供的服务，包括：
- 项目管理：获取项目目录结构、查询项目信息
- 任务管理：查询任务状态、执行记录、时间分布
- 时间规划：预测空闲时间窗口、安排任务执行时间
- 数据库查询：查看项目、环境、任务、执行记录
- 系统指标：查看任务分布、系统负载情况
钉钉机器人
在钉钉群聊中使用 AI 助手：
典型对话示例：
@TaskPyro-AI 助手 你能为我做什么AI 助手会回复详细的功能列表：
- 📊 数据查询：查看所有项目、环境配置、任务列表
- 📁 项目管理：获取项目目录结构、了解脚本文件位置
- 任务调度与预测：预测系统空闲状态、找出空闲时段
- 💬 常见使用场景：查询失败任务、查找脚本、系统空闲时间等
企业微信机器人
在企业微信群聊中与 AI 助手互动：
典型对话示例：
@TaskPyro-AI 助手 你不能为我做什么AI 助手会清晰说明能力边界：
❌ 不能做的操作：
- 读取项目文件内容
- 修改或删除数据
- 执行 SQL 写操作
- 修改项目文件
✅ 能为您做的事情：
- 📋 查询项目：列出所有项目、查看项目详情
- 查询环境/任务：查看环境配置、任务列表、任务状态
- 📊 查询执行记录：查看执行历史、成功失败统计
- 📈 查询系统指标：查看任务分布、系统负载情况
- ⏰ 预测空闲时间：基于调度计划预测系统空闲时段
- 📁 查看目录结构：获取项目的文件目录结构
配置步骤
前置准备
在开始配置之前，请确保：
- 已配置 AI 模型 API Key（参考 AI 配置）
- 拥有对应即时通讯平台的管理员权限
- 已创建企业/组织账号
企业微信机器人配置
1. 创建企业应用
- 访问 企业微信开放平台
- 登录企业微信管理后台
- 进入 应用管理 > 应用 > 自建
- 点击 创建应用
- 填写应用信息：
- 应用名称：TaskPyro-AI 助手
- 应用图标：上传 TaskPyro Logo
- 可见范围：选择需要使用的部门或人员
2. 获取机器人凭证
- 进入创建好的应用详情页
- 找到 机器人 功能模块
- 点击 添加机器人
- 获取以下信息：
- 机器人 ID (Bot ID)：以
aip-或类似前缀开头的字符串 - Secret：机器人的密钥，用于身份验证
- 机器人 ID (Bot ID)：以
3. 配置机器人
- 登录 TaskPyro 系统
- 进入 AI 助手 > 机器人配置
- 选择 企业微信机器人 标签
- 填写配置信息：
机器人 ID (Bot ID): aibOtUxq7t5xxxxxxxxxxxx Secret: 已配置，输入以修改 对话模型：glm-4.7（或其他已配置的模型） - 开启 启用企业微信服务 开关
- 点击 保存 & 启动 按钮
4. 添加到群聊
- 在企业微信中打开需要添加机器人的群聊
- 点击右上角菜单 > 添加群机器人
- 选择 TaskPyro-AI 助手
- 确认添加
5. 测试验证
在群聊中发送测试消息：
@TaskPyro-AI 助手 你好如果机器人正常回复，说明配置成功。
钉钉机器人配置
1. 创建钉钉应用
- 访问 钉钉开放平台
- 登录钉钉开发者后台
- 进入 应用开发 > 企业内部开发
- 点击 创建应用
- 填写应用基本信息
2. 添加机器人能力
- 进入应用详情页
- 在 功能配置 中添加 机器人 能力
- 配置机器人基本信息：
- 机器人名称：TaskPyro-AI 助手
- 机器人头像：上传 TaskPyro Logo
- 发送消息类型：文本消息
3. 获取应用凭证
- 在应用详情页找到 凭证与基础信息
- 获取以下信息：
- AppKey：应用的唯一标识
- AppSecret：应用密钥
4. 配置机器人
- 登录 TaskPyro 系统
- 进入 AI 助手 > 机器人配置
- 选择 钉钉机器人 标签
- 填写配置信息：
AppKey: dingxxxxxxxxxxxxx AppSecret: xxxxxxxxxxxxxxxxxxxxxx 对话模型：glm-4.7 - 开启 启用钉钉服务 开关
- 点击 保存 & 启动 按钮
5. 添加到群聊
- 在钉钉中打开需要添加机器人的群聊
- 点击右上角设置 > 群机器人 > 添加机器人
- 选择 TaskPyro-AI 助手
- 确认添加
6. 测试验证
在群聊中发送：
@TaskPyro-AI 助手 查看当前任务状态飞书机器人配置
1. 创建飞书应用
- 访问 飞书开放平台
- 登录飞书开发者后台
- 进入 应用开发 > 创建应用
- 填写应用信息：
- 应用名称：TaskPyro-AI 助手
- 应用图标：上传 TaskPyro Logo
- 应用可见范围：选择相关部门或人员
2. 添加机器人能力
- 进入应用管理页面
- 点击 添加能力 > 机器人
- 配置机器人信息：
- 机器人名称：TaskPyro-AI 助手
- 机器人头像：上传 Logo
- 消息类型：文本、富文本
3. 获取应用凭证
- 在应用详情页找到 凭证信息
- 获取以下信息：
- App ID：应用的唯一标识
- App Secret：应用密钥
4. 配置事件订阅
- 进入 事件订阅 页面
- 订阅以下事件：
- 接收消息 v2.0
- 机器人进入聊天室
- 配置事件 URL（TaskPyro 会自动提供）
5. 配置机器人
- 登录 TaskPyro 系统
- 进入 AI 助手 > 机器人配置
- 选择 飞书机器人 标签
- 填写配置信息：
App ID: cli_xxxxxxxxxxxxx App Secret: xxxxxxxxxxxxxxxxxxxxxx 对话模型：glm-4.7 - 开启 启用飞书服务 开关
- 点击 保存 & 启动 按钮
6. 添加到群聊
- 在飞书中打开需要添加机器人的群聊
- 点击右上角菜单 > 添加机器人
- 从列表中选择 TaskPyro-AI 助手
- 确认添加
7. 测试验证
在群聊中发送：
@TaskPyro-AI 助手 今天有哪些任务失败了？常用对话示例
项目查询
@TaskPyro-AI 助手 查看所有项目
@TaskPyro-AI 助手 查看项目 XXX 的详情
@TaskPyro-AI 助手 获取项目 XXX 的目录结构任务管理
@TaskPyro-AI 助手 今天有哪些任务失败了？
@TaskPyro-AI 助手 查看所有运行中的任务
@TaskPyro-AI 助手 查看任务 XXX 的执行历史
@TaskPyro-AI 助手 统计上周任务的平均执行时长环境查询
@TaskPyro-AI 助手 查看所有环境配置
@TaskPyro-AI 助手 项目 XXX 使用的是什么 Python 版本？
@TaskPyro-AI 助手 查看已安装的依赖包系统状态
@TaskPyro-AI 助手 当前系统有多少个节点？
@TaskPyro-AI 助手 查看 CPU 和内存使用情况
@TaskPyro-AI 助手 系统负载情况如何？时间预测
@TaskPyro-AI 助手 今天下午 3 点系统空闲吗？
@TaskPyro-AI 助手 预测明天的空闲时间窗口
@TaskPyro-AI 助手 什么时候适合执行长时间任务？帮助查询
@TaskPyro-AI 助手 你能为我做什么？
@TaskPyro-AI 助手 你不能为我做什么？
@TaskPyro-AI 助手 如何使用任务调度功能？使用限制
⚠️ 重要提示：
为了系统安全，AI 机器人有以下限制：
不能执行的操作
数据修改
- 不能修改或删除数据库记录
- 不能创建、更新或删除项目、环境、任务
- 仅支持数据库读查询
文件操作
- 无法读取项目文件的具体内容
- 不能编辑、创建或删除任何文件
- 只能获取项目的目录结构
SQL 写操作
- 不支持 INSERT、UPDATE、DELETE 等 SQL 语句
- 仅支持 SELECT 查询操作
系统操作
- 不能直接运行代码或命令
- 不能安装软件或配置环境
- 不能管理服务器资源
高权限操作
以下高权限操作需要通过 Web 界面 进行：
- 创建、修改、删除任务
- 停止、暂停任务执行
- 修改系统配置
- 管理用户权限
最佳实践
1. 安全配置
- 定期更换机器人 Secret
- 限制机器人可见范围
- 不要在公开群聊中使用
- 监控异常访问行为
2. 权限管理
- 仅对必要人员开放机器人权限
- 设置合理的访问控制策略
- 定期审查机器人使用记录
3. 消息优化
- 设置合理的消息频率限制
- 避免短时间内大量请求
- 配置消息免打扰时段
4. 监控告警
- 启用机器人异常告警
- 监控 API 调用失败情况
- 及时发现和处理连接问题
常见问题
Q1: 机器人没有响应怎么办？
A: 检查以下几点：
- 确认机器人已正确添加到群聊
- 检查机器人服务是否已启动
- 验证 AI 模型 API Key 是否有效
- 查看系统日志是否有错误信息
Q2: 机器人回复错误的内容？
A: 可能原因：
- AI 模型配置不正确
- 问题描述不够清晰
- 超出机器人能力范围
- 网络连接问题
Q3: 可以配置多个机器人吗？
A: 支持同时配置多个平台的机器人，但每个平台只能配置一个机器人。
Q4: 机器人会主动推送消息吗？
A: 目前机器人主要用于被动响应，主动推送功能（如告警通知）需要单独配置。
Q5: 如何停用机器人？
A: 在机器人配置页面关闭对应的服务开关即可，不会删除已配置的信息。
相关文档
提示： 更多 AI 功能正在开发中，敬请期待！