Муқаддима

Муқаддима

Модели бузурги забонӣ матн менависад, ба саволҳо ҷавоб медиҳад ва код тавлид мекунад. Аммо худаш на дар интернет ҷустуҷӯ мекунад, на файл мехонад ва на ба ягон система фармон медиҳад. Агенти зеҳни сунъӣ (AI Agent) ҳамин қадами навбатӣ аст: модели забоние, ки дар давраи «андеша — амал — мушоҳида» ҷой дода шудааст, абзорҳоро даъват мекунад, натиҷаро мебинад ва то расидан ба ҳадаф кори худро идома медиҳад.

Ин китоб дар бораи он аст, ки чунин агентҳо чӣ гуна кор мекунанд, чӣ гуна онҳоро бояд сохт ва чӣ гуна онҳоро бехатар ва боэътимод ба кор андохт.

Китоб барои кист?

Китоб барои навомӯзон навишта шудааст: барои касе, ки асосҳои Python-ро медонад (тағйирёбанда, функсия, рӯйхат ва луғат) ва шояд бо ChatGPT ё чатботи дигар кор карда бошад. Донистани омӯзиши мошинӣ ё риёзиёти олӣ лозим нест: ҳар мафҳуми нав дар ҷойи аввали пайдо шуданаш бо забони сода шарҳ дода мешавад.

Агар хоҳед дар бораи худи моделҳои забонӣ — токенсозӣ, механизми таваҷҷуҳ ва омӯзиши моделҳо — амиқтар донед, китоби «Омӯзиши моделҳои бузурги забонӣ (LLM)» ёрӣ медиҳад. Аммо барои хондани ин китоб он ҳатмӣ нест.

Китоб чӣ гуна ташкил шудааст?

Китоб аз се қисм ва хотима иборат аст.

1. Асосҳо (бобҳои 1–5). Агент чист, модели забонӣ дар он чӣ нақш дорад, абзорҳо чӣ гуна кор мекунанд, давраи «Мулоҳиза — Амал — Мушоҳида» ва аввалин агент бо китобхонаи smolagents. Ин қисм бе чаҳорчӯбаҳои мураккаб, қадам ба қадам навишта шудааст.
2. Агентҳо дар амал (бобҳои 6–12). Агенти дорои ҳолат бо LangGraph, қолабҳои асосӣ ва системаҳои бисёрагентӣ, интихоби модел, санҷиши натиҷаҳо ва MCP, иҷрои бехатар, арзёбӣ ва хотираи агент.
3. Барои хонандагони пешрафта (боби 13). Омӯзонидани агентҳо бо омӯзиши тақвиятӣ ва ҷустуҷӯи дарахтӣ. Ин боб ихтиёрӣ аст.

Хотима (боби 14) ба хатарҳои агентҳо ва роҳҳои назорати онҳо бахшида шудааст ва китобро ҷамъбаст мекунад. Боби 15 вожанома аст: истилоҳҳои асосӣ — модел, scaffolding, harness ва агент — бо забони сода шарҳ дода шудаанд.

Китобро чӣ гуна хондан беҳтар аст?

Бобҳои 1–7-ро бо тартиб хонед: ҳар боб ба боби пешин такя мекунад. Бобҳои 8–12 нисбатан мустақиланд.

Ҳар боб чунин сохтор дорад:

• Матни асосӣ — он чи ҳар хонанда бояд донад, бо мисолҳо ва коди кӯтоҳ.
• «Чиро бояд дар ёд дошт» — 3–5 ғояи асосии боб бо забони сода. Агар вақт кам бошад, аввал ҳаминро хонед.
• «Барои хонандагони пешрафта» — тафсилоти техникӣ, формулаҳо ва коди пурра. Ин қисм ихтиёрӣ аст: бори аввал метавонед онро гузаронед ва баъдтар, вақте ба он ниёз пайдо кардед, баргардед.

Мундариҷа

• Боби 1. Агент чист? — агент аз чатбот чӣ фарқ дорад, сатҳҳои мустақилият ва кай агент воқеан лозим аст.
• Боби 2. Моделҳои бузурги забонӣ, паёмҳо ва қолабҳои чат — модел матнро чӣ гуна менависад ва гуфтугӯ чӣ гуна ба модел дода мешавад.
• Боби 3. Абзорҳо — абзор чист ва модел аз куҷо медонад, ки кадом абзорро даъват кунад.
• Боби 4. Давраи «Мулоҳиза — Амал — Мушоҳида» — давраи асосии кори агент қадам ба қадам.
• Боби 5. Аввалин агент — агенти сода аз сифр ва аввалин агент бо smolagents.
• Боби 6. Аз LLM то агент — ба агент ҳолат ва хотира додан бо LangGraph.
• Боби 7. Меъмориҳо ва қолабҳо — қадам ба қадам фикр кардан (CoT), ReAct, тасдиқи инсон ва дастаи агентҳо.
• Боби 8. Моделҳое, ки агентҳоро ба кор меандозанд — барои ҳар кор модели мувофиқро чӣ гуна интихоб кунем.
• Боби 9. Аз намуна то муҳити истеҳсолӣ — санҷиши натиҷаи модел бо Pydantic ва пайваст кардани абзорҳо тавассути MCP.
• Боби 10. Иҷрои бехатар — чаро промпт муҳофизат нест ва чӣ гуна агентро бо код ва контейнер маҳдуд кунем.
• Боби 11. Арзёбӣ ва мушоҳида — агентро пеш аз ба кор андохтан ва пас аз он чӣ гуна санҷем.
• Боби 12. Хотираи агент — хотираи кӯтоҳмуддат ва дарозмуддат ва чӣ гуна онро тоза нигоҳ дорем.
• Боби 13. Банақшагирии пешрафта ва андешаронӣ (барои хонандагони пешрафта) — омӯзонидани агентҳо бо омӯзиши тақвиятӣ ва ҷустуҷӯи дарахтӣ.
• Боби 14. Хотима — хатарҳои агентҳо, роҳҳои назорат ва рӯйхати санҷиш пеш аз ба кор андохтани агент.
• Боби 15. Вожанома — модел, scaffolding, harness, агент ва истилоҳҳои дигар бо мисолҳои сода.
• Замима. Луғати истилоҳот — истилоҳоти тоҷикӣ бо муодили англисӣ.

