INTEGRITY Dokumentace

← Referenční architektury / reference-architecture / diagrams / ai

Pracovní prostor AI agenta pro Enterprise

Úvod

Podnikový pracovní prostor pro AI agenty poskytuje zaměstnancům trvalé prostředí pro práci s AI. K tomuto prostoru přidává kurátorovanou knihovnu firemního kontextu a dovedností (skills), aby lidé mohli při práci využívat vlastní znalosti organizace a osvědčené postupy. Každý pracovní prostor má svůj vlastní stav konverzace, soubory, firemní nástroje a izolované spouštění.

Zaměstnanci využívají workspace k vytváření dokumentů, prezentací, tabulek, průzkumů, workflow, zdrojového kódu a aplikací. Tyto výstupy přetrvávají i po skončení konverzace. Zaměstnanec je může kontrolovat, sdílet, exportovat nebo dál vylepšovat pomocí AI.

Architektura využívá Cloudflare Workers a Agents SDK pro orchestraci, Durable Objects pro stav, AI Gateway pro správu modelů a portály serveru MCP pro podnikové nástroje. Dynamic Workers, Sandbox SDK kontejnery a Browser Run zajišťují úlohy, které potřebují víc než jen inferenci modelu.

Na rozdíl od podniková platforma pro vibe coding, výsledkem není vždy nasazená aplikace. Zdrojový kód a aplikace jsou jen dva z výstupních typů vedle dokumentů, dat, analýz a opakovatelných pracovních postupů.

Základní architektura

Architektura enterprise AI agent workspace znázorňující různé způsoby spouštění úloh, ověřený přístup, stavový agent workspace postavený na Workers, Durable Objects, Dynamic Workers a Sandbox containers, kurátorované znalosti organizace, zabezpečený přístup k poskytovatelům AI modelů přes AI Gateway a k interním i SaaS MCP serverům přes portály MCP serverů, a trvalé výstupy.
  1. Vyvolání úlohy: Zaměstnanec zahájí nebo obnoví práci z webové aplikace, firemního chatu nebo e-mailu. Webhooky a plány mohou práci spustit i bez otevřené relace prohlížeče. Cloudflare Access ověřuje relace prohlížeče a každý asynchronní kanál si před přijetím požadavku ověří jeho podpis, token nebo odesílatele.
  2. Přejděte do pracovního prostoru agenta: Workers směrují požadavek na agenta pracovního prostoru. Agent obnoví historii konverzace, úkoly, soubory, oprávnění a frontu událostí z trvalého úložiště, čerpá z připravených znalostí organizace a v případě, že úkol vyžaduje víc než jen inferenci modelu, spustí ohraničený kód v Dynamic Workers nebo v kontejneru Sandbox.
  3. Používejte řízené modely a nástroje: Agent volá schválené modely prostřednictvím AI Gateway a schválené podnikové nástroje přes portál serveru MCP. Obě vrstvy udržují směrování k poskytovatelům, přihlašovací údaje, zásady a protokolování mimo pracovní prostor.
  4. Uložení výstupu: Pracovní prostor uloží výsledek jako trvalý pracovní výstup, který si zaměstnanec může prohlédnout, dále na něm pracovat pomocí AI, sdílet ho nebo exportovat.

Webová aplikace je primárním rozhraním, ale nejde o běhové prostředí agenta. Všechny kanály posílají události do stejného stavového pracovního prostoru, takže zaměstnanec může práci zahájit v chatu, zkontrolovat ji ve webové aplikaci a později pokračovat v rámci jedné historie agenta.

Model stavu a izolace

Model izolace a stavu Workspace znázorňující bezstavový Worker, který směruje požadavky k jednomu Durable Objectu na uživatele a Durable Objectům na workspace, přičemž každý z nich koordinuje Dynamic Workery, kontejner Sandbox a trvalé úložiště souborů a výstupů.

Workery zůstávají bezstavové. Obsluhují rozhraní a každý požadavek směrují ke správnému Durable Objectu na základě identity a workspace uvedených v požadavku.

Každý workspace je namapován na jeden Durable Object, ve kterém běží Agents SDK. Tento objekt je pro daný workspace trvalou autoritou. Vlastní konverzaci, úlohy, plánování, rozhodnutí o souhlasu a frontu událostí a koordinuje volání modelu, nástroje, soubory a spouštění. Práce pokračuje i po odpojení prohlížeče nebo restartu Worker isolate a jednotlivé workspace se škálují nezávisle na sobě, místo aby sdílely jeden proces agenta.

