如何在Agent Space搭建文档检索智能体

在华为云码道 Agent Space 中，用户可以利用自定义智能体配合文件上下文功能，构建一个专注于查找项目文档的助手。这种模式特别适合处理本地的 Markdown 或 TXT 资料，让智能体依据指定范围内的文档回答问题，而非依赖通用的训练数据。

概述

进入 Space 模式后，界面布局清晰划分了功能区域：左侧管理会话历史，中间是智能体对话交互区，右侧工具面板则用于查看文件和资源。搭建文档检索助手的核心，在于将当前打开的项目、负责执行检索任务的自定义智能体，以及对话中明确引用的具体文档三者关联起来。

需要注意的是，这种方法主要利用本地项目文件及即时加载的文件上下文，并不等同于建立了云端向量知识库。智能体是否能完整读取文档、回答是否有据可依，仍需结合当前模型能力和实际运行结果进行人工检查。

Agent Space 界面概览：左侧会话、中间对话、右侧文件面板

关于项目文件夹与文档目录

首先需要在码道 IDE 中准备好待检索的资料。登录 IDE 后，点击左上方的模式切换按钮选择【Space】。在对话面板中，可以通过【选择项目文件夹】下的【打开项目】选项，或者底部提示框的【打开文件夹】入口，加载准备存放资料的目录。

建议将项目统一存放在易于管理的路径，例如 D:\Work\DocSearchDemo，并将需要检索的 Markdown 或 TXT 文件整理到该目录下的 docs 子文件夹中。文件名应直观反映内容用途，如“产品说明.md”或“服务规则.txt”，以便在后续的上下文列表中快速辨认。

在开始配置前，务必先在编辑器中确认文件内容可正常阅读。对于扫描版图片、加密文件或尚未提取正文的格式，不应仅凭扩展名就假设其具备可检索文字；本流程不承诺支持 OCR 或所有复杂文档格式的自动解析。

关于项目文件夹与文档目录

关于【自定义智能体】的角色与工具

接下来需要创建一个专门用于检索的智能体。点击右上角的设置图标，进入官方提供的【智能体】设置页面，点击【创建智能体】。在基础信息中，名称可填写为“文档检索助手”，【作用域】选择【项目级】，【智能体类型】选择【主智能体】，这样便能在当前项目的聊天区直接调用该助手。

在描述栏中，简要说明其职能：“根据本项目文档查找信息并说明依据”。关键在于【提示词】的配置，需加入明确的行为约束，例如：“只依据本次提供的项目文档回答。先查找相关内容，再给出结论及对应文件名、小节；没有找到时说明未找到，不补写文档不存在的信息。只读资料，不修改原文件。”

在【内置工具】部分，配置所需的文件阅读能力，并核对编辑、终端等其他权限是否符合任务需求。提示词仅规定行为逻辑，不能代替工具权限的控制。完成创建后，需在【项目级】页签确认该助手已处于开启状态。

自定义智能体配置：设置名称、作用域及提示词

关于输入框里的【File】和【Folder】

返回聊天区域，点击输入框附近的【智能体】下拉菜单，选择刚才创建的“文档检索助手”。随后在输入框中输入 # 符号，从弹出的上下文菜单中选择【Folder】，并选中项目中的 docs 文件夹。这一步操作将本次检索的范围明确限定在该文件夹内。

如果只需查询某一份特定资料，可改选【File】，再从列表中选择目标文件；若需涉及多个分散文件，可按需重复添加。添加成功后，输入框中会显示相应的引用标签。点击这些引用标签，可以快速定位到目标文件或在资源管理器中打开对应目录，便于确认选取范围无误。

在输入框中使用 # 号引用 Folder 或 File

设定好范围后，提出具体问题。例如，要求查找资料中关于售后申请的说明，并列出需要提交的具体信息。应避免发出“读一下全部文件”这类模糊指令，而是明确交代需要查找的关键点。

关于回答与原文的对应检查

智能体生成回答后，必须进行依据核查。选择一道你已知文档中确有答案的问题进行测试，将回答中提到的文件名、小节标题和结论与原文逐一对照。重点检查它是否找到了正确内容、是否遗漏了关键限制条件，以及是否错误地混入了其他文件的规则。助手回复的流畅度并不能替代准确性验证。

此外，还可以询问一个资料中确实没有答案的问题，观察智能体是否按照提示词要求，如实说明缺乏依据。如果发现回答范围过大或不够精准，可以回到输入框，将引用范围从文件夹缩小为单个 File，再次进行检查。保留这个项目配置和项目级智能体，后续在同一范围内补充新资料时，只需按实际问题添加相应的文件上下文即可继续高效使用。

关于回答与原文的对应检查