Azure AI Agent Server – GitHub Copilot SDK Adapter

This package provides an adapter that lets you run a GitHub Copilot SDK session as an Azure AI Agent Server endpoint, in the same way that azure-ai-agentserver-langgraph and azure-ai-agentserver-agentframework wrap their respective frameworks.

Getting Started

Install

pip install azure-ai-agentserver-copilot

Prerequisites

• Python 3.10+
• GitHub Copilot CLI installed and in $PATH
• Valid GitHub Copilot authentication (gh auth login)

Install azd app (Local Development)

azd app lets you run all project services locally with a single command, with auto-dependencies, a real-time dashboard, and AI-powered debugging via MCP.

1. Install the Azure Developer CLI (if not already installed):

   # Windows
   winget install microsoft.azd
   
   # macOS
   brew tap azure/azd && brew install azd
   
   # Linux
   curl -fsSL https://aka.ms/install-azd.sh | bash
   

2. Add the extension source and install azd app:

   azd extension source add -n jongio -t url -l https://jongio.github.io/azd-extensions/registry.json
   azd extension install jongio.azd.app
   

3. Run the project:

   azd app run
   

Usage

import asyncio
from azure.ai.agentserver.copilot import from_copilot

async def main():
    agent = from_copilot({"model": "gpt-5"})
    await agent.run_async()

asyncio.run(main())

Once the server is running, send requests:

# Non-streaming
curl -sS -H "Content-Type: application/json" \
  -X POST http://localhost:8088/responses \
  -d '{"input":"What is the capital of France?","stream":false}'

# Streaming
curl -N -H "Content-Type: application/json" \
  -X POST http://localhost:8088/responses \
  -d '{"input":"Explain Python decorators briefly.","stream":true}'

Key Concepts

The adapter converts incoming OpenAI-format requests into Copilot SDK MessageOptions, runs them through a Copilot session, and converts the resulting SessionEvent objects back into OpenAI-format responses.

Both streaming (Server-Sent Events) and non-streaming (JSON) modes are supported.

Troubleshooting

Next Steps

See the samples directory for runnable examples.