Back to Help Home
Last updated: 2026-02-16Location: AI Agents > AI Text Logs

Auditing AI Text Agents - AI Text Logs

Quick Reference Keywords: AI text logs · Auditing conversations · Tool execution logs · Troubleshooting AI · Agent response history · Conditional tool triggers

Overview

A log is created every time an agent generates a response for a text from a customer (even if that response is not sent because the AI was turned off in between or a failure occurred). AI Text Logs allow you to see what the AI generated, why a response may not have been sent, any tools the AI used, and configuration details like which agent responded and what model it was using.

1. Navigate to AI Agents (robot icon, main left hand menu)

2. Click "AI Text Logs"

3. You can sort logs by a particular agent by clicking the agent dropdown and selecting one of your agents

4. Click on any of the log cards to view the full log

Reading a Log Entry

5. "Processing Information" at the top shows which agent responded and which provider/model was used

6. Below that, you'll see the inbound message from the contact and the AI response

Reviewing Tool Execution

7. Below the messages, you'll see tools executed (if applicable)

8. Click "Show all arguments" to expand tool usage and see key details

9. For conditional tools, key things to check are the "Trigger Reason" (the agent's explanation for why it used the tool) and any actions that were triggered, along with their status (success/failure).

10. Field Extractor tools show what field was updated with what value (or if it was skipped because the field already had a value and allow_override was not enabled).

11. Booking tools (get_available_appointment_slots and book_appointment) show the booking mode, date range searched, slots returned, and the time that was attempted to be booked.

Searching Logs

12. You can search across all agents for a particular contact by contact ID.

Get a contact's ID by going to that contact's detail page and copying the last set of characters after contacts/ in the URL.

13. Return to AI Text Logs and paste the contact ID into the search field to filter results for that contact only.

14. You can also search across all agents for a particular message by typing or pasting the message content you want to search for.

Key Tips

What to Look For When Troubleshooting:

  • Unexpected responses: Check the agent name and model in Processing Information - is the right agent responding?
  • Missing tool calls: If the AI should have used a tool but didn't, review the conditional tool trigger conditions
  • Failed actions: Expand tool details to see action success/failure statuses
  • Booking issues: Check booking tool logs for available slots returned and booking mode configuration

Searching Efficiently:

  • Filter by agent first to narrow down logs
  • Use contact ID search to see the full history of AI interactions with a specific person
  • Use message content search to find specific conversations across all agents

Related Features

Summary

AI Text Logs give you full visibility into every AI interaction:

  • Every response is logged - Even ones that weren't sent
  • Processing info shows which agent and model responded
  • Tool execution details reveal trigger reasons, actions taken, and success/failure
  • Search by agent, contact ID, or message content to find specific logs
  • Use logs to troubleshoot unexpected AI behavior, failed bookings, or missed tool triggers