文档

智能体开发

Brazosd 是一个智能体平台，提供很多智能体能力，未来也会提供更多的基础设施。用户可以使用平台能力构建强大的智能体。

云盘

智能体可以使用 Brazosd 云盘。目前云盘有几个 scope：组织云盘、频道云盘、会话云盘和用户云盘。

组织云盘在组织内共享。智能体专属的业务资料、生成产物和可复用上下文位于 @brazosd://org.drive/<org-id>/agents/<agent-id>/。

频道云盘是频道内所有成员共享的云盘。智能体作为频道成员时，可以访问对应频道的频道云盘。

会话云盘是每个会话独立的持久文件空间，用于保存附件和交付成果。智能体默认将成果保存到当前会话云盘，也可以按用户要求保存到其他位置。会话过期或手动归档不会删除云盘文件，由用户自行管理删除；归档仍会销毁工作沙箱。分支会话使用新的空云盘，已有文件仍可通过原会话路径按用户权限访问。

用户云盘属于当前用户。智能体会话继承当前用户的云盘权限，可以操作该用户的用户云盘、属于该用户的会话云盘、组织云盘，以及用户所在频道的频道云盘。

智能体工厂 repo 是特殊资源。当前运行的智能体可以读取自己的 repo，但只有在服务创建该 repo 的组织时才能写入。组织招募第三方智能体后，该智能体自己的 repo 对它只读，消费方用户也不能直接访问；这个例外不影响会话用户访问由其组织创建的其他智能体 repo。

brazosd_ctrl 工具可以让智能体使用用户的身份访问 Brazosd 的所有功能。

它属于每个智能体的默认工具集。/openapi.yaml 列出的 API operation path 都挂载在 /api/v1 下；例如其中的 /agents 应以 /api/v1/agents 调用。

通过这个工具，智能体可以把平台本身作为业务系统来操作，例如读取会话信息、处理频道上下文、管理平台资源，或者把其他平台能力组合进自己的业务流程中。

智能体以特殊字符的形式使用安全变量。Brazosd 内核拦截工具调用时，会把这些特殊字符翻译成对应的变量。

安全变量存储在加密存储中。设置了变量的值后，无法在 Brazosd 中看到明文值。

如果智能体想要请求使用验证码、密码等敏感信息，可以通过发起内置工具调用，请求用户填写。用户填写后，Brazosd 可以把这些信息作为安全变量交给后续工具调用使用，而不是把明文暴露给智能体或大模型上下文。

开发通用智能体暂时不是 Brazosd 的目标，Brazosd 暂时没有官方支持的 Agent 记忆机制。

Brazosd 旨在提供一个打造企业级专家智能体的平台，倾向于针对业务进行开发智能体。用户可以让智能体借助智能体云盘，以及通过 brazosd_ctrl 访问会话信息的方式，针对业务开发记忆模块。

每个会话都有一个隔离的、基于虚拟机的工作沙箱。工作沙箱一段时间没有使用后会进行休眠，此时只会对已使用的存储空间进行少量计费。

如果需要彻底销毁沙箱，需要对会话进行归档。归档后的会话无法继续追问。

沙箱是懒创建的，意思是新建会话后，如果没有运行沙箱指令，沙箱不会被创建。对于事件唤醒的短会话，可以通过避免创建沙箱来节省任务时长和存储管理成本。

智能体可以通过 Brazosd 加密隧道操作已经建立连接的设备。

智能体可以同时操作多个设备和沙箱。Brazosd 会在后续版本迭代中逐步支持 Android、macOS、iOS 等更多智能设备，并为 GUI 设备提供 RPA 框架。

智能体可以通过 exec_command 和 write_stdin 指令在设备上打开 PTY 进程，运行后台任务。