qoderwake数字分析师已支持自然语言转sql，含五种安全路径：一、绑定只读数据库连接；二、query console快捷键触发；三、slash命令批量生成；四、ask模式嵌入@database上下文；五、agents.md配置视图白名单与字段屏蔽。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在QoderWake中担任数字分析师角色，并希望将自然语言描述直接转化为可执行的SQL语句以支撑数据查询与报表制作，则该能力已在受控权限下正式启用。以下是该场景下的具体操作路径：
一、绑定只读数据库连接
此步骤确保QoderWake仅能访问授权Schema内的表结构与元数据，杜绝写操作风险，是所有SQL生成行为的安全前提。
1、登录QoderWake控制台，选择已部署的「数字分析师」实例。
2、点击「工作空间设置」→「数据源管理」→「绑定数据库连接」。
3、从下拉列表中选择已在JetBrains或DataGrip中成功测试的数据库连接项。
4、确认勾选启用只读查询模式及禁用DDL/DML执行权限。
二、Query Console中快捷键触发自然语言转SQL
该方式复用Qoder IDE底层Query Console集成能力，AI模型基于当前Schema实时生成合规SQL，所有输出均经权限沙盒拦截验证。
1、在QoderWake界面中打开目标数据库对应的Query Console标签页。
2、将光标置于编辑区，按下快捷键Ctrl + Shift + I（Windows/Linux）或Cmd + Shift + I（macOS）。
3、输入自然语言描述，例如：“列出近30天订单金额大于5000元的客户姓名与下单次数”。
4、按Enter后，QoderWake返回SQL代码块，并在右下角显示“已通过只读策略校验”提示。
三、Slash命令批量生成分析SQL
该方式适用于固定口径报表或周期性分析任务，绕过对话上下文，直接调用预注册的结构化SQL生成流程，保障输出一致性与可复现性。
1、进入QoderWake「命令中心」→「新建命令」。
2、填写名称为/sales_analyze，Prompt字段输入：Generate read-only SQL for sales analysis based on current database schema. Never use INSERT, UPDATE, DELETE, DROP or CREATE.
3、保存后，在任意对话输入框中键入/sales_analyze 用户地域分布与客单价中位数。
4、QoderWake立即返回符合ANSI SQL标准的SELECT语句，并附带字段注释说明。
四、Ask模式嵌入@database上下文
此方法显式注入数据库Schema信息，使QoderWake精准理解表名、字段类型、主外键关系及约束条件，避免因上下文缺失导致的语义错误或无效JOIN。
1、在QoderWake侧边栏输入框右侧点击Add Context按钮。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、从弹出菜单中选择@database选项。
3、在Schema列表中勾选目标数据库（支持多Schema并行加载）。
4、输入自然语言请求，例如：“列出所有订单金额大于5000且状态为已发货的用户邮箱”。
5、QoderWake将自动生成含完整JOIN和WHERE条件的SQL，并附带Execute按钮。
五、AGENTS.md配置视图白名单与字段屏蔽
该机制通过声明式配置限定AI可感知的数据边界，防止敏感字段被无意暴露或参与逻辑推导，满足企业级数据治理与最小权限原则。
1、在QoderWake工作空间根目录下创建或编辑AGENTS.md文件。
2、添加如下YAML区块：
```yaml
database:
whitelist_views: [sales_summary, user_active_stats]
masked_columns:
- table: users
columns: [id_card, phone]
- table: orders
columns: [payment_account]
```
3、保存后，重启数字分析师Agent实例，新策略即刻生效。
4、后续所有SQL生成请求将自动过滤未列入白名单的视图，并对指定列执行字段级脱敏屏蔽处理。
