Skip to main content
The playground chat interface is your primary tool for testing and interacting with your agents. This guide will help you master the interface and use it effectively for testing your agents.

Interface Overview

The playground chat interface consists of several key components:

Connection and Agent Selection

Connection Dropdown:
  • Select which connection to test with
  • Shows all your active connections
  • Displays connection status and details
Agent Dropdown:
  • Select which agent to test
  • Shows agents linked to the selected connection
  • Displays agent status and configuration

Chat Area

Message Display:
  • Shows conversation history
  • Displays user messages and agent responses
  • Maintains conversation context
  • Scrolls automatically as conversation grows
Message Input:
  • Text input field for typing messages
  • Send button to submit messages
  • Enter key to send messages quickly
  • Character limit and input validation

Control Panel

Clear Chat:
  • Clears conversation history
  • Starts fresh conversation
  • Useful for testing different scenarios
  • Resets conversation context
Settings:
  • Configure chat preferences
  • Adjust display options
  • Set testing parameters
  • Customize interface behavior

Getting Started

Step 1: Select Connection and Agent

  1. Click the “Connection” dropdown
  2. Choose your connection from the list
  3. Click the “Agent” dropdown
  4. Select your agent from the list
  5. Verify both are selected and active

Step 2: Start Your First Conversation

  1. Type a greeting in the message input field
  2. Press Enter or click the Send button
  3. Wait for the agent’s response
  4. Review the response for quality and accuracy

Step 3: Continue the Conversation

  1. Type your next question or message
  2. Send the message using Enter or Send button
  3. Review the agent’s response
  4. Continue testing with different questions

Chat Interface Features

Message Input

Typing and Sending:
  • Type your message in the input field
  • Use Enter key to send quickly
  • Click Send button to submit
  • Clear input field after sending
Input Validation:
  • Character limit for messages
  • Input sanitization
  • Error handling for invalid input
  • Auto-correction and suggestions

Message Display

Conversation History:
  • Shows all messages in chronological order
  • Maintains conversation context
  • Scrolls automatically to latest messages
  • Preserves conversation state
Message Formatting:
  • User messages on the right
  • Agent responses on the left
  • Timestamps for each message
  • Clear visual distinction between messages

Response Handling

Response Display:
  • Shows agent responses in real-time
  • Displays response status and progress
  • Handles long responses appropriately
  • Formats responses for readability
Error Handling:
  • Shows error messages clearly
  • Handles network issues gracefully
  • Provides retry options
  • Maintains conversation state

Effective Testing Techniques

Start with Simple Questions

Begin with basic greetings:
  • “Hello, can you help me?”
  • “What can you help me with?”
  • “Who are you?”
Progress to information questions:
  • “What does your company do?”
  • “What are your business hours?”
  • “How can I contact you?”
Test knowledge integration:
  • “What products do you offer?”
  • “How do I get started?”
  • “What are your policies?”

Test Different Question Types

Direct questions:
  • “What are your business hours?”
  • “How much does this cost?”
  • “What features does this have?”
Open-ended questions:
  • “Can you tell me about your services?”
  • “How does this work?”
  • “What should I know about your company?”
Follow-up questions:
  • “Can you tell me more about that?”
  • “What else should I know?”
  • “How does that compare to other options?”

Test Edge Cases

Unclear questions:
  • “I don’t understand what you’re saying”
  • “Can you help me with something not related to your business?”
  • “What if I’m not satisfied with your service?”
Complex questions:
  • “I’m having trouble with [specific issue]”
  • “Can you help me with a complex problem?”
  • “What should I do if [specific situation]?”
Multi-part questions:
  • “I need help with X, Y, and Z”
  • “Can you explain both A and B?”
  • “What are the differences between these options?”

Conversation Management

Starting New Conversations

Clear chat to start fresh:
  1. Click “Clear Chat” button
  2. Confirm the action if prompted
  3. Start a new conversation with a greeting
  4. Test different scenarios without previous context
When to start fresh:
  • Testing different scenarios
  • Testing edge cases
  • Comparing agent responses
  • Simulating new user interactions

Maintaining Context

Build on previous responses:
  • Ask follow-up questions
  • Reference previous information
  • Test conversation continuity
  • Verify context understanding
