---
title: 让 AI 动手查数据——从自然语言到 SQL 的魔法
date: 2026-05-28
author: 林远
series: 独立开发者的 AI 分身进化论
series_index: 2
coverImage: imgs/cover.png
tags:
  - Claude API
  - Tool Use
  - Text to SQL
  - 独立开发者
  - AI 应用
excerpt: 用户说"数据不对"，你得自己去数据库翻。直到发现 AI 可以直接写 SQL——让 AI 不只是看，还能动手。
---

## "数据不对"的困惑

"小众清单"上线三个月，用户量突破了一万。林远每天都会收到各种反馈，其中最让他头疼的就是"数据不对"这类模糊报告。

"我的清单数据不对。"用户说。
"哪里不对？"林远问。
"就是不对。"
"能具体一点吗？比如哪条数据？和预期有什么差异？"
"反正就是不对，你自己看吧。"

然后林远就得打开数据库，一层层翻找。有时候是用户理解偏差，有时候确实是 bug，更多时候是某个边缘条件没处理好。

他做过一个数据查询面板，但用户不会用——要填表单、选字段、设条件。他想教用户写 SQL，但"学习成本太高"的反馈让他放弃了这个念头。

"要是能直接用自然语言查数据就好了。"

这个念头在他脑海里转了很久。直到某天，他在 Claude Cookbooks 里翻到了 Tool Use 和 Text to SQL 的教程。

## Tool Use：让 AI 学会"动手"

上一章，林远让 AI "看见"了截图。但那只是被动接收信息——AI 能理解图片内容，却不能主动做什么。

Tool Use 是另一回事。它让 AI 能够"动手"——调用外部工具、执行操作、返回结果。

官方示例里有个计算器工具的例子：

```python
from anthropic import Anthropic

client = Anthropic()

# 定义工具
tools = [
    {
        "name": "calculator",
        "description": "一个简单的计算器，可以执行基本算术运算",
        "input_schema": {
            "type": "object",
            "properties": {
                "expression": {
                    "type": "string",
                    "description": "要计算的数学表达式，如 '2 + 3 * 4'"
                }
            },
            "required": ["expression"]
        }
    }
]

# 发送请求
message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "帮我算一下 1984135 乘以 9343116 等于多少？"
    }],
    tools=tools
)

print(message.content)
```

运行这段代码，林远看到了一个让他兴奋的结果。Claude 的响应会包含一个 `tool_use` 类型的 content block：

```python
# message.content 是一个列表，包含：
# ContentBlock(
#     type='tool_use',
#     name='calculator',
#     input={'expression': '1984135 * 9343116'}
# )
```

这告诉你要调用什么工具、传什么参数。完整的处理流程是这样的：

```python
# 1. 定义工具的实现
def calculate(expression):
    import re
    # 清理表达式，只保留数字和运算符
    expression = re.sub(r"[^0-9+\-*/().]", "", expression)
    try:
        result = eval(expression)  # 注意：生产环境应使用更安全的解析器
        return str(result)
    except:
        return "Error: Invalid expression"

# 2. 发送请求并处理响应
message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "帮我算一下 1984135 乘以 9343116"}],
    tools=tools
)

# 3. 检查 Claude 是否要调用工具
if message.stop_reason == "tool_use":
    tool_use = next(block for block in message.content if block.type == "tool_use")
    tool_name = tool_use.name
    tool_input = tool_use.input

    print(f"Claude 想调用: {tool_name}")
    print(f"参数: {tool_input}")
    # 输出: Claude 想调用: calculator
    #       参数: {'expression': '1984135 * 9343116'}

    # 4. 执行工具并返回结果
    result = calculate(tool_input["expression"])
    print(f"计算结果: {result}")
    # 输出: 计算结果: 18538003464660
```

AI 并不直接给出答案——它知道自己可能会算错，所以主动提出要调用计算器工具。你提供工具的实现，AI 决定什么时候调用、传什么参数。

这就是 Tool Use 的核心：**AI 不必什么都会，它只需要知道什么时候该用什么工具**。

林远很快理解了这个模式的威力。计算器只是示例，真正的工具可以是任何东西——查询数据库的 SQL、调用 API 的函数、访问文件系统的脚本……

"等等，这不就是自然语言查数据的思路吗？"

## Text to SQL：用中文查数据库

林远找到了 Cookbooks 里的 Text to SQL 教程。这是一个完整的指南，教你怎么把自然语言转成 SQL 查询。

核心思路很清晰：

1. 把数据库 schema 告诉 Claude
2. 用户用自然语言提问
3. Claude 生成 SQL
4. 执行 SQL，返回结果

**第一步：获取数据库结构**

