Справочник команды GitHub Copilot CLI

Команды командной строки

copilot login варианты

Стандартный режим аутентификации — это веб-браузерный поток. После завершения аутентификационный токен надежно хранится в системном хранилище учетных данных. Если хранилище учетных данных не найдено, маркер хранится в файле ~/.copilot/ конфигурации обычного текста (или каталог, указанный COPILOT_HOME в параметре).

В качестве альтернативы Второй пилот CLI буду использовать токен аутентификации, находящийся в переменных окружения. Следующие параметры проверяются в порядке старшинства: COPILOT_GITHUB_TOKEN, GH_TOKEN, , GITHUB_TOKEN. Этот метод наиболее подходит для безголового использования, например, для автоматизации.

Поддерживаемые типы токенов включают fine-grained personal access tokens (v2 PAT) с разрешением «Copilot Requests», токены OAuth из Copilot приложения CLI и токены OAuth из GitHub CLI приложения (gh). Classic personal access tokens (ghp_) не поддерживается.

Примеры:

# Authenticate with github.com
copilot login

# Authenticate with GitHub Enterprise Cloud (data residency)
copilot login --host https://example.ghe.com

# Use a fine-grained PAT via environment variable
COPILOT_GITHUB_TOKEN=github_pat_... copilot

С использованием copilot completion

Команда copilot completion SHELL выводит скрипт для указанной оболочки (bash, zsh или fish).

Используя этот скрипт (или записывая его в каталог завершения вашей оболочки), вы можете включить завершение вкладок в терминале для copilot подкоманд, опций команд и известных значений для опций команд.

Примеры использования

Bash (только текущая сессия):

source <(copilot completion bash)

source <(copilot completion bash)

Bash (постоянный, Linux):

copilot completion bash | sudo tee /etc/bash_completion.d/copilot

copilot completion bash | sudo tee /etc/bash_completion.d/copilot

Zsh — запишите результат в каталог на вашем $fpath. Перезагрузите оболочку после выполнения этой команды:

copilot completion zsh > "${fpath[1]}/_copilot"

copilot completion zsh > "${fpath[1]}/_copilot"

Рыба:

copilot completion fish > ~/.config/fish/completions/copilot.fish

copilot completion fish > ~/.config/fish/completions/copilot.fish

С использованием copilot plugins list

Выполните проверку copilot plugins list каждого подключаемого модуля, сервера MCP, навыка, источника инструкций и сервера языка, обнаруженного для текущего рабочего каталога. Выходные данные группируются по типу, а затем по области конфигурации (пользователь, репозиторий, организация, подключаемый модуль, встроенный или неизвестный).

# List everything for the current workspace
copilot plugins list

# Only MCP servers and skills
copilot plugins list --kind mcp --kind skill

# Only user-scoped resources, as JSON
copilot plugins list --scope user --json

Пользовательские агенты и перехватчики с областью сеанса не охватываются copilot plugins list; оба требуют динамического сеанса.

copilot plugins enable / copilot plugins disable

Включите или отключите подключаемый модуль, сервер MCP или навык по имени. Изменение сохраняется в конфигурации и применяется к будущим сеансам.

# Disable an MCP server
copilot plugins disable github --mcp

# Enable a skill
copilot plugins enable my-skill --skill

# Enable a plugin (default kind)
copilot plugins enable spark@copilot-plugins

Инструкции имеют только область действия сеанса и не могут быть переключаются с помощью этих команд. Языковые серверы, агенты и перехватчики управляются в другом месте.

copilot plugins remove

Удалите подключаемый модуль, удалите сервер MCP или удалите навык по имени.

# Remove an MCP server
copilot plugins remove github --mcp

# Delete a personal or project skill
copilot plugins remove my-skill --skill

# Uninstall a plugin (default kind)
copilot plugins remove spark@copilot-plugins

При этом --skillпередайте имя навыка или путь к добавленной вами пользовательской папке навыков. Имя навыка удаляет файлы этого навыка; Путь к пользовательскому каталогу отменяет регистрацию каталога и оставляет файлы на диске. Можно удалить только личные навыки и навыки проекта. Навыки, предоставляемые подключаемым модулем или встроенным набором, не могут быть удалены таким образом (отключить их вместо этого). Источники инструкций обнаруживаются на диске и не могут быть удалены здесь.

