| Name | Type | Description |
|---|---|---|
account_url* | str | Account URL, e.g.
|
container_name* | str | Target blob container name. |
prefix | str | None | Default: NoneOptional key namespace prefix within the container. Scoping each agent/session to a prefix isolates their files. |
credential | _SDK_CREDENTIAL_TYPE | Default: None |
Azure Blob Storage filesystem backend for Deep Agents.
Implements BackendProtocol using Azure Blob Storage as the persistence
layer. File content is stored in blob bodies (UTF-8 text, or raw bytes for
binary uploads). Directories are synthesized on the fly from blob key
prefixes (no directory marker blobs).
Two operations destroy data already in the container, both reachable as
agent tools: :meth:write replaces an existing file in full, and
:meth:delete removes a path plus everything nested under it. Deleting
"/" empties the configured prefix namespace -- or, with no
prefix, the entire container. Set a prefix and enable container
soft-delete/versioning to bound the blast radius.
The underlying Azure SDK clients are created lazily on first use and
cached; call :meth:close/:meth:aclose (or use the backend as a
context manager) to release them. Because the cached async client is
bound to the event loop it was first used on, drive a given backend
instance's async methods from a single event loop.
Credential to authenticate with. If None,
DefaultAzureCredential is used.
