Skip to main content

Builder - Logs Panel

Read real-time system, operation, and call logs from the floating Logs Panel in the Builder.

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, and result in 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:

  1. Open the Logs Panel by clicking Show Logs in the bottom-left corner.

  2. Set Log Type to Call to focus on skill executions.

  3. Set Search by flow Idn to the flow you are testing.

  4. Open the Sandbox and send a message.

  5. 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.

  6. If an error appears, check the JSON tab for the full payload and stack trace.

Did this answer your question?