Kalokoby

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

Podle použití

E‑mailové flow: zachyťte zprávu vedle obrazovky, která ji poslala

Potvrzení registrace, účtenka objednávky, reset hesla. Kaloko zachytí e‑mail z Mailpitu nebo letter_openeru jako krok flow, ověří předmět a odkazy a ukáže ho na plachtě vedle formuláře.

Formulář funguje. E‑mail říká „Dobrý den {{first_name}}“. Každý tým to někdy poslal. Kaloko proto dělá ze zprávy krok flow a lidé ji vidí spolu s obrazovkami kolem.

Co nás pálí

E‑maily žijí mimo prohlížeč, takže je end‑to‑end testy přeskočí nebo ověří jen předmět. Vykreslenou zprávu v obou jazycích nevidí nikdo, dokud ji nevidí zákazník.

Co se změní s Kalokem

Krok typu email ve scénáři. kaloko mail počká na zprávu v testovací schránce (Mailpit na stagingu, letter_opener lokálně v Rails projektech), zachytí ji jako obrazovku a kritéria ověří předmět, odesílatele, odkazy a text. Na plachtě e‑mail sedí hned za formulářem, který ho vyvolal.

Jak to funguje

  1. Unikátní adresa na běh

    kaloko start vypíše testovací adresu (qa+<běh>@…); agent ji použije ve formuláři, aby běh našel své zprávy.

  2. Vyvolejte a zachyťte

    po kroku s formulářem kaloko mail --step confirmation --locale cs počká na zprávu a uloží ji s vykresleným HTML i prostým textem.

  3. Ověřte

    deterministická kritéria na předmět a odkazy (potvrzovací odkaz musí vést na váš host), sémantická otázka na tón a úplnost, screenshot pro lidi.

  4. Kontrola

    kontrolující vidí formulář a e‑mail vedle sebe po jazycích a schválí je nebo vrátí jako kterýkoli jiný krok.

Skilly a prompty

Projdi registrační flow na localu včetně potvrzovacího e‑mailu v cs a en a ověř, že odkaz v mailu otevře stránku účtu.

Očekávaný výsledek: obrazovky formuláře a účtu, e‑mailový krok na jazyk s předmětem a odesílatelem, kritéria na cíl odkazu, nasdílená plachta.

Co dostanete

Otázky

Které schránky jsou podporované?

Mailpit (mail.provider: mailpit s URL) a Rails letter_opener (mail.provider: letter_opener, složka tmp/letter_opener). Jiné přes malý adaptér; ozvěte se.

Může agent kliknout na odkaz v e‑mailu?

Ano: tělo zprávy má skript kroku k dispozici, takže Playwright krok odkaz otevře a další obrazovka je samostatný krok.

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ý denMobilní aplikace: projděte obrazovky Androidu a iOS jako webové stránky

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