diff --git a/docs/source/ko/_toctree.yml b/docs/source/ko/_toctree.yml
index ddd73e71b..ceb09a355 100644
--- a/docs/source/ko/_toctree.yml
+++ b/docs/source/ko/_toctree.yml
@@ -20,8 +20,8 @@
title: π μμ΄μ νΈ λ©λͺ¨λ¦¬ κ΄λ¦¬
- title: Conceptual guides
sections:
-# - local: conceptual_guides/intro_agents
-# title: π€ What are agents?
+ - local: conceptual_guides/intro_agents
+ title: π€ μμ΄μ νΈλ 무μμΈκ°μ?
- local: conceptual_guides/react
title: π€ λ©ν°μ€ν
μμ΄μ νΈλ μ΄λ»κ² λμνλμ?
- title: μμ
diff --git a/docs/source/ko/conceptual_guides/intro_agents.md b/docs/source/ko/conceptual_guides/intro_agents.md
new file mode 100644
index 000000000..4c5820fbf
--- /dev/null
+++ b/docs/source/ko/conceptual_guides/intro_agents.md
@@ -0,0 +1,105 @@
+# μμ΄μ νΈλ 무μμΌκΉμ? π€[[what-are-agents-]]
+
+## μμ΄μ ν± μμ€ν
μκ°[[an-introduction-to-agentic-systems]]
+
+ν¨μ¨μ μΈ AI μμ€ν
μ λ§λ€κΈ° μν΄μλ LLMμκ² νμ€ μΈκ³μ λν μΌμ’
μ μ κ·Ό κΆνμ μ 곡ν΄μΌ ν©λλ€. μλ₯Ό λ€μ΄, μΈλΆ μ 보λ₯Ό μ»κΈ° μν΄ κ²μ λꡬλ₯Ό νΈμΆνκ±°λ, νΉμ μμ
μ ν΄κ²°νκΈ° μν΄ νΉμ νλ‘κ·Έλ¨μ λ°λΌ νλνλλ‘ λ§λ€ μ μμ΅λλ€. λ€μ λ§ν΄, LLMμ ***주체μ±(agency)***μ κ°μ ΈμΌ ν©λλ€. μμ΄μ ν± νλ‘κ·Έλ¨μ LLMμ΄ μΈλΆ μΈκ³μ μνΈμμ©ν μ μλλ‘ μ°κ²°νλ μΈν°νμ΄μ€μ
λλ€.
+
+> [!TIP]
+> AI μμ΄μ νΈλ **LLMμ μΆλ ₯μ΄ μν¬νλ‘μ°λ₯Ό μ μ΄νλ νλ‘κ·Έλ¨**μ
λλ€.
+
+LLMμ νμ©νλ λͺ¨λ μμ€ν
μ μ½λμ LLMμ μΆλ ₯μ ν΅ν©ν©λλ€. LLMμ μ
λ ₯μ΄ μ½λ μν¬νλ‘μ°μ μΌλ§λ μν₯μ λ―ΈμΉλμ§κ°, μμ€ν
λ΄μμ LLMμ΄ κ°μ§λ 주체μ±μ μμ€μ κ²°μ ν©λλ€.
+
+μ΄ μ μμ λ°λ₯΄λ©΄, "μμ΄μ νΈ"λ 0 λλ 1λ‘ λλλ μ΄μ°μ μΈ μ μκ° μλλλ€. λμ , "주체μ±"μ μν¬νλ‘μ°μ λν΄ LLMμ μΌλ§λ λ§μ κΆνμ λΆμ¬νλμ§μ λ°λΌ μ°μμ μΈ μ€ννΈλΌ μμμ λ³νν©λλ€.
+
+μλ νμμ 주체μ±μ΄ μμ€ν
μ λ°λΌ μ΄λ»κ² λ¬λΌμ§ μ μλμ§ νμΈν΄ 보μΈμ.
+
+| μ£Όμ²΄μ± μμ€ | μ€λͺ
| κ°λ¨ν μ΄λ¦ | μμ μ½λ |
+| ------------ | --------------------------------------------------------------- | ---------------- | -------------------------------------------------- |
+| βββ | LLM μΆλ ₯μ΄ νλ‘κ·Έλ¨ νλ¦μ μν₯μ λ―ΈμΉμ§ μμ | λ¨μ μ²λ¦¬κΈ° | `process_llm_output(llm_response)` |
+| β
ββ | LLM μΆλ ₯μ΄ if/else λΆκΈ°λ₯Ό μ μ΄ν¨ | λΌμ°ν° | `if llm_decision(): path_a() else: path_b()` |
+| β
β
β | LLM μΆλ ₯μ΄ ν¨μ μ€νμ μ μ΄ν¨ | λꡬ νΈμΆ | `run_function(llm_chosen_tool, llm_chosen_args)` |
+| β
β
β | LLM μΆλ ₯μ΄ λ°λ³΅ λ° νλ‘κ·Έλ¨ μ§μ μ¬λΆλ₯Ό μ μ΄ν¨ | λ©ν°μ€ν
μμ΄μ νΈ | `while llm_should_continue(): execute_next_step()` |
+| β
β
β
| νλμ μμ΄μ ν± μν¬νλ‘μ°κ° λ€λ₯Έ μμ΄μ ν± μν¬νλ‘μ°λ₯Ό μμν μ μμ | λ©ν° μμ΄μ νΈ | `if llm_trigger(): execute_agent()` |
+| β
β
β
| LLMμ΄ μ½λ λ΄μμ νλνλ©°, μ체 λꡬλ₯Ό μ μνκ±°λ λ€λ₯Έ μμ΄μ νΈλ₯Ό μμν μ μμ | μ½λ μμ΄μ νΈ | `def custom_tool(args): ...` |
+
+λ©ν°μ€ν
μμ΄μ νΈλ λ€μκ³Ό κ°μ μ½λ ꡬ쑰λ₯Ό κ°μ§λλ€.
+
+```python
+memory = [user_defined_task]
+while llm_should_continue(memory): # μ΄ λ£¨νκ° λ©ν° μ€ν
(multi-step) μΆλ‘ , νΈμΆμ λ°λ³΅ν΄μ μννλ 루ν μ
λλ€.
+ action = llm_get_next_action(memory) # μ΄ λΆλΆμ΄ λꡬ νΈμΆ(tool-calling) λΆλΆμ
λλ€
+ observations = execute_action(action)
+ memory += [action, observations]
+```
+
+μ΄ μμ΄μ ν± μμ€ν
μ 루ν μμμ μ€νλλ©°, κ° λ¨κ³μμ μλ‘μ΄ νλμ μνν©λλ€(μ΄ νλμ 미리 μ ν΄μ§ *λꡬ*, μ¦ ν¨μλ₯Ό νΈμΆνλ κ²μ ν¬ν¨ν μ μμ΅λλ€). κ·Έλ¦¬κ³ κ΄μ°°μ ν΅ν΄ μ£Όμ΄μ§ μμ
μ ν΄κ²°νκΈ°μ λ§μ‘±μ€λ¬μ΄ μνμ λλ¬νλ€κ³ νλ¨λ λκΉμ§ μ΄ κ³Όμ μ λ°λ³΅ν©λλ€. λ€μμ λ©ν°μ€ν
μμ΄μ νΈκ° κ°λ¨ν μν λ¬Έμ λ₯Ό ν΄κ²°νλ μμμ
λλ€.
+
+
+

