Overview
Implementation patterns for Retell AI ci integration — voice agent and telephony platform.
Prerequisites
- Completed
retellai-install-authsetup
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 ci integration
## 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
### Validate an agent configuration in a pull request
In CI, lint the agent configuration and run a scripted call against a dedicated
test agent using a masked test credential. Assert the expected tool invocation,
handoff outcome, and redacted transcript markers, but never upload real call
audio or customer data. Publish the test result as a PR artifact and require a
separate promotion step before the tested configuration reaches a live number.
## 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.