microsoft-agents-copilotstudio-client

import os from microsoft.copilotstudio.agents import Agent from microsoft.copilotstudio.agents.extension import AgentExtension from microsoft.copilotstudio.agents.models import AgentActivity, UserMessage from microsoft.copilotstudio.agents.turn_context import TurnContext # Define your agent agent = Agent() # Define an initial message handler @agent.on_message("initial_message") async def initial_message_handler(turn_context: TurnContext): user_message = turn_context.activity.value if user_message and isinstance(user_message, UserMessage): print(f"Received initial message: {user_message.text}") await turn_context.send_activity( AgentActivity(value="Hello! I'm your Copilot Studio Agent.") ) else: print("Received activity is not a UserMessage for initial_message.") # Define a follow-up message handler @agent.on_message("follow_up_message") async def follow_up_message_handler(turn_context: TurnContext): user_message = turn_context.activity.value if user_message and isinstance(user_message, UserMessage): print(f"Received follow-up message: {user_message.text}") await turn_context.send_activity( AgentActivity(value=f"You said: '{user_message.text}'. How can I help further?") ) else: print("Received activity is not a UserMessage for follow_up_message.") # Create the AgentExtension application # APP_ID and APP_PASSWORD are required for Copilot Studio to authenticate and connect. # For local testing, you might leave them empty, but they are critical for deployment. app = AgentExtension(agent, app_id=os.environ.get("COPILOT_STUDIO_APP_ID", ""), app_password=os.environ.get("COPILOT_STUDIO_APP_PASSWORD", "")) # To run this agent locally: # 1. Save this code as `app.py`. # 2. Ensure `uvicorn` is installed (`pip install uvicorn`). # 3. From your terminal, execute: `uvicorn app:app --host 0.0.0.0 --port 3978` # This will start a web server for your agent, accessible at http://localhost:3978