+
+
+
+## β
μμ΄μ νΈ μ¬μ© μμ / β μ¬μ©μ νΌν΄μΌ ν λ[[-when-to-use-agents---when-to-avoid-them]]
+
+μμ΄μ νΈλ μ±μ μν¬νλ‘μ°λ₯Ό LLMμ΄ κ²°μ νλλ‘ ν΄μΌ ν λ μ μ©ν©λλ€. νμ§λ§ μ’
μ’
κ³Όλν κΈ°λ₯μΌ μ μμ΅λλ€. ν΅μ¬ μ§λ¬Έμ 'λΉλ©΄ν μμ
μ ν¨μ¨μ μΌλ‘ ν΄κ²°νκΈ° μν΄ μν¬νλ‘μ°μ μ λ§ μ μ°μ±μ΄ νμνκ°?'μ
λλ€.
+λ§μ½ 미리 μ ν΄μ§ μν¬νλ‘μ°κ° μν©μ λ§μ§ μλ κ²½μ°κ° μ¦λ€λ©΄, μ΄λ λ λ§μ μ μ°μ±μ΄ νμνλ€λ μλ―Έμ
λλ€.
+μλ₯Ό λ€μ΄, μν μ¬ν μΉμ¬μ΄νΈμμ κ³ κ° μμ²μ μ²λ¦¬νλ μ±μ λ§λ λ€κ³ κ°μ ν΄ λ΄
μλ€.
+
+μμ²μ΄ (μ¬μ©μ μ νμ λ°λΌ) λ κ°μ§ μ ν μ€ νλμ μν κ²μ 미리 μ μ μκ³ , μ΄ λ κ²½μ° κ°κ°μ λν΄ λ―Έλ¦¬ μ μλ μν¬νλ‘μ°λ₯Ό κ°μ§κ³ μμ μ μμ΅λλ€.
+
+1. μ¬νμ λν μ λ³΄κ° νμνκ°μ? β μ§μ λ² μ΄μ€λ₯Ό κ²μν μ μλ κ²μμ°½ μ κ·Ό κΆνμ μ 곡ν©λλ€.
+2. μμ
νκ³Ό μλ΄μ μνλμ? β λ¬Έμ μμμ μμ±νλλ‘ ν©λλ€.
+
+λ§μ½ μ΄ κ²°μ λ‘ μ μΈ μν¬νλ‘μ°κ° λͺ¨λ 쿼리μ μ ν©νλ€λ©΄, μ£Όμ μμ΄ λͺ¨λ κ²μ μ§μ μ½λ©νμΈμ! μ΄λ κ² νλ©΄ μμΈ‘ λΆκ°λ₯ν LLMμ΄ μν¬νλ‘μ°μ κ°μ
νμ¬ λ°μν μ μλ μ€λ₯ μν μμ΄ 100% μ λ’°ν μ μλ μμ€ν
μ λ§λ€ μ μμ΅λλ€. λ¨μνκ³ μμ μ μΈ μμ€ν
μ λ§λ€κΈ°μν΄ μμ΄μ νΈ κΈ°λ° λμμ μ¬μ©νμ§ μλ μͺ½μΌλ‘ μ€κ³νλ κ²μ΄ μ’μ΅λλ€.
+
+νμ§λ§ μν¬νλ‘μ°λ₯Ό μ¬μ μ κ·Έλ κ² μ κ²°μ ν μ μλ€λ©΄ μ΄λ¨κΉμ?
+
+μλ₯Ό λ€μ΄, μ¬μ©μκ° λ€μκ³Ό κ°μ΄ μ§λ¬Ένλ€κ³ κ°μ ν΄ λ΄
μλ€. `"μμμΌμ μΆλ°ν μ μμ§λ§, μ¬κΆμ λκ³ μμ μμμΌλ‘ λ―Έλ€μ§ μλ μμ΄μ. νμμΌ μμΉ¨μ μ§μ΄λ κ°μ΄ μννλ¬ κ° μ μμκΉμ? μ·¨μ 보νλ ν¬ν¨ν΄μμ."` μ΄ μ§λ¬Έμ μ¬λ¬ μμΈμ λ°λΌ λ¬λΌμ§λ©°, μλ§λ μμμ 미리 μ ν΄μ§ κΈ°μ€ μ€ μ΄λ κ²λ μ΄ μμ²μ μ²λ¦¬νκΈ°μ μΆ©λΆνμ§ μμ κ²μ
λλ€.
+
+λ§μ½ 미리 μ ν΄μ§ μν¬νλ‘μ°κ° μν©μ λ§μ§ μλ κ²½μ°κ° μ¦λ€λ©΄, μ΄λ λ λ§μ μ μ°μ±μ΄ νμνλ€λ μλ―Έμ
λλ€.
+
+λ°λ‘ μ΄ μ§μ μμ μμ΄μ ν± μ€μ μ΄ λμμ΄ λ©λλ€.
+
+μ μμμμλ, λ μ¨ μ보λ₯Ό μν λ μ¨ API, μ΄λ 거리λ₯Ό κ³μ°νκΈ° μν Google Maps API, μ§μ 근무 νν© λμ보λ, κ·Έλ¦¬κ³ μ§μ λ² μ΄μ€μ λν RAG μμ€ν
μ μ κ·Όν μ μλ λ©ν°μ€ν
μμ΄μ νΈλ₯Ό λ§λ€ μ μμ΅λλ€.
+
+μ΅κ·ΌκΉμ§μ μ»΄ν¨ν° νλ‘κ·Έλ¨μ 미리 μ ν΄μ§ μν¬νλ‘μ° μμμλ§ λμνλ©°, if/else λ¬Έμ μμ 볡μ‘μ±μ μ²λ¦¬νλ €κ³ νμ΅λλ€. μ΄λ€μ "μ΄ μ«μλ€μ ν©μ κ³μ°νλΌ" λλ "μ΄ κ·Έλνμμ μ΅λ¨ κ²½λ‘λ₯Ό μ°ΎμλΌ"μ κ°μ΄ κ·Ήν νμ λ μμ
μ μ΄μ μ λ§μ·μ΅λλ€. νμ§λ§ μ€μ λ‘λ μ μ¬ν μμμ²λΌ λλΆλΆμ μ€μν μμ
μ 미리 μ ν΄μ§ μν¬νλ‘μ°μ λ€μ΄λ§μ§ μμ΅λλ€. μμ΄μ ν± μμ€ν
μ μ΄λ¬ν νκ³λ₯Ό λμ΄, νλ‘κ·Έλ¨μ΄ νμ€ μΈκ³μ λ€μν λ¬Έμ λ₯Ό μ€μ€λ‘ νμνκ³ ν΄κ²°ν μ μλλ‘ ν©λλ€.
+
+## μ `smolagents`μΈκ°μ?[[why-smolagents-]]
+
+체μΈμ΄λ λΌμ°ν°μ²λΌ λΉκ΅μ λ¨μν μμ΄μ ν± νμ© μ¬λ‘λΌλ©΄, λͺ¨λ μ½λλ₯Ό μ§μ μμ±νλ νΈμ΄ μ’μ΅λλ€. κ·Έλ κ² νλ κ²μ΄ μμ€ν
μ λ μ μ μ΄νκ³ μ΄ν΄ν μ μκ² ν΄μ£Όλ―λ‘ ν¨μ¬ λ λμ λ°©λ²μ
λλ€.
+
+νμ§λ§ LLMμ΄ ν¨μλ₯Ό νΈμΆνκ² νκ±°λ(λꡬ νΈμΆ) LLMμ΄ while 루νλ₯Ό μ€ννκ² νλ(λ©ν°μ€ν
μμ΄μ νΈ) λ± λ 볡μ‘ν λμμΌλ‘ λμ΄κ°κΈ° μμνλ©΄, λͺ κ°μ§ μΆμνκ° νμν΄μ§λλ€.
+- λꡬ νΈμΆμ κ²½μ°, μμ΄μ νΈμ μΆλ ₯μ νμ±ν΄μΌ ν©λλ€. λ°λΌμ μ΄ μΆλ ₯μ "μ¬κ³ : 'get_weather' λꡬλ₯Ό νΈμΆν΄μΌκ² λ€. νλ: get_weather(Paris)."μ κ°μ΄ 미리 μ μλ νμμ΄ νμνλ©°, μ΄ νμμ 미리 μ μλ ν¨μλ‘ νμ±ν΄μΌ ν©λλ€. κ·Έλ¦¬κ³ LLMμ μ 곡λλ μμ€ν
ν둬ννΈλ μ΄ νμμ λν΄ μλ €μ£Όμ΄μΌ ν©λλ€.
+- LLM μΆλ ₯μ΄ λ£¨νλ₯Ό κ²°μ νλ λ©ν°μ€ν
μμ΄μ νΈμ κ²½μ°, λ§μ§λ§ 루ν λ°λ³΅μμ μΌμ΄λ μΌμ λ°λΌ LLMμ λ€λ₯Έ ν둬ννΈλ₯Ό μ 곡ν΄μΌ ν©λλ€. λ°λΌμ μΌμ’
μ λ©λͺ¨λ¦¬κ° νμν©λλ€.
+
+보μλ€μνΌ, μ΄ λ κ°μ§ μμλ§μΌλ‘λ μμ΄μ νΈ μμ€ν
ꡬμ±μ λμμ€ λͺ κ°μ§ ν΅μ¬ μμμ νμμ±μ μ΄λ―Έ λ°κ²¬νμ΅λλ€.
+
+- λ¬Όλ‘ , μμ€ν
μ μμ§ μν μ νλ LLM
+- μμ΄μ νΈκ° μ κ·Όν μ μλ λꡬ λͺ©λ‘
+- μμ΄μ νΈ λ‘μ§μ λν΄ LLMμ μλ΄νλ μμ€ν
ν둬ννΈ: ReAct 루ν(μ±μ°° -> νλ -> κ΄μ°°), μ¬μ© κ°λ₯ν λꡬ, μ¬μ©ν λꡬ νΈμΆ νμ λ±...
+- μ μμ€ν
ν둬ννΈμ λͺ
μλ νμμΌλ‘ LLM μΆλ ₯μμ λꡬ νΈμΆμ μΆμΆνλ νμ
+- λ©λͺ¨λ¦¬
+
+νμ§λ§ μ κΉ, LLMμκ² κ²°μ μ μ¬μ§λ₯Ό μ£ΌκΈ° λλ¬Έμ λΆλͺ
μ€μλ₯Ό ν κ²μ
λλ€. λ°λΌμ μ€λ₯ λ‘κΉ
κ³Ό μ¬μλ λ©μ»€λμ¦μ΄ νμν©λλ€.
+
+μ μλνλ μμ€ν
μ λ§λ€κΈ° μν΄μλ μ΄ λͺ¨λ μμλ€μ΄ κΈ΄λ°νκ² κ²°ν©λμ΄μΌ ν©λλ€. μ΄κ²μ΄ λ°λ‘ μ΄ λͺ¨λ κ²λ€μ΄ ν¨κ» μλνλλ‘ λ§λλ κΈ°λ³Έ κ΅¬μ± μμλ₯Ό λ§λ€μ΄μΌ νλ€κ³ κ²°μ ν μ΄μ μ
λλ€.
+
+## μ½λ μμ΄μ νΈ[[code-agents]]
+
+λ©ν°μ€ν
μμ΄μ νΈμμ κ° λ¨κ³λ§λ€ LLMμ μΈλΆ λꡬλ₯Ό νΈμΆνλ ννμ νλμ μ μν μ μμ΅λλ€. μ΄λ¬ν νλμ μ μνλ μΌλ°μ μΈ νμ(Anthropic, OpenAI λ° λ€λ₯Έ λ§μ κ³³μμ μ¬μ©)μ λμ²΄λ‘ "μ¬μ©ν λꡬ μ΄λ¦κ³Ό μΈμλ₯Ό JSONμΌλ‘ μμ±νκ³ , μ΄λ₯Ό νμ±νμ¬ μ΄λ€ λꡬλ₯Ό μ΄λ€ μΈμλ‘ μ€νν μ§ νμ
νλ" ꡬ쑰μ
λλ€. μ΄ λ°©μμ ꡬνμ λ°λΌ μ¬λ¬ κ°μ§ ννλ‘ λ³νλ μ μμ΅λλ€.
+
+[μ¬λ¬](https://huggingface.co/papers/2402.01030) [μ°κ΅¬](https://huggingface.co/papers/2411.01747) [λ
Όλ¬Έ](https://huggingface.co/papers/2401.00812)μμλ LLMμ νλμ μ½λ μ€λν«μΌλ‘ μμ±νλ κ²μ΄ λ μμ°μ€λ½κ³ μ μ°ν λ°©λ²μμ 보μ¬μ£Όμμ΅λλ€.
+
+κ·Έ μ΄μ λ κ°λ¨ν©λλ€. μ¬λμ *μ»΄ν¨ν°κ° μννλ νλμ νννκΈ° μν΄ νΉλ³ν μ½λ μΈμ΄λ₯Ό λ§λ€μκΈ° λλ¬Έ*μ
λλ€.
+λ€μ λ§ν΄, μμ΄μ νΈλ μ¬μ©μμ λ¬Έμ λ₯Ό ν΄κ²°νκΈ° μν΄ νλ‘κ·Έλ¨μ μμ±ν κ²μ
λλ€. μ¬λ¬λΆμ νμ΄μ¬ λΈλ‘κ³Ό JSON λΈλ‘ μ€ μ΄λ κ²μΌλ‘ νλ‘κ·Έλλ°νλ κ²μ΄ λ μ¬μΈ κ²μ΄λΌκ³ μκ°νμλμ?
+
+[μ€ν κ°λ₯ν μ½λ νλμ΄ λ λμ LLM μμ΄μ νΈλ₯Ό μ΄λμ΄λΈλ€(Executable Code Actions Elicit Better LLM Agents)](https://huggingface.co/papers/2402.01030)μμ κ°μ Έμ¨ μλ κ·Έλ¦Όμ νλμ μ½λλ‘ μμ±ν λμ λͺ κ°μ§ μ₯μ μ 보μ¬μ€λλ€.
+
+
+
+JSONκ³Ό μ μ¬ν μ€λν« λμ μ½λλ‘ νλμ μμ±νλ©΄ λ€μκ³Ό κ°μ μ μμ λ μ’μ΅λλ€.
+
+- **κ΅¬μ± κ°λ₯μ±:** νμ΄μ¬ ν¨μλ₯Ό μ μνλ κ²μ²λΌ JSON νλμ μλ‘ μ€μ²©νκ±°λ, λμ€μ μ¬μ¬μ©ν JSON νλ μ§ν©μ μ μν μ μμκΉμ?
+- **κ°μ²΄ κ΄λ¦¬:** `generate_image`μ κ°μ νλμ μΆλ ₯μ JSONμ μ΄λ»κ² μ μ₯ν μ μμκΉμ?
+- **μΌλ°μ±:** μ½λλ μ»΄ν¨ν°κ° ν μ μλ λͺ¨λ κ²μ κ°λ¨νκ² νννλλ‘ λ§λ€μ΄μ‘μ΅λλ€.
+- **LLM νλ ¨ λ°μ΄ν°μμμ νν:** μμ§μ μ½λ νλμ΄ μ΄λ―Έ LLMμ νλ ¨ λ°μ΄ν°μ λ§μ΄ ν¬ν¨λμ΄ μμ΄, LLMμ΄ μ΄λ―Έ μ΄λ₯Ό μν΄ νλ ¨λμλ€λ κ²μ μλ―Έν©λλ€
\ No newline at end of file