# Az AI-ügynökök mélyreható megértése: tervezési alapelvek és mérnöki gyakorlat
[](#-e-könyv) [](https://bojieli.github.io/ai-agent-book/) [](https://github.com/bojieli/ai-agent-book) [](../../LICENSE) [](#-e-könyv)
[](https://github.com/trending)
**[中文](../../README.md) · [English](../en/README.md) · [Español](../es/README.md) · [Bahasa Indonesia](../id/README.md) · [العربية](../ar/README.md) · [繁體中文（台灣）](../zh-TW/README.md) · [Русский](../ru/README.md) · [Tiếng Việt](../vi/README.md) · [தமிழ்](../ta/README.md) · [日本語](../ja/README.md) · [Türkçe](../tr/README.md) · [한국어](../ko/README.md) · Magyar ← jelenlegi · [עברית](../../README.he.md)**
> 📥 **[PDF / EPUB letöltése](#-e-könyv)** (ajánlott) — a PDF- és EPUB-kiadás nyújtja a legjobb olvasási élményt; a könyv [online is olvasható](https://bojieli.github.io/ai-agent-book/), nyelvváltóval, összecsukható fejezetfával és teljes szövegű kereséssel.
**Ágens = NYM + Kontextus + Eszközök** — a könyv erre az alapképletre építve, tíz fejezeten keresztül vezet el az AI-ügynökök alapelveitől a mérnöki gyakorlatig. A teljes szöveg, az ábrák és a **104 kapcsolódó projekt** nyílt forráskódú.
> 📢 **A 2.0-s verzió változásai az 1.4-eshez képest:** A 2.0-s verzió a korábbi 4. fejezet „aszinkron interakció” részét és a korábbi 9. fejezet „multimodális ágensekről” szóló anyagát egyesíti, majd új 6. fejezetként, „Interakció: a megfigyelési és a cselekvési tér kiterjesztése” címmel rendezi át. A korábbi 6. („Ügynökök kiértékelése”), 7. („Modell poszt-tréning”) és 8. („Az ágensek folyamatos evolúciója”) fejezet egy-egy hellyel hátrébb került, így most rendre a 7., 8. és 9. fejezet.
>
> Ha egy régebbi PDF-et olvas, javasoljuk, hogy [töltse le a legújabb PDF-et](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-hu.pdf). Az új kiadás számos javítást és tartalmi módosítást is tartalmaz; kérjük, mindig a legfrissebb verziót használja.
| 📚 **10 fejezet** az alapoktól az éles rendszerekig | 📂 **104 kapcsolódó projekt**, helyi projektekkel és külső reprodukciós útvonalakkal | 🌐 **14 nyelv**: ZH / EN / ES / ID / AR / zh-TW / RU / TA / VI / JA / TR / KO / HU / HE |
| :---: | :---: | :---: |
## 📖 E-könyv
> 📥 **Letöltés offline olvasáshoz** (teljes szöveg, ingyenes és nyílt forráskódú). Az alábbi hivatkozások mindig a `main` ág legfrissebb buildjére mutatnak; a rögzített verziók a [Releases](https://github.com/bojieli/ai-agent-book/releases) oldalon érhetők el:
> - **Magyar** (közösségi fordítás, [@barmivalami0-ux](https://github.com/barmivalami0-ux)): [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-hu.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-hu.epub)
> - **Kínai (eredeti)**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-zh-CN.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-zh-CN.epub)
> - **Angol**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-en.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-en.epub)
> - **Spanyol**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-es.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-es.epub)
> - **Indonéz**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-id.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-id.epub)
> - **Arab**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ar.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ar.epub)
> - **Hagyományos kínai (Tajvan)**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-zh-TW.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-zh-TW.epub)
> - **Orosz**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ru.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ru.epub)
> - **Tamil**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ta.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ta.epub)
> - **Vietnámi**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-vi.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-vi.epub)
> - **Japán**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ja.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ja.epub)
> - **Török**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-tr.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-tr.epub)
> - **Koreai**: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ko.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ko.epub)
>
> 🌐 A könyv [online is olvasható](https://bojieli.github.io/ai-agent-book/). A webhely a `main` ág minden frissítése után automatikusan újraépül.
A magyar kézirat forrása a [`book-hu/`](../../book-hu/) könyvtárban található. Ez közösségi fordítás, ezért előfordulhat, hogy lemarad a kínai eredeti mögött.
🔧 Saját PDF / EPUB build készítése (a PDF-hez pandoc / xelatex / ElegantBook szükséges)
- **EPUB**: használd a közös buildrendszert; lásd az [EPUB buildelési útmutatót](../../EPUB.md)
- **Szövegforrás**: `book-hu/introduction.md`, `book-hu/chapter1.md`–`book-hu/chapter10.md` és `book-hu/afterword.md`
- **PDF build**: telepítsd a pandoc, xelatex és ElegantBook eszközöket, valamint a szükséges betűkészleteket, majd futtasd:
```bash
cd book-hu && bash build_pdf.sh
```
Az ábrák a `book-hu/images/` könyvtárban találhatók; a tördelési beállításokat a `book-hu/preamble.tex` és a `book-hu/*.lua` fájlok tartalmazzák.
## 📑 Tartalmi áttekintés (1–10. fejezet)
| Fejezet | Téma | Rövid összefoglaló | Szöveg | Kód |
| :--: | --- | --- | :--: | :--: |
| 1 | 🚀 **Ismerkedés az AI-ügynökökkel** | **Ágens = NYM + Kontextus + Eszközök**; a harness-mérnökség teremti meg a valódi versenyelőnyt | [Olvasás](../../book-hu/chapter1.md) | [4](../../chapter1/README.hu.md) |
| 2 | 🎯 **Kontextustervezés** | KV Cache, prompttervezés, Agent Skills és kontextustömörítés | [Olvasás](../../book-hu/chapter2.md) | [8](../../chapter2/README.hu.md) |
| 3 | 📚 **Felhasználói memória és tudásbázis** | Munkameneteken átívelő memória, RAG, strukturált indexek és tudásgráfok | [Olvasás](../../book-hu/chapter3.md) | [12](../../chapter3/README.hu.md) |
| 4 | 🛠️ **Eszközök** | MCP, érzékelési, végrehajtási és együttműködési eszközök, eseményvezérelt aszinkron ágensek | [Olvasás](../../book-hu/chapter4.md) | [8](../../chapter4/README.hu.md) |
| 5 | 💻 **Kódoló ágens és kódgenerálás** | A kód mint új eszközöket létrehozó eszköz; éles környezetre kész kódoló ágensek | [Olvasás](../../book-hu/chapter5.md) | [13](../../chapter5/README.hu.md) |
| 6 | 🎙️ **Interakció: a megfigyelési és a cselekvési tér kiterjesztése** | Az ágens megfigyelési és cselekvési terének kiterjesztése modalitásban és időben: aszinkron és eseményvezérelt rendszerek, beszéd, Computer Use és robotika | [Olvasás](../../book-hu/chapter6.md) | [13](../../chapter6/README.hu.md) |
| 7 | 🎯 **Ügynökök kiértékelése** | A teljesítmény összehasonlítható jelekké alakítása: környezetek, mérőszámok, statisztikai szignifikancia és értékelésvezérelt kiválasztás | [Olvasás](../../book-hu/chapter7.md) | [13](../../chapter7/README.hu.md) |
| 8 | 🧠 **Modell poszt-tréning** | Három szakasz—előképzés, SFT és RL: mikor válasszunk SFT-t vagy RL-t, az eszközhívások internalizálása és a mintahatékonyság | [Olvasás](../../book-hu/chapter8.md) | [19](../../chapter8/README.hu.md) |
| 9 | 🔄 **Az ágensek folyamatos evolúciója** | Tanulási jelek kinyerése a végrehajtási nyomvonalakból, majd a tudás, utasítások, programok és paraméterek frissítése | [Olvasás](../../book-hu/chapter9.md) | [9](../../chapter9/README.hu.md) |
| 10 | 🤝 **Többügynökös együttműködés** | Együttműködési struktúrák, kontextusmegosztás és -elszigetelés, ágenstársadalmak | [Olvasás](../../book-hu/chapter10.md) | [8](../../chapter10/README.hu.md) |
> 💡 Az **Olvasás** hivatkozások megnyitják a fejezet magyar szövegét a GitHubon; a **Kód** oszlop számai a kapcsolódó projektek magyar jegyzékére mutatnak.
>
> 📚 A javasolt tanulási sorrendet és gyakorlati tippeket a **[Tanulási javaslatok](LEARNING.md)** tartalmazza.
## 💻 A kapcsolódó kísérletek futtatása
A közösen támogatott tartomány a **Python 3.11–3.13**. A függőségeket a repository gyökeréből, fejezetenként telepítsd; másik fejezethez a `ch1` helyére `ch2`–`ch10` kerüljön:
```bash
# Ajánlott: reprodukálható környezet a repository-ban tárolt uv.lock alapján
uv sync --locked --extra ch1
# uv nélkül: telepítés pip segítségével a pyproject.toml fájlból
python -m pip install -e ".[ch1]"
```
Egy kísérlet futtatása előtt olvasd el az adott projekt README-jét az API-kulcsokról, a rendszerfüggőségekről és az esetleges további Python-verziókövetelményekről. Például:
```bash
uv run python chapter1/context/main.py
```
## 🔑 API-kulcsok
A modellt használó kísérletekhez legalább egy szolgáltatói API-kulcs szükséges. A modellválasztáshoz lásd [ezt az útmutatót](https://01.me/2025/07/llm-api-setup/); az egyes kísérletek pontos beállításait mindig a saját README-jük tartalmazza.
> 🧪 A kísérletek futtatási állapotát, bizonyítékait és még teljesítendő kapuit külön az [`EXPERIMENT_STATUS.md`](../EXPERIMENT_STATUS.md) tartalmazza; a forráskód klónozása vagy telepítése önmagában nem igazolja a kísérlet befejezését.
## 📦 Függelék · Külső repository-k beszerzése
A 6., 7., 9. és 10. fejezethez tartozó 22 külső repository, valamint egy kiegészítő tanítási cookbook méret- és licencokokból nincs a projektbe csomagolva. Az alábbi parancsok reprodukálható kiindulópontként rögzített commitokat töltenek le.
🔧 A klónozási parancsok megjelenítése (23 checkout)
```bash
# 6. fejezet · Értékelési benchmarkok
git clone https://github.com/google-research/android_world.git chapter6/android_world && git -C chapter6/android_world checkout --detach 0e95d641e244504c22087cc29b013f3b2428a261
git clone https://huggingface.co/datasets/gaia-benchmark/GAIA chapter6/GAIA && git -C chapter6/GAIA checkout --detach 682dd723ee1e1697e00360edccf2366dc8418dd9
git clone https://github.com/xlang-ai/OSWorld.git chapter6/OSWorld && git -C chapter6/OSWorld checkout --detach 8365edc975efd0477a0d62444a5beed562ab5a7b
git clone https://github.com/SWE-bench/SWE-bench.git chapter6/SWE-bench && git -C chapter6/SWE-bench checkout --detach 5cd4be9fb23971679cbbafe5a0ecade27cef99be
git clone https://github.com/sierra-research/tau2-bench.git chapter6/tau2-bench && git -C chapter6/tau2-bench checkout --detach 8d005b0e5b9e4af0bc055886fa7f95fc86d1710e
git clone https://github.com/laude-institute/terminal-bench.git chapter6/terminal-bench && git -C chapter6/terminal-bench checkout --detach 8384a179b1b8688f6ea5233a4d9d51218df1ac96
# 7. fejezet · Tanítási keretrendszerek (a bojieli/* ágak a könyvhöz igazított változatok)
git clone https://github.com/bojieli/minimind.git chapter7/MiniMind-pretrain/minimind && git -C chapter7/MiniMind-pretrain/minimind fetch origin 8bdc5d97d5845a8c1ac2ed56a5b8b4c0d0fb0795 && git -C chapter7/MiniMind-pretrain/minimind checkout --detach 8bdc5d97d5845a8c1ac2ed56a5b8b4c0d0fb0795 && test "$(git -C chapter7/MiniMind-pretrain/minimind rev-parse HEAD)" = "8bdc5d97d5845a8c1ac2ed56a5b8b4c0d0fb0795" # 7-3. kísérlet
git clone https://github.com/bojieli/minimind-v.git chapter7/MiniMind-pretrain/minimind-v && git -C chapter7/MiniMind-pretrain/minimind-v fetch origin ead791c530fa5f9a3549dbfe9e11ec732d18d2e5 && git -C chapter7/MiniMind-pretrain/minimind-v checkout --detach ead791c530fa5f9a3549dbfe9e11ec732d18d2e5 && test "$(git -C chapter7/MiniMind-pretrain/minimind-v rev-parse HEAD)" = "ead791c530fa5f9a3549dbfe9e11ec732d18d2e5" # 7-4. kísérlet
git clone https://github.com/bojieli/AdaptThink.git chapter7/AdaptThink-original && git -C chapter7/AdaptThink-original checkout --detach 0033ad172dd53ac64004b763477407014f21b838 # 7-10. kísérlet
git clone https://github.com/bojieli/SFTvsRL.git chapter7/SFTvsRL && git -C chapter7/SFTvsRL checkout --detach fef0a4a3367260a0934be1e40b01e4021698e023 # 7-11. és 7-12. kísérlet
git clone https://github.com/bojieli/AWorld.git chapter7/AWorld && git -C chapter7/AWorld checkout --detach a52d61d6d483e66b22ef16970eae5bbf4f4ab2ec # 7-16. kísérlet
git clone https://github.com/bojieli/verl.git chapter7/verl && git -C chapter7/verl checkout --detach 1593fc3a8cf894debdc3dece2a23ed739c282789 # 7-15. ReTool-recept és 7-16. tanítási háttérrendszer
git clone https://github.com/bojieli/SandboxFusion.git chapter7/SandboxFusion && git -C chapter7/SandboxFusion fetch origin 4a0d573ebd64c98234c190a9d1d49e4276199a0c && git -C chapter7/SandboxFusion checkout --detach 4a0d573ebd64c98234c190a9d1d49e4276199a0c && test "$(git -C chapter7/SandboxFusion rev-parse HEAD)" = "4a0d573ebd64c98234c190a9d1d49e4276199a0c" # 7-15. kísérlet, kódsandbox
git clone https://github.com/thinking-machines-lab/tinker-cookbook.git chapter7/tinker-cookbook && git -C chapter7/tinker-cookbook checkout --detach fc8449187041cf102905f3f751e6d2eac7f9f754
git clone https://github.com/19PINE-AI/rlvp.git chapter7/RLVP/rlvp && git -C chapter7/RLVP/rlvp fetch origin 1ad30bc7e338911fb733739393d92c420f4d8bee && git -C chapter7/RLVP/rlvp checkout --detach 1ad30bc7e338911fb733739393d92c420f4d8bee && test "$(git -C chapter7/RLVP/rlvp rev-parse HEAD)" = "1ad30bc7e338911fb733739393d92c420f4d8bee" # 7-14. kísérlet
git clone https://github.com/PRIME-RL/SimpleVLA-RL.git chapter7/SimpleVLA-RL/SimpleVLA-RL && git -C chapter7/SimpleVLA-RL/SimpleVLA-RL checkout --detach 7c51662df27b586f9e8a1ab35fcf849f2b8852f9 # 7-13. kísérlet
# 9. fejezet · GUI és robotikai reprodukciós útvonalak
git clone https://github.com/anthropics/claude-quickstarts.git chapter9/claude-quickstarts && git -C chapter9/claude-quickstarts checkout --detach 9bcc95e316e5ef6542b4c9d0469f4078829eead5 # 9-5. kísérlet, computer-use-demo/
git clone https://github.com/browser-use/browser-use.git chapter9/browser-use && git -C chapter9/browser-use checkout --detach ec9277c5001f2cb78ee419c927775a3cfc227ff8 # 9-6. kísérlet
git clone https://github.com/Vector-Wangel/XLeRobot.git chapter9/XLeRobot && git -C chapter9/XLeRobot fetch origin 3d14695e40c9c68229c0aacffca6053c75cd3eb6 && git -C chapter9/XLeRobot checkout --detach 3d14695e40c9c68229c0aacffca6053c75cd3eb6 && test "$(git -C chapter9/XLeRobot rev-parse HEAD)" = "3d14695e40c9c68229c0aacffca6053c75cd3eb6" # a 9-7. és 9-9. kísérlet közös függősége
git clone https://github.com/Grigorij-Dudnik/RoboCrew.git chapter9/RoboCrew && git -C chapter9/RoboCrew fetch origin c749148f29bd14e61347f9fc3530c343fff0d994 && git -C chapter9/RoboCrew checkout --detach c749148f29bd14e61347f9fc3530c343fff0d994 && test "$(git -C chapter9/RoboCrew rev-parse HEAD)" = "c749148f29bd14e61347f9fc3530c343fff0d994" # 9-8/9-9. kísérlet; RoboCrew v0.3.1
git clone https://github.com/StoneT2000/lerobot-sim2real.git chapter9/lerobot-sim2real && git -C chapter9/lerobot-sim2real fetch origin 87d6c1d969f6e0ca4dc5697940804e231118a63a && git -C chapter9/lerobot-sim2real checkout --detach 87d6c1d969f6e0ca4dc5697940804e231118a63a && test "$(git -C chapter9/lerobot-sim2real rev-parse HEAD)" = "87d6c1d969f6e0ca4dc5697940804e231118a63a" # 9-11. kísérlet
# 10. fejezet · Kettős ágensarchitektúra és Stanford AI Town
git clone https://github.com/19PINE-AI/TalkAct.git chapter10/use-computer-while-calling && git -C chapter10/use-computer-while-calling fetch origin 7d70007f72d45ddfc1a14e8e229b6d444e4919a2 && git -C chapter10/use-computer-while-calling checkout --detach 7d70007f72d45ddfc1a14e8e229b6d444e4919a2 && test "$(git -C chapter10/use-computer-while-calling rev-parse HEAD)" = "7d70007f72d45ddfc1a14e8e229b6d444e4919a2" # 10-3. kísérlet (historikus 10-4)
git clone https://github.com/joonspk-research/generative_agents.git chapter10/generative_agents && git -C chapter10/generative_agents fetch origin fe05a71d3e4ed7d10bf68aa4eda6dd995ec070f4 && git -C chapter10/generative_agents checkout --detach fe05a71d3e4ed7d10bf68aa4eda6dd995ec070f4 && test "$(git -C chapter10/generative_agents rev-parse HEAD)" = "fe05a71d3e4ed7d10bf68aa4eda6dd995ec070f4" # 10-5. kísérlet (historikus 10-7)
```
> A rögzített forráskód csak reprodukálható kiindulópont; nem bizonyítja, hogy a tanítási, hardveres, böngészős vagy többágenses kísérlet sikeresen lefutott.
## 🤝 Közreműködés
A könyv és a kapcsolódó kód teljes egészében nyílt forráskódú; örömmel fogadjuk a Pull Requesteket.
| Típus | Leírás |
| --- | --- |
| 📝 **Könyvszöveg** | Elírások javítása, kiegészítések, világosabb megfogalmazás és új fejlemények |
| 🐛 **Kódjavítások** | A kapcsolódó projektek robusztusabbá és könnyebben használhatóvá tétele |
| 🧪 **Új gyakorlóprojektek** | Jobb implementációk vagy új példák hozzáadása |
| 🎨 **Ábrák** | A `book-hu/images/` magyar ábráinak javítása |
| 🌐 **Fordítások** | Új nyelvek hozzáadása vagy a meglévő fordítások fejlesztése |
## 📄 Licenc
A projekt az [Apache License 2.0](../../LICENSE) feltételei szerint érhető el. Egyes alprojektek saját licencinformációkat tartalmazhatnak; ezeknél az adott alprojekt feltételei érvényesek.
## ⭐ Star-előzmények
A diagramot a [`scripts/gen_star_history.py`](../../scripts/gen_star_history.py) hozza létre, és a [GitHub Actions](../../.github/workflows/star-history.yml) naponta frissíti.
