能力总览

AgentKit 能力模块

Qt-UI AgentKit 的接口位于命名空间 UIGQtLib::QtAgent。建议业务代码统一引入聚合头文件:

#include "QtAgentKit.h"

本章按 AgentKit 的能力模块说明 SDK 的核心类、接口方法、参数、返回值和常见调用示例。

类关系概览

ChatModel
  ├─ MockChatModel
  ├─ OpenAICompatibleModel
  └─ DeepSeekModel

AgentTool
  └─ FunctionTool

ToolRegistry
AgentExecutor

PromptTemplate
ChatPromptTemplate
RunnableChain
RunnableParallel

StringOutputParser
JsonOutputParser
StructuredOutputParser

ChatMemory
InMemoryRetriever
SimpleRagChain

StateGraph
MemoryCheckpointer

AgentChatPanel
ModelConfigWidget
ToolCallTraceView
ApprovalDialog

选型建议

场景 推荐模块
只需要普通 AI 对话 ChatRequest + OpenAICompatibleModelDeepSeekModel
需要在 UI 中显示流式输出 ChatReply + AgentChatPanel
需要模型调用本地业务函数 ToolRegistry + FunctionTool + AgentExecutor
需要高风险操作确认 ToolPermission + ApprovalDialog
需要知识库问答 InMemoryRetriever + SimpleRagChain
需要多步骤可追踪流程 StateGraph + GraphTrace
需要保存流程状态 MemoryCheckpointer
需要快速验证产品能力 MockChatModel + 示例页面