@niuhuoshan/dsh-connect

典型使用案例

数据库问答

销售团队接入一个只读的 MySQL 数据源，扫描并完成 AI 语义识别后，用户可以直接提问：

华东区域本月每天的订单量和销售金额是多少？

Agent 会先从表名、字段业务名称和描述中找到相关 profile，再调用只读查询工具。数据库账号本身仍应只授予业务需要的读取权限，插件不会绕过数据库权限。

固定业务 API

管理员配置一个天气、物流或内部工单 API，声明固定的 URL、路径参数和认证方式后，用户可以说：

查询上海的物流轨迹，单号是 SF123456。

Agent 只能调用已经注册的 API 工具和已声明的参数，响应可通过 JSON Pointer 裁剪为业务需要的字段。

数据库结构变化

源库新增字段、删除表或修改字段注释后，再次执行默认的增量扫描。dsh-connect 会比较 fingerprint，只重建变化对象；扫描成功后清理已经不存在的旧对象，未变化的语义描述和人工编辑内容继续保留。若扫描中途停止，已完成对象保留，旧对象不会被提前删除。

在设置页面配置

进入 设置 -> DSH连接器 -> HTTP API -> 添加 API，填写：

• 名称、工具标识（slug）和用途描述；
• HTTP 方法：GET、POST、PUT、PATCH 或 DELETE；
• 基础 URL 和路径模板；路径参数使用 {name}；
• 参数位置：path、query、header、body；
• 参数类型：string、number、integer、boolean、json；
• 认证方式：无认证、Bearer Token、API Key 或 Basic Auth；
• 超时（1,000120,000 毫秒）、最大响应大小（1 KiB2 MiB）和可选 JSON Pointer；
• 是否允许访问私有网络、是否启用为 Agent 工具。

基础 URL 不应包含 query string；query 参数应声明在参数列表中。响应为 JSON 时，可使用 RFC 6901 JSON Pointer（例如 /data/items）只提取需要的部分。设置页提供 测试请求，测试错误会留在当前弹窗中。

配置示例

下面的定义会注册 dsh_connect_api_weather：

名称：上海天气
工具标识：weather
描述：查询指定城市当前天气，返回温度和天气状况
方法：GET
基础 URL：https://api.example.com
路径模板：/v1/weather/{city}
参数：city / path / string / 必填
参数：units / query / string / 可选
JSON Pointer：/data
认证：无

配置完成并启用后，在聊天中可以直接说：

查一下上海今天的天气。

Agent 会根据 API 描述填充 city=上海 并调用固定工具。模型不能临时修改基础域名、HTTP 方法、路径模板或声明之外的参数。