Дар бораи код

Мисолҳо бо Python навишта шудаанд (дар бораи забонҳои дигар ниг. поёнтар). Дар қисми якум китобхонаи smolagents ва API-и Hugging Face истифода мешаванд, дар қисми дуюм асосан LangChain ва LangGraph. Барои иҷрои баъзе мисолҳо калиди API-и провайдери модел (масалан, OpenAI ё Hugging Face) лозим аст.

Китобхонаҳои агентӣ хеле зуд тағйир меёбанд. Агар мисол бо версияи нави китобхона хато диҳад, ҳуҷҷатҳои ҳамон китобхонаро бинед: ғоя одатан ҳамон мемонад, танҳо номи функсия ё параметр дигар мешавад. Дар баъзе мисолҳо барои кӯтоҳӣ қисмҳои такрорӣ оварда нашудаанд; ин дар матн ё бо шарҳи дохили код (масалан, «# … оварда нашудааст») ишора шудааст. Чунин порчаҳо синтаксиси дурусти Python доранд, аммо бе қисмҳои гумшуда иҷро намешаванд. Мисолҳо барои Python 3.11 ё навтар навишта шудаанд.

Коди пурра ва дафтарҳои интерактивии (Jupyter notebook) бобҳои 6–13 дар анбори китоби аслӣ ҷойгиранд: https://github.com/Nicolepcx/ai-agents-the-definitive-guide. Номи дафтарҳо рақамгузории китоби аслиро нигоҳ медоранд (масалан, ch08_OWASP_ASI_2026.ipynb ба боби 11-и ин китоб мувофиқ аст).

Агар бо забони дигар барномасозӣ кунед

Мисолҳои китоб бо Python навишта шудаанд, зеро аксари китобхонаҳои агентӣ аввал барои Python пайдо мешаванд. Аммо агентро бо ҳар забоне сохтан мумкин аст, ки дархости HTTP фиристода ва JSON-ро коркард карда метавонад: Go, TypeScript/JavaScript, Java, C#, Rust ва ғайра. Мафҳумҳои асосии китоб — давраи «андеша — амал — мушоҳида», абзорҳо ва тавсифи онҳо бо JSON Schema, ҳолат, хотира, MCP ва ҳудуди бехатарӣ — ба забон вобаста нестанд.

Барои забонҳои дигар низ китобхонаҳо мавҷуданд, масалан:

• Go — LangChainGo ва SDK-и расмии MCP барои Go;
• TypeScript/JavaScript — LangGraph.js ва SDK-и расмии MCP барои TypeScript;
• Java ва C# — Spring AI (Java) ва Semantic Kernel (.NET).

Ин китобхонаҳо зуд тағйир меёбанд; пеш аз истифода ҳуҷҷатҳои навтаринашонро бинед.

Манбаъҳо ва миннатдорӣ

Ин китоб дар асоси маводи муаллифони дигар таҳия шудааст: тарҷума, ба ҳам пайваст ва ба хонандаи тоҷик мутобиқ карда шудааст. Ба муаллифони онҳо самимона миннатдорем.

• Курси агентҳои Hugging Face (Hugging Face Agents Course) — бобҳои 1–5. Маводи омӯзишии кушода. https://huggingface.co/learn/agents-course
• Китоби O'Reilly «AI Agents: The Definitive Guide», ки муаллифаш Николе Кёнигштейн (Nicole Koenigstein), муаллифи китоби «Transformers: The Definitive Guide» (O'Reilly) аст — бобҳои 6–13 (бобҳои 1–6, 8 ва 10-и китоби аслӣ).
• Мақолаи «Оё зеҳни сунъӣ аз назорат берун мешавад? Хатарҳои агентҳои зеҳни сунъӣ», нашрияи «Опакала» — боби 14.
• Вожаномаи агентҳои Hugging Face (Agent Glossary) — боби 15. https://huggingface.co/blog/agent-glossary

Мақолаҳои илмие, ки натиҷаҳояшон дар китоб оварда шудаанд, дар қисмҳои «Манбаъҳо»-и бобҳо зикр шудаанд. Масъулияти хатоҳои эҳтимолии тарҷума ва мутобиқсозӣ бар дӯши таҳиягарони ин китоб аст.

Чанд сухан дар бораи замон

Соҳаи агентҳо аз соҳаи худи моделҳои забонӣ ҳам тезтар тағйир меёбад: чаҳорчӯбаҳо, протоколҳо ва моделҳо ҳар чанд моҳ нав мешаванд. Аз ин рӯ, дар китоб ба принсипҳо — давраи агент, ҳолат, абзорҳо, назорат ва бехатарӣ — бештар диққат дода шудааст. Номҳои мушаххаси моделҳо ва китобхонаҳо мисол ҳастанд; принсипҳо боқӣ мемонанд.