{"id":591,"date":"2025-01-11T15:25:02","date_gmt":"2025-01-11T15:25:02","guid":{"rendered":"https:\/\/smolagents.org\/?post_type=docs&#038;p=591"},"modified":"2025-01-11T15:41:26","modified_gmt":"2025-01-11T15:41:26","password":"","slug":"tools-of-smolagents-in-depth-guide","status":"publish","type":"docs","link":"https:\/\/smolagents.org\/zh\/docs\/tools-of-smolagents-in-depth-guide\/","title":{"rendered":"Smolagents \u7684\u5de5\u5177\u300b\u6df1\u5165\u6307\u5357"},"content":{"rendered":"<p>\u5728\u8fd9\u91cc\uff0c\u6211\u4eec\u5c06\u770b\u5230\u9ad8\u7ea7\u5de5\u5177\u7684\u4f7f\u7528\u3002<\/p>\n\n\n\n<p>\u5982\u679c\u60a8\u662f\u5efa\u7acb\u4ee3\u7406\u7684\u65b0\u624b\uff0c\u8bf7\u52a1\u5fc5\u9996\u5148\u9605\u8bfb\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/conceptual_guides\/intro_agents\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u4ee3\u7406\u5165\u95e8<\/a>\u00a0\u548c\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/guided_tour\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">smolagents \u5bfc\u6e38<\/a>.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#tools\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u5de5\u5177<\/a>\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#what-is-a-tool-and-how-to-build-one\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u4ec0\u4e48\u662f\u5de5\u5177\uff0c\u5982\u4f55\u5236\u4f5c\uff1f<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#share-your-tool-to-the-hub\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u5c06\u60a8\u7684\u5de5\u5177\u5171\u4eab\u5230\u4e2d\u67a2<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#import-a-space-as-a-tool\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u5bfc\u5165\u7a7a\u95f4\u4f5c\u4e3a\u5de5\u5177<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#use-langchain-tools\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u4f7f\u7528\u8bed\u8a00\u94fe\u5de5\u5177<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#manage-your-agents-toolbox\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u7ba1\u7406\u7279\u5de5\u5de5\u5177\u7bb1<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#use-a-collection-of-tools\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u4f7f\u7528\u4e00\u7cfb\u5217\u5de5\u5177<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#what-is-a-tool-and-how-to-build-one\" target=\"_blank\" rel=\"noopener\"><\/a>\u4ec0\u4e48\u662f\u5de5\u5177\uff0c\u5982\u4f55\u5236\u4f5c\uff1f<\/h3>\n\n\n\n<p>\u5de5\u5177\u4e3b\u8981\u662f\u6307 LLM \u53ef\u4ee5\u5728\u4ee3\u7406\u7cfb\u7edf\u4e2d\u4f7f\u7528\u7684\u529f\u80fd\u3002<\/p>\n\n\n\n<p>\u4f46\u8981\u4f7f\u7528\u5b83\uff0c\u5c31\u9700\u8981\u4e3a LLM \u63d0\u4f9b\u4e00\u4e2a API\uff1a\u540d\u79f0\u3001\u5de5\u5177\u8bf4\u660e\u3001\u8f93\u5165\u7c7b\u578b\u548c\u8bf4\u660e\u3001\u8f93\u51fa\u7c7b\u578b\u3002<\/p>\n\n\n\n<p>\u56e0\u6b64\uff0c\u5b83\u4e0d\u80fd\u53ea\u662f\u4e00\u4e2a\u51fd\u6570\u3002\u5b83\u5e94\u8be5\u662f\u4e00\u4e2a\u7c7b\u3002<\/p>\n\n\n\n<p>\u56e0\u6b64\uff0c\u8be5\u5de5\u5177\u7684\u6838\u5fc3\u662f\u4e00\u4e2a\u7c7b\uff0c\u7528\u5143\u6570\u636e\u5305\u88c5\u4e00\u4e2a\u51fd\u6570\uff0c\u5e2e\u52a9 LLM \u7406\u89e3\u5982\u4f55\u4f7f\u7528\u5b83\u3002<\/p>\n\n\n\n<p>\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">\u4ece smolagents \u5bfc\u5165\u5de5\u5177\n\nclass HFModelDownloadsTool(Tool)\uff1a\n    name = \"model_download_counter\" \uff08\u6a21\u578b\u4e0b\u8f7d\u8ba1\u6570\u5668\n    description = \"\"\"\n    \u8fd9\u662f\u4e00\u4e2a\u5de5\u5177\uff0c\u7528\u4e8e\u8fd4\u56de Hugging Face Hub \u4e0a\u7ed9\u5b9a\u4efb\u52a1\u4e2d\u4e0b\u8f7d\u6b21\u6570\u6700\u591a\u7684\u6a21\u578b\u3002\n    \u5b83\u8fd4\u56de\u68c0\u67e5\u70b9\u7684\u540d\u79f0\u3002\"\"\"\n    \u8f93\u5165 = {\n        \"\u4efb\u52a1\"\uff1a{\n            \"\u7c7b\u578b\"\uff1a\"string\"\u3001\n            \"description\"\uff1a\"\u4efb\u52a1\u7c7b\u522b\uff08\u5982\u6587\u672c\u5206\u7c7b\u3001\u6df1\u5ea6\u4f30\u8ba1\u7b49\uff09\"\u3001\n        }\n    }\n    output_type = \"string\" (\u5b57\u7b26\u4e32)\n\n    def forward(self, task: str)\uff1a\n        from huggingface_hub import list_models\n\n        model = next(iter(list_models(filter=task, sort=\"downloads\", direction=-1)))\n        return model.id\n\nmodel_downloads_tool = HFModelDownloadsTool()<\/pre>\n\n\n\n<p>\u81ea\u5b9a\u4e49\u5de5\u5177\u5b50\u7c7b\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/v1.2.2\/en\/reference\/tools#smolagents.Tool\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u5de5\u5177<\/a>\u00a0\u6765\u7ee7\u627f\u6709\u7528\u7684\u65b9\u6cd5\u3002\u5b50\u7c7b\u8fd8\u5b9a\u4e49\u4e86<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u5c5e\u6027\u00a0<code>\u540d\u5b57<\/code>\uff0c\u4e0e\u5de5\u5177\u672c\u8eab\u7684\u540d\u79f0\u76f8\u5bf9\u5e94\u3002\u540d\u79f0\u901a\u5e38\u63cf\u8ff0\u4e86\u5de5\u5177\u7684\u529f\u80fd\u3002\u7531\u4e8e\u4ee3\u7801\u4f1a\u8fd4\u56de\u4efb\u52a1\u4e2d\u4e0b\u8f7d\u6b21\u6570\u6700\u591a\u7684\u6a21\u578b\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u5176\u547d\u540d\u4e3a\u00a0<code>\u6a21\u578b\u4e0b\u8f7d\u8ba1\u6570\u5668<\/code>.<\/li>\n\n\n\n<li>\u5c5e\u6027\u00a0<code>\u63cf\u8ff0<\/code>\u00a0\u7528\u4e8e\u586b\u5145\u4ee3\u7406\u7684\u7cfb\u7edf\u63d0\u793a\u3002<\/li>\n\n\n\n<li>\u4e00\u4e2a\u00a0<code>\u6295\u5165<\/code>\u00a0\u5c5e\u6027\uff0c\u5b83\u662f\u4e00\u4e2a\u5b57\u5178\uff0c\u952e\u4e3a\u00a0<code>\"\u7c7b\u578b\"<\/code>\u00a0\u548c\u00a0<code>\"\u63cf\u8ff0\"<\/code>.\u5b83\u5305\u542b\u7684\u4fe1\u606f\u6709\u52a9\u4e8e Python \u89e3\u91ca\u5668\u5bf9\u8f93\u5165\u505a\u51fa\u660e\u667a\u7684\u9009\u62e9\u3002<\/li>\n\n\n\n<li>\u4e00\u4e2a\u00a0<code>\u8f93\u51fa\u7c7b\u578b<\/code>\u00a0\u5c5e\u6027\uff0c\u8be5\u5c5e\u6027\u6307\u5b9a\u4e86\u8f93\u51fa\u7c7b\u578b\u3002\u8fd9\u4e24\u4e2a\u00a0<code>\u6295\u5165<\/code>\u00a0\u548c\u00a0<code>\u8f93\u51fa\u7c7b\u578b<\/code>\u00a0\u5e94\u662f\u00a0<a href=\"https:\/\/docs.pydantic.dev\/latest\/concepts\/json_schema\/#generating-json-schema\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">Pydantic \u683c\u5f0f<\/a>\u5b83\u4eec\u53ef\u4ee5\u662f\u5176\u4e2d\u4e4b\u4e00\uff1a\u00a0<code>~authorized_types()<\/code>.<\/li>\n\n\n\n<li>A\u00a0<code>\u8f6c\u53d1<\/code>\u00a0\u65b9\u6cd5\uff0c\u5176\u4e2d\u5305\u542b\u8981\u6267\u884c\u7684\u63a8\u7406\u4ee3\u7801\u3002<\/li>\n<\/ul>\n\n\n\n<p>\u8fd9\u5c31\u662f\u7279\u5de5\u6240\u9700\u8981\u7684\u4e00\u5207\uff01<\/p>\n\n\n\n<p>\u8fd8\u6709\u53e6\u4e00\u79cd\u5236\u9020\u5de5\u5177\u7684\u65b9\u6cd5\u3002\u5728\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/guided_tour\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u5bfc\u6e38<\/a>\u6211\u4eec\u4f7f\u7528\u00a0<code>@ \u5de5\u5177<\/code>\u00a0\u88c5\u9970\u8005\u3002\u88c5\u9970\u516c\u53f8\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/v1.2.2\/en\/reference\/tools#smolagents.tool\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u5de5\u5177()<\/a>\u00a0\u88c5\u9970\u5668\u662f\u5b9a\u4e49\u7b80\u5355\u5de5\u5177\u7684\u63a8\u8350\u65b9\u6cd5\uff0c\u4f46\u6709\u65f6\u4f60\u9700\u8981\u7684\u4e0d\u6b62\u8fd9\u4e9b\uff1a\u5728\u4e00\u4e2a\u7c7b\u4e2d\u4f7f\u7528\u591a\u4e2a\u65b9\u6cd5\u4f7f\u5176\u66f4\u6e05\u6670\uff0c\u6216\u4f7f\u7528\u989d\u5916\u7684\u7c7b\u5c5e\u6027\u3002<\/p>\n\n\n\n<p>\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u60a8\u53ef\u4ee5\u901a\u8fc7\u5b50\u7c7b\u5316\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/v1.2.2\/en\/reference\/tools#smolagents.Tool\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u5de5\u5177<\/a>\u00a0\u5982\u4e0a\u6240\u8ff0\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#share-your-tool-to-the-hub\" target=\"_blank\" rel=\"noopener\"><\/a>\u5c06\u60a8\u7684\u5de5\u5177\u5171\u4eab\u5230\u4e2d\u67a2<\/h3>\n\n\n\n<p>\u60a8\u53ef\u4ee5\u901a\u8fc7\u8c03\u7528\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/v1.2.2\/en\/reference\/tools#smolagents.Tool.push_to_hub\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">push_too_hub()<\/a>\u00a0\u5de5\u5177\u4e0a\u3002\u786e\u4fdd\u5728 Hub \u4e0a\u4e3a\u5176\u521b\u5efa\u4e86\u5b58\u50a8\u5e93\uff0c\u5e76\u4f7f\u7528\u5177\u6709\u8bfb\u53d6\u6743\u9650\u7684\u4ee4\u724c\u3002<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">model_downloads_tool.push_to_hub(\"{your_username}\/hf-model-downloads\", token=\"\")<\/pre>\n\n\n\n<p>\u8981\u8ba9 \"\u63a8\u52a8\u67a2\u7ebd \"\u53d1\u6325\u4f5c\u7528\uff0c\u60a8\u7684\u5de5\u5177\u9700\u8981\u9075\u5b88\u4e00\u4e9b\u89c4\u5219\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u6240\u6709\u65b9\u6cd5\u90fd\u662f\u81ea\u5305\u542b\u7684\uff0c\u4f8b\u5982\uff0c\u4f7f\u7528\u7684\u53d8\u91cf\u53ef\u4ee5\u662f\u6765\u81ea\u53c2\u6570\u7684\u53d8\u91cf\uff0c\u4e5f\u53ef\u4ee5\u662f\u6765\u81ea\u53c2\u6570\u7684\u53d8\u91cf\u3002<\/li>\n\n\n\n<li>\u5982\u4e0a\u6240\u8ff0\u3001\u00a0<strong>\u6240\u6709\u5bfc\u5165\u90fd\u5e94\u76f4\u63a5\u5728\u5de5\u5177\u7684\u529f\u80fd\u4e2d\u5b9a\u4e49<\/strong>\u5426\u5219\uff0c\u5728\u5c1d\u8bd5\u8c03\u7528\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/v1.2.2\/en\/reference\/tools#smolagents.Tool.save\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u4fdd\u5b58()<\/a>\u00a0\u6216\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/v1.2.2\/en\/reference\/tools#smolagents.Tool.push_to_hub\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">push_too_hub()<\/a>\u00a0\u4f7f\u7528\u81ea\u5b9a\u4e49\u5de5\u5177\u3002<\/li>\n\n\n\n<li>\u5982\u679c\u60a8\u5bf9\u00a0<code>\u542f\u52a8<\/code>\u00a0\u65b9\u6cd5\uff0c\u4f60\u53ef\u4ee5\u7ed9\u5b83\u7684\u53c2\u6570\u9664\u4e86\u00a0<code>\u81ea\u6211<\/code>.\u8fd9\u662f\u56e0\u4e3a\u5728\u7279\u5b9a\u5de5\u5177\u5b9e\u4f8b\u7684\u521d\u59cb\u5316\u8fc7\u7a0b\u4e2d\u8bbe\u7f6e\u7684\u53c2\u6570\u5f88\u96be\u8ddf\u8e2a\uff0c\u8fd9\u5c31\u59a8\u788d\u4e86\u5c06\u5b83\u4eec\u6b63\u786e\u5730\u5171\u4eab\u7ed9\u96c6\u7ebf\u5668\u3002\u65e0\u8bba\u5982\u4f55\uff0c\u5236\u4f5c\u4e00\u4e2a\u7279\u5b9a\u7c7b\u7684\u60f3\u6cd5\u662f\uff0c\u4f60\u5df2\u7ecf\u53ef\u4ee5\u4e3a\u4efb\u4f55\u9700\u8981\u786c\u7f16\u7801\u7684\u4e1c\u897f\u8bbe\u7f6e\u7c7b\u5c5e\u6027\uff08\u53ea\u9700\u8bbe\u7f6e\u00a0<code>your_variable=(...)<\/code>\u00a0\u76f4\u5c5e\u00a0<code>\u7c7b YourTool\uff08\u5de5\u5177\uff09\uff1a<\/code>\u00a0\u884c\uff09\u3002\u5f53\u7136\uff0c\u60a8\u4e5f\u53ef\u4ee5\u5728\u4ee3\u7801\u7684\u4efb\u4f55\u5730\u65b9\u521b\u5efa\u7c7b\u5c5e\u6027\uff0c\u53ea\u9700\u5c06\u5185\u5bb9\u8d4b\u503c\u7ed9\u00a0<code>self.your_variable<\/code>.<\/li>\n<\/ul>\n\n\n\n<p>\u4e00\u65e6\u5c06\u5de5\u5177\u63a8\u9001\u5230 Hub\uff0c\u5c31\u53ef\u4ee5\u5c06\u5176\u53ef\u89c6\u5316\u3002\u00a0<a href=\"https:\/\/huggingface.co\/spaces\/m-ric\/hf-model-downloads\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u8fd9\u91cc<\/a>\u00a0\u662f\u00a0<code>\u6a21\u578b\u4e0b\u8f7d\u5de5\u5177<\/code>\u00a0\u6211\u63a8\u8fc7\u7684\u3002\u5b83\u6709\u4e00\u4e2a\u6f02\u4eae\u7684\u6e10\u53d8\u754c\u9762\u3002<\/p>\n\n\n\n<p>\u5728\u6df1\u5165\u7814\u7a76\u5de5\u5177\u6587\u4ef6\u65f6\uff0c\u4f60\u4f1a\u53d1\u73b0\u8be5\u5de5\u5177\u7684\u6240\u6709\u903b\u8f91\u90fd\u5728\u00a0<a href=\"https:\/\/huggingface.co\/spaces\/m-ric\/hf-model-downloads\/blob\/main\/tool.py\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">tool.py<\/a>.\u5728\u8fd9\u91cc\uff0c\u60a8\u53ef\u4ee5\u68c0\u67e5\u522b\u4eba\u5171\u4eab\u7684\u5de5\u5177\u3002<\/p>\n\n\n\n<p>\u7136\u540e\u5c31\u53ef\u4ee5\u7528\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/v1.2.2\/en\/reference\/tools#smolagents.load_tool\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">load_tool()<\/a>\u00a0\u6216\u4f7f\u7528\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/v1.2.2\/en\/reference\/tools#smolagents.Tool.from_hub\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">from_hub()<\/a>\u00a0\u5e76\u5c06\u5176\u4f20\u9012\u7ed9\u00a0<code>\u5de5\u5177<\/code>\u00a0\u53c2\u6570\u3002\u7531\u4e8e\u8fd0\u884c\u5de5\u5177\u610f\u5473\u7740\u8fd0\u884c\u81ea\u5b9a\u4e49\u4ee3\u7801\uff0c\u4f60\u9700\u8981\u786e\u4fdd\u4f60\u4fe1\u4efb\u7248\u672c\u5e93\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u901a\u8fc7\u00a0<code>trust_remote_code=True<\/code>\u00a0\u4ece\u4e2d\u67a2\u52a0\u8f7d\u5de5\u5177\u3002<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">from smolagents import load_tool, CodeAgent\n\nmodel_download_tool = load_tool(\n    \"{your_username}\/hf-model-downloads\"\u3001\n    trust_remote_code=True\n)<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#import-a-space-as-a-tool\" target=\"_blank\" rel=\"noopener\"><\/a>\u5bfc\u5165\u7a7a\u95f4\u4f5c\u4e3a\u5de5\u5177<\/h3>\n\n\n\n<p>\u60a8\u53ef\u4ee5\u76f4\u63a5\u4ece\u4e2d\u67a2\u5bfc\u5165\u7a7a\u95f4\u4f5c\u4e3a\u5de5\u5177\uff0c\u4f7f\u7528\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/v1.2.2\/en\/reference\/tools#smolagents.Tool.from_space\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">Tool.from_space()<\/a>\u00a0\u65b9\u6cd5\uff01<\/p>\n\n\n\n<p>\u60a8\u53ea\u9700\u63d0\u4f9b Hub \u4e0a\u7a7a\u95f4\u7684 id\u3001\u540d\u79f0\u4ee5\u53ca\u6709\u52a9\u4e8e\u4ee3\u7406\u4e86\u89e3\u8be5\u5de5\u5177\u4f5c\u7528\u7684\u63cf\u8ff0\u3002\u5728\u5f15\u64ce\u76d6\u4e0b\uff0c\u8fd9\u5c06\u4f7f\u7528\u00a0<a href=\"https:\/\/pypi.org\/project\/gradio-client\/\" target=\"_blank\" rel=\"noreferrer noopener nofollow\"><code>gradio-client<\/code><\/a>\u00a0\u5e93\u6765\u8c03\u7528 Space\u3002<\/p>\n\n\n\n<p>\u4f8b\u5982\uff0c\u8ba9\u6211\u4eec\u5bfc\u5165\u00a0<a href=\"https:\/\/huggingface.co\/black-forest-labs\/FLUX.1-dev\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">FLUX.1-dev<\/a>\u00a0\u7a7a\u95f4\uff0c\u5e76\u7528\u5b83\u6765\u751f\u6210\u56fe\u50cf\u3002<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">image_generation_tool = Tool.from_space(\n    \"black-forest-labs\/FLUX.1-schnell\"\u3001\n    name=\"image_generator\"\u3001\n    description=\"\u6839\u636e\u63d0\u793a\u751f\u6210\u56fe\u50cf\"\n)\n\nimage_generation_tool(\"A sunny beach\")<\/pre>\n\n\n\n<p>\u77a7\uff0c\u8fd9\u5c31\u662f\u4f60\u7684\u56fe\u7247\uff01\ud83c\udfd6\ufe0f<\/p>\n\n\n\n<figure class=\"wp-block-image is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"1024\" src=\"https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/sunny_beach.webp\" alt=\"\" class=\"wp-image-593\" style=\"width:1176px;height:auto\" srcset=\"https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/sunny_beach.webp 1024w, https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/sunny_beach-300x300.webp 300w, https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/sunny_beach-150x150.webp 150w, https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/sunny_beach-768x768.webp 768w, https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/sunny_beach-12x12.webp 12w, https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/sunny_beach-360x360.webp 360w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>\u7136\u540e\uff0c\u4f60\u5c31\u53ef\u4ee5\u50cf\u4f7f\u7528\u5176\u4ed6\u5de5\u5177\u4e00\u6837\u4f7f\u7528\u8fd9\u4e2a\u5de5\u5177\u4e86\u3002\u4f8b\u5982\uff0c\u8ba9\u6211\u4eec\u6539\u8fdb\u4e00\u4e0b\u63d0\u793a&nbsp;<code>\u7a7f\u592a\u7a7a\u670d\u7684\u5154\u5b50<\/code>&nbsp;\u5e76\u751f\u6210\u5176\u56fe\u50cf\u3002<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">from smolagents import CodeAgent, HfApiModel\n\nmodel = HfApiModel(\"Qwen\/Qwen2.5-Coder-32B-Instruct\")\nagent = CodeAgent(tools=[image_generation_tool], model=model)\n\nagent.run(\n    \"\u6539\u8fdb\u6b64\u63d0\u793a\uff0c\u7136\u540e\u751f\u6210\u5176\u56fe\u50cf\u3002\", prompt='A rabbit wearing a space suit' (\u4e00\u53ea\u7a7f\u7740\u592a\u7a7a\u670d\u7684\u5154\u5b50)\n)<\/pre>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">=== Agent thoughts\uff1a\nimproved_prompt \u53ef\u4ee5\u662f \"\u4e00\u53ea\u7a7f\u7740\u4eae\u84dd\u8272\u592a\u7a7a\u670d\u7684\u5154\u5b50\uff0c\u5728\u6708\u7403\u8868\u9762\uff0c\u5728\u660e\u4eae\u7684\u6a59\u8272\u5915\u9633\u4e0b\uff0c\u80cc\u666f\u662f\u6e05\u6670\u53ef\u89c1\u7684\u5730\u7403\"\n\n\u73b0\u5728\uff0c\u6211\u5df2\u7ecf\u6539\u8fdb\u4e86\u63d0\u793a\uff0c\u53ef\u4ee5\u4f7f\u7528\u56fe\u50cf\u751f\u6210\u5668\u5de5\u5177\u6839\u636e\u6b64\u63d0\u793a\u751f\u6210\u56fe\u50cf\u3002\n&gt;&gt;&gt; Agent \u6b63\u5728\u6267\u884c\u4e0b\u9762\u7684\u4ee3\u7801\uff1a\nimage = image_generator(prompt=\"A bright blue space suit wearing rabbit, on the surface of the moon, under a bright orange sunset, with the Earth visible in the background\")\nfinal_answer(image)<\/pre>\n\n\n\n<figure class=\"wp-block-image is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"1024\" src=\"https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/rabbit_spacesuit_flux.webp\" alt=\"\" class=\"wp-image-592\" style=\"width:1178px;height:auto\" srcset=\"https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/rabbit_spacesuit_flux.webp 1024w, https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/rabbit_spacesuit_flux-300x300.webp 300w, https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/rabbit_spacesuit_flux-150x150.webp 150w, https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/rabbit_spacesuit_flux-768x768.webp 768w, https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/rabbit_spacesuit_flux-12x12.webp 12w, https:\/\/smolagents.org\/wp-content\/uploads\/2025\/01\/rabbit_spacesuit_flux-360x360.webp 360w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>\u8fd9\u6709\u591a\u9177\uff1f\ud83e\udd29<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#use-langchain-tools\" target=\"_blank\" rel=\"noopener\"><\/a>\u4f7f\u7528\u8bed\u8a00\u94fe\u5de5\u5177<\/h3>\n\n\n\n<p>\u6211\u4eec\u5f88\u559c\u6b22 Langchain\uff0c\u8ba4\u4e3a\u5b83\u6709\u4e00\u5957\u975e\u5e38\u5f15\u4eba\u6ce8\u76ee\u7684\u5de5\u5177\u3002\u8981\u4ece LangChain \u5bfc\u5165\u5de5\u5177\uff0c\u8bf7\u4f7f\u7528&nbsp;<code>from_langchain()<\/code>&nbsp;\u65b9\u6cd5\u3002<\/p>\n\n\n\n<p>\u4e0b\u9762\u4ecb\u7ecd\u5982\u4f55\u4f7f\u7528 LangChain \u7f51\u7edc\u641c\u7d22\u5de5\u5177\u6765\u91cd\u73b0\u4ecb\u7ecd\u4e2d\u7684\u641c\u7d22\u7ed3\u679c\u3002\u8be5\u5de5\u5177\u9700\u8981&nbsp;<code>pip install langchain google-search-results -q<\/code>&nbsp;\u624d\u80fd\u6b63\u5e38\u5de5\u4f5c\u3002<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">\u4ece langchain.agents \u5bfc\u5165 load_tools\n\nsearch_tool = Tool.from_langchain(load_tools([\"serpapi\"])[0])\n\nagent = CodeAgent(tools=[search_tool], model=model)\n\nagent.run(\"\u4e0e Attention is All You Need \u4e2d\u63d0\u51fa\u7684\u67b6\u6784\u4e2d\u7684\u7f16\u7801\u5668\u76f8\u6bd4\uff0cBERT \u57fa\u672c\u7f16\u7801\u5668\u4e2d\u591a\u4e86\u591a\u5c11\u5757\uff08\u4e5f\u79f0\u4e3a\u5c42\uff09\uff1f<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#manage-your-agents-toolbox\" target=\"_blank\" rel=\"noopener\"><\/a>\u7ba1\u7406\u7279\u5de5\u5de5\u5177\u7bb1<\/h3>\n\n\n\n<p>\u60a8\u53ef\u4ee5\u901a\u8fc7\u6dfb\u52a0\u6216\u66ff\u6362\u5c5e\u6027\u4e2d\u7684\u5de5\u5177\u6765\u7ba1\u7406\u7279\u5de5\u7684\u5de5\u5177\u7bb1\u3002&nbsp;<code>\u4ee3\u7406\u5de5\u5177<\/code>\u56e0\u4e3a\u5b83\u662f\u6807\u51c6\u5b57\u5178\u3002<\/p>\n\n\n\n<p>\u8ba9\u6211\u4eec\u6dfb\u52a0&nbsp;<code>\u6a21\u578b\u4e0b\u8f7d\u5de5\u5177<\/code>&nbsp;\u5230\u4ec5\u4f7f\u7528\u9ed8\u8ba4\u5de5\u5177\u7bb1\u521d\u59cb\u5316\u7684\u73b0\u6709\u4ee3\u7406\u3002<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">\u4ece smolagents \u5bfc\u5165 HfApiModel\n\nmodel = HfApiModel(\"Qwen\/Qwen2.5-Coder-32B-Instruct\")\n\nagent = CodeAgent(tools=[], model=model, add_base_tools=True)\nagent.tools[model_download_tool.name] = model_download_tool<\/pre>\n\n\n\n<p>\u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u5229\u7528\u8fd9\u4e2a\u65b0\u5de5\u5177\u4e86\uff1a<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">agent.run(\n    \"\u4f60\u80fd\u544a\u8bc9\u6211\u5728\u62e5\u62b1\u8138\u67a2\u7ebd\u7684'\u6587\u5b57\u5230\u89c6\u9891'\u4efb\u52a1\u4e2d\u4e0b\u8f7d\u6b21\u6570\u6700\u591a\u4f46\u5b57\u6bcd\u98a0\u5012\u7684\u6a21\u578b\u540d\u79f0\u5417\uff1f\n)<\/pre>\n\n\n\n<p>\u6ce8\u610f\u4e0d\u8981\u4e3a\u4ee3\u7406\u6dfb\u52a0\u8fc7\u591a\u5de5\u5177\uff1a\u8fd9\u4f1a\u8ba9\u8f83\u5f31\u7684 LLM \u5f15\u64ce\u4e0d\u582a\u91cd\u8d1f\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools#use-a-collection-of-tools\" target=\"_blank\" rel=\"noopener\"><\/a>\u4f7f\u7528\u4e00\u7cfb\u5217\u5de5\u5177<\/h3>\n\n\n\n<p>\u60a8\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u5de5\u5177\u96c6\u5408\u5bf9\u8c61\uff08ToolCollection object\uff09\u6765\u5229\u7528\u5de5\u5177\u96c6\u5408\uff0c\u5176\u4e2d\u5305\u542b\u60a8\u8981\u4f7f\u7528\u7684\u96c6\u5408\u7684\u6807\u9898\u3002\u7136\u540e\u5c06\u5b83\u4eec\u4f5c\u4e3a\u4e00\u4e2a\u5217\u8868\u4f20\u5165\uff0c\u521d\u59cb\u5316\u4f60\u7684\u4ee3\u7406\uff0c\u5e76\u5f00\u59cb\u4f7f\u7528\u5b83\u4eec\uff01<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">from smolagents import ToolCollection, CodeAgent\n\nimage_tool_collection = ToolCollection(\n    collection_slug=\"huggingface-tools\/diffusion-tools-6630bb19a942c2306a2cdb6f\",\n    token=\"\"\n)\nagent = CodeAgent(tools=[*image_tool_collection.tools], model=model, add_base_tools=True)\n\nagent.run(\"Please draw me a picture of rivers and lakes.\")<\/pre>\n\n\n\n<p>\u4e3a\u4e86\u52a0\u5feb\u542f\u52a8\u901f\u5ea6\uff0c\u53ea\u6709\u5728\u4ee3\u7406\u8c03\u7528\u65f6\u624d\u4f1a\u52a0\u8f7d\u5de5\u5177\u3002<\/p>","protected":false},"excerpt":{"rendered":"<p>\u5728\u8fd9\u91cc\uff0c\u6211\u4eec\u5c06\u770b\u5230\u9ad8\u7ea7\u5de5\u5177\u7684\u4f7f\u7528\u3002\u5982\u679c\u60a8\u662f\u6784\u5efa\u4ee3\u7406\u7684\u65b0\u624b\uff0c\u8bf7\u52a1\u5fc5\u5148\u9605\u8bfb\u4ee3\u7406\u5165\u95e8\u548c smolagents \u6307\u5357\u3002\u4ec0\u4e48\u662f\u5de5\u5177\uff0c\u5982\u4f55\u6784\u5efa\u5de5\u5177\uff1f\u5de5\u5177\u4e3b\u8981\u662f\u6307 LLM \u53ef\u4ee5\u5728\u4ee3\u7406\u7cfb\u7edf\u4e2d\u4f7f\u7528\u7684\u529f\u80fd\u3002\u4f46\u662f\uff0c\u8981\u4f7f\u7528\u5b83\uff0c...<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_kadence_starter_templates_imported_post":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"doc_category":[8],"doc_tag":[],"class_list":["post-591","docs","type-docs","status-publish","hentry","doc_category-tutorials"],"year_month":"2026-04","word_count":1431,"total_views":"5891","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"smolagents","author_nicename":"wd-gstargmail-com","author_url":"https:\/\/smolagents.org\/zh\/author\/wd-gstargmail-com\/"},"doc_category_info":[{"term_name":"Tutorials","term_url":"https:\/\/smolagents.org\/zh\/docs-category\/tutorials\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/docs\/591","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/comments?post=591"}],"version-history":[{"count":1,"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/docs\/591\/revisions"}],"predecessor-version":[{"id":594,"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/docs\/591\/revisions\/594"}],"wp:attachment":[{"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/media?parent=591"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/doc_category?post=591"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/doc_tag?post=591"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}