Přeskočit na obsah

Odešlete prvního agenta

Na konci tohohle tutoriálu budeš mít:

  • Agenta, kterého jsi vytvořil a nastavil ty
  • Prostor, kde si s tím agentem píšeš
  • Jeden dokončený běh, s commitnutou prací v izolovaném worktree a řádkem v protokolu běhů agenta

Předpoklady: dokončený Váš první pracovní prostor, takže tenhle pracovní prostor má zaregistrovaný repozitář a aspoň jednoho připojeného poskytovatele modelů.

  1. Jdi do Nastavení → Pracovní prostor → Agenti
  2. Klepni na Nový agent. Agent jménem „Nepojmenovaný agent“ vznikne hned a vybere se v soupisce — žádný dialog vytvoření a nic k potvrzení. Nastavíš ho na místě.
  3. Na kartě Nastavení vyplň:
    • Název: něco krátkého a zapamatovatelného, třeba alice. To je to, co píšeš za @.
    • Název: co dělá, např. „Backendový inženýr“
    • Adaptér: Control Center (built-in). Tohle zvol schválně — jen vestavěný harness se dá řídit uprostřed běhu a pozastavit na hranici tahu a na hostiteli serveru nepotřebuje nainstalované CLI.
    • Model: vyber ze seznamu, který nabízí připojený poskytovatel
    • Dovednosti: připoj ty, které sedí, třeba testing nebo architecture
  4. Stiskni Uložit změny

Kontrolní bod. Řádek soupisky ukazuje jméno tvého agenta a dutý stavový kroužek.

  1. V postranním panelu najdi sekci Prostory a klepni na tlačítko +
  2. Dej prostoru název
  3. Pod Přidat agenty vyber agenta, kterého jsi právě vytvořil
  4. Má-li pracovní prostor nějaké repozitáře, vyber ty, na kterých má tenhle prostor pracovat
  5. Klepni na Vytvořit

Prostor se otevře. Na pozadí Control Center pro tuhle konverzaci připraví copy-on-write worktree vybraných repozitářů, na vlastní větvi. Tvůj zdrojový checkout se nikdy nemění.

Napiš jeden konkrétní malý úkol nad repozitářem, který jsi zaregistroval. Nejlíp sedí něco s ověřitelným výsledkem — přidej test, oprav lint, přejmenuj symbol.

Stiskni Enter. Nikoho nemusíš zmiňovat přes @: když je v prostoru jediný agent, probudí ho obyčejná zpráva. V prostoru s několika agenty vybere jednoho @name.

Control Center složí prompt z pokynů, persony a skillů agenta a z kontextu prostoru a pak odešle běh.

Kontrolní bod. Tlačítko odeslání v composeru se změní na Zastavit — v téhle konverzaci pracuje agent — a začne přicházet text.

Krok 4: Sleduj, jak pracuje

Sekce “Krok 4: Sleduj, jak pracuje”

Konverzace vykresluje běh tak, jak probíhá:

  • Uvažování, přímo v konverzaci, jak agent přemýšlí
  • Volání nástrojů: čtení a zápis souborů, hledání, příkazy shellu, každé se svým výsledkem
  • Text: shrnutí, vysvětlení a otázky pro tebe

Když se agent na něco zeptá, odpověz v konverzaci a on pokračuje.

Metriky samotného běhu a ovládání pozastavení, obnovení a zastavení najdeš u běžícího agenta v sekci Agenti panelu Obecné u prostoru. Zvol Otevřít aktivitu.

V panelu aktivity odznak stavu hlásí Běží a po skončení běhu Úspěšně. Běh, který se zasekne nebo zacyklí, hlásí Blokováno; běh, který skončí chybou, hlásí Selhalo. V registru agentů je kroužek soupisky před prvním během dutý a plný, jakmile je agent zase nečinný.

Co běh ohraničuje: vlastní copy-on-write worktree, pověření vydaná při spuštění a odebraná při úklidu, očištěné prostředí, plocha nástrojů, kterou dovolí jeho režim, a guardraily akcí. Účinky jako push větve nebo otevření pull requestu se pouštějí zvlášť — viz Guardraily.

Krok 5: Zkontroluj výsledek

Sekce “Krok 5: Zkontroluj výsledek”
  1. Otevři Nastavení → Pracovní prostor → Agenti a vyber svého agenta
  2. Otevři kartu Protokoly

Kontrolní bod. Jeden řádek běhu, se stavem, dobou trvání, časy začátku a konce a adaptérem, na kterém běžel.

Změny agenta jsou commitnuté na větvi konverzace, v jeho worktree. Commity jsou autorované jako agent a ty jsi uvedený v traileru Co-Authored-By:.

Jak získat pull request

Sekce “Jak získat pull request”

Sám od sebe se pull request neotevře. Když ho chceš, požádej o něj ve stejné konverzaci:

Pushni tuhle větev a otevři pull request do výchozí větve.

Push (gitPush) i vytvoření PR (prCreate) ve výchozím stavu žádají tvoje schválení, takže před každým čekej potvrzení. Když ve chvíli výzvy není připojený schvalovatel, akce se zamítne, místo aby se povolila — guardraily se při selhání zavřou.

PR se otevře pod identitou GitHub, jejíž token běh použil — pod tvojí, když jsi uložil osobní token — ne pod jménem agenta. Autorství agenta je vidět na commitech.

Otevřít ho můžeš i sám: panel Správa zdrojového kódu u prostoru má tlačítko Vytvořit pull request, které větev konverzace přenese na obrazovku sestavení, a Pull requesty → Nový PR otevře tu samou obrazovku prázdnou. Tam navazuje další tutoriál.

Vytvořil jsi agenta, nastavil mu adaptér a model, dal mu prostor a úkol a sledoval, jak skutečný běh doběhne v izolovaném worktree, aniž by se dotkl tvého checkoutu.

Další: Zkontrolujte první pull request, kde se naučíš postup revize.

Víc o agentech: Model agentů. Podrobnosti odeslání: Životní cyklus odeslání agenta.