平台管理

1. 首次配置顺序

完成管理员改密后，按以下顺序配置：

1. 配置真实模型并做连通性测试。

2. 为「TimechoDB 运维助手」选择该模型。

3. 在「执行通道」确认运维建立的数据库连接可用；需要时为每个连接单独设置口令。

4. 创建用户并绑定数据库连接，按需设置预算和用户组。

5. 上传知识库、绑定技能，并设置智能体和知识库的可用范围。

6. 用普通用户账号试一次只读查询；在独立测试对象上验证审批。

同时建立第二个管理员账号，用于应急解锁和重置密码。

2. 配置模型

“模型”负责理解问题和生成回答，需要连接到实际模型服务。

1. 「模型配置」→「新增配置」。

2. 选择「内置目录」中的型号，或填写服务方提供的 Provider、Base URL、API Key 和模型名。

3. 保存 →「连通性测试」→ 通过后「设为默认」。

4. 「智能体」→ 编辑助手 → 选择该「默认模型」→ 保存。

参数说明：Provider 通常为 openai-compatible，地址示例为 https://llm.example.com/v1；实际参数由服务方提供。API Key 保存后只显示末 4 位掩码。

模型要求：

• 初始演示模型只能体验流程，正式使用需要支持工具调用的真实模型。

• 是否支持流式回答和读图，需要实际确认。

• 停用的模型不能被新会话选用。

完成后检查：新建会话，使用实际模型完成一次查询。连通性测试通过，还不能代替完整问答验证。

3. 创建和维护用户

1. 「用户管理」→「新建用户」。

2. 填写用户名、显示名、初始密码、角色、数据库 Context 和每日预算。

3. 保留「首次登录需修改密码」，保存后将网址和初始账号通过本单位规定的渠道提供给用户。

4. 让用户登录、改密并试一次只读查询。

Context 由运维先创建，步骤见配置与验证 TimechoDB Context。绑定哪个 Context，用户就使用对应数据库账号的权限；生产环境中，未绑定的非管理员不能执行 SQL。

管理任务	操作和影响
重置密码	用户下次登录需改密，旧登录状态立即失效；已有 API Token 需另外撤销
解锁账号	在「用户管理」解锁，无需等默认的 15 分钟
停用账号	立即生效，名下 API Token 也不能再使用
调整预算	修改每日 token 预算；预算是用量控制，不是严格费用封顶
调整角色或连接	编辑对应用户；不能修改自己的角色或停用自己，最后一个启用管理员不能降级

4. 设置数据库连接口令

多个数据库账号使用不同口令时，可以为各 Context 单独托管口令：

1. 打开「执行通道」，在下方「数据库连接口令」找到对应 Context。

2. 点击「设置口令」，填写实际数据库口令。

3. 平台先尝试连接数据库；连接成功后才保存，保存后不再显示口令。

4. 使用绑定该 Context 的账号试一次查询。

后续维护：

情况	处理方式与影响
显示「目标已变更」	连接主机、端口、节点或账号可能已变化；平台停止使用原托管口令。先核对新目标，再点击「更换」重新设置
清除托管口令	通常改用部署时的共用口令；若已关闭共用口令，该 Context 将无法执行数据库操作

操作留痕：设置、更换和清除都会留下审计记录，记录中不包含口令。

5. 管理用户组和可用范围

用户组用于批量指定哪些人能使用某个智能体或知识库，不会代替数据库账号权限。

1. 「用户管理」→ 页面下方「用户组」，创建组并选择成员。

2. 编辑「智能体」或「知识库」，在「可用范围」选择需要的用户组。

3. 分别使用组内和组外账号检查可见范围与使用权限。

授权生效范围：

• 选择用户组后，只有组内用户和平台管理员可用；不选用户组表示所有用户可用。

• 智能体授权收紧后，组外用户仍可查看以前的会话，但不能继续发送消息。

• 技能目前不单独按用户组授权。「表注释（平台兜底）」按数据库连接隔离，不按用户组授权。

删除用户组前检查授权：只授权给该组的智能体或知识库可能变成所有人可用；按页面提示先调整资源范围。

6. 配置智能体和技能

智能体是按任务配置的助手；技能是处理特定任务的方法说明。

1. 在「技能」上传含 SKILL.md 的标准 ZIP 技能包，查看内容并启用。

