chore: import upstream snapshot with attribution

2026-07-13 12:48:47 +08:00
commit 85f20078e8
208 changed files with 57629 additions and 0 deletions
@@ -0,0 +1,39 @@
+---
+layout: default
+title: "SmolaAgents"
+nav_order: 20
+has_children: true
+---
+
+# Tutorial: SmolaAgents
+
+> This tutorial is AI-generated! To learn more, check out [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)
+
+`SmolaAgents`<sup>[View Repo](https://github.com/huggingface/smolagents/tree/076cca5e8a130d3fa2ff990ad630231b49767745/src/smolagents)</sup> is a project for building *autonomous agents* that can solve complex tasks.
+The core component is the **MultiStepAgent**, which acts like a project manager. It uses a **Model Interface** to talk to language models (LLMs), employs **Tools** (like web search or code execution) to interact with the world or perform actions, and keeps track of its progress and conversation history using **AgentMemory**.
+For agents that write and run Python code (`CodeAgent`), a **PythonExecutor** provides a safe environment. **PromptTemplates** help structure the instructions given to the LLM, while **AgentType** handles different data formats like images or audio. Finally, **AgentLogger & Monitor** provides logging and tracking for debugging and analysis.
+
+```mermaid
+flowchart TD
+    A0["MultiStepAgent"]
+    A1["Tool"]
+    A2["Model Interface"]
+    A3["AgentMemory"]
+    A4["PythonExecutor"]
+    A5["PromptTemplates"]
+    A6["AgentType"]
+    A7["AgentLogger & Monitor"]
+    A0 -- "Uses tools" --> A1
+    A0 -- "Uses model" --> A2
+    A0 -- "Uses memory" --> A3
+    A0 -- "Uses templates" --> A5
+    A0 -- "Uses logger/monitor" --> A7
+    A0 -- "Uses executor (CodeAgent)" --> A4
+    A1 -- "Outputs agent types" --> A6
+    A4 -- "Executes tool code" --> A1
+    A2 -- "Generates/Parses tool calls" --> A1
+    A3 -- "Logs tool calls" --> A1
+    A5 -- "Includes tool info" --> A1
+    A6 -- "Handled by agent" --> A0
+    A7 -- "Replays memory" --> A3
+```