Test and validate your Agentic app interactively before deployment. Submit queries, observe agent responses in real time, and trace execution flow to catch issues early.
Overview
The Playground is an interactive chat environment where you simulate conversations with your Agentic app. It captures a detailed execution timeline for each query and stores conversation history for debugging and review.
Starting a Session
A new session starts automatically each time you open the Playground. To start a fresh session manually:
- Click New Session at the top of the Playground interface.
- The chat window clears and a blank session begins.
Starting a new session does not delete previous conversations. Access them using the History option.
Interface Components
| Component | Description |
|---|
| Query Input | Text field for entering queries. Supports typed input and voice input via browser-based speech recognition (ASR). |
| Response Display | Shows the agent’s response to each submitted query. |
| Timeline (Right Panel) | Step-by-step execution trace from user input to final output. Click a step to inspect details. |
| Flow Diagram (Right Panel) | Visual representation of the execution sequence across all components. |
| Attachments | Upload files as contextual input using the attach icon in the query input box. |
- Voice output is not supported — responses are text only.
- Voice input uses browser-based ASR, supported by default in Chrome, Firefox, Safari, and Edge.
Timeline Details
Each step in the Timeline represents a distinct agent or tool (for example, Supervisor, Insights_Agent) and shows the time taken to complete its task. Clicking a step reveals:
| Field | Content |
|---|
| Messages | The question or command sent to or received from the component, along with the reasoning used to process it. |
| Request | The prompt sent to the component. |
| Response | The output received from the component. |
| Debug Logs | Detailed status messages across agents, tools, and supervisors. Includes Guardrails execution logs, auto-expanded traces, and session and trace IDs. |
Flow Diagram
The Flow Diagram provides a visual layout of the overall execution flow, making it easier to understand the sequence of operations and interactions between components.
Attachments
Upload files to provide contextual information to the agent during a conversation.
-
Attachments require Document Upload to be enabled under Playground Settings on the Configurations page.
-
File count and size limits are set under Attachment Configurations in General Settings. Learn more.
-
Uploaded files display a preview icon next to the file name for quick identification.
Document Context Management
Uploaded documents are organized into two sections:
| Section | Description |
|---|
| In Context | Documents actively used as context for the current conversation. |
| Removed | Documents that are uploaded but excluded from the current context. |
- Remove from context: Delete the document from In Context — it moves to Removed automatically.
- Restore a document: Click the + icon in the Removed section.
- Delete permanently: Click the delete icon on the file in the Removed section.
Conversation History
The Playground automatically saves all conversation history. Use the History option to revisit, debug, or continue past sessions.
Resuming a Session
- Click History at the top of the Playground.
- Browse past conversations — each entry shows the first user message and response. Use time filters to narrow the list.
- Select a conversation to open it in the Playground.
- Review or continue the conversation from where it left off.
History Constraints
| Constraint | Detail |
|---|
| Visibility | Each user sees only their own conversation history. |
| Message limit | Only the most recent 50 messages (user inputs and agent responses) are stored and restored per session. |
| Configuration | Resumed sessions use the current configuration settings, not those from the original session. |
| Attachments | Attachments from the previous session remain accessible but must be manually re-selected to use them as context. |
| Thought traces | Available only for messages in the current active session — not for messages from resumed sessions. |
| State | Behavior |
|---|
| Authorized | Status shows “Authorized” and the agent proceeds with the query. |
| Not Authorized | A secure redirect URL is provided. Complete authorization before the agent can respond. |
The agent cannot execute actions until authorization is complete. If multiple authorizations are required, all are listed in a table at the start of the session. Unauthorized tools fail and return errors.