Глобальные ярлыки в интерактивном интерфейсе

Ярлыки временной линии в интерактивном интерфейсе

Ярлыки для сессионного выбора

Когда выбор сессии открыт (открыт через /resume или --continue):

Сессии сортируются по следующим режимам:

Сессии, уже открытые в другом окне, поднимаются наверх во всех нерелевантных режимах сортировки. Когда контекст рабочей директории отсутствует, relevance режим пропускается.

Ярлыки в режиме дифф

Когда режим дифференциала открыт (введён посредством /diff):

Навигационные ярлыки в интерактивном интерфейсе

Команды Slash в интерактивном интерфейсе

Это команды косой черты, которые можно использовать в интерактивном сеансе CLI. Подмножество этих команд косой черты доступно клиентам, которые используют ИНТЕРФЕЙС командной строки через свой сервер ACP. Дополнительные сведения см. в разделе Copilot CLI ACP сервер.

Для полного списка доступных команд слэш введите /help в интерактивный интерфейс CLI.

Параметры командной строки

Для полного списка команд и опций запустите copilot help.

Вы можете использовать --remote``--resume <TASK-ID> его для возобновления удалённых задач локально. Это работает даже тогда, когда задание изначально создавалось вне Git-репозитория.

Три источника могут устанавливать это ограничение в порядке постоянности:

Для подробностей конфигурации MDM см. Каталог конфигурации CLI GitHub Copilot.

Поддерживаемые модели

Используйте --model=MODEL переменную COPILOT_MODEL окружения для выбора модели ИИ. Пропускайте auto возможность Copilot автоматически выбирать лучшую доступную модель.

Вы также можете переключаться между моделями во время интерактивной сессии с помощью /model команды слэш.

Значения доступности инструментов

Опции и --available-tools поддерживают --excluded-tools следующие значения:

Оболочные инструменты

Инструменты управления файлами

Инструменты для делегирования агентов и задач

Другие инструменты

Шаблоны разрешений инструментов

Опции и --allow-tool принимают --deny-tool шаблоны разрешений в формате Kind(argument). Аргумент необязательн — его исключение соответствует всем подобным инструментам.

Для shell правил суффикс :* совпадает с командным стволом, за которым следует пробел, предотвращая частичные совпадения. Например, shell(git:*) совпадение git push и git pull но не совпадает giteaс .

Правила отказа всегда имеют приоритет над правилами допуска, даже если --allow-all они установлены.

# Allow all git commands except git push
copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool='MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool='MyMCP'

# Deny writes to a specific path (exact or trailing-path-segment match; no glob support yet)
copilot --deny-tool='write(secret.txt)'

--deny-tool='write(PATH)' область отрицания этого пути — другие записи не влияют на них. Совпадение разрешает асимметричные и сегменты ./.. и не учитывает регистр в macOS и Windows.

Переменные среды

Настройки конфигурационных файлов

Для подробной информации о настройках конфигурационных файлов — включая полный список пользовательских настроек, репозиториев, локальных настроек и их каскадного распределения — см. Каталог конфигурации CLI GitHub Copilot.

Project инициализация для Copilot

Когда вы используете команду copilot init, или команду слэш /init в интерактивной сессии, Copilot он анализирует вашу кодовую базу и записывает или обновляет .github/copilot-instructions.md файл в репозитории. Этот пользовательский файл инструкций содержит конкретные рекомендации по проекту, которые улучшат будущие сессии CLI.

Обычно вы используете copilot init, или /init, когда начинаете новый проект или Второй пилот CLI в существующем репозитории.

copilot-instructions.md Файл, который создаётся или обновляется, обычно документирует:

• Команды сборки, тестирования и ворса.
• Архитектура высокого уровня.
• Специфичные для кодовой базы конвенции.

Если файл уже существует, он Copilot предлагает улучшения, которые можно применить или отклонить.

