How to Use Voice AI Agent Logs in Sparkforge

Agent Logs give you a step-by-step view of every Voice AI interaction. Review conversations, track execution, identify delays, and troubleshoot with confidence.

What Voice AI Agent Logs do

Agent Logs is a centralized view of AI interactions that surfaces conversation history, execution steps, timestamps, and system-level details. Analyze interactions end to end without guesswork.

What you get

• Conversation visibility — full interaction between user and AI.
• Execution tracking with precise timestamps.
• Transfer insights — how and when handoffs happen.
• Latency analysis for slow steps.
• Data inspection in raw and parsed views.
• Failure detection at the step that broke.

How to navigate and use Agent Logs

1. Open Agent Logs. Go to AI Agents and click Agent Logs.
2. Review the logs table. Sort by agent name, contact, AI product, channel, timestamp, or status. Use the filters at the top to narrow results.
3. Locate and select a log. Use timestamps and status to find the session you want.
4. Open detail view. Click an agent name or use the three-dot action menu and pick View Details.
5. Analyze the conversation. Play the call recording (if enabled), review messages, and read context.
6. Trace the execution timeline. Follow events in order. Look for delays, transfers, and failures.
7. Inspect input and output. Toggle between Raw (system data) and Parsed (readable). Review what was sent and received at each step.
8. Review technical details. Check the model used, execution type, latency, and metadata for performance audits and debugging.

FAQ

Why is the call recording not visible?

Call recording appears only if it is enabled for the phone number used in the interaction.

What is the difference between conversation view and execution timeline?

Conversation view shows the interaction as it happened. Execution timeline shows the technical steps behind it.

What does Raw vs Parsed mean?

Raw shows the original system data. Parsed displays a cleaner, readable version of the same payload.

Can I track agent transfers?

Yes. You can see which agent initiated a transfer, which agent took over, and whether it succeeded.

How do I troubleshoot a failed interaction?

Open the log details, review the execution timeline, and inspect the step where the failure occurred.