Run history

Watch the tutorial

Run History provides comprehensive visibility into all AI Colleague executions across your organisation. It enables administrators, managers, and implementation teams to monitor performance, troubleshoot issues, and analyse business outcomes through a centralised dashboard.

Key Components:

  • Executions Table: View and manage all AI Colleague runs in a sortable, filterable table
  • Global Filters: Filter executions by time range, AI Colleague, AOP, status, and more
  • Run Details: Drill down into individual executions for step-by-step analysis
  • Run Cancellation: Cancel in-progress runs, individually or in bulk
  • Export Capabilities: Export execution data for external analysis and compliance

Accessing Run History

  1. Navigate to AI Colleagues from the main navigation

  2. In the left sidebar, expand Insights

  3. Click Run history: The default landing view displays the Executions Table with the most recent runs.

    User Personas:

    RoleAccess Level
    System AdminsFull access to all AI Colleague executions and configurations

Executions Table

The Executions Table displays all AI Colleague runs in a comprehensive, sortable format. Each row represents a single execution with key metadata for quick assessment.

Default Table Columns

ColumnDescription
Run IDUnique identifier for the execution. Clickable to open drill-down view.
Handled byAI Colleague(s) that handled the request/run.
Trigger TypeHow the execution was initiated: Manual, System/Workbench, or API
StatusCurrent execution state with colour coding (see Status Definitions below)
Initiated ByUser who triggered the execution (Manual), or "N/A" for Workbench/API triggers
Initiated ForUser for whom the request was raised, or "N/A"
Initiated OnTimestamp when the request was initiated (sortable)
Completed OnTimestamp when finished, or "N/A" for in-progress executions
Total Time TakenDuration in format: X Year(s) X Month(s) X Day(s) X Hour(s)
Input TokensTotal input tokens consumed across all LLM calls in the run
Output TokensTotal output tokens consumed across all LLM calls in the run

Status Definitions

StatusDescription
HandledRequest completed successfully
UnhandledRequest failed during execution
In ProgressExecution currently running (includes waiting for user input)
CancelledRequest cancelled — by the user, by the system, or by an admin from Run History (see Cancelling In-Progress Runs)

Additional Available Columns

The following columns can be enabled via the Edit Columns option:

ColumnDescription
EscalationTrue/False - whether escalation to Escalation Manager occurred
ChannelCommunication channel: Voice, Slack, Web, etc.
Associated AOPsList of AOPs executed during the run
Associated ToolsList of Tools executed during the run
Schedule NameName of the schedule (for System/Workbench triggers)
Participation CoverageParticipants involved (clickable to view list)
Unhandled Due ToCategory of failure (see Failure Categories)
Unhandled ReasonDetailed LLM-generated failure explanation
Cancelled ByAdmin who cancelled the run. Empty for user- or system-generated cancellations
Cancellation ReasonThe note entered when the run was cancelled

Filtering & Search

Global Filters

Filters persist across your session and can be combined to narrow down results.

Time Range Filter

OptionDescription
Last 7 daysExecutions from the past week
Last 30 daysExecutions from the past month (default)
Last 90 daysExecutions from the past quarter
Till NowAll executions since deployment
CustomSpecify custom start and end dates

Handled By Filter

Multi-select dropdown to filter by specific AI Colleagues.

  • No selection (default): Shows executions from all AI Colleagues
  • Select AICs: Quick filter for all AI Colleagues (active/inactive)

AOP Filter

Multi-select dropdown to filter by Agent Operating Protocols.

  • No selection (default): Shows all executions
  • Select AOPs: Choose specific AOPs that handled one or more runs.

Tool Filter

Multi-select dropdown to filter by Tools.

  • No selection (default): Shows all executions
  • Select tools: Choose specific tools that handled one or more runs.

Status Filter

Multi-select selection (Select one or more for status specific drill-down):

  • No selection (default): All executions
  • Handled: Only handled runs
  • Unhandled: Only unhandled runs
  • In progress: Only in progress runs
  • Cancelled: Only cancelled runs

Escalation Filter

Multi-select selection:

  • No selection (default): All runs
  • Yes: Only runs where escalation occurred
  • No: Only runs without escalation

Trigger Type Filter

