AI Chat Assistant

Your 24/7 AI-powered testing expert, ready to answer questions, provide guidance, and help you make the most of BugBrain.

What is the AI Chat?

The AI Chat Assistant is an intelligent chatbot that understands:

• BugBrain features and capabilities
• Testing best practices
• Common troubleshooting issues
• Test strategy and planning
• How to accomplish specific tasks

Think of it as having a testing expert available instantly, anytime you need help.

How to Access

Global Chat Button:

• Look for the chat icon (💬) in the bottom-right corner
• Available on every page in BugBrain
• Click to open the chat panel

Keyboard Shortcut:

• Press Cmd+K (Mac) or Ctrl+K (Windows)
• Instant access from anywhere

Contextual Help:

• Click ’?’ icons next to features
• Get help specific to what you’re looking at
• Pre-filled questions for that context

What It Can Help With

Feature Guidance

Learn how to use any BugBrain feature:

• “How do I create a test case?”
• “What are Test Plans?”
• “How does Discovery work?”
• “How do I invite team members?”

Troubleshooting

Get help fixing issues:

• “My test failed with ‘Element not found’, what should I do?”
• “Why are my tests running so slowly?”
• “I can’t find the Slack integration, where is it?”
• “Tests are flaky - how do I fix them?”

Best Practices

Learn testing strategies:

• “What’s the best way to organize test cases?”
• “How many tests should I write?”
• “When should I use AI generation vs manual?”
• “How do I handle authentication in tests?”

Task Instructions

Get step-by-step help:

• “Walk me through creating my first test”
• “How do I set up Jira integration?”
• “Show me how to run a discovery session”
• “Help me upgrade my subscription”

How It Works

1. You Ask a Question

Type your question naturally:

"I need to test a checkout flow. Where do I start?"

2. AI Understands Context

The assistant:

• Analyzes your question
• Understands what you’re trying to accomplish
• Considers BugBrain features that can help

3. Get a Detailed Answer

Receive:

• Clear explanation
• Step-by-step instructions
• Code examples or configurations
• Links to relevant documentation
• Follow-up suggestions

4. Continue the Conversation

Ask follow-up questions:

"How do I handle payment forms in that checkout test?"

The AI remembers the conversation context and provides relevant answers.

Example Conversations

Learning a New Feature

You: "What are Personas in BugBrain?"

AI: Personas in BugBrain allow you to store test user
credentials (username, password, API tokens) securely
for authenticated testing. When running tests that
require login, you can select a Persona and BugBrain
will automatically handle authentication.

Use Personas when:
- Testing behind login walls
- Testing with different user roles
- Using Discovery on authenticated pages

[Learn more about Personas →]

Debugging a Problem

You: "My login test keeps failing at the password field.
The error says 'Element not found'. What's wrong?"

AI: This usually means the selector for the password
field isn't quite right. Here are solutions to try:

1. Use a more specific selector like 'Input field with
   type password'
2. Add a Wait step before typing the password
3. Check if the field is in an iframe
4. Verify the field exists in the DOM

Try these in order. Let me know which one works!

Planning Tests

You: "I have a new search feature. What tests should
I write?"

AI: For a search feature, create tests covering:

1. Basic search with results
2. Search with no results
3. Search with special characters
4. Empty search (edge case)
5. Pagination of results
6. Search filters (if applicable)

Start with #1 and #2 as your smoke tests, then add
others for comprehensive coverage.

Features

Conversation Memory

• AI remembers your current conversation
• Refer to previous questions
• Build on earlier answers
• Context-aware responses

Code Examples

Get actual examples you can use:

Action: Assert
Target: Element with text "Dashboard"
Description: Verify user is logged in

Quick Links

Answers include links to:

• Feature documentation
• How-to guides
• Related help articles
• Relevant pages

Copy Buttons

• Copy code snippets with one click
• Paste directly into tests
• Save configuration examples

Tips for Better Answers

Be Specific

❌ “How do I test?” ✅ “How do I test a login form that requires email and password?”

Include Context

❌ “It’s not working” ✅ “My test fails at step 3 with error ‘Timeout exceeded’ when clicking the Submit button”

Mention Your Goal

❌ “Tell me about Discovery” ✅ “I want to find all pages in my app to create tests. How does Discovery help?”

Provide Error Messages

When troubleshooting, paste exact errors:

"I'm getting: Element with selector '#login-btn' not
found. The button exists - why can't the test find it?"

What the AI Cannot Do

The assistant cannot:

• Execute tests for you
• Make changes to your account
• Access your test data or credentials
• Modify test cases directly
• Perform actions on your behalf

Limitations

• Session-Based: Remembers current chat but not previous sessions
• Read-Only: Can guide but can’t take actions
• No Real-Time Data: Doesn’t see your live executions or results

Feedback

Help improve the AI:

• Use 👍 thumbs up for helpful answers
• Use 👎 thumbs down for unhelpful ones
• Add comments to explain ratings

Your feedback directly improves response quality!

Keyboard Shortcuts

• Cmd/Ctrl + K - Open chat
• Esc - Close chat
• Enter - Send message
• Shift + Enter - New line in message

When to Use the AI vs Documentation

Use the AI when:

• You need quick, specific answers
• You’re troubleshooting an issue
• You want conversational help
• You need guidance on approach

Use documentation when:

• You want comprehensive reference
• You’re learning a feature in-depth
• You need to see all options
• You want to browse and explore

Common Questions

“How do I create my first test?” Get a beginner-friendly walkthrough tailored to your situation.

“What’s the difference between Test Cases and Test Plans?” Clear explanation of both concepts and when to use each.

“My tests are failing - help!” Troubleshooting assistance with actionable solutions.

“How do I upgrade my plan?” Step-by-step billing and subscription guidance.

Getting More Help

If the AI can’t answer:

• Browse Features documentation
• Check How-To Guides
• Search documentation (top-right)
• Contact support: support@bugbrain.tech

Next Steps

Try asking the AI about:

• Any feature you’re curious about
• Problems you’re encountering
• Best practices for your use case
• Step-by-step guidance for tasks

Just click the chat icon and start asking! 💬