{"id":598,"date":"2025-01-11T15:28:59","date_gmt":"2025-01-11T15:28:59","guid":{"rendered":"https:\/\/smolagents.org\/?post_type=docs&#038;p=598"},"modified":"2025-01-11T15:40:54","modified_gmt":"2025-01-11T15:40:54","password":"","slug":"text-to-sql-example","status":"publish","type":"docs","link":"https:\/\/smolagents.org\/zh\/docs\/text-to-sql-example\/","title":{"rendered":"\u6587\u672c\u5230 SQL \u793a\u4f8b"},"content":{"rendered":"<p>\u5728\u672c\u6559\u7a0b\u4e2d\uff0c\u6211\u4eec\u5c06\u4e86\u89e3\u5982\u4f55\u4f7f\u7528&nbsp;<code>smolagents<\/code>.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>\u8ba9\u6211\u4eec\u4ece\u6700\u91cd\u8981\u7684\u95ee\u9898\u5f00\u59cb\uff1a\u4e3a\u4ec0\u4e48\u4e0d\u4fdd\u6301\u7b80\u5355\uff0c\u4f7f\u7528\u6807\u51c6\u7684\u6587\u672c\u5230 SQL \u7ba1\u9053\uff1f<\/p>\n<\/blockquote>\n\n\n\n<p>\u6807\u51c6\u7684\u6587\u672c\u5230 SQL \u7ba1\u9053\u5f88\u8106\u5f31\uff0c\u56e0\u4e3a\u751f\u6210\u7684 SQL \u67e5\u8be2\u53ef\u80fd\u4e0d\u6b63\u786e\u3002\u66f4\u7cdf\u7cd5\u7684\u662f\uff0c\u67e5\u8be2\u53ef\u80fd\u4e0d\u6b63\u786e\uff0c\u4f46\u4e0d\u4f1a\u5f15\u53d1\u9519\u8bef\uff0c\u53cd\u800c\u4f1a\u63d0\u4f9b\u4e00\u4e9b\u4e0d\u6b63\u786e\/\u65e0\u7528\u7684\u8f93\u51fa\uff0c\u800c\u4e0d\u4f1a\u5f15\u53d1\u8b66\u62a5\u3002<\/p>\n\n\n\n<p>\ud83d\udc49 \u76f8\u53cd\uff0c\u4ee3\u7406\u7cfb\u7edf\u80fd\u591f\u4e25\u683c\u68c0\u67e5\u8f93\u51fa\u7ed3\u679c\uff0c\u5e76\u51b3\u5b9a\u662f\u5426\u9700\u8981\u66f4\u6539\u67e5\u8be2\uff0c\u4ece\u800c\u5927\u5927\u63d0\u9ad8\u6027\u80fd\u3002<\/p>\n\n\n\n<p>\u8ba9\u6211\u4eec\u5efa\u7acb\u8fd9\u4e2a\u4ee3\u7406\uff01\ud83d\udcaa<\/p>\n\n\n\n<p>\u9996\u5148\uff0c\u6211\u4eec\u8bbe\u7f6e SQL \u73af\u5883\uff1a<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">\u4ece sqlalchemy \u5bfc\u5165 (\n    create_engine\u3001\n    \u5143\u6570\u636e\n    \u8868\u3001\n    \u5217\n    \u5b57\u7b26\u4e32\n    \u6574\u6570\n    \u6d6e\u70b9\u6570\u3001\n    \u63d2\u5165\n    \u68c0\u67e5\n    \u6587\u672c\u3001\n)\n\nengine = create_engine(\"sqlite:\/\/\/:memory:\")\nmetadata_obj = MetaData()\n\n<em># \u521b\u5efa\u57ce\u5e02 SQL \u8868<\/em>\ntable_name = \"\u6536\u636e\"\nreceipts = Table(\n    table_name\u3001\n    metadata_obj.Column(\"receipt_id\", Integer, primary_key=True)\n    Column(\"receipt_id\", Integer, primary_key=True)\u3001\n    Column(\"customer_name\", String(16), primary_key=True)\u3001\n    Column(\"price\", Float)\u3001\n    \u5217\uff08\"\u5c0f\u8d39\"\uff0c\u6d6e\u52a8\uff09\u3001\n)\nmetadata_obj.create_all(engine)\n\n\u884c = [\n    {\"receipt_id\"\uff1a1, \"customer_name\"\uff1a\"Alan Payne\", \"price\"\uff1a12.06, \"tip\"\uff1a1.20},\n    {\"receipt_id\"\uff1a2, \"customer_name\"\uff1a\"Alex Mason\", \"\u4ef7\u683c\"\uff1a23.86, \"tip\"\uff1a0.24},\n    {\"receipt_id\"\uff1a3, \"customer_name\"\uff1a\"Woodrow Wilson\", \"\u4ef7\u683c\"\uff1a53.43, \"tip\"\uff1a5.43},\n    {\"receipt_id\"\uff1a4, \"customer_name\"\uff1a\"Margaret James\", \"price\"\uff1a21.11, \"tip\"\uff1a1.00},\n]\nfor row in rows\uff1a\n    stmt = insert(receipts).values(**row)\n    with engine.begin() as connection\uff1a\n        cursor = connection.execute(stmt)<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/examples\/text_to_sql#build-our-agent\" target=\"_blank\" rel=\"noopener\"><\/a>\u5efa\u7acb\u6211\u4eec\u7684\u4ee3\u7406<\/h3>\n\n\n\n<p>\u73b0\u5728\uff0c\u8ba9\u6211\u4eec\u7528\u5de5\u5177\u68c0\u7d22\u6211\u4eec\u7684 SQL \u8868\u3002<\/p>\n\n\n\n<p>\u4ee3\u7406\u7cfb\u7edf\u4f1a\u5c06\u5de5\u5177\u7684\u63cf\u8ff0\u5c5e\u6027\u5d4c\u5165 LLM \u7684\u63d0\u793a\u4e2d\uff1a\u4e3a LLM \u63d0\u4f9b\u5982\u4f55\u4f7f\u7528\u5de5\u5177\u7684\u4fe1\u606f\u3002\u8fd9\u5c31\u662f\u6211\u4eec\u8981\u63cf\u8ff0 SQL \u8868\u7684\u5730\u65b9\u3002<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">inspector = inspect(engine)\ncolumns_info = [(col[\"name\"], col[\"type\"]) for col in inspector.get_columns(\"receipts\")] \u5217_\u4fe1\u606f\n\ntable_description = \"Columns:\\n\" + \"\\n\".join([f\" - {name}: {col_type}\" for name, col_type in columns_info])\nprint(table_description)<\/pre>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">\u5217\uff1a\n  - receipt_id\uff1aINTEGER\n  - customer_name: VARCHAR(16)\n  - \u4ef7\u683cFLOAT\n  - \u5c0f\u8d39\uff1aFLOAT<\/pre>\n\n\n\n<p>\u73b0\u5728\uff0c\u8ba9\u6211\u4eec\u6765\u6784\u5efa\u6211\u4eec\u7684\u5de5\u5177\u3002\u5b83\u9700\u8981\u5177\u5907\u4ee5\u4e0b\u6761\u4ef6\uff1a\u8bfb\u53d6\u00a0<a href=\"https:\/\/huggingface.co\/docs\/smolagents\/tutorials\/tools\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">\u5de5\u5177\u6587\u6863<\/a>\u00a0\u4e86\u89e3\u66f4\u591a\u8be6\u60c5\uff09<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u5e26\u6709\u00a0<code>\u53c2\u6570<\/code>\u00a0\u90e8\u5206\u5217\u51fa\u53c2\u6570\u3002<\/li>\n\n\n\n<li>\u8f93\u5165\u548c\u8f93\u51fa\u5747\u6709\u7c7b\u578b\u63d0\u793a\u3002<\/li>\n<\/ul>\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\n@tool\ndef sql_engine(query: str) -&gt; str\uff1a\n    \"\"\"\n    \u5141\u8bb8\u5bf9\u8868\u6267\u884c SQL \u67e5\u8be2\u3002\u8fd4\u56de\u7ed3\u679c\u7684\u5b57\u7b26\u4e32\u8868\u793a\u3002\n    \u8868\u540d\u4e3a \"\u6536\u636e\"\u3002\u5176\u63cf\u8ff0\u5982\u4e0b\n        \u5217\uff1a\n        - receipt_id\uff1aINTEGER\n        - customer_name: VARCHAR(16)\n        - \u4ef7\u683cFLOAT\n        - \u5c0f\u8d39\uff1aFLOAT\n\n    \u53c2\u6570\uff1a\n        query\uff1a\u8981\u6267\u884c\u7684\u67e5\u8be2\u3002\u8fd9\u5e94\u8be5\u662f\u6b63\u786e\u7684 SQL\u3002\n    \"\"\"\n    output = \"\"\n    with engine.connect() as con\uff1a\n        rows = con.execute(text(query))\n        for row in rows\uff1a\n            output += \"\\n\" + str(row)\n    \u8fd4\u56de\u8f93\u51fa<\/pre>\n\n\n\n<p>\u73b0\u5728\uff0c\u8ba9\u6211\u4eec\u521b\u5efa\u4e00\u4e2a\u5229\u7528\u8fd9\u4e00\u5de5\u5177\u7684\u4ee3\u7406\u3002<\/p>\n\n\n\n<p>\u6211\u4eec\u4f7f\u7528&nbsp;<code>\u4ee3\u7801\u4ee3\u7406<\/code>\u662f smolagents \u7684\u4e3b\u8981\u4ee3\u7406\u7c7b\uff1a\u5b83\u662f\u4e00\u4e2a\u7528\u4ee3\u7801\u7f16\u5199\u64cd\u4f5c\u7684\u4ee3\u7406\uff0c\u53ef\u4ee5\u6839\u636e ReAct \u6846\u67b6\u8fed\u4ee3\u4e4b\u524d\u7684\u8f93\u51fa\u3002<\/p>\n\n\n\n<p>\u6a21\u578b\u662f\u4e3a\u4ee3\u7406\u7cfb\u7edf\u63d0\u4f9b\u52a8\u529b\u7684 LLM\u3002HfApiModel \u5141\u8bb8\u60a8\u4f7f\u7528 HF \u7684\u63a8\u7406 API\uff08\u901a\u8fc7\u65e0\u670d\u52a1\u5668\u7aef\u70b9\u6216\u4e13\u7528\u7aef\u70b9\uff09\u8c03\u7528 LLM\uff0c\u4f46\u60a8\u4e5f\u53ef\u4ee5\u4f7f\u7528\u4efb\u4f55\u4e13\u6709 API\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\nagent = CodeAgent(\n    tools=[sql_engine]\u3001\n    model=HfApiModel(\"meta-llama\/Meta-Llama-3.1-8B-Instruct\")\u3001\n)\nagent.run(\"Can you give me the name of the client who got the most expensive receipt?\")<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"https:\/\/huggingface.co\/docs\/smolagents\/examples\/text_to_sql#level-2-table-joins\" target=\"_blank\" rel=\"noopener\"><\/a>\u7b2c 2 \u7ea7\uff1a\u8868\u8fde\u63a5<\/h3>\n\n\n\n<p>\u73b0\u5728\uff0c\u8ba9\u6211\u4eec\u6765\u589e\u52a0\u6311\u6218\u6027\uff01\u6211\u4eec\u5e0c\u671b\u4ee3\u7406\u80fd\u5904\u7406\u591a\u4e2a\u8868\u4e4b\u95f4\u7684\u8fde\u63a5\u3002<\/p>\n\n\n\n<p>\u56e0\u6b64\uff0c\u6211\u4eec\u518d\u5236\u4f5c\u4e00\u4e2a\u8868\uff0c\u8bb0\u5f55\u6bcf\u4e2a\u6536\u636e ID \u7684\u670d\u52a1\u5458\u59d3\u540d\uff01<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">table_name = \"\u670d\u52a1\u5458\"\n\u6536\u636e = \u8868\uff08\n    table_name\u3001\n    metadata_obj.Column(\"receipt_id\", Integer, primary_key=True)\n    Column(\"receipt_id\", Integer, primary_key=True)\u3001\n    Column(\"waiter_name\", String(16), primary_key=True)\u3001\n)\nmetadata_obj.create_all(engine)\n\nrows = [\n    {\"receipt_id\"\uff1a1, \"waiter_name\"\uff1a\"Corey Johnson\"}\u3001\n    {\"receipt_id\"\uff1a2, \"waiter_name\"\uff1a\"Michael Watts\"}\u3001\n    {\"\u6536\u636e\u7f16\u53f7\"\uff1a3, \"waiter_name\"\uff1a\"Michael Watts\"}\u3001\n    {\"\u6536\u636e\u7f16\u53f7\"\uff1a4, \"waiter_name\"\uff1a\"Margaret James\"}\u3001\n]\nfor row in rows\uff1a\n    stmt = insert(receipts).values(**row)\n    with engine.begin() as connection\uff1a\n        cursor = connection.execute(stmt)<\/pre>\n\n\n\n<p>\u56e0\u4e3a\u6211\u4eec\u66f4\u6539\u4e86\u8868\u683c\uff0c\u6240\u4ee5\u8981\u66f4\u65b0&nbsp;<code>SQLExecutorTool<\/code>&nbsp;\u4e0e\u8be5\u8868\u7684\u63cf\u8ff0\u4e00\u81f4\uff0c\u4ee5\u4fbf\u8ba9 LLM \u6b63\u786e\u5229\u7528\u8be5\u8868\u4e2d\u7684\u4fe1\u606f\u3002<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">updated_description = \"\"\"\u5141\u8bb8\u5bf9\u8868\u6267\u884c SQL \u67e5\u8be2\u3002\u8bf7\u6ce8\u610f\uff0c\u8be5\u5de5\u5177\u7684\u8f93\u51fa\u662f\u6267\u884c\u8f93\u51fa\u7684\u5b57\u7b26\u4e32\u8868\u793a\u3002\n\u5b83\u53ef\u4ee5\u4f7f\u7528\u4ee5\u4e0b\u8868\u683c\uff1a\"\"\"\n\ninspector = inspect(engine)\nfor table in [\"receipts\", \"waiters\"]\uff1a\n    columns_info = [(col[\"name\"], col[\"type\"]) for col in inspector.get_columns(table)] \u5217\u4fe1\u606f\n\n    table_description = f \"\u8868'{table}':\/n\"\u3002\n\n    table_description += \"Columns:\\n\" + \"\\n\".join([f\" - {name}: {col_type}\" for name, col_type in columns_info])\n    updated_description += \"\\n\\n\" + table_description\n\nprint(updated_description)<\/pre>\n\n\n\n<p>\u7531\u4e8e\u8fd9\u4e2a\u8bf7\u6c42\u6bd4\u524d\u4e00\u4e2a\u66f4\u96be\uff0c\u6211\u4eec\u5c06\u5207\u6362 LLM \u5f15\u64ce\uff0c\u4f7f\u7528\u529f\u80fd\u66f4\u5f3a\u5927\u7684\u00a0<a href=\"https:\/\/huggingface.co\/Qwen\/Qwen2.5-Coder-32B-Instruct\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">Qwen\/Qwen2.5-Coder-32B-Instruct<\/a>!<\/p>\n\n\n\n<p>\u590d\u5236\u7684<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">sql_engine.description = updated_description\n\nagent = CodeAgent(\n    tools=[sql_engine]\u3001\n    model=HfApiModel(\"Qwen\/Qwen2.5-Coder-32B-Instruct\")\u3001\n)\n\nagent.run(\"Which waiter got more total money from tips?\")<\/pre>\n\n\n\n<p>\u5b83\u53ef\u4ee5\u76f4\u63a5\u5de5\u4f5c\uff01\u8bbe\u7f6e\u51fa\u4e4e\u610f\u6599\u7684\u7b80\u5355\uff0c\u4e0d\u662f\u5417\uff1f<\/p>\n\n\n\n<p>\u8fd9\u4e2a\u4f8b\u5b50\u5df2\u7ecf\u5b8c\u6210\uff01\u6211\u4eec\u5df2\u7ecf\u89e6\u53ca\u4e86\u8fd9\u4e9b\u6982\u5ff5\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u5f00\u53d1\u65b0\u5de5\u5177\u3002<\/li>\n\n\n\n<li>\u66f4\u65b0\u5de5\u5177\u8bf4\u660e\u3002<\/li>\n\n\n\n<li>\u6539\u7528\u66f4\u5f3a\u7684 LLM \u6709\u52a9\u4e8e\u4ee3\u7406\u63a8\u7406\u3002<\/li>\n<\/ul>\n\n\n\n<p>\u2705 \u73b0\u5728\uff0c\u4f60\u53ef\u4ee5\u53bb\u6784\u5efa\u4f60\u68a6\u5bd0\u4ee5\u6c42\u7684\u6587\u672c\u5230 SQL \u7cfb\u7edf\u4e86\uff01\u2728<\/p>","protected":false},"excerpt":{"rendered":"<p>\u5728\u672c\u6559\u7a0b\u4e2d\uff0c\u6211\u4eec\u5c06\u4e86\u89e3\u5982\u4f55\u4f7f\u7528 smolagents \u5b9e\u73b0\u5229\u7528 SQL \u7684\u4ee3\u7406\u3002\u8ba9\u6211\u4eec\u4ece\u6700\u91cd\u8981\u7684\u95ee\u9898\u5f00\u59cb\uff1a\u4e3a\u4ec0\u4e48\u4e0d\u4fdd\u6301\u7b80\u5355\u5e76\u4f7f\u7528\u6807\u51c6\u7684\u6587\u672c\u5230 SQL \u7ba1\u9053\uff1f\u6807\u51c6\u7684\u6587\u672c\u5230 SQL \u7ba1\u9053\u5f88\u8106\u5f31\uff0c\u56e0\u4e3a\u751f\u6210\u7684 SQL \u67e5\u8be2\u53ef\u80fd\u4e0d\u6b63\u786e\u3002\u66f4\u7cdf\u7cd5\u7684\u662f\uff0c\u67e5\u8be2\u53ef\u80fd\u4e0d\u6b63\u786e\uff0c\u4f46\u4e0d\u4f1a\u5f15\u8d77...<\/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":[10],"doc_tag":[],"class_list":["post-598","docs","type-docs","status-publish","hentry","doc_category-examples"],"year_month":"2026-04","word_count":879,"total_views":"4151","reactions":{"happy":"1","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":"Examples","term_url":"https:\/\/smolagents.org\/zh\/docs-category\/examples\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/docs\/598","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=598"}],"version-history":[{"count":1,"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/docs\/598\/revisions"}],"predecessor-version":[{"id":599,"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/docs\/598\/revisions\/599"}],"wp:attachment":[{"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/media?parent=598"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/doc_category?post=598"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/smolagents.org\/zh\/wp-json\/wp\/v2\/doc_tag?post=598"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}