Brazosd 是一个云智能体平台。云智能体运行在云上，并且有自己的云电脑，不会干扰用户正在使用的电脑。行业专家可以通过发布智能体赚取收益。智能体只提供会话服务，不会暴露背后的核心 SOP。普通用户则可以直接使用行业专家做好的、能够落地执行具体工作的智能体，不需要先学习复杂的概念。
当一项任务足够明确时，就可以开发专门完成这项任务的智能体。例如识别发票，再把数据按照确定的方式汇总；识别错题，然后找到相关的真题等。
本系列文章将介绍如何在 Brazosd 上针对特定业务开发智能体。我们会以发票识别和错题检索为例，逐步介绍 Brazosd 提供的基础设施。本文先介绍其中最基础的一项：如何使用 Brazosd 云盘构建知识库。
Brazosd 云盘
云盘是智能体和用户之间交换文件的媒介。Brazosd 里的云盘分为以下几类：
组织云盘：整个组织的所有成员都能看到。组织内成员可以通过组织云盘分享文件。
用户云盘：每个用户自己的云盘。只有你和服务于你的智能体可以看到和管理其中的文件。
智能体云盘：智能体自己的云盘，只属于这个智能体。组织外的用户无法查看其中的内容。当智能体服务于组织外用户时，它可以读取智能体云盘里的内容，但不能写入、删除或编辑文件。只有服务于创建它的组织内用户时，它才能修改其中的文件。智能体云盘一般用于存放业务相关的内容，例如知识库等。
频道云盘：只有频道内成员可以访问，一般用于隔离不同的项目。
会话云盘：每个会话都有一个持久云盘，用于保存会话附件和智能体交付的成果。会话过期或手动归档后，文件仍保留在原路径，由你自行管理删除，无需转存到其他云盘。归档会销毁用于计算的工作沙箱，因此需要保留的成果应先保存到云盘。
智能体为用户工作时，使用的是这位用户对各类云盘的权限。智能体只是代替用户工作，并不会获得一套额外的、更高的权限。一般来说，用户能读取或修改的云盘，智能体也能进行同样的操作；用户不能访问的云盘，智能体同样不能访问。唯一的特殊情况是智能体云盘：当智能体服务于组织外用户时，它仍然可以读取自己的智能体云盘，但不能修改其中的内容。
使用云盘构建知识库
Brazosd 只提供云盘，并没有像 IMA 这样预先定义好的“知识库”功能。所谓知识库，其实就是文件 + 索引。索引如何组织，并没有适合所有业务的通用解法。我们应该根据具体需求，设计对应的文件和索引结构。
以“识别错题，然后找到相关的真题”为例，我们需要一个试卷“知识库”来存放试卷。本质上，就是把试卷按照年份和地区放进对应的文件夹，再建立索引文件，以便根据知识点找到试卷里的题目。
以英语科目为例，我们可以按照知识点建立索引文件。例如，在索引目录里创建一个“定语从句.txt”文件。这个文件记录哪些试卷里的哪些题目和“定语从句”相关，以及这些试卷存放在哪个目录下。
这样，当智能体需要找到和“定语从句”相关的真题时，只要阅读这个索引文件，就能找到对应的题目。索引文件还可以记录题目的难度、出现频率等信息，作为筛选条件。
剩下的，就是告诉智能体如何维护和使用这个知识库。下面是一段示例提示词：
# 试卷知识库
知识库位于你的智能体云盘中，包含两类文件：试卷和索引。例如：
试卷
- 2026
- 广东省
- 惠州市一调英语.docx
索引
- 定语从句.txt
- 非谓语动词.txt
索引用来找到对应的试卷。每个索引文件对应一个知识点，格式如下：
--------------------------------------------------
试卷/2026/广东省/惠州市一调英语.docx 完形填空第12题 过去分词作后置定语 难度7/10
...
--------------------------------------------------
每一行记录一道真题所在的试卷、题号、具体考点和难度，以便后续检索。
# 知识点
知识点分为：名词、冠词、代词、形容词、副词、介词、动词时态、被动语态、情态动词、虚拟语气、非谓语动词、定语从句、名词性从句、主语从句、宾语从句、表语从句、同位语从句、状语从句、主谓一致、倒装句、强调句、省略句、There be 句型、感叹句、祈使句、反意疑问句、独立主格、with 复合结构、比较级与最高级、构词法、固定搭配。
# 归档试卷
当收到用户发送的试卷时，执行以下操作：
1. 将试卷放到对应的年份和地区目录。例如：试卷/2026/湖北省/省一调英语.docx
2. 按照上一段列出的知识点，识别试卷中每道题涉及的知识点，并更新对应的索引文件
# 检索真题
当收到用户发来的题目时，先提取相关的知识点，再到智能体云盘的索引目录里找到对应的知识点索引。根据用户需求，筛选出相关的真题。这段提示词告诉了智能体知识库如何组织、如何维护，以及如何使用。把它作为智能体的职责提示词后，当智能体收到新试卷时，就会自动归档试卷并更新索引；当智能体收到题目时，就会根据索引检索相关真题。