INTEGRITY Документация

← Настройка агентов / agent-setup

GitHub Copilot + Cloudflare

Все агенты
GitHub

Расширение для редактора и инструмент командной строки с режимом агента, контекстом рабочей области и встроенной интеграцией с PR. Разработано GitHub.

ТерминалОблакоРасширение
Cloudflare SkillsCloudflare Code Mode API MCPСпециализированные MCP-серверы CloudflareДокументация GitHub Copilot

быстрый старт

  1. Установите GitHub Copilot

    Установите расширение GitHub Copilot в VS Code из Visual Studio Marketplace ↗. Для JetBrains IDE, Visual Studio или Xcode см. Установите расширение Copilot ↗ руководство.

  2. Установите Cloudflare Skills

    npx skills add https://github.com/cloudflare/skills

  3. Настройка MCP-серверов Cloudflare

    Для VS Code добавьте в .vscode/mcp.json. Для Copilot CLI добавьте в ~/.copilot/mcp-config.json для конфигурации на уровне пользователя либо .mcp.json или .github/mcp.json для конфигурации на уровне проекта. Про MCP серверы для конкретных продуктов см. mcp-server-cloudflare ↗. Сведения о полнофункциональном MCP-сервере Cloudflare API (Code Mode) см. в разделе cloudflare/mcp ↗.

    {
  "mcpServers": {
    "cloudflare": { "url": "https://mcp.cloudflare.com/mcp" },
    "cloudflare-docs": { "url": "https://docs.mcp.cloudflare.com/mcp" },
    "cloudflare-bindings": { "url": "https://bindings.mcp.cloudflare.com/mcp" },
    "cloudflare-builds": { "url": "https://builds.mcp.cloudflare.com/mcp" },
    "cloudflare-observability": { "url": "https://observability.mcp.cloudflare.com/mcp" }
  }
}

  4. Попробовать промпт

    Откройте Copilot Chat (Ctrl+Shift+I), переключитесь в режим агента и попробуйте промпт, например:

    Optimize my Worker to serve WebP images with responsive resizing using Cloudflare Images.

Доступ к платформе Cloudflare

Разверните любой раздел, чтобы узнать больше.

Cloudflare Skills

Постоянный контекст платформы, который объясняет агенту, как работает Cloudflare.