CLI ищет copilot-instructions.md файл при запуске, и если он отсутствует, отображается сообщение:

💡 Инструкции второго пилота не найдено. Запустите /init, чтобы сгенерировать copilot-instructions.md файл для этого проекта.

Если вы не хотите создавать этот файл, вы можете навсегда скрыть это сообщение запуска для текущего репозитория с /init suppress помощью команды slash.

Дополнительные сведения см. в разделе Добавление пользовательских инструкций репозитория для GitHub Copilot.

Пользовательские расположения инструкций

Второй пилот CLI загружает пользовательские инструкции из этих расположений одновременно (все объединяются):

Пользовательские инструкции импортируются

Файлы инструкций поддерживают @path импорт. Префикс строки, за которой @ следует путь, чтобы встраивать содержимое другого файла. Пути могут быть относительными к каталогу файла инструкции или абсолютным. Импорт разрешается рекурсивно, вплоть до ограничения глубины, с охранниками цикла и размера. Это поддерживается в AGENTS.md, CLAUDE.mdи .github/copilot-instructions.md.

Ссылка на Hooks

Для подробной информации о крючках — включая форматы конфигурации крючков, события крючков, входные полезные нагрузки и управление решением — см. раздел AUTOTITLE.

Конфигурация сервера MCP

MCP-серверы предоставляют дополнительные инструменты агенту CLI. Настройте постоянные серверы в ~/.copilot/mcp-config.json. Используйте --additional-mcp-config для добавления серверов на одну сессию.

Локальные (stdio) серверы, которые создаются в песочнице (см /sandbox . команду косой черты), показывают connected (sandboxed) состояние и copilot mcp list``/mcp list, так как удаленные (HTTP/SSE) серверы никогда не являются изолированными. Доступно только в экспериментальном режиме.

copilot mcp Подкомандование

Используйте copilot mcp управление конфигурациями MCP-сервера из командной строки без запуска интерактивной сессии.

** copilot mcp add Параметры:**

Типы транспорта

Поля конфигурации локального сервера

Частный реестр npm

Используйте --registry в массиве args для извлечения пакета из приватного NPM-реестра — например, Artifactory или GitHub ленты пакетов:

{
    "mcpServers": {
        "my-internal-server": {
            "command": "npx",
            "args": [
                "--registry", "https://npm.pkg.github.com",
                "@my-org/internal-mcp-server"
            ],
            "tools": ["*"]
        }
    }
}

Флаг --registry и другие флаги конфигурации npm (--userconfig, , --prefix``--globalconfig, --cache``--node-options, , --workspace) -wрассматриваются как аргументы, используемые значением при вычислении отпечатка удостоверения сервера. Это гарантирует, что проверки списков разрешений и регистрации реестра корпоративных файлов работают корректно, когда эти флаги отображаются перед названием пакета.

Поля конфигурации удалённых серверов

OAuth повторная аутентификация

Удалённые MCP-серверы, использующие OAuth, могут показывать needs-auth статус после истечения срока действия токена или необходимости другого аккаунта. Используйте /mcp auth <server-name> для запуска нового потока OAuth. Это открывает запрос аутентификации в браузере, позволяющий войти в систему или сменить аккаунт. После завершения процесса сервер автоматически подключается.

Безголовый OAuth (client_credentials грант)

Для случаев использования CI или cron, когда браузер недоступен, установите oauthGrantType: "client_credentials". Этот подход включает следующие этапы.

• oauthClientId—статический идентификатор клиента, выдаваемый поставщиком MCP.
• oauthPublicClient: false—клиент конфиденциальный.
• Хранится client_secret в системном ключе (настраивается один раз через /mcp пользовательский интерфейс или записывается в хранилище учетных данных OAuth).

При настройке CLI полностью пропускает браузер, сервер обратного вызова, PKCE и динамическую регистрацию клиента. На каждом 401 он отправляется grant_type=client_credentials напрямую на обнаруженный токен сервера.

