Files - PraisonAI

File handling enables agents to persist sessions and search file stores.

Quick Start

Persist Agent Sessions

use praisonai::{Agent, FileSessionStore};

// Create session store (uses default ~/.praisonai/sessions/)
let store = FileSessionStore::new();

// Create agent with session persistence
let agent = Agent::new()
    .name("Assistant")
    .instructions("You are a helpful assistant")
    .session_store(store)
    .build()?;

// Sessions automatically persist across restarts
agent.start("Remember my name is Alice").await?;

Custom Session Directory

use praisonai::FileSessionStore;

// Use custom directory for sessions
let store = FileSessionStore::with_dir("/path/to/sessions")
    .max_messages(100);  // Limit stored messages

User Interaction Flow

FileSessionStore

Persists session data to JSON files on disk.

pub struct FileSessionStore {
    session_dir: PathBuf,
    max_messages: usize,
}

Configuration Options

Option	Type	Default	Description
`session_dir`	`PathBuf`	`~/.praisonai/sessions/`	Directory for session files
`max_messages`	`usize`	`100`	Maximum messages per session

Methods

Method	Signature	Description
`new()`	`fn new() -> Self`	Create with default directory
`with_dir(dir)`	`fn with_dir(impl Into<PathBuf>) -> Self`	Create with custom directory
`max_messages(n)`	`fn max_messages(self, usize) -> Self`	Set message limit

Example

use praisonai::FileSessionStore;

// Default location
let store = FileSessionStore::new();

// Custom location with message limit
let store = FileSessionStore::with_dir("./my_sessions")
    .max_messages(50);

FileSearchCall

Search across file stores (used with Gemini deep research).

pub struct FileSearchCall {
    pub store_names: Vec<String>,
}

Configuration Options

Option	Type	Default	Description
`store_names`	`Vec<String>`	`[]`	Names of stores to search

Example

use praisonai::parity::FileSearchCall;

// Search specific stores
let search = FileSearchCall::new(vec![
    "documents".to_string(),
    "knowledge_base".to_string(),
]);

println!("Searching {} stores", search.store_names.len());

Best Practices

Use default paths for simplicity

FileSessionStore::new() uses ~/.praisonai/sessions/ which works across platforms.

Set message limits for long-running agents

Use .max_messages(n) to prevent unbounded memory growth in persistent agents.

Handle file I/O errors gracefully

Session store operations return Result types - always handle potential errors.

Sessions

Session management API

Memory

In-memory storage options

​Quick Start

​User Interaction Flow

​FileSessionStore

​Configuration Options

​Methods

​Example

​FileSearchCall

​Configuration Options

​Example

​Best Practices

​Related

Sessions

Memory

Quick Start

User Interaction Flow

FileSessionStore

Configuration Options

Methods

Example

FileSearchCall

Configuration Options

Example

Best Practices

Related