从第一次配置，
到日常接待。

01 / 准备

使用前，先完成千牛设置

① 开启讲述人模式

打开千牛设置 → 多店铺设置 → 通用 → 无障碍，勾选“启用讲述人模式”。先继续完成下面的气泡模式设置，再统一重启千牛使设置生效。

② 将会话窗口设为气泡模式

打开千牛设置 → 单店铺设置 → 接待设置 → 会话窗口，选择“气泡模式”。多店铺使用时，逐个确认需要接待的店铺设置。完成两项设置后退出并重新启动千牛。

③ 确认运行环境

• 使用 Windows 10（19041 或更新版本）或 Windows 11 的 64 位电脑，安装并启动智答。
• 在千牛登录要接待的店铺，打开接待面板，确认能正常看到客户列表、聊天气泡和输入框。
• 运行接待时保持 Windows 已登录、未锁屏，千牛窗口可正常操作。电脑休眠、锁屏、千牛退出或账号掉线后，桌面自动化无法正常接待。
• 使用在线 AI 时，准备服务商提供的 API 端点、API 密钥和模型名称，并确保网络可用；只使用本地规则时可关闭 AI 回复。

千牛版本不同，设置位置或文案可能略有变化；请以“启用讲述人模式”和“气泡模式”两个目标设置为准。首次安装的智答欢迎页会检查运行环境，不会替你修改千牛或店铺的发送设置。闲鱼账号不需要上述千牛设置，接入步骤见智答接待台。

02 / 上手

第一次使用，按这六步完成

1. 准备千牛。完成上面的两个设置，重启千牛并登录店铺。
2. 添加店铺。在智答左侧点“+”，或打开左下角菜单“☰ → 店铺管理 → 添加店铺”。选择千牛，填写与千牛店铺标签一致的名称，并启用店铺。
3. 先保持离线。在控制台将当前店铺切换为离线，再进入“店铺设置 → 工作模式”，将启动时默认模式也设为离线；配置完成后再在控制台开始接待。
4. 准备回复。先设置默认回复，新增几条发货、退换货等高频策略；需要智能回复时，选择传统 AI 或 Agent 并填写对应配置。商品资料和知识库可按需补充。
5. 用消息模拟验证。选择目标店铺，分别测试规则命中、AI 回答、默认回复和转人工场景。
6. 开始小范围接待。选择已连接店铺，切换为辅助模式，留意超时发送设置；确认回复和实际投递正常后，再按需切换自动模式。

03 / 店铺

添加店铺，选择工作模式

入口：左下角 ☰ → 店铺管理

店铺名称用于匹配千牛中的店铺标签，必须一致。“备注”只影响显示，可填写方便识别的简称。启用店铺后，它会出现在左侧店铺栏；拖动店铺管理列表的行可调整顺序。

选中左侧店铺，控制台会显示该店铺的运行模式、统计、快捷短语和策略。统计可在店铺离线或未连接时查看，显示当前业务日期已记录的数据；这不代表店铺正在接待。切换模式作用于当前店铺。千牛已连接店铺同时运行时，辅助与自动模式存在互斥约束；若切换被拒绝，按提示先调整其他店铺模式。“已连接”表示识别到平台窗口；“已启用”只表示允许加载该店铺，两者并不等同。

查看控制台与默认工作模式示例

查看千牛平台的辅助回复超时设置

店铺未连接或模式切换被拒绝时，先解决连接或界面检查问题。关闭主窗口默认可能只是最小化到托盘，不能作为停止接待的方法。

04 / 逻辑

一条消息，会怎样得到回复？

1. 客户消息黑名单命中后使用黑名单兜底，跳过欢迎语、策略和 AI。
2. 欢迎语满足欢迎语开关、近期消息数和当天去重条件时生成。
3. 本地策略按优先顺序匹配每条新消息，执行命中的策略动作。
4. AI / Agent 回复未命中策略的连续消息合并，交给店铺当前启用的 AI 或 Agent；Agent 可按需加载关联技能、检索知识、调用关联工具。
5. 默认回复AI 关闭、失败或无可用内容时，执行默认回复策略。
6. 过滤与投递检查生成内容；核对店铺、客户、输入框及安全状态，再按工作模式填入或发送。