{
    "mcpServers": {
        "headless-api": {
            "type": "http",
            "url": "https://api.example.com/mcp",
            "tools": ["*"],
            "oauthClientId": "YOUR-CLIENT-ID",
            "oauthPublicClient": false,
            "oauthGrantType": "client_credentials"
        }
    }
}

Фильтровое отображение

Контролировать, как обрабатывается вывод инструмента MCP с помощью filterMapping поля в конфигурации сервера.

Встроенные MCP-серверы

CLI включает встроенные MCP-серверы, доступные без дополнительной настройки.

Используйте --disable-builtin-mcps для отключения всех встроенных серверов или --disable-mcp-server SERVER-NAME для отключения конкретного сервера.

GitHub Инструменты серверов MCP

Он github-mcp-server предоставляет следующие инструменты.

Наименование серверов MCP

Имена серверов могут содержать любые печатные символы, включая пробелы, символы Unicode и пунктуацию. Контрольные символы (U+0000–U+001F, U+007F) и закрывающая распорка (}) не разрешены. Имена серверов используются как префиксы для имён инструментов — например, сервер с именем my-server создаёт имена инструментов, такие как my-server-fetch, а сервер с именем My Server — .My Server-fetch

Очистка названий инструментов MCP

Имена серверов и инструментов MCP очищаются перед отправкой в модель. Символы, недопустимые в названиях инструментов (кроме a-z, A-Z, 0-9``-``_), заменяются на .- Символы Unicode кодируются в Punycode. Символ также заменён на@, - чтобы избежать конфликтов с кодированием Punycode.

Объединённое имя (serverName-toolName) ограничено 64 символами. Когда усечение вызывает коллизию имён, добавляется числовой суффикс (например, my-server-tool2, my-server-tool3) для обеспечения уникальности.

Уровни доверия сервера MCP

MCP-серверы загружаются из нескольких источников, каждый с разным уровнем доверия.

Все вызовы инструментов MCP требуют явного разрешения. Это относится даже к операциям только для чтения на внешних сервисах.

Приоритет загрузки сервера MCP

MCP-серверы из разных источников объединяются в порядке приоритета (сначала выше). Когда серверы имеют одинаковое имя, приоритет имеет источник с более высоким приоритетом.

1. --additional-mcp-config Флаг (самый высокий)
2. Серверы, предоставляемые плагинами
3. Серверы рабочего пространства —.mcp.json и .github/mcp.json загружаемые от рабочей папки вверх до корня Git; требуют, чтобы папка была доверена
4. ~/.copilot/mcp-config.json (самый низкий)

Список разрешений корпоративного MCP

GitHub Enterprise организации могут применять список разрешений для разрешённых MCP-серверов. При активном режиме CLI оценивает каждый нестандартный сервер по корпоративной политике перед подключением.

Когда обнаруживается GitHub Enterprise политика реестра (или MCP_ENTERPRISE_ALLOWLIST включен флаг экспериментальной функции), CLI:

1. Вычисляет отпечаток пальца для каждого настроенного нестандартного сервера на основе его команды, аргументов и удалённых URL.
2. Отправляет отпечатки пальцев в конечную точку оценки корпоративного списка разрешений.
3. Разрешено только серверы, чьи отпечатки одобрены; все остальные блокируются сообщением с названием Enterprise.

Эта проверка является fail-closed: если конечная точка оценки недоступна или возвращает ошибку, нестандартные серверы блокируются до проверки политики.

Когда сервер блокируется корпоративным списком разрешений, CLI отображает:

MCP server "SERVER-NAME" was blocked by your enterprise "ENTERPRISE-NAME".
Contact your enterprise administrator to add this server to the allowlist.

Встроенные серверы по умолчанию всегда освобождаются от контроля по спискам разрешений.

Миграция из .vscode/mcp.json

Если ваш проект использует .vscode/mcp.json (формат конфигурации MCP VS Code), переходите на .mcp.json для интерфейс командной строки GitHub Copilot. Миграция переназначает servers ключ на mcpServers.

Раковины POSIX (bash, zsh, fish и другие):

jq '{mcpServers: .servers}' .vscode/mcp.json > .mcp.json

Требует jq.

PowerShell:

