插件

先区分三类资源

资源出现在列表中只表示“可被发现”，不代表已连接、已授权或当前项目可用。

发现并检查资源

1. 打开资源工作区，按名称搜索目标 Skill、插件或 MCP。
2. 查看描述、版本、来源、适用平台和所需权限。
3. 确认作用范围是个人、项目还是全局，避免误以为所有项目都会继承。
4. 阅读输入参数和数据访问范围，再决定是否连接。

连接与授权

点击“连接”或“配置”后按页面要求填写。敏感字段只在受保护的配置入口填写，不要粘贴到会话、需求、日志或截图中。连接完成后执行一次低影响探测，例如读取服务状态或列出只读资源。

在会话中调用

在会话中明确资源名称、输入范围和期望结果。工具准备写入外部系统时，检查目标、参数和审批提示；只读探测通过不等于写入一定成功。

使用业务 Agent

业务 Agent 是面向特定业务任务的专业能力入口，例如生成调研问卷、整理业务资料或调用已配置的业务服务。使用时先说明业务目标、项目范围和交付格式，再确认当前会话选择的业务 Agent 与输入参数。

1. 在会话中说明要完成的业务目标，不要把上一轮会话的路径或范围当成当前任务输入。
2. 检查业务 Agent 名称、项目和请求参数，确认没有包含客户隐私、Token 或无关文件。
3. 需要调用外部服务时，先阅读目标、参数和审批提示；生成结果后核对来源、输出路径和业务约束。
4. 接口失败时区分认证、网络、参数校验和业务 Agent 自身错误，确认没有产生部分结果后再重试。

使用知识库

知识库用于检索制度、流程、术语和项目资料，为会话提供可追溯的上下文。选择知识库后输入完整业务对象和限定条件，先查看命中的标题、摘要、版本和来源，再要求回答标明引用。

知识库没有结果、没有权限、服务不可达和回答没有引用是四种不同现象。不要把未经确认的客户资料或凭据上传到知识库；发现资料过期时记录文档名称、版本、问题位置和建议来源，交给维护者处理。

修改、停用与故障处理

修改配置后重新探测并记录生效时间。停用前确认没有自动化任务或正在执行的会话依赖它。连接失败时按“凭据 → 网络 → 作用范围 → 工具参数”的顺序排查，不要同时修改多个配置。

完成检查清单

• 资源来源、版本和权限已确认。
• 连接后完成一次低影响探测。
• 会话调用范围和审批结果可追溯。
• 停用前已检查自动化和其他依赖。

知识库能解决什么问题

知识库适合查找经过整理的制度、流程、术语和项目经验。它提供检索上下文，不等于自动替你确认业务事实；回答仍需要回看引用资料和适用范围。

在会话中使用知识库

1. 打开知识库面板，确认当前项目可用的知识库名称和更新时间。
2. 选择与问题相关的知识库，输入包含业务对象、流程节点和限定条件的查询。
3. 先查看检索到的标题、摘要和来源，再把结果加入会话上下文。
4. 在提问中要求助手列出引用来源，并将没有依据的结论标记为“待确认”。

查询“采购审批”通常比只输入“审批”更容易得到可用结果；需要限定时间或组织时，把条件写进查询。

判断结果是否可用

• 来源属于当前项目或组织允许的资料范围。
• 文档版本和更新时间满足本次任务要求。
• 检索片段包含完整条件，没有被截断或脱离上下文。
• 多份资料冲突时，要求助手列出冲突并交给业务负责人确认。

资料更新与权限

知识库内容由管理员或授权维护者更新。普通用户发现过期资料时，记录文档名称、版本、问题位置和建议来源，不要自行上传未经批准的客户资料。

连接失败排查

先确认知识库是否启用，再查看探测结果和错误时间。区分“没有权限”“服务不可达”“没有匹配结果”和“回答没有引用”；它们的处理路径不同。持续失败时向管理员提供知识库名称、查询关键词、错误码和请求时间。