Test conversation flow:
  • Start with general questions
  • Progress to specific topics
  • Test topic transitions
  • Verify conversation coherence

Interface Tips and Tricks

Keyboard Shortcuts

Efficient navigation:
  • Enter - Send message
  • Shift + Enter - New line in message
  • Ctrl/Cmd + A - Select all text
  • Ctrl/Cmd + C - Copy text
  • Ctrl/Cmd + V - Paste text
Quick actions:
  • Tab - Navigate between elements
  • Escape - Cancel current action
  • Arrow keys - Navigate message history
  • Delete/Backspace - Edit messages

Message Management

Editing messages:
  • Click on message to edit
  • Use keyboard shortcuts for editing
  • Copy and paste text easily
  • Undo and redo changes
Message history:
  • Scroll through conversation history
  • Jump to specific messages
  • Search through conversation
  • Export conversation if needed

Testing Scenarios

Customer Support Testing

Product questions:
  • “What are the features of this product?”
  • “How do I choose the right size?”
  • “What’s included with this purchase?”
  • “How do I set up this product?”
Order support:
  • “How do I track my order?”
  • “Can I change my shipping address?”
  • “What’s your return policy?”
  • “How do I cancel my order?”
Account management:
  • “How do I reset my password?”
  • “Can I update my account information?”
  • “How do I change my email address?”
  • “Can I delete my account?”

Sales and Marketing Testing

Service information:
  • “What services do you offer?”
  • “How much does this cost?”
  • “What are your packages?”
  • “Do you offer discounts?”
Feature explanations:
  • “What makes you different from competitors?”
  • “How does this feature work?”
  • “What are the benefits of this service?”
  • “Can you explain your pricing?”
Lead generation:
  • “How do I get started?”
  • “Can you send me more information?”
  • “Do you offer free trials?”
  • “How can I contact sales?”

Technical Support Testing

Troubleshooting:
  • “Why isn’t this working?”
  • “How do I fix this error?”
  • “What should I do if this happens?”
  • “Can you help me troubleshoot?”
Setup and configuration:
  • “How do I set this up?”
  • “What do I need to configure?”
  • “How do I connect this to my system?”
  • “What are the requirements?”
Integration help:
  • “How do I integrate this with my other tools?”
  • “What APIs are available?”
  • “How do I set up the connection?”
  • “Can you help me with the integration?”

Troubleshooting Interface Issues

Common Problems

Interface not loading:
  • Check your internet connection
  • Refresh the page
  • Clear browser cache
  • Try a different browser
Messages not sending:
  • Check connection and agent selection
  • Verify input is valid
  • Try refreshing the page
  • Check for error messages
Responses not appearing:
  • Wait for response to complete
  • Check agent status
  • Verify knowledge assignment
  • Try a different question

Getting Help

If you encounter issues:
  • Check the troubleshooting guide
  • Review interface documentation
  • Test with simple questions first
  • Contact support if needed

Best Practices

Effective Testing

Test systematically:
  • Start with basic questions
  • Progress to more complex scenarios
  • Test different interaction modes
  • Try edge cases and challenging questions
Document your testing:
  • Keep notes on what works well
  • Record issues and problems
  • Track improvement areas
  • Document successful test cases

Interface Usage

Use the interface efficiently:
  • Learn keyboard shortcuts
  • Use clear, concise messages
  • Test different question types
  • Maintain conversation context
Optimize your testing:
  • Test with realistic scenarios
  • Use real user questions
  • Test with different personas
  • Simulate real conversations

Next Steps

Now that you can use the chat interface effectively, you’re ready to:
  1. Test your agents thoroughly - Use the interface for comprehensive testing
  2. Refine your agents - Improve your agents based on testing results
  3. Create integrations - Deploy your tested agents to your website
  4. Monitor performance - Track how well your agents work in production
Mastering the chat interface is key to effective agent testing. Use it systematically and thoroughly to ensure your agents provide the best possible experience for your users.

Getting Help

If you need assistance with the chat interface:
  • Check the troubleshooting guide for common issues
  • Review interface documentation for detailed information
  • Test with simple questions to verify functionality
  • Contact support for additional help
You’re now ready to use the chat interface effectively for testing your agents! 🚀
I