Help Center
DocsRuns & Metrics
View agent run history, performance analytics, and troubleshoot issues
Run History
View all past runs for an agent
Navigate to an agent's detail page and click the Runs tab to see all past runs.
| Field | Description |
|---|---|
| Status | Completed, Failed, Running, or Cancelled |
| Summary | AI-generated description of what was found |
| Actions | Count of proposed, approved, rejected, and auto-executed actions |
| Trigger | Schedule, Manual, or Event |
| Duration | How long the run took in seconds |
| Dry Run | Test runs that simulate agent execution without applying any changes. Useful for validating agent behavior before enabling auto-execution. |
Use the Status dropdown above the run list to filter by All, Completed, Failed, or Running.
Click a run to see its full detail, including the AI's reasoning and all proposed actions with their statuses. The Activity tab shows a chronological log of everything the agent did during the run, including tool calls, data lookups, and decisions.
Performance Metrics
Track agent effectiveness over time
The Metricstab on an agent's detail page shows:
| Field | Description |
|---|---|
| Total Runs | Number of times the agent has executed |
| Actions Proposed | Total actions generated across all runs |
| Approval Rate | Percentage of actions approved or auto-executed |
| Average Confidence | Mean confidence score of proposed actions |
| Actions Over Time | 12-week bar chart showing approved/rejected/auto-executed trends |
| Top Action Types | Which tools the agent uses most frequently |
Test Runs (Dry Runs)
Simulate agent execution without applying changes
Click Test Runon an agent's detail page to run the agent in preview mode. Test runs:
- Execute the AI with the agent's full instructions and tools
- Generate proposed actions marked as preview (shown with a cyan indicator)
- Never actually modify any CRM data
- Appear in run history with a "[Test Run]" prefix in the summary
Use test runs to validate instructions before activating an agent or switching to "Go ahead" mode.
Audit Log
Full execution audit trail
Every tool execution is recorded in the audit log with: tool name, parameters, result, success/failure, and duration. This provides a complete compliance trail for all agent actions. The audit log is maintained automatically and retained for all runs.
Troubleshooting
Common issues and solutions
| Field | Description |
|---|---|
| Agent not running on schedule | Verify the agent status is "Active" (not paused or draft). Check the cron expression matches your intended schedule. |
| Run shows "Failed" | Click into the run to see the error message. Common causes: AI provider not configured, rate limits exceeded, invalid tool parameters, trial period expired, or monthly AI token limit reached. Check Settings > Usage for your current usage. |
| Too many low-quality actions | Refine the agent instructions to be more specific. Increase the confidence threshold. Reduce the max actions per run. |
| Actions expiring before review | Actions expire after 72 hours. Review the queue more frequently or consider enabling auto-execute for low-risk actions. |
| Scheduled run timing is off | Scheduled agents are checked every 15 minutes, so execution may be slightly delayed from the exact scheduled time. For example, an agent scheduled at 8:00 AM may run anytime between 8:00 and 8:15 AM. |