KAT 概述

KaiwuDB Agent Tools（简称 KAT）是一款基于 MCPopen in new window（Model Context Protocol，模型上下文协议）协议的智能助手，专为 KaiwuDB 用户打造。它将自然语言处理与数据库深度结合，让用户通过简单的对话即可完成 KaiwuDB 的产品使用智能问答、自动化安装部署、自然语言查询分析、故障诊断和性能调优。通过借助 LLM（Large Language Model，大语言模型）智能提示能力、结合知识库和向量搜索技术，降低 KaiwuDB 的学习、使用和运维成本，提升数据交互效率，助力企业轻松驾驭数据洞察。

KAT 包括以下核心组件：

KWDB Agent UI
- KWDB Agent UI 是一个网页图形界面，为普通用户、DBA（Database Administrator，数据库管理员）提供文本输入输出以及 MCP Server、数据库、提示词、任务、通知等配置的图形化交互能力。
- 支持在用户输入过程中，根据当前应用的上下文（如所在页面、选中内容、对话历史等），实时地、智能地生成内容建议，供用户一键采纳，从而极大地提升交互效率和体验。
KWDB Agent Server
- KWDB Agent Server 以 RESTful API 的形式提供完整的 Agent 功能，将用户的自然语言请求转化为对 KaiwuDB 数据库的操作，使 LLM 模型能够通过 KWDB MCP Server 与 KaiwuDB 数据库交互。
- 支持通过 MCP 协议访问 KaiwuDB 知识库，为用户提供便捷、高效的 KaiwuDB 数据库智能问答服务，提升用户对 KaiwuDB 数据库的使用体验与工作效率。
- 支持意图分类，自动提取用户问题中的关键词并匹配与之最接近的内置系统提示词，进行问题的解析与回答，而无需用户预选提示词。
Task Manager
- 支持触发用户设置的定时任务。
- 支持 Webhook 通知。
CMD MCP Server
- 支持读取和筛选日志。
- 支持读取系统级资源占用情况。
KWDB MCP Server
- KWDB MCP Server 是一个基于 MCPopen in new window 协议的服务器实现，它通过 MCP 协议提供一套工具和资源，用于与 KaiwuDB 数据库交互和提供商业智能功能。
- 支持读取、写入、查询、修改数据以及执行 DDL 操作。

下图展示用户如何通过 KAT 与 KaiwuDB 知识库和数据库进行交互，完成 KaiwuDB 知识库检索、数据库连接与数据库读写、查询等操作。

功能特性

账户管理

KAT 使用 KaiwuDB 账户进行身份认证和权限管理，支持账户登录与登出功能。当使用已注册的 KaiwuDB 账户登录后，用户可以使用 KAT 的全部功能。退出后，用户无法进行任何提问或系统配置操作，需重新登录方可使用。

会话与消息管理

KAT 支持管理用户的会话。管理操作分为会话级操作和消息级操作。

说明

删除操作无法撤销，请谨慎执行。

会话级操作：会话级操作将整个对话作为一个整体进行管理。
- 重命名会话：为会话分配一个自定义名称，以便于识别和组织。
- 分享会话：将整个会话的文本内容复制到系统剪贴板。
- 删除会话：永久移除整个会话及其消息。
消息级操作：消息级操作允许用户对会话内的单条、多条或全部消息记录进行管理。
- 复制消息：将所选消息的文本内容复制到系统剪贴板。
- 编辑消息：（仅限单条消息）修改已发送的消息内容。修改后可重新提交以获得新回复。
- 分享消息：为一条或多条消息记录的文本内容复制到系统剪贴板。
- 删除消息：从当前会话中移除一条或多条消息记录。

KAT 配置导入导出

KAT 支持采用标准化 JSON 格式对 MCP Server 及提示词配置进行批量导入与导出，确保配置管理的效率与一致性。对于导入操作，任一配置项格式校验失败，则整个导入操作失败并报错，避免部分配置项生效。KAT 支持自动去重完全相同的配置，避免配置冗余。

说明

导入时，系统仅校验配置格式与字段完整性，不验证配置项的业务逻辑准确性。
如果待导入的提示词文件为空或者包含系统不支持的特殊符号，则系统导入失败并返回错误。
如果待导入的 MCP Server 配置文件为空或者格式错误，则系统导入失败并返回错误。

MCP Server 配置导入示例

{
  "mcpServers": {
    // StdIO 模式
    "kaiwudb-mcp": {
      "command": "./kwdb-mcp-server -t http -p 8080 \"postgres://test:KWdb%212022@192.168.122.7:26257?sslmode=require\"",
      "type": "stdio",
      "args": [],
      "env": {},
      "cwd": ""
    },
    // Streamable HTTP 模式
    "baidumap-mcp": {
      "url": "https://mcp.map.baidu.com/mcp?ak=BVmf7L7a9zWcInzIeUOkkfGoBCXeifsX",
      "headers":{},
      "type": "streamable_http",
      "timeout": 0,
      "sse_read_timeout": 0
    }
  }
}

提示词导入示例

{
  "创建关系表": {
    "content": " create table table_name",
    "role": "system",
    "version": "1.0",
    "author": "MHL"
  }
}

意图分类

KAT 具备智能意图分类能力，自动分析用户输入的自然语言问题。系统无需依赖用户预先指定的内置提示词，而是通过以下流程即可自动解析与应答问题：

实时识别用户问题的所属分类和语义角色。
自动提取问题中的关键信息与上下文特征。
智能匹配最相关的内置系统提示词。
基于匹配结果精准生成答案。

自动任务与通知

KAT 支持基于 CRON 表达式的定时任务的全生命周期管理。定时任务能定期触发 LLM 执行数据分析、数据预测或数据库巡检等操作，结果可保存本地或推送至 Webhook。Webhook 可在指定事件发生时自动向预设 URL 推送数据，失败后自动重试并记录日志告警，确保第三方应用可以正常接收数据。

# KAT 概述

# 功能特性

# 账户管理

# 会话与消息管理

# KAT 配置导入导出

# 意图分类

# 自动任务与通知