```python
import sqlite3

def get_schema_info(db_path):
    conn = sqlite3.connect(db_path)
    cursor = conn.cursor()

    schema_info = []
    cursor.execute("SELECT name FROM sqlite_master WHERE type='table';")
    tables = cursor.fetchall()

    for (table_name,) in tables:
        cursor.execute(f"PRAGMA table_info({table_name})")
        columns = cursor.fetchall()
        table_info = f"Table: {table_name}\n"
        table_info += "\n".join(f"  - {col[1]} ({col[2]})" for col in columns)
        schema_info.append(table_info)

    conn.close()
    return "\n\n".join(schema_info)

# 示例输出
# Table: departments
#   - id (INTEGER)
#   - name (TEXT)
#   - location (TEXT)
#
# Table: employees
#   - id (INTEGER)
#   - name (TEXT)
#   - age (INTEGER)
#   - department_id (INTEGER)
#   - salary (REAL)
#   - hire_date (DATE)
```

**第二步：构造 Prompt**

```python
def generate_sql_prompt(schema, query):
    return f"""
你是一个 AI 助手，负责将自然语言查询转换为 SQL。

数据库结构：
<schema>
{schema}
</schema>

将以下自然语言查询转换为 SQL：
<query>
{query}
</query>

请在 <sql> 标签中提供 SQL 查询语句。
"""

# 用户提问
user_query = "工程部有哪些员工？"
prompt = generate_sql_prompt(schema, user_query)
```

**第三步：让 Claude 生成 SQL**

```python
response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1000,
    messages=[{"role": "user", "content": prompt}]
)

# 提取 SQL
sql = response.content[0].text.split("<sql>")[1].split("</sql>")[0].strip()
print(sql)
# 输出: SELECT e.name FROM employees e
#       JOIN departments d ON e.department_id = d.id
#       WHERE d.name = 'Engineering';
```

**第四步：执行 SQL 并返回结果**

```python
import pandas as pd

def run_sql(db_path, sql):
    conn = sqlite3.connect(db_path)
    result = pd.read_sql_query(sql, conn)
    conn.close()
    return result

result = run_sql("myapp.db", sql)
print(result)
```

整个过程行云流水。用户说"工程部有哪些员工"，系统自动生成 SQL、执行查询、返回结果。

林远立刻在本地数据库上试了几个查询：

- "本月新增用户有多少？" → 正确的 COUNT 查询
- "销量最高的五个产品" → 正确的 TOP 5 查询
- "过去七天每天的订单金额" → 正确的日期分组查询

"这太强了，我之前写的查询面板可以扔了。"

## 进阶：让 SQL 生成更可靠

林远继续往下读，发现 Cookbooks 里还有几个提升可靠性的技巧。

**1. Few-shot Prompting：给示例**

```python
examples = """
示例 1:
<query>列出 HR 部门的所有员工</query>
<sql>SELECT e.name FROM employees e
    JOIN departments d ON e.department_id = d.id
    WHERE d.name = 'HR';</sql>

示例 2:
<query>2022 年入职的员工平均薪资是多少？</query>
<sql>SELECT AVG(salary) FROM employees
    WHERE strftime('%Y', hire_date) = '2022';</sql>
"""
```

在 prompt 里加入几个示例，AI 生成的 SQL 会更准确。

**2. Chain-of-Thought：让 AI 展示思考过程**

```python
def generate_sql_with_cot(schema, query):
    return f"""
将以下查询转换为 SQL，并在 <thought_process> 标签中展示你的思考过程。

<query>{query}</query>

输出格式：
<thought_process>
1. 分析查询需要哪些表
2. 确定表之间的关联条件
3. 选择需要返回的字段
4. 构建完整的 SQL
</thought_process>
<sql>你的 SQL</sql>
"""
```

AI 会先分析查询需求，再生成 SQL。这个中间步骤让它能处理更复杂的查询。

**3. Self-Improvement：错误自修正**

更高级的做法是让 AI 自己修正错误：

```python
def generate_sql_with_retry(query, max_attempts=3):
    for attempt in range(max_attempts):
        sql = generate_sql(query)
        success, result, error = execute_sql(sql)

        if success:
            return sql, result

        # 如果执行失败，让 AI 修正
        correction_prompt = f"""
之前的 SQL 执行失败了：
SQL: {sql}
错误: {error}

请分析错误并给出修正后的 SQL。
"""
        sql = generate_sql(correction_prompt)

    return None, None
```

林远把这个模式用在了他的项目里。用户反馈"数据不对"时，他先让 AI 把相关数据查出来，再和用户一起核对。很多时候，问题就在这个过程中暴露出来了。

## 实战：构建一个自然语言查询工具

林远决定为"小众清单"做一个自然语言查询功能。核心代码如下：

