👤 For pipe admins
🔐 Available on all plans
🎯 For those who want to monitor the performance and accuracy of their digital workforce.
The AI Agent Logs area gives you full visibility into how an agent behaves inside your processes. It lets you understand the decisions an agent made, the data and knowledge it used, and where an error occurred, so you can trust and improve your digital workforce, reducing support tickets necessity.
Logs help you:
See what the agent did during each execution, step by step.
Understand why it decided something, in plain business language.
Trace the source of every decision, including which document or field it relied on.
Find errors quickly, including the step where a failure happened and its cause.
Confirm skipped actions, so you know when the agent chose not to act and why.
How to open AI Agent Logs
In the pipe’s top header, click AI Agents.
Open the Logs tab in the upper-left corner. You will see the most recent executions, each showing the agent name, the behavior that was triggered, the card that was processed, and the execution status.
Click See Details and then Tracing to inspect it.
Before you start
To access the logs, you must:
Have Pipe Admin permissions.
Have at least one AI Agent configured and active in the pipe.
Step-by-step
1. Access the AI Agents area
Inside your pipe, click the AI Agents button located in the top header.
2. Navigate to the Logs tab
In the upper-left corner of the agents' screen, click the Logs tab. Here you will see a list of all recent executions, including the agent's name, the triggered behavior, the processed card, and the execution status.
3. Analyze the Summary
To understand a specific execution, click the See Details button next to the desired log. The first view is the Summary:
Status: Success, failure, or processing.
Dates: When the execution started and ended.
Context: Which trigger started the agent and which card was affected (including the Card ID).
4. Explore the Tracing
Click the Tracing tab to view the step-by-step execution. This area details the flow followed by your agent and which steps were completed. We are constantly evolving this section to provide even more data and visibility over time regarding your agent’s behavior.
New Tracing Nodes
📍 This feature area is in constant update with new tracing nodes.
Execution Plan
Each step now includes the agent’s reasoning in plain business language, derived from what the agent actually did during the run (not a generic, after-the-fact explanation). You can read, in order, how the agent moved from the trigger to its final action, so a non-technical process owner can understand a decision without asking IT.
If a particular step does not expose reasoning, the log flags that explicitly, so you are never left guessing whether information is missing or simply unavailable.
Knowledge Sources
For agents that use knowledge bases (for example, intelligent document processing, data lookups, or attached documents), the Tracing shows the exact source behind a decision: the document name, the section, and the specific excerpt (chunk) the agent relied on. This lets you verify that the agent consulted the right source and used it correctly.
Agent Actions
Each Action appears as its own node in the flow with its own reasoning, planning or execution details, for example: Update card, Move card, and the other actions your agent can run.
Understanding failures and decisions
Logs are essential for fine-tuning your agent's behavior:
Clear Errors: If a step fails, the Tracing will indicate exactly which step stopped and why (e.g., a missing required field or a permission error).
Skipped Actions: The agent will show when it decided not to perform an action, accompanied by a logical justification for that decision.
Validation Checklist
Use the logs to validate a new or edited agent:
Confirm the final Status shows Success.
In Tracing, follow the Execution Plan to check that the reasoning matches what you expected.
Under Knowledge Sources, confirm the agent consulted the correct documents, sections, and fields.
Identify any problematic step and adjust the agent’s instructions accordingly.
Send us feedback
Have a suggestion for AI Agent Logs?
Use the Send feedback button in the top-right corner. Your input helps shape what we build next.