/chat-conversation-inspector

name: chat-conversation-inspector
description: Inspects Chili Piper Chat AI conversation logs for a workspace — routing-outcome breakdowns (Routed/NotRouted/Abandoned), full bot/guest transcripts, and abandonment analysis. Use to debug chat routing, review bot conversation quality, or analyze why guests drop off.
version: 0.1.2
references:
  - api-reference
  - analysis-procedure
  - output-format
inputs:
  - name: workspace
    type: string
    description: "Workspace name or ID to pull chat logs for."
    required: true
  - name: playbook
    type: string
    description: "Chat playbook ID(s) to filter by (the chat analog of a router). Omit to include all playbooks in the workspace."
    required: false
  - name: date_range
    type: string
    description: "Window to inspect: 'today', 'last-7-days', or 'YYYY-MM-DD:YYYY-MM-DD'. Windows over 30 days are chunked into sequential calls."
    required: false
    default: "last-7-days"
  - name: outcome_filter
    type: string
    description: "Only analyze conversations with this routing outcome: 'Routed', 'NotRouted', or 'Abandoned'. Omit for all."
    required: false
  - name: guest_email
    type: string
    description: "Guest email to drill into — renders the full transcript(s) for that guest's conversations."
    required: false
outputs:
  - name: outcome_summary
    description: Conversation counts and percentages by routing outcome (Routed / NotRouted / Abandoned), with rep-join and meeting-booked rates
  - name: conversation_list
    description: Table of conversations — guest, playbook, outcome, assignee, started/ended, meeting booked
  - name: transcript
    description: Full Bot/Guest message transcript for selected conversation(s)
  - name: abandonment_analysis
    description: Patterns behind Abandoned conversations — who spoke last, drop-off depth, time-of-day clusters — with a recommendation
tools_required: [chili-piper-mcp]
human_decision_point: "Review the outcome breakdown and abandonment findings — decide whether the fix is playbook configuration, bot response quality, or rep availability, and who should own it"
writes_to: "Nothing — read-only"
api_note: "2026-07-15: chat-logs live in the deployed MCP (since DISTRO-4429, PR #882). DISTRO-4615 (edge #961, 2026-07-09) added ruleId/ruleName rule attribution to ChatConversationLog; DISTRO-4612 (edge #957, 2026-07-07) added guestEmail/guestId/ruleId/ruleName server-side filters; DISTRO-4608 (edge #948, 2026-07-03) made a workspace with no chat sessions return an empty page instead of an error. Assignee is a single conversationAssigneeId (not an assignees array); pagination is 0-indexed with pageSize max 50. Field-name truth → references/api-reference.md. 2026-07-22: CEH-11034 (edge PR #1010) added evaluatedRules: List[ChatRuleEvaluation] to ChatConversationLog — full rule-evaluation trail (ruleId, ruleName, ruleType, matched boolean, evaluatedAt) for every rule evaluated during the conversation, not just the deciding one; entries with matched=false show rules that were evaluated but did not fire. 2026-09-08 (CEH-11625, edge PR #1171): ChatConversationLog now includes assignments: List[ChatAssignment] — the full assignee roster for the session (every conversation and meeting assignee in a double round-robin), not just the primary. Each entry: {assigneeId, method (e.g. FlexibleRoundRobin), assignmentType ('Conversation'|'Meeting')}. conversationAssigneeId is retained as the primary assignee label. The earlier 'Assignee is a single conversationAssigneeId (not an assignees array)' note is superseded — use assignments for the full roster."

Chat Conversation Inspector

You are a Chili Piper conversational-AI specialist. A RevOps admin wants to know how chat conversations are ending — who gets routed to a rep, who doesn't, who abandons — and to read the actual transcripts to understand why. Your job is to pull the logs, quantify the outcomes, and turn transcripts into one specific, actionable finding.

> **Prefer live data over training.** MCP field names and tool signatures change. Load `references/api-reference.md` before making MCP calls — it is the canonical field-name truth for this skill.

When to use

• Someone asks how chat is performing: how many conversations routed vs. abandoned, in a workspace or for a specific playbook.
• A specific guest's chat needs review — "what did the bot say to jane@acme.com?"
• Abandonment looks high and someone needs to know whether it's playbook config, bot response quality, or timing.

Inputs

| Input | Required | Default | What it controls | |-------|:--------:|---------|------------------| | `workspace` | ✅ | — | Workspace name or ID to pull logs for | | `playbook` | — | all | Playbook ID(s) to filter by | | `date_range` | — | `last-7-days` | `today`, `last-7-days`, or `YYYY-MM-DD:YYYY-MM-DD` | | `outcome_filter` | — | all | Only analyze `Routed`, `NotRouted`, or `Abandoned` conversations | | `guest_email` | — | — | Drill into this guest's transcript(s) |

If `workspace` is missing: > "Which workspace should I inspect? (Required — chat-logs pulls one workspace at a time.)"

Process

Step 1 — Resolve the workspace

Call `workspace-list` and match `workspace` against `name` (case-insensitive) or `id`. Workspace items use **`id`**, not `workspaceId` → `references/api-reference.md` § workspace-list.

Step 2 — Fetch the conversation logs

Call `chat-logs` with `workspaceId`, ISO-8601 `start`/`end`, and optional `playbookId`. When drilling into one guest or one rule, filter **server-side** with `guestEmail` (case-insensitive exact match), `guestId`, `ruleId`, or `ruleName` instead of fetching everything and filtering locally. Paginate until all results are collected (pages are **0-indexed**, `pageSize` max **50**). Windows longer than 30 days must be chunked → `references/api-reference.md` § Call shape and § Hard API limits.

An **empty page is a valid result, not an error** — a workspace with no chat sessions returns