pwsh -NoProfile -Command "`$json = Get-Content '.vscode/mcp.json' -Raw | ConvertFrom-Json; `$content = ([pscustomobject]@{ mcpServers = `$json.servers } | ConvertTo-Json -Depth 100); [System.IO.File]::WriteAllText('.mcp.json', `$content, (New-Object System.Text.UTF8Encoding `$false))"

В Windows замените pwsh на powershell, если используете Windows PowerShell вместо PowerShell Core.

Выходные данные сервера Stdio

Транспорт MCP stdio резервирует stdout исключительно для фреймов с разделителями новой линии JSON-RPC. Интерфейс командной строки автоматически фильтрует любые строки, отличные от JSON— журналы обычного текста, трассировки стека исключений или строки только пробелов, прежде чем передавать выходные данные в средство синтаксического анализа протокола.

Записывает все диагностические выходные данные в stderr, а не stdout. Сервер, который записывает журналы или сообщения об ошибках в stdout, может активировать цикл обратной связи синтаксического анализа ошибок, который останавливает подтверждение инициализации; Фильтр предотвращает это путем автоматического удаления кадров, отличных от JSON.

Линии длиной более 1 МБ обходят структурную проверку и перенаправляются as-is, чтобы избежать разделения или уменьшения превышения размеров, но допустимых кадров протокола (например, большой tools/list ответ).

Справочник по навыкам

Навыки — это файлы Markdown, которые расширяют возможности CLI. Каждый навык находится в отдельном каталоге с SKILL.md файлом. При вызове (через /SKILL-NAME агента или автоматически) содержание навыка вводится в разговор.

Фронтматические поля навыков

Места навыков

Навыки загружаются из этих мест в порядке приоритета (первым найденным выигрывает дублирующиеся имена).

Удалённые навыки проецируются наряду с местными навыками и следуют тому же приоритету, основанному на названии, если локальный навык имеет одинаковое название.

Если два подключаемых модуля предоставляют навыки с одинаковым именем, оба они сосуществуют с использованием имен вызовов с поддержкой подключаемых модулей, таких как /my-plugin/search и /other-plugin/search. Голое имя направляется в подключаемый модуль с более высоким приоритетом. Это относится только к навыкам; команды сохраняют дедупликацию на основе стандартных уровней, где выигрывает более высокий приоритет источника.

Команды (альтернативный формат навыка)

Команды являются альтернативой навыкам, хранящимся в отдельных .md файлах в .claude/commands/. Имя команды происходит от имени файла. Командные файлы используют упрощённый формат (поле не name требуется) и поддерживают argument-hint, description, allowed-tools, и disable-model-invocation. Команды имеют меньший приоритет, чем умения с таким же названием.

Ссылка на таможенных агентов

Пользовательские агенты — это специализированные AI-агенты, определённые в файлах Markdown. Имя файла (без расширения) становится идентификатором агента. Используйте .agent.md или .md как расширение файла.

Встроенные агенты

Фронтматэрные поля пользовательского агента

Местоположение кастомных агентов

Для агентов с проектной областью действия CLI идёт вверх от текущего рабочего каталога к корню Git, загружаясь .github/agents/ и .claude/agents/ загружая каталоги на каждом уровне предков. Это означает, что каждый пакет или подкаталог в монорепо может вводить своих собственных агентов. Когда на пути существует несколько .github/agents/ каталогов, все загружаются, при этом самый глубокий каталог получает наивысший приоритет. .github/agents/ Конвенция имеет приоритет .claude/agents/ на том же уровне. Агенты пользовательского уровня имеют меньший приоритет, чем агенты на уровне проекта. Агенты плагинов имеют самый низкий приоритет.

Обмен данными агента

Используйте list_agents``write_agent и используйте пользовательские агенты для инспекции близлежащих агентов и координации работы в сессии с несколькими агентами.

Метки отношений в list_agents

Метки отношений определяют, как видимые агенты связаны с текущим агентом. Метки появляются, когда субагент работает внутри родительской сессии с включенной общей связью между братьями и сестрами.

Перечень с областью объёма

