Qt-UI AgentKit - Qt 与 AI Agent 智能体开发包

产品概览

面向 Qt 应用的智能体开发与流程编排能力

Qt-UI AgentKit 为 Qt Widgets 应用提供模型接入、提示词编排、工具调用、结构化输出、记忆、RAG、状态工作流、人工审批和执行追踪能力，帮助桌面软件构建可控、可调试、可集成的 AI Agent。

查看文档

✓

提供 OpenAI-compatible、DeepSeek 等模型客户端、Mock 离线模型和统一模型配置界面。

✓

内置工具注册、函数工具调用、权限审批、执行 Trace 和结果展示控件。

✓

支持 Prompt Template、输出解析、对话记忆、RAG 检索和状态流程编排等 Agent 常用能力。

✓

提供 Qt Widgets 原生示例程序，可按能力模块独立验证并快速集成到桌面产品。

产品能力

AgentKit 能力模块组织的产品说明

AgentKit 围绕模型接入、提示词编排、工具调用、结构化输出、记忆、RAG 和状态工作流提供完整的智能体开发能力。

查看能力文档

核心能力概览

模型对话

支持 Mock 离线模型、OpenAI-compatible 接口与 DeepSeek 接口，演示普通对话、流式输出、停止生成和错误提示。

能力说明

通过统一的 ChatModel 抽象封装模型请求，业务侧只需要构造 ChatRequest 并监听 ChatReply 信号即可接收流式片段、完整结果和错误状态。

调用举例

ChatRequest request;
request.addSystemMessage("你是 Qt 应用助手。");
request.addUserMessage("分析当前设备状态。");

ChatReply* reply = model->chat(request, {}, this);
connect(reply, &ChatReply::deltaReceived, this, &Panel::appendText);
connect(reply, &ChatReply::finished, this, &Panel::finishText);

提示词与链式调用

提供 PromptTemplate、ChatPromptTemplate、Runnable Chain 和 Parallel 分支，方便把提示词、模型和解析器组合成业务流程。

能力说明

提示词模板负责变量替换，RunnableChain 负责把模板和模型串起来，适合把固定业务流程沉淀成可复用的调用单元。

调用举例

RunnableChain chain;
chain.setSystemPrompt("你是 Qt 架构顾问。");
chain.setPrompt(PromptTemplate("请分析 {topic} 的实现方案。"));
chain.setModel(model);

ChatReply* reply = chain.invoke({ { "topic", "工具调用审批" } }, this);

输出解析

内置 String、JSON 和结构化输出解析，适合把模型结果转换成可被 Qt 业务代码继续处理的数据。

能力说明

当模型需要返回结构化数据时，可以使用 JsonOutputParser 或 StructuredOutputParser 校验字段，把自然语言输出转换为 QJsonObject。

调用举例

QString error;
StructuredOutputParser parser({ "title", "risk", "action" });

QJsonObject data = parser.parse(modelText, &error);
if (!error.isEmpty()) {
    qWarning() << error;
}

记忆与 RAG

ChatMemory 保存多轮上下文，InMemoryRetriever 和 SimpleRagChain 演示本地文档检索增强回答。

能力说明

ChatMemory 用于维护多轮消息，SimpleRagChain 会先从本地文档中检索上下文，再把问题和上下文一起发送给模型。

调用举例

InMemoryRetriever retriever;
retriever.setDocuments({
    "AgentKit 支持工具调用、审批和 Trace。",
    "StateGraph 用于状态流程编排。"
});

SimpleRagChain rag;
rag.setRetriever(retriever);
rag.setModel(model);
ChatReply* reply = rag.ask("如何做流程编排？", 2, this);

工具调用与审批

工具注册、参数传入、执行 Trace 和权限审批形成完整闭环，写文件、外部访问等高风险操作会先请求确认。

能力说明

FunctionTool 可把本地 C++ 函数注册为工具，AgentExecutor 统一处理工具调用、Trace 记录和高权限操作审批。

调用举例

registry->registerTool(new FunctionTool(
    "query_device_status",
    "查询设备状态",
    schema,
    ToolPermission::ReadOnly,
    [](const QJsonObject& args) {
        return ToolResult{ true, {}, "设备状态正常" };
    },
    registry));

状态流程编排

StateGraph 支持节点、条件边、循环、Checkpoint 和人工 Review，适合构建可追踪的 Agent 工作流。

能力说明

StateGraph 使用 QJsonObject 作为状态载体，节点返回局部更新，普通边和条件边控制下一步执行位置。

调用举例

StateGraph graph;
graph.addNode("step", [](const QJsonObject& state) {
    return QJsonObject{ { "count", state.value("count").toInt() + 1 } };
});
graph.addEdge(StateGraph::start(), "step");
graph.addEdge("step", StateGraph::end());

GraphRunResult result = graph.invoke({ { "count", 0 } });

授权对比

Qt-UI AgentKit 版本对比

试用版仅用于评估、学习和原型验证，不提供源码，不支持商用；付费授权版本用于正式商用并提供对应源码包。下表为预置版本说明。

功能 / 版本	试用版免费	基础版（AgentKit）￥6,800	完整版￥12,800
适用说明	用于评估、学习和原型验证，不提供源码，不支持商用。	包含当前单产品完整源码，单项目商用，包含 1 年版本免费升级权益。	包含 Qt-UI 全系列 4 款产品完整源码，不限商用项目数量，包含 1 年版本免费升级权益。
授权用途	评估试用 / 原型验证 / 不支持商用	当前单产品 / 单项目商用	全系列 4 款产品 / 不限商用项目数量
源代码与资源	试用内容，不含源码	当前单产品完整源码包	全系列 4 款产品完整源码包
版本更新	不承诺更新	1 年版本免费升级权益	1 年版本免费升级权益
技术支持	试用反馈	邮件 + 工单支持	邮件 + 工单 + 优先支持