Skip to main content

Usage

DeepAgent supports three types of storage backends for the virtual filesystem: ephemeral (StateBackend), persistent (MemoryBackend), and hybrid routing (CompositeBackend).

Backend Types

StateBackend (Ephemeral)

In-memory storage that persists only during the agent session. Use when:
  • Temporary working files
  • No persistence needed
  • Fast operations required

MemoryBackend (Persistent)

Persistent storage that survives process restarts. Use when:
  • Long-term memory needed
  • Files must persist across sessions
  • Important data storage

CompositeBackend (Hybrid)

Route different paths to different backends. Use when:
  • Mix ephemeral and persistent storage
  • Different storage strategies for different paths
  • Optimize storage based on file importance

Key Points

  • StateBackend: Fast, ephemeral, no persistence
  • MemoryBackend: Persistent, survives restarts, requires Storage
  • CompositeBackend: Route by path, mix strategies
  • Default backend is StateBackend if not specified