GitHub Copilot

Use GitHub Copilot’s hosted models with docker-agent through your existing GitHub subscription.

Overview

GitHub Copilot exposes an OpenAI-compatible Chat Completions API at https://api.githubcopilot.com. docker-agent ships with built-in support for it as the github-copilot provider, so any user with a paid GitHub Copilot subscription can reuse their entitlement from docker-agent.

Prerequisites

• An active GitHub Copilot subscription (Individual, Business, or Enterprise).
• A personal access token with the copilot scope, exported as GITHUB_TOKEN.

export GITHUB_TOKEN="ghp_..."

Configuration

Inline

agents:
  root:
    model: github-copilot/gpt-4o
    instruction: You are a helpful assistant.

Named model

models:
  copilot:
    provider: github-copilot
    model: gpt-4o
    temperature: 0.7
    max_tokens: 4000

agents:
  root:
    model: copilot

Available Models

The exact set of models you can call depends on your Copilot plan. The most commonly available ones today are:

Check the GitHub Copilot documentation for the current model list.

Copilot-Integration-Id Header

GitHub’s Copilot API rejects requests that don’t carry a Copilot-Integration-Id header with a Bad Request error. docker-agent automatically sends copilot-developer-cli for the github-copilot provider, so PAT-based usage works out of the box.

We specifically chose copilot-developer-cli (instead of, say, vscode-chat) because it is the integration id accepted by the Copilot API for both OAuth tokens and Personal Access Tokens. Most docker-agent users authenticate with a PAT exported as GITHUB_TOKEN, and vscode-chat is rejected for those tokens.

If you need to send a different integration id — for example if your organization allows-lists a specific value — you can override it via provider_opts.http_headers:

models:
  copilot:
    provider: github-copilot
    model: gpt-4o
    provider_opts:
      http_headers:
        Copilot-Integration-Id: my-custom-integration

Header names are matched case-insensitively, so copilot-integration-id works too.

Custom HTTP Headers

provider_opts.http_headers is a generic escape hatch that works for any OpenAI-compatible provider, not just GitHub Copilot. Every key/value pair is added to every outgoing request:

models:
  my_model:
    provider: openai
    model: gpt-4o
    provider_opts:
      http_headers:
        X-Request-Source: docker-agent
        X-Tenant-Id: my-team

How It Works

GitHub Copilot is implemented as a built-in alias in docker-agent:

• API type: OpenAI-compatible (Chat Completions)
• Base URL: https://api.githubcopilot.com
• Token variable: GITHUB_TOKEN
• Default headers: Copilot-Integration-Id: copilot-developer-cli

This means the same client as OpenAI is used, so every OpenAI feature supported by docker-agent (tool calling, structured output, multimodal inputs, etc.) is available when the underlying model supports it.