欢迎语可与业务回复一起出现。客户在生成期间又发了消息时，智答会重新核对对话，并按最新消息重新规划。看到“已生成”不等于“已发送”，是否成功投递要看消息状态和千牛中的实际对话。

05 / 策略

把确定的问题写成回复策略

入口：☰ → 策略管理，或控制台 → 管理策略

1. 选择当前店铺，点“新增策略”，填写策略名称并选择匹配方式。
2. 添加主关键词，再按需要添加加词、减词。
3. 配置一个或多个动作，确认动作顺序；需要限定时间时设置生效时段。
4. 勾选“启用此策略”并保存。拖动列表行，把更具体、需要优先处理的策略放在前面。
5. 在顶部输入测试消息，点“匹配策略”或按回车检查命中，再去消息模拟验证完整回复。

关键词匹配忽略字母大小写。生效时段留空表示永久生效，开始晚于结束表示跨天时段。当前策略编辑器提供回复消息、回复图片、转人工、调用 API四类动作。

文本回复可以选择“回复完整内容”（整段作为一条消息）或“随机回复一行”（从非空行随机选一条）。图片可选择本地文件或 HTTP 地址。转人工动作会提示人工接管；调用 API 适合已有业务接口的场景，与下文 Agent 的连接工具分开配置。

查看策略编辑与动作配置

策略“导出 / 导入”使用 JSON 文件，操作前确认当前店铺。配置变量时优先点击编辑框提供的变量按钮，避免手写错误。

06 / 店铺设置

配置 AI，并准备兜底与边界

入口：店铺管理 → 设置，或右键左侧店铺 → 店铺设置

店铺设置共有八页：AI 配置、Agent配置、默认回复、欢迎语、黑名单、消息处理、工作模式、变量管理。知识库、连接工具与技能在“Agent配置”页下方关联；各店铺独立保存设置。

AI 配置

当前 AI 配置页提供LLM 大模型，填写下表参数。Coze 仅保留历史配置兼容，当前界面不提供新建 Coze 配置的入口。勾选“启用 AI 回复”后，只处理策略未解决的消息。传统 AI 与 Agent 二选一，开启其中一个会关闭另一个；两者都关闭时保留规则与默认回复。

“清空AI配置”会立即执行清空操作并要求确认，默认回复策略会保留。关闭 AI 开关后，规则和默认回复仍可工作。

其余设置怎么配

查看默认回复、欢迎语、黑名单、消息处理四页示例

07 / Agent

让 Agent 按需使用知识、工具与技能

适合需要结合店铺知识、多轮提问、查询订单等业务接口的接待。先配置模型，再限定它能使用的知识、工具与技能；只关联这些能力，不会自动切换回复模式。

入口：店铺设置 → Agent配置；☰ → 插件管理 → 模型工具 / 模型技能

1. 配置独立模型。开启 Agent，填写 OpenAI 兼容 Chat Completions 端点、密钥、模型与系统提示词。模型需支持原生函数工具；Agent 不继承传统 AI 的模型配置。
2. 设置执行边界。检查模型请求次数、工具调用次数、超时、上下文字符数及工具结果预算等上限。提示词中说明哪些信息必须查证、何时询问客户、何时转人工。
3. 关联能力。向下滚动到关联区域，勾选本店铺允许使用的工具、技能和知识库。工具及技能须已启用且可用；知识库须有可用的发布版本，系统检索也须开启。
4. 保存并验证。点“保存”，用消息模拟检查回复依据和工具结果，再用测试客户验证实际投递。调用失败或结果不明确时，应人工核实业务状态。

