文档

智能体开发

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

云盘

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

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

会话云盘是每个会话隔离的云盘。用户和智能体发送文件时，文件都会通过会话云盘流转，因此会话云盘适合存放与单次会话上下文直接相关的文件。

智能体云盘是智能体在该组织下独属于自己的云盘。它适合存放智能体长期使用的业务资料、生成产物和可复用上下文。

用户云盘是属于用户自己的云盘。智能体可以操作会话云盘和频道云盘，但不能操作用户云盘。

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

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

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

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

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

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

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

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

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

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

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

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

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