Analytics and Chat History
See every conversation your AVCodex agent has had with techs, programmers, and end-clients. Track usage. Export data so you can feed it back into your operations review.
Browse every conversation, watch the metrics that matter (volume, repeat questions, unresolved threads), and pull data out for your own analysis.
Open Chats in your agent's navigation. The page has two tabs:
- Chatlogs: browse and view conversations.
- Actions: download data and wire up output integrations.
The left side shows every session with filters:
Filters#
| Filter | Options |
|---|---|
| Search | Search message content |
| Status | All or Unread only |
| Source | Web, API, Slack, WhatsApp, Email, Voice |
| Tag | Filter by conversation tags |
| Phone Number | Filter by phone (voice or SMS conversations) |
Chat Session Info#
Each session shows:
- User name or email (if collected) or anonymous.
- Source channel badge.
- Preview of recent messages.
- Timestamp.
- Unread indicator.
Click a session to open it.
Transcript Tab#
- Full message history.
- User and agent turns.
- Timestamps on every message.
- Attachments and images shared (a photo of a bad signal-flow indicator, an iPad screenshot of a Q-SYS UI, a control panel error code).
Memory Extracted Tab#
- Facts the agent pulled out of this conversation.
- Used for the User Memory feature.
In the Actions tab you get a high-level read:
| Metric | Description |
|---|---|
| Total Sessions | All chat sessions |
| Unread | Sessions you have not opened |
| Today | Sessions from today |
| Avg Messages | Average messages per session |
| Unique Users | Distinct users who chatted |
For an AV helpdesk agent, the metrics that matter most are usually: total sessions per site (which buildings are calling for help most often), unique users (are the same techs hitting the same issues), and avg messages (long conversations often signal a docs gap).
Download as CSV#
- Open Chats -> Actions.
- Click Download Chatlogs.
- A CSV downloads with every conversation.
The CSV contains:
- Session ID.
- User info (if collected).
- Source channel.
- Timestamps.
- All messages with roles.
Google Sheets Integration#
Sync new conversations to Google Sheets automatically:
- Open Chats -> Actions.
- Click the Output card.
- Connect Google Sheets.
- New conversations land as new rows.
Useful for AV ops managers who want a single sheet of every interaction across all client sites.
Mark as Read#
Conversations are marked read when you open them. The unread count in the sidebar updates automatically.
Filter by Source#
Use the Source filter to see only conversations from a given channel:
- Web: browser widget or iframe (a QR code in a conference room).
- API: API integrations (a custom dispatch app).
- Slack: Slack bot messages (your internal #av-ops channel).
- WhatsApp: WhatsApp integration (a field tech in transit).
- Email: email conversations.
- Voice: phone call transcripts.
Use chat history to make the agent better:
- Find common questions. Search for patterns. If 40% of conversations are "audio is too low in BOS-14", that is a real-world signal.
- Spot confusion. Long back-and-forth threads usually mean a docs gap or a missing tool.
- Update knowledge. Add the missing AS-built drawing, programming guide, or commissioning checklist.
- Refine prompts. Adjust the system prompt based on the conversations you actually see, not the ones you imagined.
No conversations showing#
- Confirm the agent is published and reachable.
- Check that users have actually chatted (test it yourself).
- Clear all filters.
Cannot find a specific chat#
- Use the search box on message content.
- Filter by source if you know the channel.
- Confirm the status filter is not hiding it.
Download not working#
- Wait for the download to finish (large datasets take a moment).
- Check your browser's download folder.
- Try a different browser if it persists.
Pull analytics programmatically through the AVCodex MCP Server. Useful for AI-assisted reviews and bulk reporting.
Available Tools#
| Tool | Description |
|---|---|
get_app_analytics |
Summary metrics (sessions, messages, users, satisfaction) |
search_conversations |
Find conversations with filters and search |
get_conversation |
Full conversation transcript |
get_top_queries |
Most common user questions |
export_conversations |
Export conversation data to JSON |
get_tag_analytics |
View tag detection metrics |
Example Prompts#
"Show me analytics for my AV helpdesk agent for the past week."
"Find conversations where techs mentioned 'no audio'."
"What are the top 10 questions techs ask my Crestron-programmer assistant?"
"Export all conversations from December."Workflow: Weekly Operations Review#
You: Show me a summary of all my agents' performance this week.
Agent: [calls get_app_analytics for each agent]
Weekly summary:
- AV Helpdesk: 1,247 conversations, 4.5/5 satisfaction
- Crestron Programmer Assistant: 432 conversations, 4.3/5
- Spec-Sheet Bot: 298 conversations, 4.1/5
You: What are techs asking about most?
Agent: [calls get_top_queries]
Top queries across your agents:
1. "How do I reset the Q-SYS Core remotely?" (142)
2. "What is the firmware version for DM-NVX-360?" (98)
3. "Audio is dropping out on Shure MXA920 in BOS-14." (74)
...Note: MCP server access requires a Builder plan or higher.
*AVCodex · Your AV expertise. Amplified by AI.*