tonybaloney-azure-ai-agentserver-copilot 1.0.0b3

GitHub Copilot SDK adapter for Azure AI Agent Server

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

Problem	Fix
CopilotClient fails to start	Ensure the Copilot CLI is installed and gh auth login has been run.
Timeout errors	The default session timeout is 300 s. For long-running prompts, set a higher timeout.

Next Steps

See the samples directory for runnable examples.