Smolagents入门教程：10分钟跑起你的第一个AI Agent（2026版）

📘 AI教程 💬 🔥 Trending

🩺 摘要

HuggingFace出的Smolagents是我见过最容易上手的Agent框架。不需要懂LangChain那一套抽象，写代码就像写普通Python函数。

📝 详情

Smolagents是什么？

Smolagents是HuggingFace推出的轻量级Agent框架。名字里的"Smol"就是"Small"——整个框架的核心代码不到2000行。

为什么选Smolagents？

不需要复杂的Prompt工程。 在Smolagents里，你写的工具就是Python函数，Agent通过Code Agent模式自动调用这些函数。

10分钟上手

Step 1: 安装

pip install smolagents

Step 2: 写一个工具

from smolagents import tool

@tool
def search_web(query: str) -> str:
    """Search the web for information"""
    return f"Searching for {query}..."

Step 3: 创建Agent

from smolagents import CodeAgent, HfApiModel

agent = CodeAgent(
    tools=[search_web],
    model=HfApiModel()
)
agent.run("Search for latest AI news")

三个关键概念

  1. Tool（工具） — 一个带类型注解和文档字符串的Python函数，Agent会自动理解怎么用它
  2. Agent（代理） — 核心执行者，接收任务、规划步骤、调用工具
  3. Model（模型） — 驱动Agent推理的大语言模型

适合谁用？

  • 想快速尝试Agent开发的Python开发者
  • 做原型验证的项目
  • 教学和演示场景

总结

Smolagents的价值在于极低的上手门槛。从安装到跑起第一个Agent，10分钟够了。等需求复杂了再迁移到CrewAI或LangChain。