新建 Agent 默认温度为 0.3、最大输出 1000 Token、模型请求轮次与工具调用次数各 3、运行时限 20 秒、上下文预算 150000 字符、单工具结果预算 6000 字符，思考模式为高（high）。已有配置保留原值；技能加载和资源读取也计入工具调用次数，复杂任务超出上限时先检查执行详情，再调整。

HTTP 工具：按三步配置业务接口

从“☰ → 插件管理 → 模型工具”打开“模型工具管理”，添加 HTTP 工具。工具目录供全应用管理，各店铺通过关联决定能否使用；工具名称和说明应准确描述它能完成的业务。

1. 基本信息：填写工具名称、用途、HTTP/HTTPS 请求地址、方法及接口要求的鉴权。当前外部工具面向公网地址，不支持本机或内网地址。
2. 请求参数：定义参数类型、说明和必填项，指定由 AI 提供、固定配置或客户／店铺上下文提供。客户与店铺身份优先使用上下文来源。
3. 返回结果：选择允许交给 Agent 的字段并填写含义，避免把接口完整响应中无关或敏感字段全部交给模型。保存后回店铺关联。

查看 HTTP 工具配置与请求测试示例

MCP 工具：连接服务，再选择工具

添加远程 HTTP MCP 服务，填写服务地址与鉴权，确认服务使用权限后连接并发现工具，再选择需要管理的工具，检查参数与返回字段，保存并关联店铺。当前不支持本地 stdio 服务或本机／内网 MCP 地址。发现工具只是读取工具定义，不代表执行了业务操作。

查看 MCP 服务连接示例

规则里的“调用 API”属于另一条执行路径，不受上述 Agent 预览限制代替保护。Agent 能否访问接口、接口是否实际成功、客户是否收到回复，是三个需要分别核对的结果。

模型技能：导入业务指导，再关联店铺

入口：☰ → 插件管理 → 模型技能；或店铺设置 → Agent配置 → 管理技能

技能用于保存可复用的客服处理步骤和参考资料；工具用于请求业务接口；知识库用于检索已发布内容。当前技能支持文本指导和包内 UTF-8 文本参考资料，不执行脚本、不安装依赖，也不解析图片、PDF 等二进制资源。技能中声明的工具或依赖不会自动获得执行权限。

1. 准备目录。选择直接包含 SKILL.md 的技能目录，或其直接子目录分别包含技能的集合目录。SKILL.md 须以 YAML 元数据开头，包含 name、description 和非空正文；名称须与目录名一致，只用小写字母、数字和单连字符，最长 64 字符。参考资料随目录一起导入。
2. 导入并检查。点“导入技能”选择目录，查看每个技能的导入结果；新导入技能默认未启用。选中一行，在右侧检查说明、正文、资源和依赖提示。
3. 启用并关联。在技能行点“启用”并确认；回到店铺“Agent配置”页，勾选对应技能，点“保存”。同时确认已开启本店铺 Agent 并配置好独立模型。
4. 模拟验证。输入符合技能说明的问题，在调试信息中查看“技能加载与资源读取”。Agent 先看到名称和说明，再按问题加载正文及所需资源；关联不保证每次调用，也不等于已经用于回答。

修改技能：点“打开”进入智答管理的技能目录，编辑并保存文件后，回到管理窗口点“重载技能”；“查询”只筛选列表。点“更新”可从外部目录导入同名新内容，保留原有启停状态和店铺关联；需要更名时作为新技能导入。已开始的生成使用其固定内容版本，后续生成使用重载后的版本。

停用技能后不再允许后续调用；删除前须先解除所有店铺关联，可点“查看关联店铺”定位。历史引用版本会保留。技能目录缺失、文本无效或资源不可用时，检查“不可用”原因，修复后重载或重新导入，再验证。

技能包最多 200 个文件、总计 16 MiB，单个文本最多 256 KiB，目录层级最多 8 层；不允许符号链接或目录联接。正文过长仍可能超过 Agent 的结果或上下文预算，此时请精简正文，将细节拆成参考资料。整机 .zhidabak 备份包含技能资产；单店铺 ZIP 配置包不携带技能资产，导入后须重新导入并关联技能。

