> ## Documentation Index
> Fetch the complete documentation index at: https://thethirdpenco-feat-tool-lifecycle-events.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Persistent Chatbot

> Build an AI chatbot that remembers conversations across sessions

Create a chatbot that persists conversation history using SQLite, so users can continue where they left off.

## Full Example

```python theme={null}
import asyncio
from ai_query import tool, Field
from ai_query.agents import Agent, SQLiteStorage
from ai_query.providers import openai

class SupportBot(Agent):
    def __init__(self, user_id: str):
        super().__init__(
            user_id,
            model=openai("gpt-4o"),
            system="You are a helpful customer support agent.",
            storage=SQLiteStorage("./support_bot.db"),
            initial_state={"ticket_count": 0}
        )

    @tool(description="Create a support ticket")
    async def create_ticket(
        self,
        subject: str = Field(description="Ticket subject")
    ) -> str:
        count = self.state.get("ticket_count", 0) + 1
        await self.update_state(ticket_count=count)
        return f"Created ticket #{count}: {subject}"

async def main():
    user_id = "user-123"
    
    # Session 1
    bot = SupportBot(user_id)
    async with bot:
        print(await bot.chat("Hi, I'm Alice. Create a ticket for my keyboard."))

    # Session 2 (Persistent!)
    bot2 = SupportBot(user_id)
    async with bot2:
        print(await bot2.chat("What was that ticket number again?"))

if __name__ == "__main__":
    asyncio.run(main())
```

## How It Works

### Composition over Inheritance

The `Agent` class uses composition for storage. Instead of inheriting from a specific storage agent, you pass a storage backend to the constructor:

```python theme={null}
agent = Agent("id", storage=SQLiteStorage("db.sqlite"))
```

### Automatic Persistence

When using `async with agent:`, the agent automatically:

1. Loads state and messages from storage on start.
2. Saves messages after every `chat()` or `stream()` call.
3. Saves state whenever `set_state()` or `update_state()` is called.