微赞知识库
接入检查
按工具名后缀 ai_kb_* 发现当前环境的工具，不写死 MCP 服务名或前缀。
- 所需工具可用：直接执行对应流程。
- 未发现工具：提示“请先在所用 AI 工具的 MCP 设置中接入微赞企业知识库服务，服务地址与认证方式向企业管理员获取；接入后可继续查询或上传。”已配置时检查是否启用、连接正常及当前会话是否已加载工具，不重复安装。
- 认证失败提示重新认证；权限不足提示申请目标知识团队权限，不误报为未安装。
调用时以实际工具 schema 为准；字段、格式白名单及返回结构按需查阅 references/tools.md。MCP 传结构化参数，不手工拼接底层 HTTP URL；ID 类型按当前 schema 适配。
场景分流（MANDATORY）
| 场景 | 工具与流程 |
|---|---|
| 查询知识、功能用法、业务规则 | ai_kb_search → 根据回答及引用作答 |
| 查找文档、读取全文 | 已有 docId 直接 ai_kb_document_detail；否则先检索定位 |
| 查看知识团队或标签 | ai_kb_team_list／ai_kb_tag_list |
| 上传 Markdown 或纯文本 | 完整正文 → ai_kb_review_submit |
| 正文含本地图片或附件 | ai_kb_get_upload_urls → PUT 附件 → 正文引用最终 url → 文本送审 |
| 上传 Word/PDF/PPT/Excel 等文件 | ai_kb_get_upload_urls → PUT 原文件 → ai_kb_review_submit_file → 查询解析状态 |
| 更新已有文档 | 读取当前全文 → 合并修改 → ai_kb_review_submit |
| 查询文件解析及审核状态 | ai_kb_parse_result {taskNo} |
查询
question传用户问题原文；未指定团队时搜索全部可读团队，指定团队名时先查询并匹配真实 ID。- 多轮问答沿用当前会话的
sessionId；无法取得时按 schema 省略，不编造。 - 回答附返回的来源标题及文档 ID／链接；需要全文时读取详情，不以检索摘要代替。
answerType=NO_ANSWER时明确未检索到依据，不编造答案。知识库不提供实时订单、余额等经营数据，也不保证检索结果为全量文档目录。
上传与更新
- 确定团队：查询团队，只使用
myPermission.permissions含EDIT的可写项。用户指定则精确匹配；未指定且仅一条可写团队则直接使用，多条请用户选择，无可写项则说明权限不足。 - 匹配标签：查询所选团队有效标签，仅选与文档核心主题直接对应的标签，无明确匹配则不传，不创建标签。
- 提交完整内容：保留完整正文，不截断或改写业务规则。标题优先用户指定，其次首个一级标题或文件名。
- 新建文本：{teamId, title, content, tagIds?, changeNote?}。
- 更新文本：先读当前正文，再提交{docId, content, tagIds?, changeNote?}，不传新建字段。不得按同名自动覆盖；工具会清空草稿及编辑占用，存在未授权替换的草稿或他人占用时先说明影响并确认。
- 文件送审：{teamId, title, fileUrl, fileName, tagIds?, changeNote?}。直接上传原文件供服务端解析，无需本地转换；此接口不支持覆盖已有文档。 - 回报结果：文本成功回报审核标识及“已提交人工审核，尚未发布”；文件回报
taskNo与实际解析／审核状态。
本地 .md 默认读取全文后文本送审；内嵌图片作为附件上传，不能把图片送审当作 OCR 能力。用户明确要求上传或更新即可执行对应送审，仅查询或整理时不写入。
文件上传与状态
- 链接单次最多领取 20 个，
uploadUrl有效期 10 分钟。按实际 MIME 用 PUT 上传并确认 HTTP 200 后，使用返回的最终url，不能传临时上传链接或任意网页地址。不要使用已下线的 base64 上传工具。 PENDING/PARSING：解析中，间隔 5–10 秒查询，最多 6 次仍未完成则回报任务号与当前状态，留待继续查询。SUCCESS + reviewStatus=PENDING：解析成功、待人工审核，无需再次送审；FAILED/PARSE_FAILED：报告失败原因；APPROVED/REJECTED：按实际状态回报通过／退回，不承诺已同步检索。- 解析查询仅接受文件任务的
taskNo；文本审核标识不能当作解析任务号。 - 按业务
success判断结果，不只看 HTTP 200。重复提审报错或写入超时、结果不确定时先核实状态，不盲目重试。保留实际错误码与原因，便于处理。
