在很多 Qt 桌面软件中，数据并不在大模型手里，而是在本地进程、业务对象、数据库、设备采集模块或 Qt Model 中。用户真正想要的也不是“模型回答一段泛泛而谈的文字”，而是让 AI 能看懂当前软件里的数据，然后执行查询、分析、汇总、导出等动作。

这就是 Agent 能力比普通聊天机器人更有价值的地方：大模型负责理解自然语言和规划动作，Qt 程序负责提供真实数据和可控函数。二者通过 tool calling 连接起来，AI 才能真正和桌面应用里的数据发生交互。

本文如何用 Qt-UI AgentKit 把 Qt/C++ 函数注册为工具，让大模型完成“查询异常设备、生成告警摘要、导出报告”这样的业务流程。

这个流程可以回答知识类问题，但它不知道 Qt 程序里的实时数据。例如用户问：

如果只是普通聊天，大模型并不知道有哪些设备、哪些设备异常、报告应该保存在哪里。它只能猜。

这样 AI 不是“凭空回答”，而是通过 Qt 函数读取业务状态。

 中，内置一组设备状态数据：

_devices = {
    { "Pump-001", "主冷却泵", "正常", 53.2, 0.18, "" },
    { "Pump-002", "备用冷却泵", "预警", 74.5, 0.42, "温度持续升高" },
    { "Valve-014", "蒸汽阀门", "严重", 88.1, 0.66, "压力波动" },
    { "Fan-008", "排风机", "正常", 42.0, 0.12, "" },
    { "Motor-021", "输送电机", "预警", 69.3, 0.39, "振动超过阈值" }
};


这些数据在 Qt 程序内存中，不在模型上下文里。模型如果要知道异常设备，就必须调用 Qt 提供的函数。

用户输入“查找异常设备并导出报告”后，可以看到模型调用了哪些工具、工具是否成功、是否触发审批、耗时和输出结果。

三、把 Qt 函数注册成 Agent 工具

_toolRegistry->registerTool(new UIGQtLib::QtAgent::FunctionTool(
    "find_abnormal_devices",
    "查找预警或严重状态的演示设备。",
    objectSchema({}),
    UIGQtLib::QtAgent::ToolPermission::ReadOnly,
    [this](const QJsonObject& args) { return findAbnormalDevices(args); },
    _toolRegistry));


[this](const QJsonObject& args) { return findAbnormalDevices(args); }


它把大模型提出的 tool call 映射到了 Qt/C++ 成员函数。模型不直接访问 

，也不能随便执行代码，它只能调用你明确注册出来的工具。

 是一个普通 Qt/C++ 函数。它遍历设备列表，把状态不是“正常”的设备返回给 Agent。

UIGQtLib::QtAgent::ToolResult AgentKitDemoWindow::findAbnormalDevices(const QJsonObject& args) const
{
    Q_UNUSED(args);

    QJsonArray array;
    QStringList ids;

    for (const Device& device : _devices)
    {
        if (device.status != "正常")
        {
            array.append(QJsonObject{
                { "id", device.id },
                { "status", device.status },
                { "alarm", device.alarm }
            });
            ids << device.id;
        }
    }

    return {
        true,
        QJsonObject{ { "devices", array } },
        QStringLiteral("异常设备：%1").arg(ids.join(", "))
    };
}


 同时返回结构化数据和可读文本：

这种设计的好处是：Qt 程序仍然掌握数据来源和执行边界，大模型只负责选择工具和组织结果。

如果工具需要参数，可以通过 schema 告诉模型参数结构。例如按设备 ID 查询：

_toolRegistry->registerTool(new UIGQtLib::QtAgent::FunctionTool(
    "query_device_status",
    "按 deviceId 查询单个演示设备状态。",
    objectSchema({
        {
            "deviceId",
            QJsonObject{
                { "type", "string" },
                { "description", "设备 id，例如 Pump-001" }
            }
        }
    }, { "deviceId" }),
    UIGQtLib::QtAgent::ToolPermission::ReadOnly,
    [this](const QJsonObject& args) { return queryDeviceStatus(args); },
    _toolRegistry));


模型看到这个 schema 后，就知道需要生成类似这样的参数：

const QString id = args.value("deviceId").toString();


这让自然语言和强类型业务函数之间有了一个稳定的桥。

六、AgentExecutor 如何串起模型和工具

Demo 中设备分析不是手写关键词判断，而是通过通用 

_deviceExecutor = new UIGQtLib::QtAgent::AgentExecutor(this);
_deviceExecutor->setToolRegistry(_toolRegistry);
_deviceExecutor->setSystemPrompt(QStringLiteral(
    "你是设备状态分析助手。用户要求查找异常设备、生成告警摘要或导出报告时，应优先使用可用工具完成任务。需要导出报告时调用 export_report。"
));


