Kalokoby

Všichni průvodci › Podle použití

Podle použití

Hostované běhy: Kaloko vám každé ráno projde stránky

Kaloko na svých prohlížečích otevře stránky scénáře jen pro čtení každý den nebo týden, ve všech jazycích a viewportech, a běh nasdílí, jako byste ho prošli vy.

Marketingový web se mění třikrát týdně a žádná z těch změn neprojde vašimi pull requesty. Každou noc by ho mohla projít úloha v CI, jenže nikdo nechce udržovat CI pro web, který sám nenasazuje. Hostované běhy projdou stránky na straně Kaloka.

Co nás pálí

Pravidelná kontrola potřebuje stroj, na kterém poběží: úlohu v CI, server, notebook, který zůstane zapnutý. U pár veřejných stránek je to víc práce než stránky samotné, takže se kontrola nikdy nenastaví a rozbitou stránku najde návštěvník.

Co se změní s Kalokem

V plánech Business a Enterprise Kaloko na svých prohlížečích otevře stránky scénáře jen pro čtení, každý den nebo týden v hodinu, kterou zvolíte, pořídí screenshoty celých stránek ve všech jazycích a viewportech, zkontroluje, co jde ze stránky ověřit, a běh nasdílí vaším jménem. Business má v ceně 2 000 načtených stránek měsíčně, Enterprise 10 000.

Jak to funguje

  1. Napište scénář jen pro čtení

    kroky, které otevřou stránku. kaloko draft https://example.com https://example.com/cenik ho připraví ze stránek samotných.

  2. Naplánujte ho

    kaloko schedule add --scenario qa/flows/public.yml --env production --every day --at 5 (hodina je v UTC). --every week --weekday mon ho spustí jednou týdně.

  3. Stránky za bránou

    přihlašovací údaje HTTP Basic z prostředí se pošlou jednou a uloží zašifrované. U stránek za přihlášením člověk uloží přihlášení přes kaloko auth save a plán ho použije s --account.

  4. Spravujte ho

    kaloko schedule list ukáže příští a poslední běh a stránky spotřebované tento měsíc; run, pause, resume a remove berou id plánu. Totéž je v Nastavení → Integrace.

  5. Přečtěte si výsledek

    běh se objeví jako každý jiný, i s porovnáním s referenčním během. Kritéria na selektory, texty, titulky a meta se rozhodnou; kritéria, která chtějí plný průchod, ukážou „nehodnoceno“ i s důvodem.

Skilly a prompty

Naplánuj v Kaloku denní kontrolu našich veřejných stránek na produkci v 5 UTC, jen pro čtení, a řekni mi, kolik stránek měsíčně spotřebuje.

Očekávaný výsledek: zvalidovaný scénář jen pro čtení, jeden kaloko schedule add a odhad stránek za měsíc z počtu jazyků × viewportů × kroků.

Pokladna potřebuje klikání. Dej mi místo toho workflow pro GitHub Actions, které ji projde každé pondělí.

Očekávaný výsledek: kaloko schedule export github --scenario qa/flows/checkout.yml --env staging --every week zapíše workflow a vyjmenuje secrets, které potřebuje.

Co dostanete

Otázky

Co hostované běhy neumí?

Klikat a psát: kroky, které dělají víc než otevření stránky, se vynechají a vyjmenují. Plný průchod potřebují i nativní aplikace, lokální a privátní adresy, přihlašovací údaje v hlavičkách a základní adresy podle jazyka; ten pustí kaloko schedule export github ve stejném rytmu.

Co se počítá do rozpočtu stránek?

Každá načtená stránka: každý krok v každém jazyce a viewportu. Scénář s 10 stránkami ve 2 jazycích na desktopu i mobilu načte za jeden běh 40 stránek.

Je to na produkci bezpečné?

Hostované běhy stránky jen otevřou a přečtou. Nic se neklikne, neodešle ani nevytvoří.

Další průvodci

Akceptace tasku s AI agentem přímo v pull requestuRegrese před releasem: porovnání běhu s přijatým referenčním běhemSEO a kontrola landing pages na produkci, jen pro čtení, každý denE‑mailové flow: zachyťte zprávu vedle obrazovky, která ji poslala

Nainstalujte jednou, pak pracujte přes agenta

Kaloko běží tam, kde je váš kód a váš agent. Služba výsledky ukládá a verzuje, zobrazuje plachtu a sbírá schválení.

  1. Přidejte CLI do projektu
    npm install --save-dev kaloko

    Potřebuje Node 20 nebo novější. Aktualizace později přes npm update kaloko.

  2. Vytvořte konfiguraci a nainstalujte skill
    npx kaloko init --agent claude --org <your-org>

    Skill se zkopíruje do .claude/skills/kaloko. npx kaloko doctor ověří Chrome, konfiguraci a token.

  3. Založte organizaci a vytvořte token

    Založte organizaci, stanete se jejím adminem. Úvodní stránka nabídne token s rolí tester jedním kliknutím, později ho najdete v Nastavení → API tokeny. Uložte ho do .env projektu:

    KALOKO_TOKEN=qwk_…
    TYPESAFE_API_KEY=…   # optional: semantic evaluator

Pak už jen zadávejte agentovi

Skill naučí vašeho agenta celou smyčku: z úkolu napíše akceptační plán a scénář, projde obrazovky, vyhodnotí je, nasdílí plachtu, přečte si připomínky a opraví je. Příkazy psát nemusíte, vy jen projdete plachtu.

Co agent spouští (nebo spusťte sami, třeba v CI)

Stejná smyčka ručně:

npx kaloko start --scenario docs/tasks/TASK-123/qa/scenario.yml --env local
npx kaloko walk        # playwright steps; agent/manual steps: kaloko capture
npx kaloko evaluate
npx kaloko share --pr
npx kaloko feedback    # what reviewers said, with ids to answer