You can debug your bot conversation using the built-in Emulator in the right-side panel.

πŸ“˜

Note

To visualize the actual user experience, use the Share button to have a hosted easily shareable version of the Web Chat (this is the production bot already, conversations will be saved) or ideally test the bot in the channel you intend to deploy it on. Conversations in the Emulator won't be saved and the bot invocations won't be counted against your usage quota, but AI operations will.

Status Indicator

🟠 Training
This indicates that the bot is getting trained using your latest edits in the studio.

🟒 Ready
This indicates that the bot has been trained and is ready for testing in the emulator.

πŸ”΄ Error
This indicates that the bot could not be trained and has some errors.


Shortcuts

Opening & Closing the Emulator

Press cmd/ctrl + e to toggle the Emulator (Right Panel)

Resend the Same Messages

Pressing ↑ or ↓ on your keyboard in the text input allows you to navigate and resend previously sent messages quickly.

πŸ“˜

Info

The last 20 messages sent are persisted in your browser storage.


Options

New Conversation

The New Conversation button erases the history and state from the old conversation and start a new conversation with the same user information. It's available at the top right corner of the emulator.

Start as a new user

The Start as new user button erases the history and state from the old conversation and start a new conversation with different user information. It's available at the top right corner of the emulator behind the 3 dots.

Simulate timeout event

The Simulate timeout event button triggers the Timeout flow so you can check how the bot behaves when the conversation expires. It's available at the top right corner of the emulator behind the 3 dots.


In-line Logs

The Emulator shows the status of the conversation and the different steps that are being or have been executed under the hood to get the bot's response. They are a simpler version of the Event Debugger's summary. Bot events, and card-processing results are shown this way, only in the emulator.

Bot-events

  • Conversation started: The user has started the conversation by sending a message or a Trigger Event has been triggered.
  • Conversation ended: The conversation flowed to an End node and has gone through the Conversation End workflow, or it has ended by not having possible transitions.
  • Error ocurred: An irrecoverable error has ocurred and the conversation has flowed to the Error . The error message is visible by hovering the status.
  • Waiting for user input: The bot is waiting for the user to send a message in order to proceed with the conversation flow.

Card-processing results

Knowledge Base

  • Answer found in Knowledge Base: The bot has gone through the Knowledge Bases and found an answer to the user's question. Clicking it will take you to the Logs tab where you can see in details what was sent to the AI and the raw output.
  • Knowledge disabled on that node: The bot won't try to find an answer in the Knowledge Base because this node doesn't expect or accept Knowledge questions.
  • No content matched the query: There is no content in the Knowledge Base that matches the user message. May accompany the previous status.
  • Knowledge Base answer: Text displayed automatically after a question without the need of a Text card. It will contain the citations to help you debug the answers.

Execute

  • Executing code: The bot is executing some custom code from an Execute Code card.
  • Executed code: The bot has finished executing the code. It is mentioned how many milliseconds it took to run.

AI

  • AI Task Running: The bot is running an AI Task. This involves making a request to the selected LLM model, getting a response and then processing it.
  • AI Task Completed: The bot has finished running the AI Task. It is mentioned how many milliseconds it took to run.

Flow Logic

  • Entered Workflow - The conversation has flowed to a different workflow. The workflow name is mentioned.
  • Transitioned: The conversation has flowed to another workflow or node. It is mentioned the name of the workflow and the node it transitioned to. Clicking it will lead you to the exact node.
  • Restarting from node: The conversation is being restarted from a specific node by user request. It is mentioned the name of the node it is restarting from.

Capture Information

  • Capturing Variable: The bot is currently trying to extract information from the user message with a Capture card to optionally save it in a variable.
  • Captured variable: The bot has successfully extracted information from the user message and saved it in a variable.
  • Capture variable failed: The bot wasn't able to extract information and has reached the limit of retries.