void AgentKitDemoWindow::sendDeviceMessage(const QString& text)
{
    _traceView->clearTraces();
    _deviceChat->appendUserMessage(text);
    _deviceChat->beginAssistantMessage();
    _deviceChat->setRunning(true);
    _deviceExecutor->run(text);
}


这个执行器是通用的，不绑定设备 Demo。你可以把工具换成订单查询、数据库检索、CAD 对象分析、PLC 状态读取、日志分析，流程仍然成立。

Agent 做业务系统时，最怕“模型偷偷做了什么”。AgentKit Demo 的底部 Trace 表会显示每次工具调用：

connect(_deviceExecutor,
        &UIGQtLib::QtAgent::AgentExecutor::traceAdded,
        _traceView,
        &UIGQtLib::QtAgent::ToolCallTraceView::addTrace);


有了 Trace，Agent 的执行过程就不是一个黑盒。开发者可以看到模型是否选择了正确工具、参数是否合理、工具返回了什么数据。

_toolRegistry->registerTool(new UIGQtLib::QtAgent::FunctionTool(
    "export_report",
    "将演示报告导出到系统临时目录。",
    objectSchema({
        {
            "fileName",
            QJsonObject{
                { "type", "string" },
                { "description", "输出文件名" }
            }
        }
    }),
    UIGQtLib::QtAgent::ToolPermission::FileSystem,
    [this](const QJsonObject& args) { return exportReport(args); },
    _toolRegistry));


 权限默认需要用户确认。Demo 中审批弹窗连接如下：

connect(_deviceExecutor,
        &UIGQtLib::QtAgent::AgentExecutor::approvalRequired,
        this,
        [this](const UIGQtLib::QtAgent::ApprovalRequest& request) {
            const bool allowed = UIGQtLib::QtAgent::ApprovalDialog::ask(request, this);
            _deviceExecutor->resolveApproval(request.id, allowed);
        });


这样模型可以提出“导出报告”的意图，但真正写文件前必须经过用户允许。对于桌面软件来说，这是 Agent 落地的关键边界：AI 可以建议和发起动作，但高风险动作要可审计、可拒绝。

这时大模型的回答不是凭空生成的，而是来自 Qt 程序真实函数返回的数据。

把 Demo 换成真实业务系统时，可以按这个思路扩展：

_toolRegistry->registerTool(new UIGQtLib::QtAgent::FunctionTool(
    "query_order_status",
    "根据订单号查询订单状态。",
    objectSchema({
        {
            "orderNo",
            QJsonObject{
                { "type", "string" },
                { "description", "订单号" }
            }
        }
    }, { "orderNo" }),
    UIGQtLib::QtAgent::ToolPermission::ReadOnly,
    [this](const QJsonObject& args) {
        return queryOrderStatus(args.value("orderNo").toString());
    },
    _toolRegistry));


建议先从只读工具开始，例如查询状态、检索数据、生成摘要。涉及写文件、执行命令、修改数据库、调用外部网络时，要使用更高权限并引入审批。

十一、设计 Agent 工具的几个原则

工具名会被模型引用，尽量使用清晰的英文 snake_case，例如：

find_abnormal_devices
query_device_status
generate_alarm_summary
export_report


工具说明不是给开发者看的注释，而是给模型看的能力说明。它应该告诉模型“什么时候该调用这个工具”。

参数越清楚，模型越不容易传错。例如 

4. 返回值同时给结构化数据和文本摘要

结构化 JSON 方便模型继续推理，文本摘要方便 Trace 和最终回答使用。

文件系统、系统命令、写数据库、外部网络请求都不应该静默执行。

Qt Agent 的核心不是让大模型替代 Qt 程序，而是让大模型调用 Qt 程序已经具备的能力。

在这个 Demo 中，模型不会直接访问设备列表，也不会直接写文件。它只能通过开发者注册的工具完成动作：

这种架构让 AI 与数据交互变得可控、可观察、可扩展。对于 Qt 桌面产品来说，它可以把传统按钮和表格之外的交互升级为自然语言驱动的业务操作，同时保留工程软件所需要的边界感和可靠性。

Qt Agent 智能体让大模型调用Qt的函数，实现Ai与数据的交互

人工智能

编程语言

开发工具

Qt-UIAgentKit实现AI与Qt应用数据交互，通过注册C++函数为工具，让大模型执行查询、分析、导出等业务操作。支持设备状态查询、告警摘要生成、报告导出等功能，确保数据安全可控，提供完整工具调用追踪。开源项目地址：https://gitee.com/qt-ui/AgentKit

聊天机器人

结构化数据

日志分析

日志文件

文件系统

数据库

Agent

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Qt Agent 智能体让大模型调用Qt的函数，实现Ai与数据的交互

Qt Agent 智能体让大模型调用Qt的函数，实现Ai与数据的交互

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