import logging import os from typing import List, Optional from dotenv import load_dotenv from livekit.agents import ( Agent, AgentSession, ChatContext, JobContext, WorkerOptions, cli, function_tool, mcp, ) from livekit.plugins import deepgram, openai, silero from livekit.plugins.turn_detector.multilingual import MultilingualModel load_dotenv(os.path.join(os.path.dirname(__file__), "..", "..", ".env")) logger = logging.getLogger("contact-agent") class ContactAgent(Agent): def __init__( self, chat_ctx: ChatContext, tools: Optional[List[function_tool]] = None ) -> None: final_instructions = ( "You are a Contact specialist. You can help find contact information such as phone " "numbers, email addresses, or other details for individuals. " + "You can also add new contacts or update existing ones if tools like " "'get_contact_details', 'add_contact', 'update_contact' are available. " + "If your task is complete or the user asks for something outside your contact " "management capabilities (e.g., math, web search), you MUST use the " "'delegate_to_router_agent' tool to return to the main assistant." ) all_tools = tools if tools is not None else [] mcp_servers_list = [] zapier_mcp_url = os.getenv("ZAPIER_CONTACT_MCP_URL") if zapier_mcp_url: mcp_servers_list.append( mcp.MCPServerHTTP( url=zapier_mcp_url, timeout=5, client_session_timeout_seconds=5, ) ) else: logger.warning( "ZAPIER_CONTACT_MCP_URL not set. Contact agent may not have all its tools." ) super().__init__( instructions=final_instructions, chat_ctx=chat_ctx, allow_interruptions=True, mcp_servers=mcp_servers_list, tools=all_tools, ) async def on_enter(self): self.session.generate_reply() async def entrypoint(ctx: JobContext): await ctx.connect() session = AgentSession( vad=silero.VAD.load(), stt=deepgram.STT(model="nova-3", language="multi"), llm=openai.LLM(model="gpt-4o-mini"), tts=openai.TTS(voice="alloy"), turn_detection=MultilingualModel(), ) await session.start(agent=ContactAgent(chat_ctx=session._chat_ctx), room=ctx.room) if __name__ == "__main__": cli.run_app(WorkerOptions(entrypoint_fnc=entrypoint))