2. 在「智能体」编辑助手，设置用途说明、默认模型、绑定技能、可检索知识库和默认执行策略。

3. 在「可用工具」中勾选需要的工具；不允许某类任务时取消对应勾选。

4. 按管理用户组和可用范围设置可用范围，再新建会话验证。

技能生效：上传技能包后还需要绑定到智能体。内置技能随平台版本更新。

工具范围：

• 可用工具默认全部启用，后续新增的工具也默认启用；升级后应复查。

• 停用的工具不会提供给模型，模型尝试调用也会被拒绝。

• 标为「数据出域」的工具会将数据发到平台外；不允许预测的场景，应取消该智能体的预测工具。

完成后检查：助手使用的模型、技能、知识库和可用工具符合预期，受限账号无法使用该助手。

7. 管理知识库

7.1 新建与验证

1. 「知识库」→「新建知识库」→「上传文档」。

2. 在「文档」清单等待「解析中」变为「可检索」。失败时按原因处理。

3. 用「检索测试」检查命中内容和出处；点击「前后文」查看相邻段落。

4. 在「智能体」绑定所需知识库，并通过「可用范围」限制访问用户组。

5. 用实际用户在对话中提问，核对回答出处。

7.2 文件与扫描件要求

项目	要求
文件格式和大小	.txt、.md、.csv、.pdf、.docx，默认单文件不超过 30 MB；旧 Word .doc 需另存为 .docx
扫描件模型	使用默认模型识别，默认模型必须支持读图；识别计入模型用量
扫描件页数	最多识别 20 页；超出上限会解析失败，应拆分后上传
文字与扫描页混合的 PDF	可能只提取文字页，请核对需要的内容是否已解析

7.3 文档更新与访问范围

• 同名重传：解析成功后替换旧版，失败时旧版仍可检索。

• 解析中断：服务重启时未完成解析的文档会标为失败，需要重新上传。

• 删除资料：删除文档或知识库前确认影响范围。

• 未绑定知识库：智能体可检索全部对当前用户可用的知识库，并不绕过用户组权限。

• 系统知识库：「表注释（平台兜底）」请勿改名；用户只能检索自己数据库 Context 范围的相应内容。

8. 配置外部工具（MCP）

外部工具用于连接工单、通知等其他系统，需要管理员先登记服务并为智能体启用。外部服务应由本单位允许使用，且后端能够访问。

1. 打开「外部工具（MCP）」→「登记 MCP 服务」。

2. 填写名称、工具名前缀、服务地址、可选的 Authorization 授权信息和超时。

3. 保存后查看工具清单；读取失败也会保存配置并显示原因，修正后点「刷新」。

4. 编辑对应「智能体」，在「外部工具（MCP）」中启用该服务。

5. 新建会话试一次允许的操作，核对审批卡和审计记录。

登记要求：

• 只支持 Streamable HTTP 方式的 http/https 地址；工具名前缀登记后不能修改。

• 授权信息加密保存，之后只显示「已设置」；平台密钥更换或丢失后，需要重新填写。

调用与停用：

• 调用会发送参数到外部服务，需要用户审批，并记录「数据出域」；用户可在本会话记住同一工具的批准。

• 停用服务后，所有智能体都不能继续调用它。

• 登记、修改、刷新和删除也会留下审计记录。

部署限制：需要限制可登记的服务主机，或关闭全部外部工具时，由运维按常用配置 配置。当前不支持将 TimechoAgent 作为 MCP Server 对外提供工具。

9. 维护公共记忆、用量和平台状态

管理事项	操作与检查重点
公共记忆	在「记忆」维护共同口径和偏好，检查来源与时效，不保存个人秘密；普通用户维护自己的个人记忆
全体用量	在「用量统计」按模型、日期、智能体和用户汇总；普通用户和数据库管理员只看自己的用量。「其中估算」表示供应商未返回准确用量、按字符估算的部分
数据库通道	「执行通道」→「重新探测」，确认连接与版本正确
系统自检	请运维协助查看；错误（error）先处理，提醒（warn）确认原因。生产环境保持演示模式关闭
审批分离	按常用配置 将危险审批限制为仅数据库管理员，或开启四眼审批，让一般写入也由另一人批准
API Token	统一管理步骤见API 接入