lzwcai-mcp-server-package/.kilo/skills/数字员工平台数据库技能的.md

数字员工平台数据库技能配置指南

概述

本文档介绍两种使用数字员工平台数据库技能的方法：

• 方法一：通过数字员工对话直接使用
• 方法二：通过 AI 编辑器的 Skills + MCP 搭配使用

---

方法一：通过数字员工对话使用

配置说明

此方法通过配置 MCP Server 来连接数字员工平台。

MCP 配置示例

{
  "mcpServers": {
    "lzwcai-mcp-agile-db": {
      "command": "uvx",
      "type": "stdio",
      "args": [
        "lzwcai-mcp-agile-db"
      ],
      "timeout": 600,
      "env": {
        "API_KEY": "eyJhbGciOiJIUzUxMiJ9.eyJ0b2tlbl90eXBlIjoiTE9HSU4iLCJsb2dpbl91c2VyX2tleSI6IjljMDllMjZhLWFkNzgtNGNmMi05YzQ5LWQzY2Y5NjI5MGRjYyJ9.v5ZffkvM2CnMkoWqc-Xy-0gN2oLBjyfJlm_YnCE6TWBwfKVmpuakoRXFMTiHQG8LOphv7JlEmZHcYpzwM52D0Q"
      }
    }
  }
}

注意事项

• 配置中的 API_KEY 是数字员工平台的密钥
• 存在单点登录问题，请使用不会过期的账号密钥
• Skills 配置参考：lzwcai-agile-db

---

方法二：通过 AI 编辑器使用

配置说明

此方法通过下载 Skills 和 MCP 配置，在 AI 编辑器中搭配使用，支持直接对话操作。

MCP 配置示例

{
  "mcpServers": {
    "lzwcai_mcp_agile_db": {
      "command": "uvx",
      "args": [
        "lzwcai-mcp-agile-db"
      ],
      "env": {
        "UV_INDEX_URL": "http://192.168.2.236:3141/lzwc/dev/+simple/",
        "API_KEY": "eyJhbGciOiJIUzUxMiJ9.eyJ0b2tlbl90eXBlIjoiTE9HSU4iLCJsb2dpbl91c2VyX2tleSI6IjljMDllMjZhLWFkNzgtNGNmMi05YzQ5LWQzY2Y5NjI5MGRjYyJ9.v5ZffkvM2CnMkoWqc-Xy-0gN2oLBjyfJlm_YnCE6TWBwfKVmpuakoRXFMTiHQG8LOphv7JlEmZHcYpzwM52D0Q",
        "backendBaseUrl": "http://192.168.2.236:8088"
      }
    }
  }
}

环境变量说明

变量名	说明	示例值
UV_INDEX_URL	Python 包索引地址	http://192.168.2.236:3141/lzwc/dev/+simple/
API_KEY	数字员工平台 API 密钥	(见配置示例)
backendBaseUrl	后端服务基础地址	http://192.168.2.236:8088

---

使用建议

1. 选择方法：根据实际使用场景选择合适的方法

   • 数字员工对话：适合快速使用
   • AI 编辑器：适合更灵活的配置和使用

2. 密钥管理：妥善保管 API_KEY，避免泄露

3. 网络配置：确保网络可以访问配置的后端地址

---

相关资源

• Skills 目录：lzwcai-agile-db/
• 详细技能文档：lzwcai-agile-db/SKILL.md

---

对话使用场景示例

以下是配置好技能后，您可以直接使用的对话示例：

📊 场景 1：浏览数据源和表

用户： "帮我看看有哪些数据源"

AI 回复：

共找到 3 个数据源：
1. HMD产品（PostgreSQL, 运行中）
2. 测试数据库（MySQL, 运行中）
3. 历史数据（Oracle, 已停止）

请告诉我您想看哪个数据源？

---

用户： "看看HMD产品有哪些表"

AI 回复：

HMD产品 数据源包含以下数据库和表：

order_db:
  - orders (订单表, 15 个字段, 2568 条记录)
  - users (用户表, 8 个字段, 156 条记录)
  - products (商品表, 12 个字段, 892 条记录)

analytics_db:
  - daily_stats (日报表, 10 个字段, 365 条记录)

---

🔍 场景 2：查询表数据

用户： "查一下users表前10条数据"

AI 回复：

users 表共 156 条记录，当前显示第 1-10 条：

