Capabilities Overview
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 + OpenAICompatibleModel 或 DeepSeekModel |
| 需要在 UI 中显示流式输出 | ChatReply + AgentChatPanel |
| 需要模型调用本地业务函数 | ToolRegistry + FunctionTool + AgentExecutor |
| 需要高风险操作确认 | ToolPermission + ApprovalDialog |
| 需要知识库问答 | InMemoryRetriever + SimpleRagChain |
| 需要多步骤可追踪流程 | StateGraph + GraphTrace |
| 需要保存流程状态 | MemoryCheckpointer |
| 需要快速验证产品能力 | MockChatModel + 示例页面 |