```python
import sqlite3
from anthropic import Anthropic
import pandas as pd

class NaturalLanguageQuery:
    def __init__(self, db_path):
        self.db_path = db_path
        self.client = Anthropic()
        self.schema = self._get_schema()

    def _get_schema(self):
        conn = sqlite3.connect(self.db_path)
        cursor = conn.cursor()
        cursor.execute("SELECT name FROM sqlite_master WHERE type='table';")
        tables = cursor.fetchall()

        schema_parts = []
        for (table_name,) in tables:
            cursor.execute(f"PRAGMA table_info({table_name})")
            columns = cursor.fetchall()
            cols = "\n".join(f"  - {col[1]}: {col[2]}" for col in columns)
            schema_parts.append(f"表名: {table_name}\n字段:\n{cols}")

        conn.close()
        return "\n\n".join(schema_parts)

    def query(self, question):
        # 生成 SQL
        prompt = f"""
数据库结构：
{self.schema}

问题：{question}

请生成 SQL 查询，用 <sql> 标签包裹。
只返回 SELECT 语句，不要修改数据。
"""
        response = self.client.messages.create(
            model="claude-sonnet-4-6",
            max_tokens=1000,
            messages=[{"role": "user", "content": prompt}]
        )

        text = response.content[0].text
        if "<sql>" in text:
            sql = text.split("<sql>")[1].split("</sql>")[0].strip()

            # 执行查询
            try:
                conn = sqlite3.connect(self.db_path)
                result = pd.read_sql_query(sql, conn)
                conn.close()
                return {"success": True, "sql": sql, "data": result}
            except Exception as e:
                return {"success": False, "error": str(e), "sql": sql}

        return {"success": False, "error": "无法生成 SQL"}

# 使用示例
nlq = NaturalLanguageQuery("xiaozhongqingdan.db")
result = nlq.query("过去七天新增了多少清单？")
print(result["data"])
```

林远把这个功能集成到了后台管理界面。现在他可以直接用中文查数据：

- "昨天的活跃用户数"
- "每个分类下有多少清单"
- "最近一个月新增用户的来源分布"

"终于不用手写 SQL 了。"林远长舒一口气。

## 更多的工具，更多的可能

Tool Use 的应用远不止 SQL 查询。林远开始思考还能接入什么工具：

- **API 调用工具**：让 AI 直接调用第三方 API，比如天气、汇率、股票
- **文件操作工具**：让 AI 读写文件、处理数据
- **邮件发送工具**：让 AI 自动发邮件通知
- **代码执行工具**：让 AI 跑一段代码验证结果

官方教程里还有一个 `customer_service_agent.ipynb`，展示了如何组合多个工具构建一个客服 Agent。

"每个工具都是一个'手'。AI 有越多的手，就能做越多的事。"

但林远也意识到一个问题：现在还是他来决定什么时候用什么工具。真正的 Agent 应该能自己规划任务、调用工具、完成目标，而不是每次都等用户发指令。

Cookbooks 里有一个章节叫 `The Chief of Staff Agent`。林远点进去，看到了下一个方向——让 AI 真正"自主"起来。

## 从"动得了"到"能自主"

那天晚上，林远更新了他的开发日志：

> 第二项能力解锁：Tool Use。
>
> 以前查数据要写 SQL，现在说一句话就行。
>
> 但这还不够。AI 现在是被动的——我让它查，它才查。
>
> 真正的 AI 分身应该能主动规划。我给一个目标，它自己分解任务、调用工具、汇报结果。
>
> 这个能力，Cookbooks 里叫 Agent SDK。下一章要好好研究一下。

林远不知道的是，那个"自己调研竞品最新动态"的梦想，已经离他不远了。

---

## 代码参考

本文涉及的完整代码来自 Claude Cookbooks：https://github.com/anthropics/claude-cookbooks/

- `tool_use/calculator_tool.ipynb` - Tool Use 入门示例
- `tool_use/customer_service_agent.ipynb` - 多工具组合示例
- `capabilities/text_to_sql/guide.ipynb` - Text to SQL 完整指南

**下期预告**：输入"调研竞品最新动态"，AI 自动完成搜索、阅读、总结全流程。Agent SDK 让 AI 真正自主起来……

---

*本文属于「独立开发者的 AI 分身进化论」系列，记录一个独立开发者如何逐步解锁 Claude API 的各项能力。*

"小众清单"上线三个月，用户量突破了一万。林远每天都会收到各种反馈，其中最让他头疼的就是"数据不对"这类模糊报告。

让 AI 动手查数据——从自然语言到 SQL 的魔法

软件研发

编程语言

"小众清单"项目上线后，林远面临用户"数据不对"的困扰。通过Claude的ToolUse和TexttoSQL功能，他开发了自然语言查询工具，用户只需用中文提问就能获取数据。AI自动生成SQL并执行查询，大幅提升数据查询效率。文章还介绍了提升SQL生成准确性的技巧，如Few-shotPrompting和Chain-of-Thought。

文件系统

数据库

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

"小众清单"项目上线后，林远面临用户"数据不对"的困扰。通过Claude的ToolUse和TexttoSQL功能，他开发了自然语言查询工具，用户只需用中文提问就能获取数据。AI自动生成SQL并执行查询，大幅提升数据查询效率。文章还介绍了提升SQL生成准确性的技巧，如Few-shotPrompting和Chain-of-...

让 AI 动手查数据——从自然语言到 SQL 的魔法-腾讯云开发者社区-腾讯云

让 AI 动手查数据——从自然语言到 SQL 的魔法

让 AI 动手查数据——从自然语言到 SQL 的魔法

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