Merge edmundman's UFC_FIGHT_PREDICTOR contribution

environments/community/router_env/engine/agents/contact_agent.py

@@ -0,0 +1,84 @@
+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))