08 / 资料

维护商品资料与快捷短语

商品管理：给 AI 准确的商品参考

入口：☰ → 商品管理

选择店铺，点“新增商品”，填写商品标题、商品链接、详情、主图，以及规格名称和规格值。规格值可包含名称、价格、描述和图片。确认商品及需要使用的规格已启用后保存。

快捷短语：人工接待时直接使用

入口：☰ → 快捷短语，或控制台 → 管理短语

选择店铺，点“新增”，填写名称、文本、使用场景和可选图片，并按需要分组。列表支持编辑、删除和拖动排序。快捷短语也可作为 AI 的话术参考。

Alt + X 快捷短语弹窗与店铺变量

先将光标放到目标输入框，按默认快捷键 Alt + X 打开弹窗，再点击短语。弹窗默认“立刻发送”开启；只想填入时，在“系统设置 → 快捷键”取消“快捷短语是否立刻发送”，并核对发送键是 Enter 还是 Shift + Enter。可设置短语是否跟随店铺。

常用联系方式、服务时间等可在“店铺设置 → 变量管理”统一维护。用编辑框的变量按钮插入系统变量或 {变量名}，先保存店铺设置再测试实际替换结果。

查看快捷短语弹窗与变量管理

09 / 知识库

让 AI 使用你的店铺知识

适合放入发货说明、售后政策、商品问答和活动规则。可以让多个店铺关联公共知识库，也可以为各店铺分别建立专用知识库。

1. 建库。打开“☰ → 本地知识 → 知识库 → 新增”。填写名称，按资料选择 FAQ 问答、文档或混合类型。
2. 维护内容。打开“本地知识 → 文档管理”，选择目标知识库，新增条目或导入文件。FAQ 填标准问题与答案，文档填说明正文；分类管理可先建立资料分类。
3. 预览导入。支持 Markdown、TXT、CSV FAQ、文字型 PDF、DOCX 和 XLSX，也可粘贴文本。先点“预览”，检查拆分内容和解析提示，再选择“跳过重复”或“复制为新知识”并导入。扫描 PDF、加密文档、旧版 DOC/XLS 及含宏的 Office 文件不支持；Excel 公式只读取已保存的计算结果。
4. 审核并发布。检查条目状态、有效期和内容，将要使用的条目设为已审核；回到知识库管理点“发布”，确认出现发布版本。
5. 启用系统检索。进入“系统设置 → 知识库”，将“知识库使用模式”设为“关键词检索知识库”，点“确定”。首次使用无需配置向量接口；需要语义检索时，再选择“关键词 + 语义检索”。
6. 关联店铺。进入“店铺设置 → Agent配置”，向下滚动并勾选需要的知识库，关联后自动启用本店铺检索。配置并开启 Agent，保存。旧 Coze 配置可继续使用兼容链路；当前 AI 配置页不能新建 Coze。
7. 检查命中。用“本地知识 → 检索调试”测试典型问题，查看命中片段和 Prompt 预览，再用消息模拟检查实际回答。

查看文档管理、系统开关与检索调试示例

需要语义检索时，再配置向量接口

“知识库使用模式”提供不使用知识库、关键词检索知识库、关键词 + 语义检索三个选项。关键词检索使用 BM25；需要语义检索时选择第三项，填写完整 Embedding 接口地址、密钥、模型及高级设置中的维度。可先点“测试连接”，确认后保存并发布知识库或“重建向量”。更换模型或维度后也需重建。云端向量接口会接收知识文本或查询文本，与聊天 AI 配置独立。

查看知识库高级设置与历史清理说明

发现回答不准确时，可从消息站的“知识反馈”或消息记录的“反馈不准确”填写正确答案；在“本地知识 → 纠错反馈”中处理反馈，生成知识草稿、审核并发布，再重测。“标记发布”只更新反馈状态，不代替知识库发布。在“发布版本管理”中核对当前版本与发布历史。

