Interface Guide¶
Learn how to use Convoscope's chat interface effectively.
Main Interface Overview¶
Complete Convoscope interface - click to enlarge
The Convoscope interface consists of three main areas:
1. Chat Area (Center)¶
This is where your conversations happen:
- Message bubbles: Your messages appear on the right, AI responses on the left
- Streaming responses: AI responses appear word-by-word in real-time
- Conversation history: Scroll up to see previous messages
- Auto-scroll: Interface automatically scrolls to new messages
Sending Messages¶
- Type your message in the text box at the bottom
- Press Enter or click the send button
- Watch for the AI response to stream in
- Continue the conversation naturally
2. Sidebar (Left)¶
Sidebar controls - click to enlarge
The sidebar contains all your controls and settings:
Provider Selection¶
Provider dropdown menu - click to enlarge
- Provider dropdown: Choose between OpenAI, Anthropic, or Google
- Status indicators: Green ✅ means provider is ready
- Model selection: Each provider offers different AI models
- Automatic fallback: If your selected provider fails, others will take over
Conversation Management¶
- Save conversation: Give your chat a custom name and save it
- Load conversation: Resume previous conversations from the dropdown
- New conversation: Start fresh (clears current chat)
- Export options: Download conversations as HTML files
Settings¶
- Temperature: Control AI creativity (0.0 = focused, 1.0 = creative)
- Max tokens: Set maximum response length
- Stream responses: Toggle real-time vs complete responses
3. Status Area (Bottom)¶
- Provider status: Shows which AI provider is currently responding
- Error messages: Clear, helpful error messages when things go wrong
- Connection status: Indicates if the app is connected properly
Using Multiple Providers¶
Provider Status Indicators¶
- ✅ Green check: Provider is ready and working
- ⚠️ Yellow warning: Provider has issues but may work
- ❌ Red X: Provider is unavailable
Switching Providers¶
- Manual switching: Use the dropdown to select a different provider
- Automatic fallback: If your provider fails, Convoscope automatically tries others
- Seamless experience: Your conversation continues regardless of which provider responds
Example Workflow¶
flowchart TD
A[Select OpenAI] --> B[Send message]
B --> C{OpenAI working?}
C -->|Yes| D[Get OpenAI response]
C -->|No| E[Auto-switch to Anthropic]
E --> F[Get Claude response]
D --> G[Continue conversation]
F --> G
style A fill:#e3f2fd
style G fill:#e8f5e8
Error Handling¶
Friendly error messages - click to enlarge
When something goes wrong, Convoscope shows helpful messages:
- API key issues: Clear instructions on how to fix authentication
- Rate limits: Explains when to try again
- Network problems: Suggests checking connection
- Provider outages: Shows which providers are available
Mobile Interface¶
Mobile-responsive design - click to enlarge
Convoscope works great on mobile devices:
- Responsive design: Layout adapts to screen size
- Touch-friendly: Large buttons and easy scrolling
- Same features: All functionality available on mobile
Keyboard Shortcuts¶
- Enter: Send message
- Shift + Enter: New line in message
- Ctrl/Cmd + K: Clear conversation (if implemented)
Tips for Better Conversations¶
Getting Better Responses¶
- Be specific: Clear questions get better answers
- Provide context: Reference previous parts of conversation
- Try different providers: Each AI has different strengths
- Adjust temperature: Lower for factual, higher for creative responses
Managing Long Conversations¶
- Save regularly: Don't lose important conversations
- Export when needed: Download conversations for reference
- Start new chats: Fresh conversations for new topics
- Use descriptive names: Make saved conversations easy to find
Troubleshooting Interface Issues¶
Chat Not Responding¶
- Check provider status indicators
- Verify internet connection
- Try switching providers
- Check error messages in status area
Sidebar Not Working¶
- Refresh the page
- Check browser console for errors
- Verify all providers are configured
Mobile Issues¶
- Try landscape orientation
- Refresh the page
- Check mobile browser compatibility
Need more help? Check the Troubleshooting Guide for common issues and solutions.