Overview
Tool Logs provide full visibility into what your AI agent does during conversations — every tool call, RAG search, and external channel event is recorded with input/output data, execution time, and status.
Open Tool Logs by clicking the Tool Logs button in the top-right corner of the agent editor modal.
Two Tabs
The modal has two tabs:
Records every tool execution during AI conversations. Each entry shows:
| Field | Description |
|---|
| Tool Name | The function that was called (e.g. rag_search, get_products, get_company_info) |
| Node Name | Which workflow node triggered this tool |
| Node Type | Node category — Orchestrator, Product Agent, Media Agent, Company Agent, Formatter, or Custom |
| Status | success, error, or no_results |
| Execution Time | Duration in milliseconds |
| Date | When the tool was executed |
error, the error message is displayed at the top of the expanded section.
Tool logs are grouped by rounds. A round represents one LLM function-calling iteration — the AI may call multiple tools in a single round before generating a response. Round dividers help you understand the sequence of tool calls within a conversation turn.
Channel Logs
Records events from external communication channels — webhooks, phone calls, messenger messages. Each entry shows:
| Field | Description |
|---|
| Channel Type | Widget, Phone, Telegram, WhatsApp, Instagram, etc. |
| Direction | inbound (received) or outbound (sent) |
| External ID | Caller or sender identifier from the external provider |
| Status | success or error |
| Date | When the event occurred |
What Gets Logged
Tool logs are created automatically whenever the agent:
- Searches the knowledge base —
rag_search with the query and number of results found
- Calls a function tool — any tool configured in the agent’s toolset (e.g.
get_products, get_documents, get_photos, get_videos, get_company_info)
- Executes integration tools — Google Ads, Facebook Ads, and other connected service tools
Channel logs are created when:
- An inbound webhook arrives — phone call, messenger message, or any external channel event
- An outbound message is sent — the agent’s response delivered through a channel
Clearing Logs
Use the Clear Logs button (trash icon) at the top of the modal to delete all logs for the current agent. This action is irreversible.
Logs are stored in a partitioned database table for performance. High-volume agents may accumulate thousands of entries — use Clear Logs periodically to keep the interface responsive.
