INTEGRITY Dokumentace

← Nastavení agentů / agent-setup

GitHub Copilot + Cloudflare

Všichni agenti
GitHub

Rozšíření editoru a CLI s režimem agenta, kontextem pracovního prostoru a nativní integrací PR. Vytvořeno společností GitHub.

TerminálCloudRozšíření
Cloudflare SkillsCloudflare Code Mode API MCPServery Cloudflare MCP pro konkrétní doményGitHub Copilot Docs

Rychlý start

  1. Nainstalujte GitHub Copilot

    Nainstalujte rozšíření GitHub Copilot ve VS Code z Visual Studio Marketplace ↗. Pro JetBrains IDE, Visual Studio nebo Xcode viz Nainstalujte rozšíření Copilot ↗ návod.

  2. Nainstalujte Cloudflare Skills

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

  3. Nakonfigurujte MCP servery Cloudflare

    Pro VS Code přidejte do .vscode/mcp.json. Pro Copilot CLI přidejte do ~/.copilot/mcp-config.json pro konfiguraci na úrovni uživatele, nebo .mcp.json nebo .github/mcp.json pro konfiguraci na úrovni projektu. Pro MCP servery specifické pro daný produkt se podívejte na mcp-server-cloudflare ↗. Informace o kompletním serveru Cloudflare API MCP (Code Mode) najdete v 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. Vyzkoušejte prompt

    Otevřete Copilot Chat (Ctrl+Shift+I), přepněte do režimu agenta a vyzkoušejte prompt, například:

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

Přístup k platformě Cloudflare

Rozbalením libovolné sekce se dozvíte více.

Cloudflare Skills

Trvalý kontext platformy, který agenta naučí, jak Cloudflare funguje.