Samostatný Durable Object pro každého uživatele uchovává nastavení profilu, registr workspace, integrace a udělená oprávnění. Jeden uživatel vlastní mnoho na sobě nezávislých stavových workspace.

Pracovní prostor koordinuje zdroje, ale neukládá vše. Pro každou úlohu vybírá běhové prostředí: Dynamic Workers pro omezené Code Mode, kontejnery Sandbox SDK pro plnohodnotné shellové a buildovací prostředí a Browser Run pro izolované relace prohlížeče. Velké soubory a znovupoužitelné výstupy jsou uloženy ve verzované souborové službě a oprávnění ke sdílení jsou udržována odděleně od samotných dat výstupu, takže přístup lze udělit nebo odebrat bez přesunu souboru. Zálohy sandboxu a sdílený organizační kontext využívají R2. Události použití a životního cyklu využívají Workers Analytics Engine nebo externí systém.

Rozsah Primitivum Cloudflare Odpovědnost Lifetime
Aplikace Workers UI, API, ověřování, směrování a vstup kanálů Bezstavové zpracování požadavků
Uživatel Durable Object Profil, registr pracovního prostoru, integrace, oprávnění a aktivita Trvalé
Workspace Agents SDK a Durable Object Stav agenta, fronta událostí a orchestrace jednotlivých kroků Trvalé
Spuštění v režimu Code Mode Dynamický Worker Omezený kód a skladba nástrojů Dočasné
Aktivní vývojové prostředí Kontejner Sandbox SDK Shell, sestavení, náhledy a kódovací relace Vytvořeno na vyžádání
Relace prohlížeče Browser Run Navigace po webu, interakce, snímky obrazovky a vykreslování PDF Vázáno na relaci
Soubory uživatele Verzovaná souborová služba Soubory, uložené výstupy a revize Trvalé
Knihovna dovedností a kontextu Objektové úložiště pouze pro čtení (R2) Pečlivě vybrané dovednosti, referenční kontext a příkazy Publikováno centrálně
Záloha R2 Zálohy sandboxu Trvalé

Řízený přístup k modelům a nástrojům

Všechny požadavky na model procházejí přes AI Gateway. Agent využívá modely od různých poskytovatelů, aniž by bylo nutné logiku specifickou pro daného poskytovatele přesouvat do každého pracovního prostoru. AI Gateway zajišťuje směrování, sleduje využití a náklady a ukládá protokoly požadavků.

Enterprise nástroje se připojují přes portál serveru MCP. Portál zpřístupňuje jediný endpoint, uplatňuje zásady Access, spravuje dostupné nástroje, směruje přihlašovací údaje jednotlivých uživatelů a zaznamenává jejich aktivitu. Administrátoři vytvářejí portály pro jednotlivé týmy, aby agent získal jen nástroje potřebné pro svou práci, a ne všechny nástroje v organizaci.

Dovednosti a organizační kontext

Workspace čerpá z centrálně publikované knihovny s možností pouze pro čtení, která je sdílená mezi všemi workspace. Knihovna obsahuje skills, tedy opakovaně použitelné postupy pro úkoly, které agent načítá podle potřeby, a context, tedy referenční materiály, které organizace chce, aby agenti používali.

Dovednosti se vrstvují podle zdroje, od těch poskytovaných platformou přes organizací sdílené až po lokální v rámci pracovního prostoru, takže tým může výchozí nastavení rozšířit nebo přepsat. Agent dovednosti vypisuje, danou dovednost načte, pokud odpovídá úkolu, a po jejím dokončení ji zase uvolní. Díky tomu se pokyny nedostávají do kontextu modelu, dokud nejsou potřeba.

Knihovnu publikujte prostřednictvím verzovaného úložiště pouze pro čtení, díky čemuž zůstávají změny dovedností a kontextu auditovatelné a kontrolovatelné. Knihovna je pro agenta určena pouze ke čtení a je řízena centrálně.

Bezpečnostní model

K výstupu modelu, výstupu nástrojů i vygenerovanému kódu přistupujte jako k nedůvěryhodnému. Kontrolní mechanismy uplatňujte na hranici platformy, nikoli ve vygenerovaném kódu.