The Logs Panel is a global floating panel at the bottom of the Builder interface. It displays real-time system, operation, and call logs generated by the AI Employee runtime. Use it to debug flow execution, trace event handling, and diagnose errors while developing.
Open the Logs Panel
Click Show Logs in the bottom-left corner of the Builder. The panel opens at the bottom of the screen, and the button changes to Hide Logs.
To collapse the panel, click Hide Logs, or click the fold icon (down-arrow) in the top-right corner of the panel.
Log levels
Each log entry has one of three severity levels:
Level | Icon | Description |
|---|---|---|
Info | Circle with an "i" | Informational messages about normal operations. |
Warning | Triangle with an exclamation mark | Non-critical issues that may need attention. |
Error | Circle with an "x" | Failures that prevented an operation from completing. |
Log types
Type | Description |
|---|---|
System | Platform-level events such as startup, shutdown, and configuration changes. |
Operation | Execution-level events. Expandable to show the full JSON payload. |
Call | Skill execution events. Expandable with three tabs: Details, JSON, and States. |
Call log details
When you expand a Call log entry, three tabs are available:
Details: Displays
runtime_context_id,external_event_id, andresultin a grid.JSON: Shows the full log entry as a JSON object.
States: Lists state name/value pairs active at the time of the call.
If the call included a prompt, a Show Prompt button appears to display the prompt content.
Filter logs
The Logs Panel toolbar provides the following filters:
Filter | Description |
|---|---|
Log Level | Multi-select: Info, Warning, Error. |
Log Type | Multi-select: System, Operation, Call. |
Search by message | Text search across log messages. Matching terms are highlighted. |
Search by project Idn | Filter by project identifier. |
Search by flow Idn | Filter by flow identifier. |
Search by skill Idn | Filter by skill identifier. |
Runtime Context Id | Filter by a specific runtime context UUID. |
From date | Start date and time. Defaults to two weeks before the current date. |
To date | End date and time. |
External Event Id | Filter by an external event UUID. |
Agent | Filter by agent persona. |
User | Filter by user persona and actor. |
Toolbar actions
The actions are icon buttons in the panel's title bar. Refresh and clear sit next to the Logs title, and fold is on the right.
Action | Description |
|---|---|
Refresh | Reloads the log list with the current filters. |
Clear | Resets all filters to their defaults. |
Fold | Collapses the Logs Panel. |
Log pagination
The panel loads 50 log entries at a time. Scroll to the bottom of the list to automatically load the next page.
Use case: Debug a flow in real time
When testing a flow with the Sandbox, use the Logs Panel to observe what happens behind the scenes:
Open the Logs Panel by clicking Show Logs in the bottom-left corner.
Set Log Type to Call to focus on skill executions.
Set Search by flow Idn to the flow you are testing.
Open the Sandbox and send a message.
Watch new log entries appear. Expand a Call entry to inspect the Details tab for the runtime context and result, or the States tab to see variable values.
If an error appears, check the JSON tab for the full payload and stack trace.