查看知识纠错与发布版本

10 / 验证

先在消息模拟中验证回复

入口：☰ → 消息模拟

1. 选择目标店铺；需要验证商品问题时选择模拟商品。
2. 输入客户问题，点“发送消息”，或按 Enter；Shift + Enter 换行。
3. 查看回复和右侧调试信息：来源、匹配规则、AI Provider、耗时、上下文和提示词详情。
4. 连续追问测试对话上下文；测试另一位客户的独立场景前点“清空对话”。

展开“模拟上下文”可填写客户标签、订单统计、订单明细和商品等。若填写“本轮客户消息列表”，每行一条，它会覆盖主输入框；高级 JSON 覆盖用于需要精确复现上下文的场景。

至少验证：一条规则命中的消息、一条未命中的消息、连续追问、一个需要人工处理的问题，以及 AI 关闭时的默认回复。模拟正常后，再在千牛中验证实际读取、草稿和发送状态。

11 / 接待

查看消息站，及时接管对话

每天开始时，确认千牛已登录、店铺连接正常，检查当前模式与免打扰时段。主窗口底部显示正在处理的店铺、客户、客服、客户消息、回复及关键动作。

• 看状态：结合已发送、待人工等状态判断下一步；生成成功与发送成功分别检查。
• 看原因：点“消息详情”图标，核对客户问题、回复依据和异常；AI 内容有误时提交知识反馈。
• 回到客户：点“跳转对话”图标（可用时）或在千牛手动打开对应客户，处理投诉、退款争议等问题。

临时中断与较长时间人工处理

输入框里已有人工草稿、客户身份无法确认、上下文不可靠或安全检查未通过时，智答会保留现场并提示人工处理。先核对和处理草稿，再恢复自动接待。

“转人工”表示记录并提示人工介入，可附带安抚文案；不会保证把会话自动分配给千牛中的另一个客服账号。

12 / 浏览器接待

闲鱼账号，在智答接待台中处理

闲鱼使用独立浏览器账号环境，与千牛的桌面接待分开运行，目前为实验功能。一个账号对应独立登录环境；账号是否登录、会话是否可操作和回复是否送达，都以实际状态为准。

入口：店铺管理添加闲鱼店铺 → 账号登录与绑定 → 智答接待台

1. 在店铺管理添加并启用闲鱼店铺，先配置回复策略、模型及默认模式。
2. 启动该账号接待，按提示在管理的浏览器中登录，并确认绑定的是目标账号。后续继续使用该账号的浏览器环境；登录失效时按提示重新登录。
3. 打开“智答接待台”，选择顶部账号页签，确认登录、运行状态和模式。用左侧全部／未读／人工筛选、客户搜索或日期查找会话。
4. 选择客户，查看时间线、订单或商品上下文以及生成的回复。选择接待台中的会话不会强制切换平台网页中的会话。

编辑草稿、人工发送与失败处理

在回复框编辑、保存或清空草稿，会进入当前会话的人工接管状态；切换账号或会话后仍保留接管。当前版本不会因为你发完一条消息就自动解除接管，请持续关注“人工接管”标记。

接待台中的快捷短语用于填入文本草稿，检查后再发送。点“发送回复”或按 Enter 提交，Shift + Enter 换行。“已写入浏览器发送队列”仅表示提交成功，之后继续观察已发送、失败等状态，并核对平台实际对话。

提示“会话已更新”时，重新检查最新消息与草稿再发送。已明确失败的任务可按界面提供的“重试”操作处理；发送结果未知时先核对平台对话，避免重复发送。已接收的图片可点击查看，当前浏览器发送以文本为主，不能把千牛的图片发送能力直接套用到此通道。

移除会话用于整理本地会话列表，不代表删除平台聊天记录。账号需要换绑或删除时，先在店铺管理按提示解绑；整机数据备份不包含浏览器 Cookie 或登录状态。

