Struct MemoryConfig 

pub struct MemoryConfig {
    pub backend: MemoryBackendType,
    pub path: Option<String>,
    pub url: Option<String>,
    pub grpc_url: Option<String>,
    pub collection: Option<String>,
    pub dimensions: Option<usize>,
    pub api_key: Option<String>,
    pub embedding_model: Option<String>,
    pub use_server_embeddings: Option<bool>,
    pub prefix: Option<String>,
    pub max_entries: Option<usize>,
    pub ttl_seconds: Option<i64>,
}

Configuration for memory backends.

This struct can be used at the mesh level (shared by all agents) or at the agent level (per-agent configuration).

Examples

InMemory (default)

[memory]
backend = "inmemory"
max_entries = 500
ttl_seconds = 3600

SQLite (persistent)

[memory]
backend = "sqlite"
path = "./data/knowledge.db"

Redis (distributed)

[memory]
backend = "redis"
url = "redis://localhost:6379"
prefix = "myapp"
ttl_seconds = 7200

Qdrant (vector database)

[memory]
backend = "qdrant"
grpc_url = "http://localhost:6334"
collection = "agent_memory"
dimensions = 384
embedding_model = "ollama::mxbai-embed-large"

ChromaDB (vector database)

[memory]
backend = "chromadb"
url = "http://localhost:8000"
collection = "agent_memory"
use_server_embeddings = true

Pinecone (cloud vector database)

[memory]
backend = "pinecone"
api_key = "${PINECONE_API_KEY}"
collection = "agent-memory"
dimensions = 1536

Fields

backend: MemoryBackendType

Backend type: “inmemory”, “sqlite”, “redis”, “qdrant”, “chromadb”, or “pinecone”

path: Option<String>

Path for SQLite database file. Use “:memory:” for in-memory SQLite. Only used when backend = “sqlite”.

url: Option<String>

Connection URL for Redis or ChromaDB. Example: “redis://localhost:6379” or “http://localhost:8000” Used when backend = “redis” or “chromadb”.

grpc_url: Option<String>

GRPC URL for Qdrant. Example: “http://localhost:6334” Only used when backend = “qdrant”.

collection: Option<String>

Collection/index name for vector databases. Used by Qdrant, ChromaDB, and Pinecone.

dimensions: Option<usize>

Vector dimensions for embeddings. Required for Qdrant and Pinecone when creating new collections.

api_key: Option<String>

API key for cloud services (Pinecone, etc.). Can use environment variable syntax: “${PINECONE_API_KEY}”

embedding_model: Option<String>

Embedding model identifier (e.g., “ollama::mxbai-embed-large”). Used for generating embeddings if not using server-side embeddings.

use_server_embeddings: Option<bool>

Whether to use the vector DB’s server-side embedding feature. ChromaDB supports this with configured embedding functions.

prefix: Option<String>

Key prefix for Redis namespace isolation. Only used when backend = “redis”.

max_entries: Option<usize>

Maximum number of entries for InMemory backend. When exceeded, oldest entries are evicted. Only used when backend = “inmemory”.

ttl_seconds: Option<i64>

Default TTL (time-to-live) in seconds for entries. Entries will be automatically removed after this time. Supported by all backends.

Implementations

impl MemoryConfig

pub fn new() -> Self

Create a new default memory config (InMemory backend).

pub fn in_memory() -> Self

Create an InMemory backend configuration.

pub fn sqlite(path: impl Into<String>) -> Self

Create a SQLite backend configuration.

pub fn redis(url: impl Into<String>) -> Self

Create a Redis backend configuration.

pub fn qdrant( grpc_url: impl Into<String>, collection: impl Into<String>, dimensions: usize, ) -> Self

Create a Qdrant backend configuration.

Arguments

• grpc_url - Qdrant gRPC URL (e.g., “http://localhost:6334”)
• collection - Collection name
• dimensions - Vector dimensions

pub fn chromadb(url: impl Into<String>, collection: impl Into<String>) -> Self

Create a ChromaDB backend configuration.

Arguments

• url - ChromaDB URL (e.g., “http://localhost:8000”)
• collection - Collection name

pub fn pinecone( api_key: impl Into<String>, collection: impl Into<String>, dimensions: usize, ) -> Self

Create a Pinecone backend configuration.

Arguments

• api_key - Pinecone API key
• collection - Index name
• dimensions - Vector dimensions

pub fn with_max_entries(self, max: usize) -> Self

Set max entries limit.

pub fn with_ttl_seconds(self, seconds: i64) -> Self

Set default TTL in seconds.

pub fn with_prefix(self, prefix: impl Into<String>) -> Self

Set Redis key prefix.

pub fn with_collection(self, collection: impl Into<String>) -> Self

Set collection/index name.

pub fn with_dimensions(self, dimensions: usize) -> Self

Set vector dimensions.

pub fn with_embedding_model(self, model: impl Into<String>) -> Self

Set embedding model.

pub fn with_server_embeddings(self, enabled: bool) -> Self

Enable or disable server-side embeddings.

pub fn with_api_key(self, api_key: impl Into<String>) -> Self

Set API key for cloud services.

Trait Implementations

impl Clone for MemoryConfig

fn clone(&self) -> MemoryConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MemoryConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MemoryConfig

fn default() -> MemoryConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MemoryConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MemoryConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.