Az első ügynök elindítása

Mit fog felépíteni

Az oktatóanyag végére a következőkkel rendelkezik:

• Egy ügynök, amelyet Ön hozott létre és konfigurált
• Egy tér, ahol Ön és az az ügynök beszélget
• Egy befejezett futás, commitolt munkával egy elszigetelt worktree-ben és egy sorral az ügynök futásnaplójában

Előfeltétel: Az első munkaterületed elvégzése, így ebben a munkaterületben van regisztrált repó és legalább egy csatlakoztatott modellszolgáltató.

1. lépés: Ügynök létrehozása

1. Nyissa meg a Beállítások → Munkaterület → Ügynökök pontot
2. Kattintson az Új ügynök elemre. Azonnal létrejön egy „Névtelen ügynök” nevű ügynök, és ki lesz jelölve a névsorban — nincs létrehozási párbeszédablak, és semmit sem kell megerősíteni. Helyben konfigurálja.
3. A Beállítások lapon adja meg a következőket:
   • Név: valami rövid és könnyen megjegyezhető, például alice. Ezt írja be a @ után.
   • Cím: mit csinál, például „Backend-fejlesztő”
   • Adapter: Control Center (built-in). Szándékosan ezt válassza — csak a beépített harness vezérelhető futás közben, és állítható meg egy körhatáron, ráadásul a szerverkiszolgálón nem kell CLI-t telepíteni.
   • Modell: válasszon a csatlakoztatott szolgáltató által kínált listából
   • Készségek: csatoljon olyat, amelyik illik, például testing vagy architecture
4. Nyomja meg a Módosítások mentése gombot

Az adapter nélküli ügynök a beépített cikluson fut

Ha az Adapter mező nincs kitöltve, az indítás a Control Center (built-in) értékre esik vissza — ez a szerveren belüli ügynökciklus, így a kiszolgálón nincs mit telepíteni. Még mindig szüksége van egy modellre: ha nincs beállítva, az Anthropic alapértelmezett modelljét kéri; ez akkor működik, ha csatlakoztatott egy Anthropic-fiókot, ellenkező esetben pedig meghiúsul a következő hibával: No credential for provider "anthropic". Mindenesetre állítsa be mindkettőt kifejezetten, különben egy Ön által nem választott modellen fog futni.

Ellenőrzési pont. A névsor sorában az ügynök neve és egy üreges állapotgyűrű látható.

2. lépés: Tér indítása

1. Az oldalsávon keresse meg a Terek szakaszt, és kattintson a + gombra
2. Adjon nevet a térnek
3. Az Ügynökök hozzáadása alatt válassza ki az imént létrehozott ügynököt
4. Ha a munkaterületen vannak repók, válassza ki, melyeken dolgozzon ez a tér
5. Kattintson a Létrehozás elemre

A tér megnyílik. A háttérben a Control Center létrehoz a kijelölt repókból egy copy-on-write worktree-t ehhez a beszélgetéshez, saját ágon. A forrás-checkoutja soha nem módosul.

3. lépés: Feladat küldése

Írjon be egy konkrét, kis feladatot a regisztrált repóval kapcsolatban. A legjobban az ellenőrizhető eredményű feladat működik — adjon hozzá egy tesztet, javítson egy lintet, nevezzen át egy szimbólumot.

Nyomja meg az Entert. Nem kell @-említéssel megjelölnie senkit: ha egyetlen ügynök van a térben, egy egyszerű üzenet felébreszti. Több ügynököt tartalmazó térben a @name választ ki egyet.

A Control Center összeállítja a promptot az ügynök utasításaiból, personájából, készségeiből és a tér kontextusából, majd elindítja a futást.

Ellenőrzési pont. Az üzenetszerkesztő küldés gombja leállítás gombbá alakul — egy ügynök dolgozik ebben a beszélgetésben —, és elkezd megérkezni a szöveg.

4. lépés: Nézze, ahogy dolgozik

A beszélgetés megjeleníti a futást, ahogy az megtörténik:

• Gondolkodás, soron belül megjelenítve, ahogy az ügynök gondolkodik
• Eszközhívások: fájlolvasások és -írások, keresések, shell-parancsok, mindegyik a saját eredményével
• Szöveg: összefoglalók, magyarázatok és az Önnek szánt kérdések

Ha az ügynök kérdez valamit, válaszoljon a beszélgetésben, és az ügynök folytatja.

Egy futás saját mérőszámaihoz, valamint a szüneteltetés, folytatás és leállítás vezérlőihez keresse meg a futó ügynököt a tér Általános paneljének Ügynökök szakaszában, és válassza a Tevékenység megnyitása lehetőséget.

A tevékenységpanelben az állapotjelvény Fut, majd a futás befejezésekor Sikeres értéket mutat. Az elakadó vagy ciklikusan ismétlődő futás Blokkolva; a hibát adó futás Sikertelen. Az ügynökjegyzékben a névsor gyűrűje üreges az első futás előtt, és tömör, amint az ügynök ismét tétlen.

Mi korlátozza a futást: a saját copy-on-write worktree-je, az indításkor a számára közvetített és a megszüntetéskor visszavont hitelesítő adatok, a megtisztított környezet, a módja által engedélyezett eszközfelület és a műveletkorlátok. Az olyan hatások, mint egy ág pusholása vagy egy pull request megnyitása, külön kapuk mögött vannak — lásd: Korlátok.

5. lépés: Az eredmény ellenőrzése

1. Nyissa meg a Beállítások → Munkaterület → Ügynökök pontot, és válassza ki az ügynökét
2. Nyissa meg a Naplók lapot

Ellenőrzési pont. Egy futássor, amely az állapotát, időtartamát, kezdési és befejezési idejét, valamint az általa használt adaptert mutatja.

Az ügynök módosításai a beszélgetés ágán vannak commitolva, a worktree-jében. A commitok szerzője az ügynök, Önt pedig egy Co-Authored-By: trailer jelöli meg.

Pull request beszerzése

Semmi sem nyit pull requestet magától. Ha szeretne egyet, kérje ugyanabban a beszélgetésben:

Pusholja fel ezt az ágat, és nyisson pull requestet az alapértelmezett ág ellen.

A pusholás (gitPush) és a PR létrehozása (prCreate) alapértelmezés szerint az Ön jóváhagyását kéri, így mindegyik előtt számítson egy megerősítésre. Ha a kérés felbukkanásakor nincs csatlakoztatva jóváhagyó, a művelet megtagadásra kerül ahelyett, hogy engedélyeznék — a korlátok zárt állapotba esnek.

A PR azon GitHub-identitás alatt nyílik meg, amelynek a tokenjét a futás használta — az Öné, ha személyes tokent tárolt —, nem az ügynök neve alatt. Az ügynök szerzősége a commitokon látszik.

Ön is megnyithatja: a tér Verziókezelés paneljén van egy Pull request létrehozása gomb, amely átviszi a beszélgetés ágát a szerkesztőképernyőre, a Pull requestek → Új PR pedig ugyanezt a képernyőt nyitja meg üresen. Itt folytatódik a következő oktatóanyag.

Összefoglaló

Létrehozott egy ügynököt, beállította az adapterét és a modelljét, adott neki egy teret és egy feladatot, és végignézte, ahogy egy valódi futás befejeződik egy elszigetelt worktree-ben anélkül, hogy hozzányúlt volna a checkoutjához.

Következő: Az első pull request átnézése, hogy megismerje az átnézési folyamatot.

További információ az ügynökökről: Az ügynökmodell. Az indítás részleteiről: Ügynökindítás életciklusa.