← Sandbox SDK / sandbox / tutorials
Nastavení Claude Managed Agents
Cloudflare poskytuje samosprávné prostředí pro Claude Managed Agents ↗. Smyčka agenta běží na platformě Anthropic, zatímco Cloudflare poskytuje runtime, ve kterém se provádí akce agenta: sandboxy, kontrolu odchozího provozu, přístup k prohlížeči, e-mail a vlastní nástroje.
Tato integrace se dodává jako open-source šablona pro nasazení. Vytvořte fork repozitáře, nasaďte jej do svého účtu Cloudflare a podle potřeby si jej upravte.
Začínáme
Co získáte
Nasaďte řídicí rovinu založenou na Workers, která vám poskytne:
- Dva backendy sandboxu : Každý agent může běžet na plnohodnotném MicroVM (Containers) nebo lehký izolát (Dynamic Workers). MicroVM poskytují agentovi plné linuxové prostředí s bash a libovolnými procesy. Studený start trvá jen milisekundy a stojí zlomek ceny kontejnerové relace.
- Připojení k privátním službám : Připojení agentů k privátním interním službám přes Workers VPC a Mesh aniž by byly vystaveny veřejnému internetu.
- Řízení odchozího provozu : Veškerý provoz agenta směrujte přes přizpůsobitelné proxy. Přihlašovací údaje vkládejte do odchozích požadavků, aniž by je agent kdy viděl, omezte přístup na konkrétní domény, nebo si napište vlastní middleware pro proxy.
- E-mail agenta : Přidělte každé relaci agenta vlastní e-mailovou adresu pro odesílání a přijímání zpráv pomocí Cloudflare Email Service.
- Nástroje Run v prohlížeči : Poskytněte agentům headless prohlížeče využívající Browser Run pro webové požadavky, snímky obrazovky a ovládání přes CDP. Záznamy relací poskytují auditní stopu každé akce v prohlížeči.
- Generování obrázků : Generování obrázků pomocí Workers AI.
- Vlastní nástroje : Rozšiřte agenty vlastními nástroji přidáním definice funkce do jediného souboru. Nástroje běží v runtime Workers s přístupem ke všem vašim bindingům. Není potřeba žádná další infrastruktura.
- Dashboard : Vestavěné uživatelské rozhraní pro správu agentů, zobrazování relací, kontrolu logů a připojení přes SSH k běžícím sandboxům MicroVM.
Jak to funguje
Když agent Claude spustí relaci, Anthropic odešle webhook do řídicí roviny založené na Workers, která běží ve vašem účtu Cloudflare. Řídicí rovina dá každé relaci vlastní sandbox, směruje odchozí provoz podle zásad odchozího provozu pro danou relaci a zachovává její stav i v době, kdy relace spí.
Anthropic tento přístup popisuje jako oddělení mozku od rukou: smyčka agenta běží na Anthropic (mozek), zatímco infrastruktura pro spouštění a provádění kódu (ruce) běží na Cloudflare.
Kdy to použít
Samostatně spravované prostředí Cloudflare použijte, když potřebujete:
- Kontrola nad infrastrukturou sandboxu, ve které běží vaši agenti
- Zabezpečená připojení k soukromým interním službám
- Vlastní zásady odchozího provozu pro vkládání přihlašovacích údajů a omezení domén
- Vlastní nástroje využívající Cloudflare bindings (R2, D1, KV, Vectorize a další)
- Možnost zvolit pro každého agenta mezi backendy MicroVM a isolate
Začínáme
Postupujte podle úvodní příručka ↗ v repozitáři a nasaďte řídicí rovinu do svého účtu. Návod provede vytvořením prostředí Anthropic, nastavením tajných hodnot, zajištěním úložiště, nasazením Workeru a konfigurací webhooků.
Klíčová dokumentace
Repozitář obsahuje podrobnou dokumentaci ke každé funkci:
| Téma | Co pokrývá |
|---|---|
| Připojování k soukromým službám ↗ | Pomocí Workers VPC bindings se dostanete ke službám v jiných cloudech, on-premise nebo na vašem notebooku |
| Uplatňování zásad pro odchozí provoz (egress) ↗ | Vkládejte přihlašovací údaje a zabezpečte relace agentů. Nastavte seznamy povolených a zakázaných položek, vkládání hlaviček, vlastní proxy Workery a směrování přes VPC |
| Sandboxy založené na Isolate oproti sandboxům založeným na VM ↗ | Vyberte nejlepší prostředí pro spouštění agentů |
| E-mail agenta ↗ | Dejte agentům vlastní e-mailové adresy a možnost odesílat zprávy |
| Nástroje pro vykreslování v prohlížeči ↗ | Pozorovatelné interakce agenta s prohlížečem pomocí Browser Run |
| Přidávání vlastních nástrojů ↗ | Nové nástroje se deklarují v jediném souboru: src/tools/custom-tools.ts ↗ |
| Přizpůsobení sandboxů ↗ | Změňte Dockerfile a instance_type nastavení pro backend MicroVM |
| Snímky a perzistence stavu ↗ | Perzistence stavu napříč oběma typy sandboxu |
| Architektura ↗ | Životní cyklus požadavku od příchodu webhooku přes předání až po některý ze sandboxových backendů, včetně všech Worker bindingů, které řídicí rovina využívá |
| Zabezpečení přístupu ↗ | Zabezpečený přístup k řídicí rovině CMA |