Files

File handling and session persistence in PraisonAI Rust SDK

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

Quick Start

1. 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?;

2. 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

Methods

) -> 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

| []` | 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

Related