Skills jsou instrukce, které agent načítá na vyžádání. cloudflare/skills balíček pokrývá každou vrstvu platformy, takže agent zná vaše konvence, aniž byste mu je museli znovu vysvětlovat.

  • agents-sdkVytvářejte AI agenty na Cloudflare Workers pomocí Agents SDK. Načtěte při vytváření stavových agentů, trvalých workflow, aplikací s WebSocket v reálném čase, naplánovaných úloh, serverů MCP, chatovacích aplikací, hlasových agentů nebo automatizace prohlížeče. Zahrnuje třídu Agent, správu stavu, volatelné RPC, Workflows, trvalé provádění, fronty, opakování, observabilitu a React hooks. Upřednostňuje čerpání z dokumentace Cloudflare před předtrénovanými znalostmi.
  • cloudflareKomplexní dovednost pro platformu Cloudflare zahrnující Workers, Pages, úložiště (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), feature flags (Flagship), síťové služby (Tunnel, Spectrum), zabezpečení (WAF, DDoS) a infrastructure as code (Terraform, Pulumi). Použijte ji pro jakýkoli vývojářský úkol týkající se Cloudflare. Upřednostňuje čerpání informací z dokumentace Cloudflare před předtrénovanými znalostmi.
  • cloudflare-email-serviceOdesílejte a přijímejte transakční e-maily pomocí Cloudflare Email Service (Email Sending + Email Routing). Použijte při vytváření odesílání e-mailů (binding Workers nebo REST API), směrování e-mailů, zpracování e-mailů v Agents SDK nebo integraci e-mailu do libovolné aplikace: Workers, Node.js, Python, Go a dalších. Dále použijte pro doručitelnost e-mailů, SPF/DKIM/DMARC, nastavení e-mailu ve wrangler, nástroje MCP pro e-mail nebo když má kódovací agent odesílat e-maily. I pro jednoduché požadavky jako "přidej e-mail do mého Workeru" obsahuje tento skill důležité podrobnosti o konfiguraci.
  • cloudflare-one"Slouží jako průvodce prací s Cloudflare One Zero Trust a SASE napříč Access, Gateway, WARP, Tunnel, Cloudflare WAN, DLP, CASB, device posture a identitou. Použijte při návrhu, konfiguraci, řešení problémů nebo kontrole nasazení Cloudflare One. Přednostně načítá data: používá aktuální dokumentaci a API schémata Cloudflare místo vestavěné dokumentace k produktům."
  • cloudflare-one-migrationsPlánuje migrace ze Zscaler ZIA/ZPA, Palo Alto, starších VPN, SWG nebo SASE řešení na Cloudflare One. Použijte pro posouzení migrace, mapování zásad, plány nasazení a analýzu parity a mezer.
  • durable-objectsVytváří a kontroluje Cloudflare Durable Objects. Použijte při budování stavové koordinace (chatovací místnosti, hry pro více hráčů, rezervační systémy), implementaci metod RPC, ukládání do SQLite, alarmů, WebSockets nebo při kontrole kódu DO z hlediska osvědčených postupů. Zahrnuje integraci s Workers, konfiguraci wrangler a testování pomocí Vitest. Upřednostňuje čerpání informací z dokumentace Cloudflare před předtrénovanými znalostmi.
  • sandbox-migrate-to-nextPoužijte při přechodu aplikace Cloudflare Sandbox ze stabilního @cloudflare/sandbox na @cloudflare/sandbox@next (náhled Sandbox SDK 1.0), nebo když uživatel žádá o migraci či upgrade na Sandbox 1.0 / @next. Nepoužívejte pro běžnou práci se stable verzí (sandbox-stable) ani pro nové aplikace @next (sandbox-next).
  • sandbox-nextPoužijte při vytváření nebo úpravě aplikací Cloudflare Sandbox na @cloudflare/sandbox@next (náhled Sandbox SDK 1.0): spouštění kódu, AI runnery, interpretery, úlohy podobné CI, terminály, soubory, připojení (mounts), tunely, náhledové URL, životní cyklus nebo chyby. Nepoužívejte pro výchozí stabilní balíček (použijte sandbox-stable) ani pro přechod ze stable na @next (použijte sandbox-migrate-to-next).
  • sandbox-stablePoužijte při vytváření nebo úpravě aplikací Cloudflare Sandbox na aktuálním stabilním balíčku @cloudflare/sandbox (výchozí npm tag): příkazy, relace, soubory, porty, tunely, terminály, bridge, produkce nebo čištění zastaralého API při zachování stable verze. Nepoužívejte pro @cloudflare/sandbox@next (použijte sandbox-next) ani pro přechod na verzi 1.0 (použijte sandbox-migrate-to-next).
  • turnstile-spinNastavte Cloudflare Turnstile v projektu od začátku do konce. Projděte kódovou základnu, vytvořte widget přes Cloudflare API, vložte ho tam, kde požadavky uživatelů potřebují ověření proti botům (odesílání formulářů, akce v SPA, API endpointy, odkazy ke stažení, přidávání komentářů nebo hlasování atd.), propojte kanonické server-side siteverify se stávajícím backendem zákazníka, ověřte a uložte skill. Načtěte, když uživatel požádá o přidání Turnstile, nastavení CAPTCHA, ochranu formuláře nebo endpointu proti botům, nebo o opravu integrace Turnstile. Odpovídá developers.cloudflare.com/turnstile/spin.
  • web-perfAnalyzuje výkon webu pomocí Chrome DevTools MCP. Měří Core Web Vitals (LCP, INP, CLS) a doplňkové metriky (FCP, TBT, Speed Index), identifikuje zdroje blokující vykreslování, řetězce síťových závislostí, posuny rozložení a problémy s ukládáním do mezipaměti a přístupností. Použijte, pokud máte auditovat, profilovat, ladit nebo optimalizovat výkon načítání stránky, skóre Lighthouse nebo rychlost webu. Upřednostňuje čerpání z aktuální dokumentace před předtrénovanými znalostmi.
  • workers-best-practicesKontroluje a píše kód Cloudflare Workers podle osvědčených postupů pro produkční nasazení. Načtěte při psaní nových Workers, kontrole kódu Workeru, konfiguraci wrangler.jsonc nebo při hledání běžných antipatternů Workers (streaming, nezachycené promises, globální stav, secrets, bindings, observabilita). Upřednostňuje vyhledávání v dokumentaci Cloudflare před předtrénovanými znalostmi.
  • wranglerNástroj Cloudflare Workers CLI pro nasazování, vývoj a správu Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines a Secrets Store. Načtěte před spuštěním příkazů wrangler, abyste zajistili správnou syntaxi a osvědčené postupy. Upřednostňuje čerpání z dokumentace Cloudflare před předtrénovanými znalostmi.
MCP servery

Přímý přístup k Cloudflare API, dokumentaci a observabilitě.

