{"id":2454,"date":"2026-09-06T12:32:22","date_gmt":"2026-09-06T04:32:22","guid":{"rendered":"https:\/\/blog.zjml.life\/?p=2454"},"modified":"2026-09-06T12:36:38","modified_gmt":"2026-09-06T04:36:38","slug":"%e4%bb%8e%e9%9b%b6%e5%bc%80%e5%a7%8b%e5%ad%a6%e4%b9%a0-agent-%e5%bc%80%e5%8f%91-smolagents-%e6%a1%86%e6%9e%b6%e6%b7%b1%e5%ba%a6%e5%88%86%e6%9e%90%ef%bc%88%e4%b8%80%ef%bc%89%ef%bc%9a","status":"publish","type":"post","link":"https:\/\/blog.zjml.life\/?p=2454","title":{"rendered":"\u4ece\u96f6\u5f00\u59cb\u5b66\u4e60 Agent \u5f00\u53d1 \u2014\u2014 smolagents \u6846\u67b6\u6df1\u5ea6\u5206\u6790\uff08\u4e00\uff09\uff1acli.py"},"content":{"rendered":"\n

smolagents\u6846\u67b6\u662f\u4e00\u4e2a\u6781\u7b80\u7684 ReAct agent \u6846\u67b6\uff0c\u6bd4\u8f83\u9002\u5408\u6211\u4eec\u8fd9\u79cd\u96f6\u57fa\u7840\u7684\u540c\u5b66\u5165\u95e8 agent \u5f00\u53d1\uff0c\u5b66\u4e60\u5e76\u7406\u89e3 anegt \u7684\u8bbe\u8ba1\u903b\u8f91\u3002<\/p>\n\n\n\n

\u5165\u53e3\u51fd\u6570\u2014\u2014main()<\/h2><\/div>\n\n\n\n

\u89c2\u5bdf\u5165\u53e3\u51fd\u6570\u53ef\u4ee5\u8ba9\u6211\u4eec\u5feb\u901f\u4e86\u89e3\u5176\u6d41\u7a0b\uff1a<\/p>\n\n\n\n

def main() -> None:\n    args = parse_arguments()\n\n    # Check if we should run in interactive mode\n    # Interactive mode is triggered when no prompt is provided\n    if args.prompt is None:\n        prompt, tools, model_type, model_id, provider, api_base, api_key, imports, action_type = interactive_mode()\n    else:\n        prompt = args.prompt\n        tools = args.tools\n        model_type = args.model_type\n        model_id = args.model_id\n        provider = args.provider\n        api_base = args.api_base\n        api_key = args.api_key\n        imports = args.imports\n        action_type = args.action_type\n\n    run_smolagent(\n        prompt,\n        tools,\n        model_type,\n        model_id,\n        provider=provider,\n        api_base=api_base,\n        api_key=api_key,\n        imports=imports,\n        action_type=action_type,\n    )<\/code><\/pre>\n\n\n\n
\u53ef\u4ee5\u770b\u5230\uff0cmain()\u65b9\u6cd5\u5c31\u53ea\u662f\u62ff\u5230\u542f\u52a8\u53c2\u6570\uff0c\u7136\u540e\u8c03\u7528run_smolagent()\u65b9\u6cd5\u3002<\/p>\n\n\n\n
\u6838\u5fc3\u65b9\u6cd5\u2014\u2014run_smolagent()<\/h2><\/div>\n\n\n\n
\u8fd9 40 \u884c\u662f\u6574\u4e2a\u6587\u4ef6\u7684\u4ef7\u503c\u6240\u5728\u3002<\/p>\n\n\n\n
1. \u52a0\u8f7d\u73af\u5883\u53d8\u91cf<\/h3><\/div>\n\n\n\n
load_dotenv()<\/code><\/pre>\n\n\n\n
\u5148\u8c03\u7528load_dotenv()<\/code>\u65b9\u6cd5\uff0c\u4ece.env<\/code>\u6587\u4ef6\u4e2d\u52a0\u8f7d\u73af\u5883\u53d8\u91cf\uff0c\u628a\u9879\u76ee\u6839\u76ee\u5f55 .env<\/code> \u6587\u4ef6\u7684\u5185\u5bb9\u8bfb\u8fdb os.environ<\/code>\uff1a<\/p>\n\n\n\n
def load_dotenv(\n    dotenv_path: Optional[StrPath] = None,\n    stream: Optional[IO[str]] = None,\n    verbose: bool = False,\n    override: bool = False,\n    interpolate: bool = True,\n    encoding: Optional[str] = \"utf-8\",\n) -> bool:\n    \"\"\"Parse a .env file and then load all the variables found as environment variables.\n\n    Parameters:\n        dotenv_path: Absolute or relative path to .env file.\n        stream: Text stream (such as `io.StringIO`) with .env content, used if\n            `dotenv_path` is `None`.\n        verbose: Whether to output a warning the .env file is missing.\n        override: Whether to override the system environment variables with the variables\n            from the `.env` file.\n        interpolate: Whether to interpolate variables using POSIX variable expansion.\n        encoding: Encoding to be used to read the file.\n    Returns:\n        Bool: True if at least one environment variable is set else False\n\n    If both `dotenv_path` and `stream` are `None`, `find_dotenv()` is used to find the\n    .env file with its default parameters. If you need to change the default parameters\n    of `find_dotenv()`, you can explicitly call `find_dotenv()` and pass the result\n    to this function as `dotenv_path`.\n\n    If the environment variable `PYTHON_DOTENV_DISABLED` is set to a truthy value,\n    .env loading is disabled.\n    \"\"\"\n    if _load_dotenv_disabled():\n        logger.debug(\n            \"python-dotenv: .env loading disabled by PYTHON_DOTENV_DISABLED environment variable\"\n        )\n        return False\n\n    if dotenv_path is None and stream is None:\n        dotenv_path = find_dotenv()\n\n    dotenv = DotEnv(\n        dotenv_path=dotenv_path,\n        stream=stream,\n        verbose=verbose,\n        interpolate=interpolate,\n        override=override,\n        encoding=encoding,\n    )\n    return dotenv.set_as_environment_variables()<\/code><\/pre>\n\n\n\n
\u4e4b\u540e\u4f7f\u7528.env<\/code>\u6587\u4ef6\u4e2d\u7684\u914d\u7f6e\u9879\uff0c\u7528os.getenv()<\/code>\u65b9\u6cd5\u5373\u53ef\uff0c\u4f8b\u5982\uff1a<\/p>\n\n\n\n
import os\nfrom dotenv import load_dotenv\n\nload_dotenv()                        # \u2460 \u53ea\u9700\u8c03\u7528\u4e00\u6b21\uff0c\u653e\u5728\u6700\u5f00\u5934\nkey = os.getenv(\"HF_API_KEY\")        # \u2461 \u4e4b\u540e\u968f\u5904\u53d6\u7528<\/code><\/pre>\n\n\n\n
\u63a5\u4e0b\u6765\u7684load_model()<\/code>\u65b9\u6cd5\u4e2d\u4f1a\u7528\u5230.env<\/code>\u6587\u4ef6\u4e2d\u7684\u914d\u7f6e\u9879\u3002<\/p>\n\n\n\n
2. \u6784\u9020\u6a21\u578b<\/h3><\/div>\n\n\n\n
\u8fd9\u91cc\u7684\u5b9e\u73b0\u7b80\u5355\u7c97\u66b4\uff0c\u517c\u5bb9\u4e864\u4e2d\u6a21\u578b\u914d\u7f6e\u65b9\u5f0f\uff1a<\/p>\n\n\n\n
model = load_model(model_type, model_id, api_base=api_base, api_key=api_key, provider=provider)<\/code><\/pre>\n\n\n\n
def load_model(\n    model_type: str,\n    model_id: str,\n    api_base: str | None = None,\n    api_key: str | None = None,\n    provider: str | None = None,\n) -> Model:\n    if model_type == \"OpenAIModel\":\n        return OpenAIModel(\n            api_key=api_key or os.getenv(\"FIREWORKS_API_KEY\"),\n            api_base=api_base or \"https:\/\/api.fireworks.ai\/inference\/v1\",\n            model_id=model_id,\n        )\n    elif model_type == \"LiteLLMModel\":\n        return LiteLLMModel(\n            model_id=model_id,\n            api_key=api_key,\n            api_base=api_base,\n        )\n    elif model_type == \"TransformersModel\":\n        return TransformersModel(model_id=model_id, device_map=\"auto\")\n    elif model_type == \"InferenceClientModel\":\n        return InferenceClientModel(\n            model_id=model_id,\n            token=api_key or os.getenv(\"HF_API_KEY\"),\n            provider=provider,\n        )\n    else:\n        raise ValueError(f\"Unsupported model type: {model_type}\")<\/code><\/pre>\n\n\n\n
\u901a\u8fc7if-elif\u63d0\u4f9b\u4e86\u56db\u79cd\u9009\u62e9\uff1a<\/p>\n\n\n\n
model_type<\/th>\u8bf4\u660e<\/th><\/tr><\/thead>
InferenceClientModel<\/code><\/td>HF Inference API\uff0cCLI \u9ed8\u8ba4\uff0c\u8bfb HF_API_KEY<\/td><\/tr>
OpenAIModel<\/code><\/td>OpenAI \u517c\u5bb9\u63a5\u53e3\u3002\u6ce8\u610f\u9ed8\u8ba4 api_base \u6307\u5411 Fireworks\uff0c\u4e0d\u662f OpenAI \u5b98\u65b9<\/strong><\/td><\/tr>
LiteLLMModel<\/code><\/td>LiteLLM \u4ee3\u7406\uff0c\u4e00\u4e2a\u63a5\u53e3\u6253\u901a\u4e0a\u767e\u5bb6\u5382\u5546<\/td><\/tr>
TransformersModel<\/code><\/td>\u672c\u5730\u63a8\u7406\uff0c\u9700\u8981 torch + \u663e\u5361<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
3. \u6784\u9020\u5de5\u5177<\/h3><\/div>\n\n\n\n
\u8fd9\u4e00\u6b65\u5f00\u59cb\u51c6\u5907\u5de5\u5177\u96c6\uff0c\u7ed9\u6a21\u578b\u4f7f\u7528\uff0c\u5de5\u5177\u6709\u672c\u5730\u5de5\u5177\u548c\u8fdc\u7a0b\u5de5\u5177\uff0c\u901a\u8fc7\u4e0d\u540c\u7684\u65b9\u5f0f\u83b7\u53d6\uff1a<\/p>\n\n\n\n
    available_tools = []\n\n    for tool_name in tools:\n        if \"\/\" in tool_name:\n            space_name = tool_name.split(\"\/\")[-1].lower().replace(\"-\", \"_\").replace(\".\", \"_\")\n            description = f\"Tool loaded from Hugging Face Space: {tool_name}\"\n            available_tools.append(Tool.from_space(space_id=tool_name, name=space_name, description=description))\n        else:\n            if tool_name in TOOL_MAPPING:\n                available_tools.append(TOOL_MAPPING[tool_name]())\n            else:\n                raise ValueError(f\"Tool {tool_name} is not recognized either as a default tool or a Space.\")<\/code><\/pre>\n\n\n\n
\u5982\u679c\u662f\u8fdc\u7a0b\u5de5\u5177\u7684\u8bdd\uff0c\u7528Tool.from_space()<\/code>\u65b9\u6cd5\u83b7\u53d6\uff0c\u5982\u679c\u662f\u672c\u5730\u5de5\u5177\u7684\u8bdd\uff0c\u5c31\u76f4\u63a5\u4ece TOOL_MAPPING<\/code> \u91cc\u62ff\u5230\u5de5\u5177\u7684\u7c7b\uff0c\u7136\u540e\u81ea\u5df1\u5b9e\u4f8b\u5316\u3002<\/p>\n\n\n\n
\u6211\u4eec\u53ef\u4ee5\u770b\u770b TOOL_MAPPING<\/code> \u7684\u5b9a\u4e49\uff1a<\/p>\n\n\n\n
TOOL_MAPPING = {\n    tool_class.name: tool_class\n    for tool_class in [\n        PythonInterpreterTool,\n        DuckDuckGoSearchTool,\n        VisitWebpageTool,\n    ]\n}<\/code><\/pre>\n\n\n\n
\u53ef\u4ee5\u770b\u5230\uff0c\u9ed8\u8ba4\u662f\u4e09\u4e2a\u5de5\u5177\uff0c\u90a3\u4e48 TOOL_MAPPING<\/code> \u7684\u7ed3\u6784\u5e94\u8be5\u662f\u8fd9\u6837\uff1a<\/p>\n\n\n\n
{\n    'python_interpreter': <class 'smolagents.default_tools.PythonInterpreterTool'>,\n    'web_search':         <class 'smolagents.default_tools.DuckDuckGoSearchTool'>,\n    'visit_webpage':      <class 'smolagents.default_tools.VisitWebpageTool'>,\n}<\/code><\/pre>\n\n\n\n
\u6240\u4ee5\u5b9e\u9645\u4e0a\u5c31\u662f\uff0c\u6211\u4eec\u914d\u7f6e\u4f7f\u7528\u54ea\u4e9b\u5de5\u5177\uff0c\u5b83\u5c31\u7ed9\u5de5\u5177\u96c6\u6dfb\u52a0\u54ea\u4e9b\u5de5\u5177\uff0c\u800c\u4e0d\u662f\u4e00\u80a1\u8111\u628a\u672c\u5730\u5de5\u5177\u5168\u6dfb\u52a0\u8fdb\u53bb\u3002<\/p>\n\n\n\n
4. \u6784\u9020Agent<\/h3><\/div>\n\n\n\n
\u8fd9\u662f\u6700\u540e\u4e00\u90e8\uff0c\u6784\u9020 Agent \uff0c\u8fd9\u91cc\u63d0\u4f9b\u4e86\u4e24\u79cd Agent \u7c7b\u578b\uff0c CodeAgent \u548c ToolCallingAgent \uff0c\u5b98\u65b9\u63a8\u8350\u4f7f\u7528 CodeAgent \uff0c CodeAgent \u80fd\u5728\u6c99\u76d2\u91cc\u5199\u4ee3\u7801\uff0c ToolCallingAgent \u53ea\u80fd\u8c03\u7528\u5de5\u5177\u5e76\u4e14\u8ba9\u5de5\u5177\u8f93\u51fa\u3002<\/p>\n\n\n\n
    if action_type == \"code\":\n        agent = CodeAgent(\n            tools=available_tools,\n            model=model,\n            additional_authorized_imports=imports,\n            stream_outputs=True,\n        )\n    elif action_type == \"tool_calling\":\n        agent = ToolCallingAgent(tools=available_tools, model=model, stream_outputs=True)\n    else:\n        raise ValueError(f\"Unsupported action type: {action_type}\")<\/code><\/pre>\n\n\n\n
\u6211\u4eec\u4f1a\u53e6\u5f00\u4e00\u7bc7\u535a\u5ba2\uff0c\u6df1\u5ea6\u7814\u7a76 CodeAgent \u548c ToolCallingAgent \u3002<\/p>\n\n\n\n
5. \u542f\u52a8Agent<\/h3><\/div>\n\n\n\n
\u6700\u540e\uff0c\u8c03\u7528 agent.run()<\/code> \u65b9\u6cd5\uff0c\u8ba9 Agent \u8dd1\u8d77\u6765\uff0c\u6d41\u7a0b\u5c31\u5168\u90e8\u7ed3\u675f\u4e86\u3002<\/p>\n\n\n\n
    agent.run(prompt)<\/code><\/pre>\n\n\n\n
\u7ed3\u8bed<\/h2>\n\n\n\n
\u6211\u4eec\u770b\u5b8c\u4e86 cli.py \uff0c\u5b83\u662f\u4e00\u4e2a\u771f\u6b63\u53ef\u7528\u7684\u4ea7\u54c1\u529f\u80fd\uff0c\u80fd\u591f\u6839\u636e\u7528\u6237\u7684\u8f93\u5165\u7ec4\u88c5\u5de5\u5177\u3001\u542f\u52a8 Agent \uff0c\u4e0b\u4e00\u6b65\u6211\u4eec\u4f1a\u4e00\u8d77\u6df1\u5ea6\u7814\u7a76\uff0csmolagents \u6846\u67b6\u662f\u5982\u4f55\u5b9e\u73b0\u4e00\u4e2a Agent \u7684\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"
smolagents\u6846\u67b6\u662f\u4e00\u4e2a\u6781\u7b80\u7684 ReAct agent \u6846\u67b6\uff0c\u6bd4\u8f83\u9002\u5408\u6211\u4eec\u8fd9\u79cd\u96f6\u57fa\u7840\u7684\u540c\u5b66\u5165\u95e8 agen […]<\/p>\n","protected":false},"author":1,"featured_media":2454,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","footnotes":""},"categories":[35],"tags":[36,37],"class_list":["post-2454","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-agent-","tag-agent","tag-smolagents"],"uagb_featured_image_src":{"full":["https:\/\/pic.zjml.life\/api\/image\/178866913177373a7f5?quality=mid",800,600,false],"thumbnail":["https:\/\/pic.zjml.life\/api\/image\/178866913177373a7f5?quality=mid",150,150,true],"medium":["https:\/\/pic.zjml.life\/api\/image\/178866913177373a7f5?quality=mid",300,300,false],"medium_large":["https:\/\/pic.zjml.life\/api\/image\/178866913177373a7f5?quality=mid",768,0,false],"large":["https:\/\/pic.zjml.life\/api\/image\/178866913177373a7f5?quality=mid",1024,1024,false],"1536x1536":["https:\/\/pic.zjml.life\/api\/image\/178866913177373a7f5?quality=mid",1536,1536,false],"2048x2048":["https:\/\/pic.zjml.life\/api\/image\/178866913177373a7f5?quality=mid",2048,2048,false]},"uagb_author_info":{"display_name":"zjml","author_link":"https:\/\/blog.zjml.life\/?author=1"},"uagb_comment_info":0,"uagb_excerpt":"smolagents\u6846\u67b6\u662f\u4e00\u4e2a\u6781\u7b80\u7684 ReAct agent \u6846\u67b6\uff0c\u6bd4\u8f83\u9002\u5408\u6211\u4eec\u8fd9\u79cd\u96f6\u57fa\u7840\u7684\u540c\u5b66\u5165\u95e8 agen…","_links":{"self":[{"href":"https:\/\/blog.zjml.life\/index.php?rest_route=\/wp\/v2\/posts\/2454","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.zjml.life\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.zjml.life\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.zjml.life\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.zjml.life\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2454"}],"version-history":[{"count":3,"href":"https:\/\/blog.zjml.life\/index.php?rest_route=\/wp\/v2\/posts\/2454\/revisions"}],"predecessor-version":[{"id":2457,"href":"https:\/\/blog.zjml.life\/index.php?rest_route=\/wp\/v2\/posts\/2454\/revisions\/2457"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.zjml.life\/index.php?rest_route=\/wp\/v2\/posts\/2454"}],"wp:attachment":[{"href":"https:\/\/blog.zjml.life\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2454"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.zjml.life\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2454"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.zjml.life\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2454"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}