13 / 复盘

查记录、看报表、做效果评测

消息记录：追踪一次处理发生了什么

入口：☰ → 消息记录

选择“端到端消息”查看读取与投递结果，选择“大模型消息”查看 AI 调用，选择“Agent消息”筛选 Agent 处理记录；按店铺、客户昵称和关键字搜索。点“查看详情”检查完整消息、回复、上下文或 AI 请求信息。需要长期验证的案例可点“加入评测集”，内容错误可点“反馈不准确”。

Agent 详情：核对模型、工具与技能执行步骤

在消息记录中选择“Agent消息”，找到目标记录并点“Agent详情”。窗口按记录时间展示模型调用、工具调用、技能加载、参考资源读取及模型请求中的技能范围，包含状态、耗时、错误和已保存的请求／响应快照；点“复制全部”可复制排查信息。历史消息没有关联执行记录时会提示无法展示步骤。

消息模拟右侧调试区也会显示本轮技能与知识使用情况。排查“没有按技能回答”时，先确认启用与关联，再看是否加载、预算是否足够、内容是否进入模型请求。分享详情前检查并去除客户资料或凭据。

统计报表：比较店铺和日期

入口：☰ → 统计报表

按业务日期和店铺搜索，查看读取、处理、发送、接待、转人工、响应时间与知识检索等指标；点“指标趋势”观察变化。业务日期采用中国标准时间。多个客户消息可能合并处理，一次处理也可能产生多条回复，因此各项计数不要求一一相等。

查看统计报表示例

效果评测：修改配置后，重复检查同一批题目

入口：☰ → 效果评测 → 评测题目 / 评测记录

1. 在“评测题目”中选择店铺，新增客户问题、参考回复和需要的上下文；也可从消息记录加入。
2. 点“启动评测”，确认名称和备注后启动。任务在后台运行，去“评测记录”查看进度和结果。
3. 点“查看详情”，逐题核对实际回复、来源和错误，标为正确或错误，并记录错误原因。
4. 调整策略、提示词或知识库后再次评测，用“指标趋势”比较多次结果；比较时尽量保持题目与标注标准一致。

查看评测题目与指标趋势示例

查看评测详情与人工标注

日志、审计与诊断：按问题选择入口

入口：系统设置 → 界面外观 → 勾选“托盘快捷菜单显示开发工具”并确定；再右键 Windows 系统托盘中的智答图标 → 开发工具

业务回复先查消息记录；启动、连接、服务异常在托盘“开发工具 → 应用日志”中按时间和级别定位；自动化操作及安全事件查“开发工具 → 审计管理”。向支持人员反馈时提供发生时间、店铺、操作与脱敏后的提示，不要公开密钥或客户资料。

OCR识别可手动选择图片或截取区域识别文字；界面探查用于查看目标窗口、控件属性、子元素、父元素链及元素 OCR。它们用于诊断和人工查看，不代表千牛接待会自动切换为 OCR 读取；日常使用无需修改控件定位。

查看应用日志、审计和诊断工具

14 / 桌面助手

桌面提醒、迷你模式与桌宠

设置工作提醒

系统设置 → 界面外观 → 启用桌面提醒 → 确定；主窗口铃铛入口 → 桌面提醒

1. 启用后打开提醒管理，点“新增”，填写提醒名称、内容和提醒方式。
2. 选择间隔分钟或指定时刻，并设置星期及生效时段。未设时段时，按选中的星期全天生效；跨午夜时段归属开始的那一天，时间采用中国标准时间。
3. 保存后可单独暂停、恢复、编辑或删除提醒。“重新计时”只重置这条提醒；暂停的提醒仍保持暂停，时段外会等待下一个有效时段。
4. 在“提醒设置”选择仅弹框，或弹框加铃声。间隔提醒在关闭提醒弹窗后开始下一次计时；指定时刻提醒按时间触发。

查看提醒编辑与提醒设置