Servery MCP poskytují typované nástroje pro volání Cloudflare za běhu. Na výběr máte ze dvou možností: Code Mode tedy jediný server, který pokrývá celé Cloudflare API (2,500+ endpointů v ~1,000 tokenech), nebo sadu zaměřených serverů pro konkrétní produkty, hostovaných v cloudflare/mcp-server-cloudflare repozitáři. Úplný katalog najdete také v Servery MCP pro Cloudflare dokumentaci.

  • Code mode APIcode modeŠiroký přístup k celému Cloudflare API prostřednictvím spouštění kódu, s minimální režií na tokenyhttps://mcp.cloudflare.com/mcp
  • server AI GatewayProhledávejte své logy, získávejte podrobnosti o promptech a odpovědíchhttps://ai-gateway.mcp.cloudflare.com/mcp
  • Server Audit LogsDotazování na protokoly auditu a generování reportů pro kontroluhttps://auditlogs.mcp.cloudflare.com/mcp
  • Server AutoRAGVyhledávejte a dotazujte se na instance AutoRAG účtuhttps://autorag.mcp.cloudflare.com/mcp
  • Server Browser RunNačítá webové stránky, převádí je do markdownu a pořizuje snímky obrazovkyhttps://browser.mcp.cloudflare.com/mcp
  • Server Cloudflare BlogVyhledávejte a čtěte příspěvky z Cloudflare Bloguhttps://blog.mcp.cloudflare.com/mcp
  • Cloudflare One CASB serverRychle odhalte bezpečnostní nedostatky v konfiguraci aplikací SaaS a chraňte tak uživatele i datahttps://casb.mcp.cloudflare.com/mcp
  • Kontejnerový serverVytvořte vývojové prostředí typu sandboxhttps://containers.mcp.cloudflare.com/mcp
  • server Demo DayUkázka minimálního MCP serveru Cloudflarehttps://demo-day.mcp.cloudflare.com/mcp
  • Server Digital Experience MonitoringZískat rychlý přehled o kritických aplikacích ve vaší organizacihttps://dex.mcp.cloudflare.com/mcp
  • Server DNS AnalyticsOptimalizace výkonu DNS a ladění problémů na základě aktuálního nastaveníhttps://dns-analytics.mcp.cloudflare.com/mcp
  • Dokumentační serverZískejte aktuální referenční informace o Cloudflarehttps://docs.mcp.cloudflare.com/mcp
  • Server LogpushZískat rychlé souhrny stavu úloh Logpushhttps://logs.mcp.cloudflare.com/mcp
  • Server pro observabilituLadění a přehled o protokolech a analytice vaší aplikacehttps://observability.mcp.cloudflare.com/mcp
  • Server RadarProzkoumejte přehledy o internetu Cloudflare Radarhttps://radar.mcp.cloudflare.com/mcp
  • Server Workers BindingsVytvářejte aplikace Workers s úložištěm, AI a výpočetními primitivyhttps://bindings.mcp.cloudflare.com/mcp
  • Server Workers BuildsZískat přehledy a spravovat Cloudflare Workers Buildshttps://builds.mcp.cloudflare.com/mcp
Wrangler CLI

Lokální vývoj, nasazení a příkazy specifické pro Workers.

Použijte Wrangler pro místní vývoj, nasazení a příkazy specifické pro daný produkt, například wrangler d1 migrations apply nebo wrangler tail. Součástí je wrangler Skill učí agenta, kdy po něm sáhnout.

Dokumentace vhodná pro agenty

Reference optimalizované pro agenty s úsporným využitím tokenů.

Připojte /index.md k libovolné URL adrese Cloudflare docs a získáte čistou verzi v markdownu. Každá sekce nejvyšší úrovně produktu má také vlastní llms.txt tedy index stránek přizpůsobený velikosti jednoho kontextového okna. Několik užitečných příkladů:

Úplný přehled o tom, jak je tato dokumentace strukturovaná pro agenty, najdete v průvodce Docs for Agents.

Příklad promptů

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.

Tipy

Časté dotazy

Podporuje Copilot Cloudflare Skills?

Ano. GitHub Copilot přidal podporu Agent Skills pro režim agenta ve VS Code, Copilot CLI i cloudového agenta. Spusťte npx skills add https://github.com/cloudflare/skills a nainstalujte je. Podívejte se na O agent skills ↗ příručku s podrobnostmi o tom, kde Copilot hledá Skills.

