discordbot/MULTI_CONVERSATION_README.md
2025-04-25 14:03:49 -06:00

106 lines
3.5 KiB
Markdown

# Multi-Conversation AI Feature
This document explains how to use the multi-conversation AI feature, which allows users to maintain multiple separate conversations with the AI, each with its own settings and history.
## Commands
### Basic Commands
- `!chat <message>` - Send a message to the AI using your active conversation
- `!convs` - Manage your conversations with a UI
- `!chatset` - View and update settings for your active conversation
- `!chatimport` - Import conversations from the sync API
### Slash Commands
- `/chat <message>` - Send a message to the AI using your active conversation
## Managing Conversations
Use the `!convs` command to see a list of your conversations. This will display a UI with the following options:
- **Dropdown Menu** - Select a conversation to switch to, or create a new one
- **Settings Button** - View and modify settings for the active conversation
- **Rename Button** - Change the title of the active conversation
- **Delete Button** - Delete the active conversation
## Conversation Settings
Each conversation has its own settings that can be viewed and modified using the `!chatset` command:
```
!chatset - Show current settings
!chatset temperature 0.8 - Set temperature to 0.8
!chatset max_tokens 2000 - Set maximum tokens
!chatset reasoning on - Enable reasoning
!chatset reasoning_effort medium - Set reasoning effort (low, medium, high)
!chatset web_search on - Enable web search
!chatset model gpt-4 - Set the model
!chatset system <message> - Set system message
!chatset title <title> - Set conversation title
!chatset character <name> - Set character name
!chatset character_info <info> - Set character information
!chatset character_breakdown on - Enable character breakdown
!chatset custom_instructions <text> - Set custom instructions
```
## Syncing with Flutter App
The multi-conversation feature is compatible with the Discord sync API, allowing users to access their conversations from a Flutter app.
To import conversations from the sync API, use the `!chatimport` command. This will show a confirmation message with the number of conversations that will be imported.
## Examples
### Starting a New Conversation
```
!chat Hello, how are you?
```
### Managing Conversations
```
!convs
```
### Viewing Settings
```
!chatset
```
### Changing Settings
```
!chatset temperature 0.8
!chatset reasoning on
!chatset system You are a helpful assistant that specializes in programming.
!chatset character Hatsune Miku
!chatset character_info Hatsune Miku is a virtual singer and the most famous VOCALOID character.
!chatset character_breakdown on
```
### Importing Conversations
```
!chatimport
```
## Technical Details
- Conversations are stored in `ai_multi_conversations.json`
- Active conversation IDs are stored in `ai_multi_user_settings.json`
- Conversations are synced with the Discord sync API if available
- Each conversation has its own history, settings, system message, and character settings
## Tips for Best Results
1. **Use descriptive titles** for your conversations to easily identify them
2. **Customize the system message** for each conversation to get more relevant responses
3. **Use character settings** for roleplay conversations
4. **Add custom instructions** for specific requirements or constraints
5. **Adjust temperature** based on the task - lower for factual responses, higher for creative ones
6. **Enable reasoning** for complex questions that require step-by-step thinking
7. **Use web search** for conversations that need up-to-date information