Skills: инструкции, которые агент загружает по требованию. См. cloudflare/skills пакет охватывает все уровни платформы, поэтому агент знает ваши соглашения и вам не нужно объяснять их заново.

  • agents-sdkСоздавайте ИИ-агентов на Cloudflare Workers с помощью Agents SDK. Загружайте этот навык при создании агентов с состоянием, устойчивых Workflows, приложений на WebSocket в реальном времени, отложенных задач, MCP-серверов, чат-приложений, голосовых агентов или автоматизации браузера. Охватывает класс Agent, управление состоянием, вызываемый RPC, Workflows, устойчивое выполнение, очереди, повторные попытки, observability и React hooks. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении модели.
  • cloudflareКомплексный навык по платформе Cloudflare, охватывающий Workers, Pages, хранилища (KV, D1, R2), ИИ (Workers AI, Vectorize, Agents SDK), функциональные флаги (Flagship), сети (Tunnel, Spectrum), безопасность (WAF, DDoS) и инфраструктуру как код (Terraform, Pulumi). Используйте для любых задач разработки на Cloudflare. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении.
  • cloudflare-email-serviceОтправка и получение транзакционных писем через Cloudflare Email Service (Email Sending + Email Routing). Используйте при реализации отправки почты (binding Workers или REST API), маршрутизации почты, обработки почты в Agents SDK либо интеграции почты в любое приложение: Workers, Node.js, Python, Go и т. д. Также используйте для вопросов доставляемости почты, SPF/DKIM/DMARC, настройки wrangler для почты, MCP инструментов для почты или когда агенту для написания кода нужно отправить письмо. Даже для простых запросов вроде «добавь почту в мой Worker» этот skill содержит важные детали настройки.
  • cloudflare-one"Помогает в работе с Cloudflare One Zero Trust и SASE в Access, Gateway, WARP, Tunnel, Cloudflare WAN, DLP, CASB, device posture и identity. Используйте при проектировании, настройке, устранении неполадок или проверке развёртываний Cloudflare One. Приоритет на актуальные данные: используйте текущую документацию Cloudflare и схемы API вместо встроенной документации по продуктам."
  • cloudflare-one-migrationsПланирует миграцию с Zscaler ZIA/ZPA, Palo Alto, устаревших VPN, SWG или SASE стеков на Cloudflare One. Используется для оценки миграции, сопоставления политик, планов развёртывания и анализа соответствия функциональности.
  • durable-objectsСоздание и проверка Cloudflare Durable Objects. Используйте при разработке систем с сохранением состояния (чаты, многопользовательские игры, системы бронирования), реализации RPC-методов, хранилища SQLite, будильников (alarms), WebSockets, а также при проверке кода DO на соответствие лучшим практикам. Охватывает интеграцию с Workers, конфигурацию wrangler и тестирование с помощью Vitest. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении.
  • sandbox-migrate-to-nextИспользуется при переносе приложения Cloudflare Sandbox со стабильной версии @cloudflare/sandbox на @cloudflare/sandbox@next (превью Sandbox SDK 1.0), а также когда пользователь просит выполнить миграцию или обновление до Sandbox 1.0 или @next. Не подходит для повседневной работы со стабильной версией (sandbox-stable) или новых приложений на @next (sandbox-next).
  • sandbox-nextИспользуется при создании или изменении приложений Cloudflare Sandbox на @cloudflare/sandbox@next (превью Sandbox SDK 1.0): выполнение кода, ИИ-раннеры, интерпретаторы, задачи в духе CI, терминалы, файлы, точки монтирования, туннели, preview URL, жизненный цикл или ошибки. Не подходит для стабильного пакета по умолчанию (используйте sandbox-stable) и для переноса со стабильной версии на @next (используйте sandbox-migrate-to-next).
  • sandbox-stableИспользуется при создании или изменении приложений Cloudflare Sandbox на текущем стабильном пакете @cloudflare/sandbox (тег npm по умолчанию): команды, сессии, файлы, порты, туннели, терминалы, bridge, продакшен или очистка устаревшего API при сохранении стабильной версии. Не подходит для @cloudflare/sandbox@next (используйте sandbox-next) и для переноса на версию 1.0 (используйте sandbox-migrate-to-next).
  • turnstile-spinНастраивает Cloudflare Turnstile в проекте от начала до конца. Сканирует кодовую базу, создаёт виджет через Cloudflare API, встраивает его там, где запросам пользователя нужна проверка на бота (отправка форм, действия в SPA, API endpoints, ссылки для скачивания, отправка комментариев или голосов и т. д.), подключает каноническую серверную проверку siteverify в существующем бэкенде клиента, выполняет валидацию и сохраняет skill. Загружайте, когда пользователь просит добавить Turnstile, настроить CAPTCHA, защитить форму или endpoint от ботов либо исправить интеграцию Turnstile. Отражает developers.cloudflare.com/turnstile/spin.
  • web-perfАнализирует производительность веб-страниц с помощью Chrome DevTools MCP. Измеряет Core Web Vitals (LCP, INP, CLS) и дополнительные метрики (FCP, TBT, Speed Index), выявляет ресурсы, блокирующие рендеринг, цепочки сетевых зависимостей, сдвиги макета, проблемы кеширования и пробелы в доступности. Используйте этот навык, когда нужно провести аудит, профилирование, отладку или оптимизацию скорости загрузки страницы, показателей Lighthouse или скорости сайта. Отдаёт приоритет данным из актуальной документации, а не знаниям, полученным при обучении модели.
  • workers-best-practicesПроверяет и пишет код Cloudflare Workers в соответствии с лучшими практиками для продакшена. Загружайте при написании новых Workers, проверке кода Worker, настройке wrangler.jsonc или поиске типичных антипаттернов Workers (streaming, floating promises, global state, secrets, bindings, observability). Отдаёт приоритет данным из документации Cloudflare, а не предобученным знаниям.
  • wranglerCLI для Cloudflare Workers: развёртывание, разработка и управление Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines и Secrets Store. Загружайте этот навык перед выполнением команд wrangler, чтобы обеспечить правильный синтаксис и соблюдение лучших практик. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении модели.
MCP-серверы

Прямой доступ к Cloudflare API, документации и инструментам наблюдаемости.

