快速接入

快速接入

1. 配置模型

AgentKit 示例程序支持从本地配置读取模型信息。可以在运行目录或 UIGearsAgentKit 目录放置 agentkit.local.json。

OpenAI-compatible 配置示例：

{
  "provider": "openai",
  "baseUrl": "https://api.example.com/v1",
  "apiKey": "your-api-key",
  "model": "your-model",
  "maxTokens": 1024,
  "timeoutMs": 60000,
  "stream": true
}

DeepSeek 配置示例：

{
  "provider": "deepseek",
  "baseUrl": "https://api.deepseek.com",
  "apiKey": "your-deepseek-api-key",
  "model": "deepseek-v4-flash",
  "maxTokens": 1024,
  "timeoutMs": 60000,
  "stream": true
}

也可以通过环境变量配置真实模型。OpenAI-compatible provider 使用 OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL；DeepSeek provider 使用 DEEPSEEK_API_KEY、DEEPSEEK_BASE_URL、DEEPSEEK_MODEL。

没有配置时，示例程序会自动使用 Mock 模型离线运行。

2. 创建聊天请求

using namespace UIGQtLib::QtAgent;

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

ChatReply* reply = model->chat(request, {}, parent);

3. 注册工具

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

4. 运行示例程序

打开 AgentKit 示例程序后，可通过左侧能力树分别查看基础对话、模型能力、流程能力和设备监控分析示例。