calling_agent.py

"""
---
title: Outbound Calling Agent
category: telephony
tags: [telephony, outbound-calls, survey, ice-cream-preference]
difficulty: beginner
description: Agent that makes outbound calls to ask about ice cream preferences
demonstrates:
  - Outbound call agent configuration
  - Goal-oriented conversation flow
  - Focused questioning strategy
  - Brief and direct interaction patterns
  - Automatic greeting generation
---
"""

import logging
import os
from pathlib import Path
from dotenv import load_dotenv
from livekit.agents import JobContext, WorkerOptions, cli, Agent, AgentSession
from livekit.plugins import openai, silero, deepgram

load_dotenv()

logger = logging.getLogger("calling-agent")
logger.setLevel(logging.INFO)

class SimpleAgent(Agent):
    def __init__(self) -> None:
        super().__init__(
            instructions="""
                You are calling someone on the phone. Your goal is to know if they prefer
                chocolate or vanilla ice cream. That's the only question you should ask, and
                you should get right to the point. Say something like "Hello, I'm calling to
                ask you a question about ice cream. Do you prefer chocolate or vanilla?"
            """,
            stt=inference.STT(
                model="deepgram/nova-3-general"
            ),
            llm=inference.LLM(
                model="openai/gpt-5-mini",
                provider="openai",
            ),
            tts=inference.TTS(
                model="cartesia/sonic-3",
                voice="9626c31c-bec5-4cca-baa8-f8ba9e84c8bc",
            ),
            vad=silero.VAD.load()
        )

    async def on_enter(self):
        self.session.generate_reply()

async def entrypoint(ctx: JobContext):
    session = AgentSession()

    await session.start(
        agent=SimpleAgent(),
        room=ctx.room
    )

if __name__ == "__main__":
    cli.run_app(WorkerOptions(entrypoint_fnc=entrypoint))