Используйте scope on list_agents , чтобы сузить список перед выбором целей.

В сессиях с одним агентом стандартный вид сосредоточен на дочерних агентах. В сессиях с несколькими агентами по умолчанию отображается локальный контекст, а не всё дерево.

list_agents(scope="siblings")
list_agents(scope="children")
list_agents(scope="all")

Обмежённые сообщения

Используйте scope для write_agent передачи одного сообщения нескольким связанным агентам.

Используйте обмежённые сообщения только от субагента, работающего внутри родительской сессии с включенной общей связью между братьями и сестрами. В сессиях верхнего уровня выбирайте агентов с явными agent_id значениями.

Если область совпадает с слишком большим количеством агентов, write_agent возвращается ошибка и вместо этого запрашивает явные agent_id значения из list_agents .

write_agent(scope="children", message="Re-check your findings against the updated schema.")
write_agent(scope="siblings", message="Post status when your current check completes.")
write_agent(agent_id="explore-auth", message="Focus on token refresh flow and report only confirmed issues.")

Ограничения субагентов

CLI устанавливает ограничения на глубину и параллельность, чтобы предотвратить появление неуправляемых агентов.

Глубина определяет, сколько агентов вложено друг в друга. При достижении предела глубины самый внутренний агент не может создавать новые субагенты. Параллельность подсчитывает, сколько субагентов работает одновременно на протяжении всего дерева сессий. При достижении лимита новые запросы субагентов отклоняются до тех пор, пока активный агент не завершит работу.

Лимит по умолчанию зависит от вашего Copilot тарифа:

Пользователи выставления счетов на основе использования могут переопределить эти ограничения с subagents.maxConcurrency помощью параметров и subagents.maxDepth параметров:

{
    "subagents": {
        "maxConcurrency": 16,
        "maxDepth": 10
    }
}

Значения за пределами допустимого диапазона зажаты: maxConcurrency ограничена 32``maxDepth и ограничена256. Эти параметры игнорируются для планов, которые не используют выставление счетов на основе использования. См. раздел параметров файла конфигурации.

Агенты-помощники

Агенты Sidekick работают автоматически в фоне и публикуют контекст во входящие сессии. Они реагируют на события сессии, а не на прямое вызвание.

Добавьте sidekick: блок к любому определению агента, чтобы сделать его агентом-помощником:

---
name: Context Gatherer
description: Gathers relevant context when the working directory changes
sidekick:
    triggers:
        - session.context_changed
        - event: user.message
          limit: 1
    behavior: persistent
    maxSendsPerTurn: 2
---

Gather useful context about the current repository and working directory.
Summarize recent changes and any relevant project structure.

Триггеры Sidekick

Каждая запись является triggers либо строкой имени события, которая вызывает неограниченное количество раз, либо объект с event и необязательным limit.

Поля конфигурации помощников

Такое "restart" поведение подходит для агентов, собирающих контекст без статуса. Такое "persistent" поведение подходит агентам, которые накапливают состояние по ходам.

Ответы на одобрение разрешений

Когда CLI запросит разрешение на выполнение операции, вы можете ответить следующими клавишами.

Когда появляется полный диалог, вы также можете выбрать один из следующих вариантов:

Опция This location появляется, когда CLI может определить ключ местоположения (корень Git или текущий каталог). Он сохраняет одобрение для диска, так что то же разрешение автоматически получается при следующей работе с этой директорией без повторного запроса.

Используйте /permissions reset для очистки одобрений в памяти для текущей сессии.

Security

Режим планирования

/plan запускает сеанс анализа только для чтения, который предотвращает выполнение операций записи и команд оболочки, позволяя полностью исследовать базу кода. Изменение вызовов средства — редактор записывает файлы, не планирующие файлы, apply_patch изменяя команды оболочки и создание запроса на вытягивание, жестко блокируются на уровне инструментов, а не просто не рекомендуется системным запросом. Подагенты, рожденные из сеанса в режиме плана, наследуют то же ограничение. Операции чтения и записи в сам файл плана по-прежнему разрешены.

Анализ безопасности командования