Mám použít Skills, server MCP, Wrangler CLI, nebo všechno dohromady?

Všechny tři. Skills načítají odborné znalosti o Cloudflare do každé relace v režimu agenta. Server Cloudflare API MCP zajišťuje operace na platformě (DNS, WAF, Zero Trust, R2 buckets). Wrangler spouští lokální vývoj a nasazení v terminálu VS Code. Součástí je wrangler Skill učí Copilot, kdy sáhnout po kterém z nich.

Potřebuji stále soubor .github/copilot-instructions.md?

Jde o doplňující nástroje. Custom instructions použijte pro jednoduché konvence platné pro celé úložiště, které se týkají téměř každého úkolu (standardy kódování, preferované knihovny). Skills použijte pro podrobné, situační pokyny, které má Copilot načíst jen tehdy, kdy jsou relevantní.

Dokáže Copilot nasazovat přímo do Cloudflare?

Ano, přes Wrangler v terminálu VS Code, nebo přes workflow GitHub Actions, který za vás může vygenerovat Copilot.

Řešení potíží

Skills se v Copilotu nenačítají

Skills fungují jen v režimu agenta VS Code, v Copilot CLI a v cloudovém agentovi, ne v inline doplňování nebo běžném chatu. Přepněte Copilot Chat do režimu agenta. Pokud Skills stále nejsou rozpoznány, přečtěte si O agent skills ↗ pro cesty, které Copilot kontroluje.

Server MCP není ve VS Code dostupný

Ujistěte se, že používáte VS Code 1.99+, který podporuje MCP nativně. Přidejte konfiguraci serveru do .vscode/mcp.json.

Zastaralé informace o produktech Cloudflare

Povolte Server Cloudflare docs MCP aby agent mohl za běhu načítat aktuální dokumentaci. Pokud nechcete používat MCP server, nasměrujte agenta přímo na developers.cloudflare.com/llms.txt pro katalog všech produktů, nebo developers.cloudflare.com/<product>/llms.txt pro index specifický pro daný produkt.

Vytváření agentů na Cloudflare

Cloudflare není jen cíl pro nasazení agentů, je to kompletní stack pro vytváření vlastních.

Agents SDK

Stavoví AI agenti se stavem, plánováním, RPC, e-maily a streamovaným chatem, a Code Mode SDK pro tokenově efektivní používání nástrojů.

Zjistit více
Vytvoření serveru MCP

Nasaďte vzdálený server MCP na Workers s OAuth, trvalým stavem (durable state) a streamovatelným HTTP transportem.

Zjistit více
Workers AI

Spouštějte open source LLM, embedding modely a obrazové modely na edge síti. Použijte je jako poskytovatele modelu pro svého agenta.

Zjistit více
Worker Loader

Načítejte uživatelský kód na vyžádání do izolovaných Workers. Zabezpečený sandbox, na kterém Code Mode stojí.

Zjistit více

Další agenti

Anthropic

Claude Code

Kódovací agent pro terminál, který rozumí vaší kódové základně, spouští příkazy, upravuje soubory a spravuje git. Vytvořila společnost Anthropic.

Zobrazit návod
OpenAI

Codex

Kódovací agent OpenAI dostupný jako terminálové CLI i desktopová aplikace. Čte a zapisuje soubory, spouští příkazy a prochází web v sandboxu.

Zobrazit návod
Cursor

Cursor

IDE postavené primárně na AI, založené na VS Code, s úpravami více souborů přes Composer a agenty běžícími na pozadí. Vytváří ho společnost Cursor.

Zobrazit návod
Anomálie

OpenCode

Open source terminálový agent s bohatým textovým rozhraním (TUI), který funguje s 75+ LLM. Vytvořila společnost Anomaly.

Zobrazit návod
Cognition

Windsurf

Agentní IDE s kontextem Cascade a Flows pro vícekrokové úlohy. Vytváří ho společnost Cognition.

Zobrazit návod
Microsoft

Visual Studio Code

Bezplatný open source editor kódu s nativní podporou klienta Model Context Protocol (MCP) a integrací Copilot Chat. Vytvořeno společností Microsoft.

Zobrazit návod
LM Studio

Bionic

Výkonný agent pro programování a práci. Nativně lokální, s otevřenými modely v cloudu. Od LM Studio.

Zobrazit návod