retellai-observability

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](https://docs.retellai.com)
- [retell-sdk npm](https://www.npmjs.com/package/retell-sdk)

## Next Steps

See related Retell AI skills for more workflows.