Model Configuration

Three model paths for the Copilot SDK. Each session needs different configuration.

Path 1: GitHub Default

No configuration needed. SDK uses the default model.

const session = await client.createSession({});
// or simply: client.createSession()

Best for: quick prototyping, no model preference.

Path 2: GitHub Specific Model

Specify a model name. Discover available models with listModels().

const models = await client.listModels();
// Pick from available models
const session = await client.createSession({
  model: "o4-mini",
});

Path 3: Azure BYOM (Bring Your Own Model)

Use your own Azure AI deployment. For local development use DefaultAzureCredential; for production use ManagedIdentityCredential — see auth-best-practices.md.

⚠️ Warning: The Copilot SDK encrypts prompt content. Only models that support decrypting encrypted content work with BYOM. Using unsupported models returns "400 Encrypted content is not supported" or silently times out.

Supported Models

Required API Settings

Provider Config

Code Pattern

Auth: DefaultAzureCredential is for local development. See auth-best-practices.md for production patterns.

import { DefaultAzureCredential } from "@azure/identity";

const credential = new DefaultAzureCredential();
const { token } = await credential.getToken("https://cognitiveservices.azure.com/.default");

const session = await client.createSession({
    model: process.env.MODEL_NAME || "o4-mini",
    provider: {
        type: "azure",
        baseUrl: process.env.AZURE_OPENAI_ENDPOINT,
        bearerToken: token,
        wireApi: "completions",
        azure: { apiVersion: "2025-04-01-preview" },
    },
});

Environment Variables

Token Refresh

⚠️ Warning: bearerToken is static — no auto-refresh.

• Tokens valid ~1 hour
• Production: get fresh token per request
• Long-running sessions fail after expiry

Discovering Azure Deployments

listModels() returns GitHub models only. For Azure deployments:

az cognitiveservices account deployment list --name <resource> --resource-group <rg>

Template Environment Variables

The template uses env vars for model path selection:

Errors