Sessions

Persist conversation history across application restarts

Sessions automatically save and restore conversation history, enabling persistent chats.

Quick Start

1. Create a Session

   use praisonai::Session;
   
   // Create a new session (automatically loads if exists)
   let mut session = Session::new("user-123-chat");
   
   // Add messages
   session.add_user_message("My name is Alice").await?;
   session.add_assistant_message("Nice to meet you, Alice!").await?;
   
   // Session automatically saved to disk

2. Load Existing Session

   use praisonai::Session;
   
   // Explicitly load an existing session
   let session = Session::load("user-123-chat")?;
   
   // Get message history
   let history = session.get_history();
   for msg in history {
       println!("{}: {}", msg.role, msg.content);
   }

3. Use Session with Store

   use praisonai::{Session, FileSessionStore};
   use std::sync::Arc;
   
   // Create with custom directory
   let store = Arc::new(FileSessionStore::with_dir("/custom/path"));
   let session = Session::with_store("chat-123", store);

How It Works

Session Methods

Configuration

Common Patterns

Multi-User Application

use praisonai::{Agent, Session};

async fn handle_user(user_id: &str, message: &str) -> String {
    // Each user gets their own persistent session
    let session = Session::load(user_id)
        .unwrap_or_else(|_| Session::new(user_id));

    let agent = Agent::new()
        .name("Assistant")
        .session(session)
        .build()
        .unwrap();

    agent.chat(message).await.unwrap()
}

Best Practices

Related