Agent Zero

Az Agent Zero nyílt forráskódú ügynök-keretrendszer, amely egy Docker konténerben teljes Linux rendszert kap: terminált, fájlrendszert, böngészőt és valódi asztali felületet. Nem egyetlen feladatra van beprogramozva: a projekt leírása szerint a saját gépén fut, eszközöket használ és készít, tanul, javítja magát, a munkafolyamatai pedig követhetők maradnak.

A hangsúly a környezeten van. Az ügynök az operációs rendszert használja eszközként, ezért nem kell minden lépéshez külön integráció, és amihez nincs kész eszköze, azt kóddal oldja meg a konténeren belül.

Mi az Agent Zero?

Egyetlen konténer teljes Linux rendszert szállít, benne XFCE asztali munkamenettel a webes felület oldalsó vásznán. Ez nem távoli virtuális gép és nem megosztott vágólap: ugyanaz az asztal, amit a felhasználó is lát, ezért bármikor be lehet avatkozni.

• Asztal és böngésző. Az ügynök grafikus programokat nyithat, fájlokat kezelhet, oldalakat olvashat, űrlapokat tölthet ki, képernyőképet készíthet. Az annotációs módban egy elemre kattintva utasítás lesz belőle: módosítás, vizsgálat, újraimplementálás vagy megjegyzés.
• Közös munka fájlokon. A Markdown szerkesztő és a LibreOffice kötései mellett az ügynök és a felhasználó ugyanazon a dokumentumon dolgozik.
• Bővíthetőség. A Plugin Hub közösségi bővítményeket kínál, a tools/ saját eszközöket, a prompts/ saját utasításokat fogad, a Skills (SKILL.md) pedig kontextusfüggő eljárásokat ad hozzá.
• Memória és projektek. A memória vektoros visszakeresésre épül, a projektek külön fájl-, utasítás-, titok- és memóriatérrel zárják el egymástól a munkákat.
• Együttműködés. MCP kliensként és szerverként is működik, az A2A több példányt kapcsol össze, a feladat részei pedig alügynökökkel delegálhatók.

Telepítés és futtatás

A szokásos út a konténer. Asztali gépen az A0 Launcher ellenőrzi a Docker meglétét, létrehozza és kezeli a példányokat, és kiosztja a portokat; szerveren vagy szkriptből az A0 Install használható, amely quick-start módban egyetlen példányt hoz létre, majd kilép. Ha a Docker már fut, a hivatalos image közvetlenül is indítható, a 80-as port leképezésével és a perzisztens adatok /a0/usr alá kötésével. Ez a könyvtár a fájlokat, a beszélgetéseket és a titkokat is tartalmazza, ezért egyetlen tiszta kötést érdemes használni, és frissítés előtt mentést készíteni. Ha a 80-as port foglalt, másik hosztportot kell választani.

A gazdagép eléréséhez az A0 CLI Connector tartozik, amelyet a munkaállomáson, nem a konténerben kell telepíteni. Ez köti össze a futó ügynököt a helyi terminállal, a projektfájlokkal és a böngészővel, miközben az ügynök a konténerben marad. A hozzáférés nem automatikus: a gazdagépen végzett írás és parancsfuttatás engedélyezett gépekhez kötött.

Modellek és szolgáltatók

Három modellszerep van: a fő modell beszélget és tervez, a segédmodell a gyors belső feladatokat végzi, a beágyazó modell pedig a memóriát és a tudásbázis indexelését szolgálja. Utóbbi cseréje újraindexelést indíthat.

• Felhő. OpenRouter az alapértelmezett javaslat, de Anthropic, OpenAI és más hosztolt szolgáltatók is beállíthatók saját API-kulccsal.
• Saját fiók. Codex/ChatGPT, GitHub Copilot, Google Cloud Gemini vagy xAI Grok bejelentkezéssel.
• Helyi. Ollama vagy LM Studio a munkaállomáson, offline működéshez.

A helyi modelleknél a leggyakoribb hiba a hálózati cím: a konténeren belül a localhost a konténerre mutat, nem a gazdagépre, ezért a hoszton futó modellszervert host.docker.internal:11434 címen vagy a Docker híd átjáróján kell elérni. Ha a szerver csak 127.0.0.1-en figyel, a konténer nem éri el: Docker felé nyitott címre kell kötni, a portot pedig szűk körre korlátozni.

Amit a dokumentáció korlátként említ

A projekt útmutatása is hangsúlyozza, hogy az erő valódi környezetből jön, és fegyelem kell hozzá.

• Izoláció. Dockerben vagy más elszigetelt környezetben futtassuk; a teljes otthoni könyvtár becsatolása kockázatos, és frissítésnél a teljes /a0 könyvtárat nem érdemes térképre kötni.
• Gazdagép-hozzáférés. Az A0 CLI-nak adott írási és végrehajtási engedély csak megbízható gépekre és munkaterületekre vonatkozzon.
• Titkok. A hitelesítő adatok a /a0/usr/secrets.env fájlban élnek, amely nem mindig kerül bele a mentési archívumba.
• Hálózat. A webes felület internetre nyitása előtt kötelező a hitelesítés.
• Függőségek. A kódvégrehajtás a Docker futását igényli, a teljesítmény az erőforrásoktól függ, a beszélgetések és a memória pedig a /a0/usr alatt élnek, ezért mentés vagy kötet nélkül elveszhetnek.
• Delegálás. Az alügynököknek adott munka akkor hasznos, ha jól elválasztható; ugyanazon fájlok párhuzamos szerkesztését a dokumentáció is kerülésre javasolja.

Nálunk a CyberElectro az Agent Zero-t akkor veti be, amikor egy feladat valódi gépi környezetet és hosszabb önálló végrehajtást igényel, és a Hermes Agent mellé delegálja.

Tovább olvasás

• agent0ai/agent-zero - a forráskód és a dokumentáció kiindulópontja; a mappákban a promptok, eszközök és a biztonsági modell is olvasható.
• Installation - a telepítés útjai Launcherrel, A0 Install-lal vagy közvetlenül Dockerrel, a helyi modellszerverek beállításával.
• A0 CLI Connector - a gazdagép elérése úgy, hogy az ügynök közben a konténerben marad.