| id | username | email           | status | created_at          |
|----|----------|-----------------|--------|---------------------|
| 1  | admin    | admin@test.com  | active | 2024-01-01 00:00:00 |
| 2  | user1    | user1@test.com  | active | 2024-01-02 10:30:00 |
| 3  | user2    | user2@test.com  | inactive| 2024-01-03 15:45:00 |
...

注：默认查询测试环境，如需查询生产环境请说明。

---

📝 场景 3：执行 SQL 查询

用户： "统计每个地区的订单数量"

AI 回复：

各地区订单统计：

| 地区 | 订单数 |
|------|--------|
| 华东 | 1,250  |
| 华南 | 980    |
| 华北 | 756    |
| 西南 | 432    |
| 东北 | 289    |

---

➕ 场景 4：插入数据

用户： "新增一个用户，用户名是test_user，邮箱test@test.com"

AI 回复：

即将向 users 表插入以下数据：
  username = test_user
  email = test@test.com
  （id 自动生成）

确认插入吗？

用户： "确认"

AI 回复：

✅ 已成功插入用户 test_user (ID: 157)

---

✏️ 场景 5：更新数据

用户： "把ID为5的用户邮箱改成new@test.com"

AI 回复：

即将更新 users 表 ID=5 的记录：
  email: old@test.com → new@test.com

确认更新吗？

用户： "确认"

AI 回复：

✅ 已更新用户 ID=5 的邮箱为 new@test.com

---

🗑️ 场景 6：删除数据

用户： "删除ID为10的订单"

AI 回复：

⚠️ 安全提醒：此操作存在删除风险。
具体说明：数据将永久删除，不可恢复。

确认要删除以下记录吗？
  订单 ID=10, 订单号=ORD-2024-0010, 金额=¥1,250.00

请回复"确认删除"继续。

用户： "确认删除"

AI 回复：

✅ 已成功删除订单 ID=10

---

🤖 场景 7：AI 生成表结构

用户： "帮我设计一个商品表，包含名称、价格、库存、分类"

AI 回复：

AI 已生成表结构设计：

表名: products (商品表)
字段:
  - id (SERIAL, 主键) - 主键ID
  - name (VARCHAR(200), 非空) - 商品名称
  - price (DECIMAL(10,2)) - 价格
  - stock (INTEGER) - 库存数量
  - category (VARCHAR(50)) - 分类
  - created_at (TIMESTAMP) - 创建时间

是否需要在此基础上修改或直接创建？

用户： "直接创建到order_db数据库"

AI 回复：

✅ 已成功创建表 products (商品表)

---

📥 场景 8：导入 Excel 数据

用户： "帮我导入这个Excel文件：https://example.com/data.xlsx"

AI 回复：

AI 已识别 Excel 文件内容：

表名: customers (客户表)
字段:
  - id (SERIAL, 主键)
  - name (VARCHAR(100)) - 客户名称
  - phone (VARCHAR(20)) - 电话
  - address (TEXT) - 地址

预览数据（前3条）：
| id | name   | phone      | address        |
|----|--------|------------|----------------|
| 1  | 张三   | 13800138000| 北京市朝阳区   |
| 2  | 李四   | 13900139000| 上海市浦东新区 |
| 3  | 王五   | 13700137000| 广州市天河区   |

共 50 条数据待导入。

⚠️ 安全提醒：此操作可能涉及数据安全风险。
说明：导入的数据将写入数据库，请确认数据来源合法合规。
请确认是否继续？

用户： "继续"

AI 回复：

✅ 成功导入 50 条数据到 customers 表

---

🔑 场景 9：API 密钥管理

用户： "帮我创建一个新的API密钥"

AI 回复：

请输入密钥名称：

用户： "测试密钥"

AI 回复：

✅ 已创建 API 密钥：
名称: 测试密钥
密钥: lzwc_sk_xxxxxxxxxxxx
状态: 启用
过期时间: 2025-06-18

请妥善保管密钥，丢失后无法找回。

---

⚠️ 重要使用提示

1. 环境选择： 默认使用测试环境（test），操作生产环境需要明确说明"查询生产环境"或"操作生产环境"

2. 安全确认： 所有写操作（增删改）都会先预览并等待您的确认

3. 多选原则： 有多个数据源/数据库/表可选时，AI会列出让您选择，不会擅自做主

4. 分步执行： 复杂任务会分步完成，每一步都会确认后再继续