---

name: retellai-observability description: "Retell AI observability \u2014 AI voice agent and phone call automation.\n
Use when working with Retell AI for voice agents, phone calls, or telephony.\nTrigger
\ with phrases like "retell observability", "retellai-observability", "voice
\ agent".\n" allowed-tools: Read, Write, Edit, Bash(npm:), Bash(curl:), Grep version: 1.9.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io tags:

• saas
• retellai
• voice
• telephony
• ai-agents compatibility: Designed for Claude Code

---

Retell AI Observability

Overview

Implementation patterns for Retell AI observability — voice agent and telephony platform.

Prerequisites

• Completed retellai-install-auth setup

Instructions

Step 1: SDK Pattern

import Retell from 'retell-sdk';
const retell = new Retell({ apiKey: process.env.RETELL_API_KEY! });

const agents = await retell.agent.list();
console.log(`Agents: ${agents.length}`);

Output

• Retell AI integration for observability

Error Handling

Error	Cause	Solution
401 Unauthorized	Invalid API key	Check RETELL_API_KEY
429 Rate Limited	Too many requests	Implement backoff
400 Bad Request	Invalid parameters	Check API documentation

Examples

Alert on a regression while protecting call content

Emit structured metrics for call completion, transfer outcome, latency, and provider errors using agent version and environment as bounded labels. When an alert fires, link the affected call identifiers to a restricted investigation record instead of attaching transcripts to the dashboard. Compare a synthetic call against the last known-good version, then make one reversible routing or configuration change and watch the same metrics through the defined recovery window.

Resources

• Retell AI Documentation
• retell-sdk npm

Next Steps

See related Retell AI skills for more workflows.