Команды оболочки анализируются перед выполнением для выявления потенциально опасных паттернов:

• Удаление файла (rm -rf)
• Модификации системы (sudo, chmod 777)
• Сетевая эвакуация (curl с чувствительными путями)
• Доступ к учётным данным (чтение .env, SSH-ключи)
• Встроенные переменные среды, которые переопределяют опасные переменные (например, PATH=..., LD_PRELOAD=...)

Команды высокого риска отображают дополнительные предупреждения и требуют явного подтверждения.

Отрицающий переменные среды

CLI блокирует встроенное назначение переменных среды, которые могут быть использованы для выполнения произвольного кода даже в иначе командах только для чтения. Заблокированные категории включают:

web_fetch Защита SSRF

Инструмент обеспечивает защиту от web_fetch подделки запросов на стороне сервера (SSRF) перед выполнением любого HTTP-запроса:

• Протокольный лист разрешений: разрешены только http:// URL-адреса https:// . file:// а другие схемы отклоняются.
• IP-блоклист: Запросы на адреса loopback (127.x.x.x, ::1), частные диапазоны RFC-1918 (10.x, 172.16–31.x, 192.168.x) и облачные метаданные (например, 169.254.169.254) блокируются IP-литеральной проверкой и предварительным разрешением DNS.
• Автоматических перенаправления нет: 3xx перенаправления не следуют автоматически. URL целевого направления повторно проверяется по тому же IP-блоку перед переходом.

Чтобы обеспечить web_fetch доступ localhost во время разработки — например, для локального сервера документации — установите следующую переменную среды:

export COPILOT_WEB_FETCH_ALLOW_LOCALHOST=1

Мониторинг OpenTelemetry

Второй пилот CLI может экспортировать трассы и метрики через OpenTelemetry (OTel), что даёт вам видимость взаимодействия с агентами, вызовы LLM, выполнение инструментов и использование токенов. Все имена и атрибуты сигналов следуют семантическим конвенциям OTel GenAI.

OTel по умолчанию выключен без накладных расходов. Он активируется при выполнении любого из следующих условий:

• COPILOT_OTEL_ENABLED=true
• OTEL_EXPORTER_OTLP_ENDPOINT задано
• COPILOT_OTEL_FILE_EXPORTER_PATH задано

Конфигурацию OTel можно также задать в VS Codeили в корпоративном managed-settings.json файле. См. сведения о включении мониторинга OTel в VS Code документации и Справочник по управляемым параметрам предприятия.

Переменные среды OTel

Traces

Время выполнения создаёт иерархическое дерево span для каждого взаимодействия агента. Каждое дерево содержит корневый invoke_agent размах, с chat и execute_tool дочерними spans.

invoke_agent Атрибуты размаха

Обворачивает весь вызов агента: все LLM-вызовы и выполнение инструментов для одного пользовательского сообщения.

• Верхнеуровневые сессии используют span kind CLIENT (удалённый вызов сервиса) с server.address и server.port.
• Вызовы субагентов (например, explore, task) используют span kind INTERNAL (in-process) без атрибутов сервера.

chat Атрибуты размаха

Один проём на запрос LLM. Размах видов: CLIENT.

execute_tool Атрибуты размаха

Один размах на вызов инструмента. Размах видов: INTERNAL.

Metrics

Метрики конвенции GenAI

Метрики, специфичные для поставщика

Временные события

События жизненного цикла, зафиксированные на активном chat или invoke_agent промежуточном цикле.

Атрибуты ресурсов

Все сигналы несут эти атрибуты ресурсов.

Захват контента

По умолчанию не фиксируется содержимое запросов, ответы или аргументы инструментов — только метаданные, такие как названия моделей, количество токенов и длительность. Чтобы охватить полный контент, установите OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true.

Когда включено захват контента, заполняются следующие атрибуты.

Дополнительные материалы

• интерфейс командной строки GitHub Copilot
• Ссылка на крючки GitHub Copilot
• Ссылка на плагин GitHub Copilot CLI
• GitHub Copilot CLI программный справочник
• Каталог конфигурации CLI GitHub Copilot