MCP серверы предоставляют типизированные инструменты для обращения к Cloudflare во время выполнения. Есть два варианта: Code Mode то есть единый сервер, который охватывает весь Cloudflare API (более 2 500 эндпоинтов примерно в 1000 токенов), либо набор узкоспециализированных серверов для конкретных продуктов, размещённых в cloudflare/mcp-server-cloudflare репозитории. Полный каталог также доступен в MCP серверы для Cloudflare документации.

  • Code mode APIcode modeШирокий доступ ко всему API Cloudflare через выполнение кода с минимальным расходом токеновhttps://mcp.cloudflare.com/mcp
  • Сервер AI GatewayВыполняйте поиск по своим логам, получайте подробности о промптах и ответахhttps://ai-gateway.mcp.cloudflare.com/mcp
  • Сервер Audit LogsВыполняйте запросы к журналам аудита и формируйте отчёты для проверкиhttps://auditlogs.mcp.cloudflare.com/mcp
  • Сервер AutoRAGПоиск и запросы к экземплярам AutoRAG аккаунтаhttps://autorag.mcp.cloudflare.com/mcp
  • Сервер Browser RunЗагружайте веб-страницы, преобразуйте их в markdown и делайте снимки экранаhttps://browser.mcp.cloudflare.com/mcp
  • Сервер Cloudflare BlogПоиск и чтение публикаций в Cloudflare Bloghttps://blog.mcp.cloudflare.com/mcp
  • Cloudflare One CASB serverБыстро выявляйте неправильные конфигурации безопасности SaaS-приложений для защиты пользователей и данныхhttps://casb.mcp.cloudflare.com/mcp
  • Сервер контейнеровРазверните среду разработки sandboxhttps://containers.mcp.cloudflare.com/mcp
  • сервер Demo DayДемонстрация минимального MCP-сервера Cloudflarehttps://demo-day.mcp.cloudflare.com/mcp
  • Сервер Digital Experience MonitoringПолучить быстрый обзор критически важных приложений в вашей организацииhttps://dex.mcp.cloudflare.com/mcp
  • Сервер DNS AnalyticsОптимизируйте производительность DNS и отлаживайте проблемы с учётом текущей настройкиhttps://dns-analytics.mcp.cloudflare.com/mcp
  • Сервер документацииПолучайте актуальную справочную информацию о Cloudflarehttps://docs.mcp.cloudflare.com/mcp
  • Logpush-серверПолучить краткие сводки о состоянии задач Logpushhttps://logs.mcp.cloudflare.com/mcp
  • Сервер наблюдаемостиОтлаживайте приложение и анализируйте его журналы и аналитикуhttps://observability.mcp.cloudflare.com/mcp
  • Сервер RadarИзучите данные Cloudflare Radar о состоянии интернетаhttps://radar.mcp.cloudflare.com/mcp
  • Сервер Workers BindingsСоздавайте приложения Workers с примитивами хранения, ИИ и вычисленийhttps://bindings.mcp.cloudflare.com/mcp
  • Сервер Workers BuildsПолучить аналитику и управлять Cloudflare Workers Buildshttps://builds.mcp.cloudflare.com/mcp
Wrangler CLI

Локальная разработка, деплой и команды, специфичные для Workers.

Используйте Wrangler для локальной разработки, развёртывания и команд для конкретных продуктов, например wrangler d1 migrations apply или wrangler tail. Встроенный wrangler Skill учит агента, когда к нему обращаться.

Документация, удобная для агентов

Экономичные по токенам справочные материалы, оптимизированные для агентов.

Добавьте в конец /index.md к любому URL-адресу документации Cloudflare, чтобы получить чистую версию в markdown. У каждого раздела продукта верхнего уровня также есть собственный llms.txt то есть индекс страниц, рассчитанный на одно контекстное окно. Несколько полезных примеров:

Чтобы получить полное представление о том, как эта документация структурирована для агентов, см. руководство «Docs for Agents».

Примеры запросов

Set up a KV namespace for edge-cached session storage in my Worker.
Build an image upload and transformation service using R2 and Cloudflare Images.
Build a multi-tenant SaaS backend where each customer gets an isolated D1 database.
Use Workers for Platforms to let my customers deploy their own code in isolated environments.
Set up WAF rules to block SQL injection and XSS attacks on my application.

Советы

Часто задаваемые вопросы

Поддерживает ли Copilot Cloudflare Skills?

