Všichni průvodci › Podle agenta

Kaloko v CI: headless běhy a jeden komentář v PR na scénář

Stejný průchod z GitHub Actions nebo jiného CI: vestavěné Chromium, token testera na sdílení, token jen pro čtení na čtení, výsledky v PR a na plachtě.

Průchod, který dělá agent, může běžet i jako úloha v CI. Tytéž čtyři příkazy běží proti review nebo stagingu při každém pushi a PR dostane jeden komentář na scénář, který se sám aktualizuje.

Co nás pálí

Screenshoty z CI končí jako artefakty, které nikdo nestáhne. Vizuální kontroly žijí v jiném nástroji s vlastním přihlášením a vlastní představou, co je krok.

Co se změní s Kalokem

CI spustí kaloko start, walk, evaluate, share --pr. Místo artefaktu je plachta, místo notifikace komentář v PR. Verdikty dávají lidé na plachtě a zpátky je čte agent nebo další úloha.

Jak to funguje

1. Konfigurace pro CI

   kopie kaloko.config.yml bez browser.channel, aby se použilo vestavěné Chromium (npx playwright install --with-deps chromium), prostředí omezená na to, kam CI dosáhne.

2. Secrets

   KALOKO_TOKEN s rolí tester na sdílení běhů; TYPESAFE_API_KEY, pokud chcete v CI vyhodnocovat sémantická kritéria. Úlohám, které jen čtou výsledky nebo exportují běhy, stačí token jen pro čtení.

3. Úloha

   checkout, npm ci, instalace Chromia, pak čtyři příkazy s --config kaloko.ci.config.yml; kaloko export, pokud chcete zip i jako artefakt.

4. Brána

   kaloko feedback --json vrátí verdikt běhu; úloha může před deployem počkat na accepted. Denní obnova dema Kaloka je přesně taková úloha.

Skilly a prompty

Pro CI není prompt, jen workflow. Takhle vypadá nejmenší funkční (token testera uložte jako secret KALOKO_TOKEN):

# .github/workflows/kaloko.yml
on:
  pull_request:
  schedule: [{ cron: '30 4 * * *' }]
jobs:
  walk:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22 }
      - run: npx playwright install --with-deps chromium
      - run: |
          npx kaloko start --scenario qa/flows/public.yml --env staging
          npx kaloko walk && npx kaloko evaluate && npx kaloko share --pr
        env:
          KALOKO_TOKEN: ${{ secrets.KALOKO_TOKEN }}

KALOKO_TOKEN=… npx kaloko start --scenario qa/flows/public.yml --env staging && npx kaloko walk && npx kaloko share

Očekávaný výsledek: nasdílený běh, komentář v PR (s --pr na větvi s pull requestem), souhrnný řádek v logu úlohy.

Co dostanete

• Jedno místo pro vizuální akceptaci, ať běh vyrobil člověk, agent nebo CI.
• Tokeny s rozsahem a expirací: jen nahrávání pro CI, které sdílí, jen čtení pro CI, které čte.
• Export libovolného běhu jako zip, než vyprší.

Otázky

Jak to vypadá

Skutečný běh Kaloka nad jeho veřejnými stránkami, obnovený každý den. Tuhle plachtu dostane váš tým.

Další průvodci