Ügynök létrehozása és konfigurálása

Ez az útmutató bemutatja, hogyan adhat hozzá egy ügynököt egy munkaterülethez, és hogyan konfigurálhatja addig, amíg az ténylegesen futni tud.

Minden munkaterület öt ügynököt kap alapból — egy CEO-t, valamint a qa, architect, engineer és librarian ügynököt —, így általában már vannak ügynökei, mielőtt bármelyiket beállítaná. Az alábbi lépések ugyanúgy érvényesek egy alapból létrehozott ügynökre, mint egy újra.

Mielőtt elkezdi

• Egy munkaterületen belül van. A teljes felület a Beállítások → Munkaterület → Ügynökök alatt található (/settings/workspace/agents).
• Az ügynöknek háttérrendszerre lesz szüksége. Vagy csatlakoztasson szolgáltatót a beépített harnesshez a Beállítások → Szerver → Modellszolgáltatók alatt, vagy telepítse a Claude Code CLI-t arra a gépre, amely a cc_server-t futtatja.
• Ha azt szeretné, hogy az ügynök készségeket hordozzon, először telepítse őket a Beállítások → Munkaterület → Készségek alatt. Az ügynök űrlapján csak azokat a készségeket tudja be- és kikapcsolni, amelyek már léteznek a munkaterületen.

Az ügynök hozzáadása

1. Nyissa meg a Beállítások → Munkaterület → Ügynökök pontot.
2. Kattintson az Új ügynök gombra.

Nincs párbeszédablak és nincs szerepkörválasztó. Azonnal létrejön egy „Névtelen ügynök” nevű ügynök, amely ki is jelölődik a jobb oldali részletek panelen.

Ekkor a bal oldali névsorban a „Névtelen ügynök” látható, a részletek paneljének Beállítások lapja nyitva van, a Név mezőben pedig a „Névtelen ügynök” szerepel.

Adjon nevet neki

• Név — az @-említésekben használt rövid azonosító, például alice. Az említések feldolgozása a @ karaktert és az azt követő szókaraktereket egyezteti, így egy kötőjelet, pontot vagy szóközt tartalmazó nevet soha nem lehet megemlíteni.
• Cím — az ember által olvasható megnevezés, például „Senior fejlesztő”.
• Rendszerprompt — opcionális kiegészítő utasítások, amelyek ügynökutasításokat tartalmazó szakaszként kerülnek be; nem helyettesítik az összeállított prompt többi részét.

Kattintson a Módosítások mentése gombra az űrlap alján. Az oldal minden mezőjét ez az egy gomb menti.

Adjon neki adaptert és modellt

Az Adapter legördülő lista azokat a futtatókat sorolja fel, amelyekkel a szervergép ténylegesen rendelkezik. A beépített adapter mindig megtalálható (maga a szerver). A Claude Code csak akkor jelenik meg, ha a CLI-jét felismerték azon a gazdagépen:

Adapter	Háttérrendszer
Control Center (built-in)	A folyamaton belüli ügynökciklus — nincs külső CLI
Claude Code	claude -p --output-format stream-json

Csak a beépített adapter érvényesíti a módokat, a futás közbeni irányítást, a szüneteltetést és a folytatást, a befejezési szerződéseket és az alügynököket. A Claude Code ezek közül egyiket sem nyújtja. A Cursor, a Codex és a többi modellszolgáltató a beépített adapterhez csatlakozik, nem külön futtatóként.

Az üres adapter a beépített ciklust jelenti

Az az ügynök, amelynél nincs beállítva adapter, a Control Center (built-in) adapterhez kerül kiosztásra, vagyis a szerveren belüli ciklushoz, így a gazdagépre semmit nem kell telepíteni. Ha modell sincs beállítva, az Anthropic alapértelmezett modelljét kéri, ezért egy teljesen beállítatlan ügynök csak akkor fut, ha csatlakoztatott egy Anthropic-fiókot. Az alapból létrehozott szakértők egyikkel sem rendelkeznek; mindkettőt állítsa be minden olyan ügynökön, amelyet használni kíván.

A Modell legördülő listát az Ön által választott adapter vezérli. A beépített adapternél a lista élőben azokból a szolgáltatókból áll össze, amelyeket a Beállítások → Szerver → Modellszolgáltatók alatt csatlakoztatott, így egy tárolt hitelesítő adat nélküli szolgáltató nulla modellt ad hozzá.

Készségek hozzáadása

A Készségek egy chipválasztó az ebben a munkaterületben telepített készségcsomagok fölött. Koppintson egy chipre a be- vagy kikapcsolásához; a pipa jelöli a kiválasztottakat. Ha a munkaterületen nincs készség, a mező ezt írja: „No skills available. Create skills in Settings → Skills first.”

