产品介绍

1. 简介

TimechoAgent 是面向 TimechoDB 的数据库智能助手。用户可以在浏览器中用日常语言描述需求，由助手查询数据、执行经授权的数据库操作，并解释结果。

从查询设备指标，到生成图表、整理运维报告，再到阅读操作规范，用户可以在同一会话中持续提问和补充资料。涉及写入或删除数据时，平台会按规则请求审批，并保留操作记录，便于后续核查。

2. 核心能力

• 自然语言操作数据库：描述要查询或处理的数据，助手生成相应数据库指令，在账号权限和审批规则允许的范围内执行。

• 数据分析与成果输出：汇总和比较数据，展示折线图或柱状图，将查询结果导出为 CSV，或根据已查询数据生成 Markdown 报告。

• 资料阅读与知识辅助：读取文档附件，结合知识库中的规范回答并注明出处；使用支持读图的模型时，可以识别图片和扫描件。

• 会话与工作成果管理：围绕同一任务持续追问，保存个人偏好，将 SQL、脚本或草稿写入会话工作区，继续修改并下载。工作区文件只保存，不会自动执行。

• 权限、审批与审计：按角色分配管理和审批权限，为用户绑定数据库连接，记录执行结果、审批和用量，供授权人员核查。

• 预测与外部工具扩展：管理员完成配置后，可调用 TimechoAI 进行时间序列预测，或通过外部工具连接其他服务；相关数据发送需按平台规则审批。

3. 适用场景

场景	示例需求	可以获得的结果
日常数据查询	“查昨天各台设备的平均温度，列出最高的 5 台。”	查询结果及统计说明，可继续要求图表或导出
运维状态检查	“检查数据库节点和磁盘状态，列出需要关注的问题。”	状态检查结果及明细，供运维人员进一步判断
运维报告整理	“根据本次已经查询的数据生成运维日报，注明统计范围。”	可复制或下载的 Markdown 报告
操作规范查阅	“按知识库中的设备规范，说明温度超限后的检查步骤。”	带文档名、页码或章节等出处的回答
脚本和草稿整理	“把本次巡检 SQL 保存到工作区，后续再改成按小时统计。”	可继续修改、复制或下载的文本文件
趋势预测	“预测某台设备接下来一小时的温度。”	审批后得到预测值与历史、预测曲线；需已配置预测服务且数据符合要求

查询和操作范围取决于账号绑定的数据库权限。使用报告或执行数据库变更前，应结合实际业务核对结果；具体操作步骤和限制见后续章节。

4. 认识工作界面

区域	常用入口和用途
左侧「工作台」	「对话工作台」用于提问；「会话管理」用于重命名、摘要和回收站操作
左侧「知识与记忆」	「知识库」查看可用资料；「记忆」管理个人偏好
左侧「治理与审计」	「用量统计」查看用量；授权管理员还可进入「审计中心」
左侧「系统管理」	平台管理员配置智能体、技能、模型、外部工具和用户；「执行通道」平台管理员与数据库管理员可见
对话区域	输入问题、上传资料、查看回答、查询结果、图表和审批卡
对话页右侧	查看「上下文预览」「执行通道」「工作区」；审批人员还可查看待审批操作
右上角用户菜单	「修改密码」「API Token」「关于」「退出登录」

不同角色看到的入口不同。没有某个管理菜单时，先联系平台管理员确认权限。

5. 建议阅读顺序

已有平台网址和账号的用户，可直接从快速入门开始，无需先阅读安装命令。

角色或任务	建议阅读顺序
普通用户	快速入门 → 常用功能 → 审批与审计
数据库管理员	快速入门 → 审批与审计
平台管理员	平台管理，按需阅读审批与审计
部署与运维人员	安装部署 → 日常运维 → 备份、恢复与升级；配置与监控见配置与监控
脚本或系统接入人员	API 接入，涉及数据库操作时同时阅读审批与审计
遇到提示或需要帮助	常见问题与支持