主窗口最小化、进入迷你模式或收起到托盘时，提醒仍可运行；退出智答后停止。关闭“启用桌面提醒”会暂停并保留配置。锁屏、休眠或调整系统时间后重新建立计时基准，不会连续补发历史提醒。

调整主窗口与桌宠

使用标题栏按钮进入迷你模式、置顶或还原窗口；吸附和店铺跟随可在界面外观设置，默认快捷键为 F2 和 F5。迷你模式和托盘收起只改变显示，接待是否运行仍由店铺模式决定。

在“系统设置 → 界面外观”启用桌面宠物并选择角色。桌宠展示运行状态、消息与提醒，不会替代店铺配置，也不会自行生成或发送客服回复；查看状态时仍以主窗口记录为准。

查看主窗口迷你模式

15 / 维护

系统设置、备份与升级

入口：☰ → 系统设置；修改后点“确定”保存

查看界面外观与通用设置示例

查看快捷键与快捷短语发送选项

备份与恢复

入口：系统设置 → 备份恢复

定期备份，尤其在批量修改、导入或升级前。选择“仅配置数据”或“配置数据 + 消息明细数据”，点“快速备份”保存 .zhidabak 文件。

两种模式都不备份审计库和统计库，也不备份浏览器 Profile、Cookie 或登录状态。恢复包在覆盖前会校验数据库、资源完整性和关联；缺失、损坏或技能历史版本冲突会被拒绝。恢复失败时使用回滚链路保留现场；不要绕过校验手工覆盖文件。恢复前先将店铺离线并备份现有数据，再点“快速恢复”选择备份包，核对覆盖提示；恢复完成后重启智答，重新确认账号登录、连接和工作模式。

只迁移一个店铺的配置

在“店铺管理”中点该店铺的“导出”保存 ZIP 配置包，再在目标店铺行点“导入”。选择“原有配置”或独立“Agent配置”域，按需导出、导入；它与整机 .zhidabak 备份用途不同。导入会覆盖目标配置域，请先备份。Agent 配置域迁移时会关闭 Agent、清除模型及工具凭据和技能关联；工具导入为未启用，技能资产不随单店铺配置包迁移。导入后重新填写模型与鉴权、启用并关联工具，单独导入和关联技能，再开启 Agent 验证；原有配置域仍可能包含传统 AI 密钥和业务资料。

数据保留与自动清理

“通用设置 → 数据保留天数”默认 90 天，可选 1～180 天，控制 LLM 会话、审计事件、发送队列及启动指标等历史数据。启动约 5 分钟后首次清理，随后每 3 小时运行；仍在处理或结果未确认的 Agent 操作记录会保留必要关联，不按到期直接删去。

LLM 调用记录的请求原文只保留 15 天，与上述业务保留天数分开；过期后部分详情可能不再显示原文。系统日志和知识库检索日志使用“日志记录 → 日志保留天数”（默认 30 天）。知识库保留当前发布版本及最近 3 个历史版本，被检索、反馈、Agent 或评测引用的旧版本继续保留；超过业务保留期且已无引用的知识文档附件会清理。需要长期排查的记录或附件，请在清理前备份。

本地数据与软件升级

“打开数据目录”可定位本机文件。当前持久数据根目录为 %LOCALAPPDATA%\Zhida\ZhidaAgent，数据库和图片位于其 Data 子目录，日志在 Logs，技能资产在根目录的 Skills。数据保留期和自动清理会影响可查询的历史记录，需要长期保存时提前备份。

在“☰ → 关于我们 → 检查更新”查看更新；有更新时也可使用标题栏的升级按钮。确认升级后软件会下载、退出并重启，建议先暂停接待并备份。在线更新适用于安装版，源码运行或便携目录可能提示不支持。

16 / 排查

常见问题，按现象检查

发生异常时，先按 F3 或将相关店铺切换离线，再检查现场。记录店铺、时间和具体提示，有助于在消息记录和日志中定位。