腾讯混元大模型本身不支持数据库直连，需通过自建HTTP服务作为工具函数，配合tool calling机制实现查库功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让腾讯混元智能体直接连接并查询 MySQL 数据库，而不是靠人工写 SQL 再粘贴执行。这要求智能体具备数据库连接能力、SQL 生成与安全校验、结果结构化返回三重能力。
确认混元是否支持数据库直连
腾讯混元大模型本身是纯文本推理模型，【不自带数据库驱动或连接能力】。它无法像本地 Python 脚本那样直接 import pymysql 或 execute SELECT。所谓“智能体查数据库”，实际是通过「混元 + 外部工具调用（Tool Calling）」实现的——必须由你部署一个带数据库访问权限的服务端代理，再将该服务注册为混元可调用的 function tool。
截至2026年10月，腾讯云官方未开放开箱即用的数据库直连智能体模板。你必须自行构建工具函数，并在调用时显式启用 enable_tool_calls 参数。
搭建可查库的混元智能体（三步走）
第一步：准备数据库访问服务
在你的服务器（如 CVM）上部署一个轻量 HTTP 接口，例如用 Flask 写一个 /query-db 端点。它接收 JSON 请求体中的 SQL（经白名单校验），连接预设的 MySQL 实例，返回 JSON 格式结果。注意：该服务必须配置好白名单 IP、最小权限账号（只读账号）、SQL 关键词过滤（禁用 DROP/DELETE/UPDATE 等非查询语句）。
第二步：定义 tool schema 并注册到混元
在调用混元 /chat/completions 接口时，在请求体中传入 tools 字段，声明你刚才部署的服务：
{"type": "function", "function": {"name": "query_mysql", "description": "查询指定MySQL数据库，仅支持SELECT语句", "parameters": {"type": "object", "properties": {"sql": {"type": "string", "description": "纯SELECT语句，不含分号，字段名和表名必须小写"}, "db_name": {"type": "string", "enum": ["activity_db", "user_profile"]}}, "required": ["sql", "db_name"]}}}
第三步：发起带 tool call 的对话请求
向混元发送用户问题（如“查一下今天签到人数”），并在请求头中设置 enable_tool_calls=true；混元会判断是否需要调用 query_mysql 工具，若需调用，则返回 tool_calls 字段，含参数 sql="SELECT COUNT(*) FROM user_task WHERE task_type='sign_in' AND DATE(create_time)=CURDATE()" 和 db_name="activity_db"；你捕获该响应后，立即用参数调用你自己的 /query-db 接口，拿到结果再拼回 conversation 发送给混元做最终总结。
替代方案：用混元生成 SQL 后人工执行
方法一：纯提示词引导生成可执行 SQL
在混元聊天框中输入：“你是资深 MySQL DBA，当前数据库有表 user_log（字段：id, uid, action, time），表 game_info（字段：gid, name, category）。请根据我的自然语言需求，只输出标准 SELECT 语句，不要解释、不要注释、不要用```包裹。”
方法二：用 RAG 增强上下文准确性
提前将数据库表结构（CREATE TABLE 语句）、字段含义说明、常用业务口径整理成 Markdown 文档，上传至腾讯云向量数据库；调用混元前，先检索相关表结构片段，拼进 system prompt，显著降低“把 user_id 写成 uid”这类低级错误概率。
注意：此方案下混元不接触真实数据，所有 SQL 必须由你审核后再执行。
验证智能体是否真能查库
① 向混元提问：“列出 activity_db 库中所有以 ‘log_’ 开头的表名”
② 观察返回内容：若直接给出表名列表（如 log_click、log_share），说明已成功接入 tool 并完成闭环；若返回“我无法访问数据库，请联系管理员”，说明 tool 未注册或 enable_tool_calls 未开启；若返回一段 SELECT table_name FROM information_schema.tables WHERE table_schema='activity_db' AND table_name LIKE 'log_%'，说明停留在 SQL 生成阶段，尚未打通执行链路。
这一步必须实测，不能仅看文档描述。
