1. 本地 SQLite 数据怎么接上 AI 能力你手里大概率躺着几个.sqlite或.db文件爬虫抓下来的商品表、App 埋点日志、老项目导出的用户行为数据。它们有个共同点——用 Python 内置的sqlite3就能读不需要装任何第三方包。但读完数据之后呢想让它自动生成摘要、做字段清洗、按自然语言查询就得调用大模型 API。问题来了你电脑上可能同时装着三四个 AI 工具每个都要单独配 Key、单独改环境变量时间一长自己都记不清哪个 Key 对应哪个服务。这篇就解决这个具体场景用 Python 读取本地 SQLite 文件把查出来的数据通过 TaoToken 统一 Key 送进模型并且用一份config.toml把多工具的 Key 管理收拢到一处。适合谁适合手头有本地数据、又想少折腾配置的 Python 开发者。读完你能拿到三样东西一份可直接复制的config.toml骨架、一段能跑通的 SQLite 读取代码、一个验证 API 是否接通的请求动作。先说清楚 SQLite 的定位。它是文件型数据库一个.sqlite文件就是一个完整数据库里面可以有很多张表。Python 标准库自带sqlite3import sqlite3直接可用不用pip install。连接靠connect()执行 SQL 靠游标cursor。这些是基础但真正卡人的往往不是读数据而是读完之后怎么把数据顺畅地交给 AI以及怎么不让 Key 散落一地。下面按「先读库、再统一 Key、后验证」的顺序走。2. TaoToken 前置统一 Key 与 config.toml 骨架在写代码之前先把 Key 管理这件事定下来。TaoToken 的作用是给你一个统一的接入入口多个 AI 工具或模型调用可以共用同一套 Key 体系省得每个工具单独维护。你需要先去控制台拿一个 API Key地址是 https://taotoken.net/api Key 的创建入口在 https://taotoken.net/api-keys 。拿到之后不要硬编码进 Python 脚本而是写进config.toml。为什么用 TOML 而不是.env或 JSONTOML 支持分组、注释清晰、Python 3.11 有内置tomllib可以直接读老版本用tomli也轻量。下面这份骨架你可以直接复制把your_key_here换成自己的# config.toml # TaoToken 统一 Key 配置骨架 [taotoken] # 统一接入地址不要加多余路径 base_url https://taotoken.net/api # 在 https://taotoken.net/api-keys 创建后填入 api_key your_key_here # 默认调用的模型按需替换 default_model claude-sonnet-4-5 # 单次请求超时秒 timeout 60 [sqlite] # 本地数据库文件路径相对或绝对都行 db_path ./data/alfw.sqlite # 单次最多取多少行送去分析防止上下文爆炸 max_rows 50 [logging] level INFO这里有几个参数值得单独说。base_url固定指向 TaoToken 的 API 入口后面代码里拼接/v1/messages之类的路径时基于它。max_rows是我踩过坑之后加的SQLite 表动辄几万行全塞给模型既慢又贵先限制行数需要更多再分页。timeout给 60 秒本地网络波动时不至于直接失败。读取配置的代码很短Python 3.11 直接用tomllibimport tomllib with open(config.toml, rb) as f: cfg tomllib.load(f) base_url cfg[taotoken][base_url] api_key cfg[taotoken][api_key] db_path cfg[sqlite][db_path]如果你用的是 3.10 或更早pip install tomli然后把import tomllib换成import tomli as tomllib其余不变。这一步做完Key 就不再散落在各个脚本里了。3. 可复制配置读取 SQLite 并组装请求现在进入核心部分。先读 SQLite把数据整理成模型能吃的格式再拼请求。读取这块sqlite_master是理解数据库结构的钥匙——它本身是一张系统表记录了所有表的名字和建表语句。想看库里有哪些表import sqlite3 mydb sqlite3.connect(db_path) cursor mydb.cursor() cursor.execute(SELECT name FROM sqlite_master WHERE typetable;) tables cursor.fetchall() print(tables)输出类似[(Faces,), (FacePose,), (FaceImages,)]。拿到表名后看某张表的字段结构用PRAGMA table_infocursor.execute(PRAGMA table_info(Faces)) columns cursor.fetchall() # 每行格式(cid, name, type, notnull, dflt_value, pk) for col in columns: print(col[1], col[2])PRAGMA table_info返回的六元组里第二个是字段名第三个是类型。这一步很关键因为你要根据字段名决定把哪些列送去分析。接下来取数据并转成文本def fetch_rows(cursor, table, limit): cursor.execute(fSELECT * FROM {table} LIMIT ?, (limit,)) rows cursor.fetchall() col_names [d[0] for d in cursor.description] lines [ | .join(col_names)] for r in rows: lines.append( | .join(str(v) for v in r)) return \n.join(lines) data_text fetch_rows(cursor, Faces, cfg[sqlite][max_rows])注意LIMIT ?用了参数化占位符table名因为不能参数化实际项目里要做白名单校验别直接拼用户输入。组装好文本后拼 API 请求。TaoToken 的接口兼容主流消息格式用requests发 POSTimport requests url f{base_url}/v1/messages headers { x-api-key: api_key, anthropic-version: 2023-06-01, content-type: application/json, } payload { model: cfg[taotoken][default_model], max_tokens: 1024, messages: [ {role: user, content: f下面是 SQLite 表数据请总结字段含义\n{data_text}} ], } resp requests.post(url, headersheaders, jsonpayload, timeoutcfg[taotoken][timeout]) print(resp.status_code) print(resp.json())x-api-key头带上统一 Keyanthropic-version是接口版本标识。如果你调的是其他模型系列头部字段可能不同以接入文档为准https://taotoken.net/doc 。把这段和前面的读取代码拼起来就是一条完整的「本地数据 → AI」链路。4. 验证请求跑通并确认结果配置写完别急着高兴先做一次最小验证。建议分两步先确认 SQLite 读得对再确认 API 通。第一步单独跑读取逻辑打印表名和前几行print(tables:, tables) print(sample:, data_text[:300])如果tables是空列表说明db_path指错了文件或者文件里确实没表。如果data_text只有表头没有数据行检查max_rows是不是被设成了 0。第二步发一次真实请求看返回结构。成功的响应里通常有content字段里面是模型生成的文本。你可以这样提取result resp.json() if resp.status_code 200: for block in result.get(content, []): if block.get(type) text: print(block[text]) else: print(failed:, result)实测下来第一次跑通时最直观的成功信号是终端打印出模型对Faces表字段的自然语言解释比如「face_id 是主键file_id 关联文件db_id 标识来源库」。这说明数据从 SQLite 出来、经过统一 Key、到达模型、再返回整条链路是通的。如果返回 401多半是 Key 没填对或没生效返回 404检查base_url后面拼的路径是不是多了或少了斜杠。验证通过后你可以把这段逻辑封装成函数换张表、换个提示词就能复用。想直接在网页上试模型效果、不写代码可以用模型对话入口https://taotoken.net/models 。5. 本篇常见错排查跑不通的时候按下面这几类对号入座基本能覆盖九成问题。Key 相关401 Unauthorized最常见。先确认config.toml里的api_key没有多余空格或引号嵌套错误。TOML 里字符串用双引号别写成api_key your_key_here没引号会被当变量。另外确认 Key 是在 https://taotoken.net/api-keys 创建且未过期。路径相关sqlite3.OperationalError: unable to open database file。这是db_path的问题相对路径是相对于你运行脚本的目录不是脚本所在目录。稳妥做法是用pathlib拼绝对路径from pathlib import Path db_path Path(__file__).parent / data / alfw.sqlite表名相关no such table: Faces。表名大小写敏感先用sqlite_master查出来的真实名字为准。另外sqlite_sequence、sqlite_stat1这类是系统表别拿去分析。请求相关requests.exceptions.Timeout。本地数据量大时组装data_text可能很慢或者模型响应超时。先把max_rows调小到 10 试再逐步加。content-type写成application/json别漏。编码相关SQLite 里如果有中文str(v)转换一般没问题但写文件时记得encodingutf-8。请求体里json参数会自动处理编码不用手动encode。依赖相关ModuleNotFoundError: No module named tomllib。Python 版本低于 3.11装tomli并改导入名。requests没装就pip install requests。把报错信息和上面几类对照多数情况五分钟内能定位。如果涉及接口字段或鉴权细节直接查接入文档更准https://taotoken.net/doc 。6. 长期编码与 Agent 场景的接入选择如果你只是偶尔跑一次本地数据分析上面这套「读 SQLite 统一 Key 单次请求」就够了。但如果你在写一个长期维护的编码助手、或者要接 Agent 做多轮工具调用Key 和配置的管理方式就得再上一层。这时候可以看 Coding Planhttps://taotoken.net/coding-plan 。它面向的是持续性的编码与 Agent 场景配置骨架和本篇的config.toml思路一致只是把调用频次、模型切换、上下文管理这些长期需求考虑进去了。回到本篇的核心config.toml骨架解决的是「Key 不散落」SQLite 读取解决的是「本地数据能出来」验证请求解决的是「链路真的通」。三件事拆开都不难难的是把它们串成一条不返工的流程。我的建议是先把config.toml建好再写读取函数最后加请求——顺序别反反了容易在调试时把配置问题和代码问题混在一起。等你把Faces表跑通换成自己的数据表只是改个表名的事。