How to Test Your Agent

Testing your Blueticks bot before deploying it is essential to ensure it works as expected. This guide covers a simple approach to testing your bot.

Restrict Access During Testing

When testing your bot, the simplest approach is to limit who can interact with it using the Trigger node:

1. Set your Contact List Type to "Allow List"
2. Add only your own contact or specific test users
3. This ensures only authorized testers can trigger the bot flow

Testing Different Bot Modes

Blueticks supports two different bot modes, each requiring specific testing approaches:

Workflow Mode Testing

When testing structured workflow bots:

• Follow each predefined path in your flow
• Test all decision branches and conditions
• Verify that the correct nodes are triggered based on user inputs
• Ensure all variables are properly set and maintained throughout the flow

Agent Mode Testing (LLM)

When testing AI-powered agent bots:

• Test with a variety of questions and prompts
• Check that the agent understands different phrasings of the same question
• Verify that responses are accurate and helpful
• Test complex scenarios that might require the agent to reference multiple knowledge sources

Testing Knowledge Base Retrieval

If your bot uses knowledge bases, you should verify that it correctly retrieves information:

1. Test individual documents using the context menu's "Test Query" option
2. This allows you to check if specific documents are properly indexed and retrievable

The Test Query feature helps you:

• Verify that document content is being properly extracted
• Confirm that semantic search is working as expected
• Test different query phrasings to optimize your content
• Identify gaps in your knowledge base

Analyzing Test Sessions

After running test conversations with your bot, use the Session Detail View to analyze performance:

1. Navigate to the Agent List View by clicking "Agents" in the sidebar
2. Select your agent to open the Agent Detail View
3. Find your test session in the Sessions list
4. Click on it to open the Session Detail View

Once in the Session Detail View, you can examine the full conversation and flow path:

The Session Detail View allows you to:

• Review the complete conversation flow
• See how the bot processed your inputs
• Identify any unexpected responses or behavior
• Verify that knowledge base retrievals are relevant
• Analyze response times and conversation quality
• Examine the flow visualization to understand the bot's decision path

This detailed analysis helps you identify areas for improvement before making your bot available to a wider audience.

Testing Tips

Here are some basic testing approaches:

Test the Complete Flow

• Run through your bot flow from start to finish
• Make sure all messages display correctly
• Verify that transitions between nodes work as expected

Test Different Responses

• Try different user inputs to see how your bot handles them
• Test with both expected and unexpected responses
• Check that your bot provides clear instructions

By restricting access with the Allow List during testing, you can safely experiment with your bot before making it available to a wider audience.