Multi-select selection:

  • No selection (default): All runs
  • API: Only runs initiated via API
  • Workbench: Only runs initiated via Workbench
  • Manual: Only runs initiated manually

Schedule Name Filter

Multi-select dropdown to filter by specific schedule names.

Failure Categories

When an execution fails, the system categorises the failure to aid troubleshooting.

Primary Failure Categories

CategoryDescription
Out of Scope / Guardrail ViolationRequest fell outside the AI Colleague's defined job description or violated guardrail policies
Guardrail ViolationInput or output was blocked or flagged by an active guardrail policy (PII Detection, Moderation, or Jailbreak)
Tool/AOP failure : execution errorTool/AOP failed to execute as expected
📘

Note

For runs that ended due to a guardrail violation, click into the run to see the dedicated Guardrail Violation step in the execution timeline. It shows which guardrail triggered, what was detected, and the action that was taken.

Cancelling In-Progress Runs

Admins can cancel runs that will never finish — such as scheduled runs stuck waiting on a person — so the In Progress count reflects reality. Only In progress runs can be cancelled, and cancellation requires AI Colleague Admin permission; read-only viewers see the runs but no cancel action.

Ways to Cancel

Entry PointHow
Bulk — Run History tableOpen the table's overflow (⋮) menu → Cancel runs. A checkbox column appears; select the runs (terminal rows are disabled with "Only In progress runs can be cancelled"), then click Cancel runs (N)
Single — table rowOpen the row's overflow (⋮) menu → Cancel run
Single — Execution detailsOpen the overflow (⋮) menu in the run's header → Cancel run

Confirmation & Cancellation Note

Cancelling always requires confirmation. The dialog includes a Cancellation note (up to 200 characters) — optional for a single run, required for bulk, where one note applies to all selected runs.

What Happens on Cancellation

  • The run moves to Cancelled immediately; in-progress steps may take a moment to stop. Work already completed (tickets raised, emails sent, records updated) is not rolled back.
  • Cancellation cascades through nested and helper AOPs, and loops dispatch no further items.
  • Users in the run are informed the request was cancelled by an administrator. Pending approvals and input requests are closed server-side — assignees are not notified, but are told the request was cancelled if they act on the card later.
  • A cancelled run cannot be resumed or revived; late callbacks and approvals are recorded on the timeline but do not change the run's status.

What Gets Recorded

Cancelled by and the cancellation reason are shown in the run detail header, on hover over the Cancelled chip in the table, and as optional columns (see Additional Available Columns). The run's timeline ends with a "Run cancelled" node carrying the timestamp, actor, and reason. On cancellation, the timestamp populates Completed On, and Total Time Taken is computed from initiation to cancellation.

📘

Note

System-generated cancellations (abandonment, cleared chat, guardrail violation) have no "Cancelled by" value — that's how they're distinguished from admin cancellations.

📘

Note

Runs that are part of an evaluation are not eligible for cancellation, as a cancelled run would read as a failed test case.

Participation Coverage

Click the Participation Coverage badge on any row to view all participants involved in that execution.

Participant Categories

CategoryDescription
Initiated ForThe individual or entity this run serves
Action OwnersUsers assigned approval or input tasks during execution
Escalation Contact(s)Users contacted for exception handling and guidance

Token Tracking

Run History tracks token consumption for cost monitoring and performance analysis.

ColumnDescription
Input TokensSum of all input tokens across all LLM calls in the run
Output TokensSum of all output tokens across all LLM calls in the run

Token Aggregation Includes:

  • Initial Analysis (re-ranking, shortlisting of AOP/Tool)
  • Tools/AOP invocations using LLM
  • Any AOP step using LLM processing

Note: Runs without LLM invocations display "NA" for token columns.


Column Customisation

Manage Columns

  1. Click the Edit Columns icon next to the table header
  2. Check/uncheck columns to show/hide
  3. Changes apply immediately

Reorder Columns

  1. Drag and drop column headers to reorder
  2. Column order preferences persist across sessions

Exporting Data

Export Options

FormatDescription
CSV (.csv)Plain comma-separated values

Export Behaviour

  • Exports current filtered and sorted view
  • All columns exported (added through managed columns)
  • Maximum 10,000 rows per export
  • Exports exceeding 10,000 rows generate a .zip file with multiple files
  • Share via Email: Option to send export directly to specified recipients



Did this page help you?