A repók saját készségeit itt nem választja ki. Az a repó, amely ilyeneket szállít (a .agents/skills/, .claude/skills/ vagy .opencode/skills/ könyvtárban), automatikusan hozzáadja azokat ahhoz az ügynökhöz, amelyik éppen abban a repóban dolgozik, és lecserélődnek, amikor átvált egy másikba — lásd: Repóhoz kötött készségek.

A beszámolási vonal és a persona beállítása

• Felettese — válasszon ki egy másik ügynököt név szerint. Ez építi fel azt a beszámolási fát, amelyet az oldalfejléc Szervezeti ábra gombja mutat. Ez nem az a névsor, amelyet egy csapatvezető a delegáláskor használ — az a csapat tagjaiból és azok készségeiből áll össze.
• Persona — szabad szöveg, amely a hangnemet és a viselkedést formálja, például: „Az egyszerű, olvasható megoldásokat részesíti előnyben. Minden új kódhoz tesztet ír.”

A futtatás hangolása

• Gondolkodási erőfeszítés — a lehetőségek a kiválasztott modell saját közzétett szintjeiből származnak: Low / Medium / High, valamint Extra High az OpenAI stílusú modelleknél és Extra High + Max a Claude stílusúaknál. A mező teljesen el van rejtve, ha a kiválasztott modell nem deklarál gondolkodási szinteket, és ilyenkor a modell saját alapértelmezésére esik vissza.
• Kontextusablak mérete — a modellváltáskor mindig előre kitöltődik a modell kontextusablakával, egy koppintásra elérhető chipekkel a modell alapértelmezéséhez, valamint a 200k, 500k és 1M értékhez. A modell kiválasztása után beírt érték érvényesül a következő modellváltásig.
• Csend időtúllépés (perc) — ennyi kimenet nélküli idő után megszakítja a futtatást. Hagyja üresen a módonkénti alapértelmezés használatához.

Jogosultságok megadása

Az ügynöknek nincsenek saját jogosultságkapcsolói. Hogy mit pusholhat, nyithat meg, fésülhet össze vagy érhet el, azt a Beállítások → Munkaterület → Ügynökjogosultságok alatti műveleti szabályok határozzák meg, ahol egy szabály erre az ügynökre korlátozható. Alapértelmezés szerint a push, a pull request, az átnézés vagy összefésülés és a követőbe írás egyaránt előbb Önt kérdezi meg, a hálózati hozzáférés pedig engedélyezett.

Az ügynök GitHub-tokenje mindig csak olvasásra jogosult. A push a Control Centeren megy át, amely a továbbítás előtt megkérdezi a Küldés távoli tárolóra szabályt. Hogy az egyes szabályok hogyan érik el a futást, lásd a Homokozószabályzatok konfigurálása oldalon.

A szabályok és az operációs rendszer homokozója külön rétegek

A szabályok azt döntik el, mit tehet egy ügynök; az operációs rendszer homokozója azt korlátozza, hol olvashatnak, írhatnak és kapcsolódhatnak a folyamatai. A cc_server a gazdagép homokozójába csomagolja az ügynökfuttatásokat, ahol van ilyen — a Windowson nincs natív háttérrendszer, a Linuxnak és a WSL2-nek pedig bwrap és socat kell. A határok teljes körét lásd a Homokozó és biztonság oldalon.

Ellenőrizze, hogy fut

1. Nyissa meg a Beállítások → Szerver → Modellszolgáltatók oldalt, és győződjön meg róla, hogy a választott adapter telepített verziót jelez a „Nem található” helyett. Kattintson a Frissítés gombra az újrapróbálkozáshoz — a próba a cc_server-t futtató gépen fut, nem azon, amelyet éppen néz.
2. Nyisson meg egy teret az ügynökkel, és küldjön neki üzenetet, vagy @-említse meg egy meglévő térben.
3. Térjen vissza a Beállítások → Munkaterület → Ügynökök oldalra, válassza ki az ügynököt, és nyissa meg a Naplók lapot. Meg kell jelennie egy futtatásnak állapotjelvényével, időtartamával, kezdési időpontjával és a használt adapterrel. A Nézet megnyitja az adott futtatás eseményfolyamát.

Ha egyáltalán nem jelenik meg futtatás, végezze végig az Ügynök diagnosztizálása útmutatót.

Ügynök törlése

Válassza ki a névsorban. A Beállítások lapon görgessen az űrlap alján lévő Veszélyzóna szakaszig, és kattintson a Törlés gombra.

Kapcsolódó útmutatók

• Ügynökök párhuzamos futtatása
• Ügynökcsapat felépítése
• Adapterek és modellek kezelése
• Ügynök diagnosztizálása
• Ügynökkonfiguráció-referencia

Kapcsolódó fogalmak

• Az ügynökmodell
• Módok
• Homokozó és biztonság