retellai-hello-world

name	retellai-hello-world
description	Retell AI hello world — AI voice agent and phone call automation. Use when working with Retell AI for voice agents, phone calls, or telephony. Trigger with phrases like "retell hello world", "retellai-hello-world", "voice agent".
allowed-tools	Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep
version	1.9.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","retellai","voice","telephony","ai-agents"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Retell AI Hello World

Overview

Create your first Retell AI voice agent and make a test phone call.

Prerequisites

• Completed retellai-install-auth
• A phone number registered in Retell AI Dashboard (or use web call for testing)

Instructions

Step 1: Create an LLM Configuration

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

// Create LLM configuration (what the agent says)
const llm = await retell.llm.create({
  model: 'gpt-4o',
  general_prompt: `You are a friendly receptionist for Acme Corp.
    - Greet callers warmly
    - Ask how you can help
    - Take messages if needed
    - Be concise and professional`,
});
console.log(`LLM created: ${llm.llm_id}`);

Step 2: Create a Voice Agent

const agent = await retell.agent.create({
  response_engine: {
    type: 'retell-llm',
    llm_id: llm.llm_id,
  },
  voice_id: '11labs-Adrian',  // Choose from available voices
  agent_name: 'Acme Receptionist',
});
console.log();