Agent Development

Brazosd is an agent platform that provides many agent capabilities and will provide more infrastructure over time. Users can build powerful agents by using the capabilities provided by the platform.

Cloud Drive

Agents can use Brazosd cloud drives. Cloud drives currently have several scopes: channel drive, session drive, agent drive, and user drive.

A channel drive is shared by all members in a channel. When an agent is a member of a channel, it can access that channel's drive.

A session drive is isolated per session. Files sent by users and agents flow through the session drive, so it is suitable for files that are directly related to a single session context.

An agent drive belongs exclusively to an agent within an organization. It is suitable for business materials, generated artifacts, and reusable context that the agent uses over time.

A user drive belongs to the user. Agents can operate session drives and channel drives, but they cannot operate user drives.

The brazosd_ctrl Tool

The brazosd_ctrl tool allows an agent to access all Brazosd features using the user's identity.

With this tool, an agent can operate the platform itself as a business system, such as reading session information, handling channel context, managing platform resources, or composing other platform capabilities into its own business workflow.

Secure Variables

Agents use secure variables through special character forms. When the Brazosd kernel intercepts tool calls, it translates those special characters into the corresponding variables.

Secure variables are stored in encrypted storage. After a variable value is set, the plaintext value cannot be viewed in Brazosd.

If an agent wants to request sensitive information such as a verification code or password, it can start a built-in tool call and ask the user to fill it in. After the user fills it in, Brazosd can provide that information as a secure variable for later tool calls instead of exposing plaintext to the agent or to the large model context.

Agent Memory

Developing general-purpose agents is not currently a goal of Brazosd, and Brazosd does not currently provide an officially supported agent memory mechanism.

Brazosd is designed as a platform for building enterprise-grade expert agents, and it favors developing agents for specific business domains. Users can build business-specific memory modules by letting agents use the agent drive and by using brazosd_ctrl to access session information.

Sandbox

Each session has an isolated virtual-machine-based work sandbox. After the work sandbox has not been used for a period of time, it enters sleep mode, and only a small amount is charged for the storage space already used.

To fully destroy a sandbox, the session must be archived. Archived sessions cannot be continued with follow-up questions.

Sandboxes are created lazily. This means that after a new session is created, if no sandbox command is run, the sandbox will not be created. For short sessions awakened by events, avoiding sandbox creation can reduce task duration and storage management cost.

Devices

Agents can operate connected devices through the Brazosd encrypted tunnel.

Agents can operate multiple devices and sandboxes at the same time. Brazosd will gradually support more smart devices such as Android, macOS, and iOS in future versions, and will provide an RPA framework for GUI devices.

Device Background Tasks

Agents can use the exec_command and write_stdin commands to open PTY processes on devices and run background tasks.

If a device does not support PTY, such as older versions of Windows, the agent can only use shell_command to run foreground tasks.

Sandbox background tasks will be supported in future versions. Currently, only devices support background tasks managed by the device connector.