Да. GitHub Copilot добавил поддержку Agent Skills для режима агента VS Code, Copilot CLI и облачного агента. Выполните npx skills add https://github.com/cloudflare/skills и установите их. См. О навыках агента ↗ руководство, где подробно описано, где именно Copilot ищет Skills.

Что использовать: Skills, MCP сервер, Wrangler CLI или всё сразу?

Все три инструмента. Skills загружают экспертизу Cloudflare в каждую сессию режима агента. MCP-сервер Cloudflare API отвечает за операции платформы (DNS, WAF, Zero Trust, бакеты R2). Wrangler выполняет локальную разработку и деплой в терминале VS Code. Встроенный wrangler Skill учит Copilot, когда какой из них использовать.

Нужен ли всё ещё файл .github/copilot-instructions.md?

Это не взаимоисключающие инструменты. Custom instructions используйте для простых общерепозиторных соглашений, применимых почти ко всем задачам (стандарты кода, предпочитаемые библиотеки). Skills используйте для детальных, ситуативных указаний, которые Copilot должен загружать только при необходимости.

Может ли Copilot развернуть проект напрямую в Cloudflare?

Да, через Wrangler в терминале VS Code или через workflow GitHub Actions, который может сгенерировать для вас Copilot.

Устранение неполадок

Skills не загружаются в Copilot

Skills работают только в VS Code agent mode, Copilot CLI и облачном агенте, но не с inline completion или обычным чатом. Переключите Copilot Chat в режим agent. Если Skills всё ещё не обнаруживаются, обратитесь к О навыках агента ↗ для путей, которые проверяет Copilot.

MCP сервер недоступен в VS Code

Убедитесь, что используете VS Code версии 1.99 или новее, которая поддерживает MCP изначально. Добавьте конфигурацию сервера в .vscode/mcp.json.

Получение устаревшей информации о продуктах Cloudflare

Включить MCP-сервер документации Cloudflare чтобы агент мог загружать актуальную документацию во время выполнения. Если вы не хотите использовать MCP сервер, укажите агенту напрямую на developers.cloudflare.com/llms.txt для каталога всех продуктов, либо developers.cloudflare.com/<product>/llms.txt для индекса конкретного продукта.

Создание агентов на Cloudflare

Cloudflare не просто площадка для развёртывания агентов, а полноценный стек для создания собственных агентов.

Agents SDK

Stateful AI агенты с состоянием, планированием, RPC, почтой, потоковым чатом, а также Code Mode SDK для экономичного по токенам использования инструментов.

Подробнее
Создание MCP-сервера

Разверните удалённый MCP сервер на Workers с OAuth, устойчивым состоянием и потоковым HTTP транспортом.

Подробнее
Workers AI

Запускайте LLM, embedding модели и модели для работы с изображениями с открытым исходным кодом на edge. Используйте как провайдера моделей для своего агента.

Подробнее
Worker Loader

Загружает пользовательский код в изолированные Workers по требованию. Безопасная песочница, лежащая в основе Code Mode.

Подробнее

Другие агенты

Anthropic

Claude Code

Терминальный агент для написания кода, который понимает вашу кодовую базу, выполняет команды, редактирует файлы и управляет git. Разработан компанией Anthropic.

Просмотреть руководство
OpenAI

Codex

Агент для написания кода от OpenAI, доступен как терминальный CLI и десктопное приложение. Читает и записывает файлы, выполняет команды и работает с вебом в песочнице.

Просмотреть руководство
Cursor

Cursor

IDE с приоритетом на ИИ на основе VS Code: правки в нескольких файлах через Composer и фоновые агенты. Разработчик: Cursor.

Просмотреть руководство
Аномалия

OpenCode

Терминальный агент с открытым исходным кодом и продвинутым TUI, работает с более чем 75 LLM. Разработан компанией Anomaly.

Просмотреть руководство
Cognition

Windsurf

Агентная IDE с контекстом Cascade и Flows для многошаговых задач. Разработчик: Cognition.

Просмотреть руководство
Microsoft

Visual Studio Code

Бесплатный редактор кода с открытым исходным кодом, со встроенной поддержкой клиента Model Context Protocol (MCP) и интеграцией с Copilot Chat. Разработан Microsoft.

Просмотреть руководство
LM Studio

Bionic

Мощный агент для написания кода и работы. Изначально локальный, с открытыми моделями в облаке. От LM Studio.

Просмотреть руководство