在构建企业级智能体应用时，大模型接入只是整个系统能力建设的起点。要让智能体真正参与业务流程，还需要完成模型配置、应用编排以及运行链路验证等多个环节。

在完成 qKnow 智能体构建平台部署后，部分用户在首次使用过程中可能会遇到一些配置问题：

> 系统已经可以正常访问，但不清楚后续初始化流程；模型服务已经完成接入，但在执行图谱抽取、知识库文档解析等任务时仍然出现调用异常；进入 Bot 管理页面后，又不了解内置 Bot 与普通 Bot 在功能定位上的区别。

这些问题看似发生在不同模块，实际上通常集中在两个核心配置点：

- 大模型服务是否已经正确接入，并能够正常调用；
- 平台内部功能依赖的 Bot 是否已经关联到可用模型。

对于首次使用 qKnow 智能体构建平台的用户，可以**按照“模型配置—Bot 检查—运行验证”的流程完成基础配置**，确保模型能力能够顺利进入智能体执行链路。

---

## 01 配置模型平台：确保 qKnow 具备可调用的大模型能力

大模型是智能体运行过程中的基础能力来源。

在创建 Bot 或使用图谱抽取、知识库解析等功能之前，需要先完成模型平台接入。

进入：

```
系统管理 → 模型市场
```

在模型市场中，可以完成大模型平台的连接配置。

目前 qKnow 支持多种常见模型平台接入，包括：

* DeepSeek
* Ollama
* Qwen
* OpenAI

不同模型平台在部署方式、认证方式以及访问地址方面存在差异，因此配置时需要根据实际使用的模型服务填写对应参数。
![1.png](https://developer.qcloudimg.com/http-save/yehe-11809485/912d63a2299ece7f89f8d9b9c8f56ed0.png)

例如：

* 云端模型通常需要配置 API Key；
* 本地部署模型通常需要配置服务地址；
* 不同平台支持的模型名称可能存在差异，需要确认模型标识是否正确。

---

### 配置 API Key：以通义千问为例

以 Qwen 模型平台为例，在模型市场中接入时，需要先完成密钥配置。

进入：

```
密钥设置
```

根据模型平台要求填写对应的 API Key。

API Key 可以理解为 qKnow 调用外部模型服务时使用的身份凭证。

>同一个模型平台支持配置多个 API Key。
>
![2.png](https://developer.qcloudimg.com/http-save/yehe-11809485/224287f51ae1ae2c1553b59f139b58f5.png)

在实际使用过程中，如果存在多个环境或业务场景，建议根据用途进行区分，例如：

* 测试环境使用独立密钥；
* 生产环境使用独立密钥；
* 不同业务团队使用不同密钥。

这样可以在出现调用异常时，更容易定位具体问题。

同时需要注意：

API Key 属于敏感配置内容，不建议通过普通文档、聊天记录或者截图形式明文传播。

---

### 检查模型详情：确认模型是否同步成功

完成密钥配置并保存后，可以进入：

```
模型详情
```

查看当前模型平台下可使用的模型列表。

正常情况下，qKnow 会根据已配置的平台信息同步对应模型。

因此，模型列表是否能够正常显示，也是验证模型接入是否成功的重要方式。
![3.png](https://developer.qcloudimg.com/http-save/yehe-11809485/c27c5c906158c7fc461bf5bbd84e3160.png)

如果模型列表没有正常同步，可以优先检查以下内容：

1. API Key 是否填写正确；
2. 当前密钥是否仍然有效；
3. 模型平台类型是否与密钥来源一致；
4. 部署环境是否能够正常访问模型服务；
5. 模型平台是否限制了访问权限或调用范围。

需要注意的是：

完成密钥保存并不代表模型配置已经完成。

第一步真正完成的标准应该是：

* 模型平台连接正常；
* 模型列表能够同步；
* 目标模型处于可调用状态。

---

## 02 检查内置 Bot：确认功能调用的模型配置

完成模型平台接入后，还需要进一步检查 Bot 配置。

进入：

```
Bot 管理
```

可以查看当前系统中的 Bot 应用。

qKnow 中的 Bot 主要分为两类：

* 内置 Bot；
* 用户创建的非内置 Bot。

两类 Bot 在用途和维护方式上存在区别。

---

### 什么是内置 Bot？

内置 Bot 是 qKnow 平台预先配置的 Bot。

这些 Bot 并不仅仅是展示示例，而是可能参与平台内部功能调用。
![4.png](https://developer.qcloudimg.com/http-save/yehe-11809485/3aa547bbb26c42b3a6a68c16de3a2a68.png)

例如：

* 图谱抽取流程；
* 知识库文档解析；
* 部分智能处理任务。

这些功能在执行过程中，会调用对应 Bot 中配置的模型节点。

因此，当出现：

* 图谱抽取失败；
* 文档解析异常；
* 模型调用失败；

等问题时，除了检查模型市场配置，也需要关注相关内置 Bot 的模型设置。

---

### 内置 Bot 是否可以修改？

内置 Bot 可以通过超级管理员账号进行调整。

但是，由于部分内置 Bot 与系统功能存在关联，因此修改时需要谨慎。
![5.png](https://developer.qcloudimg.com/http-save/yehe-11809485/a40bf99ef6bfab51b5e4bf3ecfcd369a.png)

调整前建议确认：

* 当前 Bot 被哪些功能使用；
* 当前问题是否仅由模型配置导致；
* 是否真的需要调整流程节点。

通常情况下，如果只是模型不可用，优先修改 LLM 节点中的模型配置即可。

不建议在不了解调用关系的情况下：

* 删除节点；
* 修改整体流程；
* 大范围调整已有逻辑。

否则可能影响依赖该 Bot 的其他功能。

---

### 非内置 Bot 与内置 Bot 的区别

用户自行创建的 Bot 属于非内置 Bot。

这类 Bot 主要用于业务场景开发，可以根据实际需求自由调整。

两者区别如下：

| Bot 类型  | 主要用途       | 修改方式                |
| ------- | ---------- | ------------------- |
| 内置 Bot  | 支撑平台相关功能运行 | 可以修改，但需要谨慎，通常由管理员维护 |
| 非内置 Bot | 用户自定义智能体业务 | 可根据业务需求自由修改或删除      |

简单来说：

如果是开发新的业务智能体，可以创建新的非内置 Bot。

如果是排查图谱抽取、知识库解析等平台能力异常，则需要重点检查对应内置 Bot。

---

### 为什么模型已经配置，功能仍然无法使用？

这是很多首次使用 qKnow 时容易忽略的问题。

模型市场配置完成，只代表：

“平台已经具备调用某些模型的能力。”

但并不代表：

“所有 Bot 已经自动切换到这些模型。”

例如：

qKnow 内置 Bot 的 LLM 节点默认模型可能为：

```
qwen-max
```

如果当前模型市场中：

* 没有配置对应 Qwen 平台；
* 当前账号无法访问 qwen-max；
* 当前环境不存在该模型；

那么相关 Bot 在执行任务时仍然可能调用失败。

即使模型市场中已经配置了其他可用模型，也不会自动替换内置 Bot 中原有模型。

因此，需要进一步检查 Bot 内部模型配置。

---

### 如何修改内置 Bot 的模型？

首先，需要使用超级管理员账号登录。

进入需要调整的内置 Bot。

找到工作流中的：

```
LLM 节点
```

打开节点配置，检查当前选择的模型。
![6.png](https://developer.qcloudimg.com/http-save/yehe-11809485/eb9191b6620a0ab56c9de2d39f7ede2b.png)

如果当前模型不可用，可以根据实际情况切换为模型市场中已经完成配置的模型。
![7.png](https://developer.qcloudimg.com/http-save/yehe-11809485/2f7b02c2a687fd93c3ebbd2a9f950cfc.png)

选择替换模型时，需要确认：

* 模型已经在模型市场完成配置；
* 模型详情页面能够正常显示；
* API Key 当前有效；
* 部署环境可以访问模型服务；
* 模型能力符合当前任务需求。

完成修改后，需要保存 Bot 配置。
![8.png](https://developer.qcloudimg.com/http-save/yehe-11809485/141dadf241365510299a628c1ad95ec4.png)

需要特别注意：

如果只修改模型，但没有保存 Bot，那么运行时仍可能继续使用旧配置。

对于内置 Bot：

如果问题只是模型不可调用，通常只需要调整 LLM 节点即可。

除非已经明确业务逻辑和节点关系，否则不建议同时修改大量流程配置。

---

## 03 完成功能验证：确认模型配置真正生效

完成模型市场和 Bot 配置后，还需要进行一次完整验证。

建议按照以下顺序检查：
### 1. 检查模型列表

进入：

```
模型详情
```

确认目标模型已经同步，并处于可使用状态。

如果模型列表为空或者同步异常，需要优先排查：

* API Key；
* 网络连接；
* 模型平台配置。

---

### 2. 检查内置 Bot 的 LLM 节点

进入对应功能使用的内置 Bot。

确认：

* LLM 节点已经选择当前可用模型；
* 原默认模型已经调整；
* 配置已经保存。

---

### 3. 验证实际业务功能

根据实际使用场景进行验证，例如：

* 图谱抽取是否能够正常执行；
* 知识库文档是否能够正常解析；
* Bot 是否能够正常调用模型完成对话。

如果仍然出现异常，可以按照以下顺序继续排查：

1. 模型平台是否正常；
2. API Key 是否有效；
3. 模型列表是否同步成功；
4. 内置 Bot 是否选择正确模型；
5. Bot 修改是否已经保存；
6. 当前环境是否可以访问模型服务；
7. 当前模型是否适用于对应任务。

---

## qKnow 基础配置流程总结

整个配置过程可以简单理解为三个层次：

第一层：

模型市场解决的是：

> qKnow 可以调用哪些模型。

第二层：

Bot 配置解决的是：

> 某个功能实际使用哪个模型。

第三层：

业务验证解决的是：

> 模型能力是否已经完整连接到实际功能。

![9.png](https://developer.qcloudimg.com/http-save/yehe-11809485/38eb03b724b6ed29e4d7c139ec3c6f43.png)

很多初次部署后的问题，并不是模型没有接入，而是模型接入后，Bot 仍然使用旧的模型配置。

因此，当出现图谱抽取失败、知识库解析异常或者 Bot 调用模型失败时，可以优先检查：

* 模型是否已经正确接入；
* 内置 Bot 是否选择了可用模型；
* 修改后的配置是否已经保存。

---

## 总结

对于 qKnow 智能体构建平台来说，完成部署只是系统运行的第一步。

要让智能体能力、知识库能力以及图谱相关功能稳定运行，还需要完成模型服务接入、Bot 模型关联以及调用链路验证。

整个初始化过程可以归纳为：

1. 在模型市场完成模型平台接入，配置密钥并确认模型同步成功；

2. 检查内置 Bot，将不可用的默认模型调整为当前环境支持的模型；

3. 保存配置，并通过实际业务场景验证模型调用链路。

其中最容易被忽略的是 Bot 配置环节。

模型市场中存在可用模型，并不意味着内置 Bot 会自动切换模型。如果 LLM 节点仍然绑定当前环境不可访问的 qwen-max，相关功能依然可能无法正常运行。

因此，在使用 qKnow 构建智能体应用时，需要同时关注模型服务层、Bot 配置层以及业务执行层。

只有三者形成完整连接，大模型能力才能稳定支撑知识库问答、图谱构建以及智能体应用开发等实际业务场景。


在构建企业级智能体应用时，大模型接入只是整个系统能力建设的起点。要让智能体真正参与业务流程，还需要完成模型配置、应用编排以及运行链路验证等多个环节。

qKnow 智能体构建平台配置实践：从模型接入到 Bot 调用链路验证的完整指南

qKnow 智能体构建平台完成部署后，需按“配置模型—检查 Bot—验证使用”三步完成基础配置。首先在模型市场中接入 DeepSeek、Ollama、Qwen、OpenAI 等模型平台并同步模型列表；然后检查内置 Bot 的 LLM 节点，将不可用的默认模型修改为当前可用模型；最后通过图谱抽取或文档解析等功能验证链路。常见误区是模型市场配置了模型，但内置 Bot 未同步切换。

人工智能

开发工具

后端

qKnow智能体平台部署后，模型接入不等于配置完成。需按“模型配置—Bot检查—运行验证”流程操作：先在模型市场配置APIKey并确认模型同步，再检查内置Bot的LLM节点是否绑定可用模型（默认qwen-max可能不可用），最后通过图谱抽取或文档解析验证调用链路。模型市场有模型不代表Bot自动切换，务必保存修改后的配置。

代码解释

智能体

2026上云采购 | AI焕新·智启新局

lexiang

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

qKnow智能体平台部署后，模型接入不等于配置完成。需按“模型配置—Bot检查—运行验证”流程操作：先在模型市场配置APIKey并确认模型同步，再检查内置Bot的LLM节点是否绑定可用模型（默认qwen-max可能不可用），最后通过图谱抽取或文档解析验证调用链路。模型市场有模型不代表Bot自动切换，务必保存修改后的配置...

qKnow 智能体构建平台配置实践：从模型接入到 Bot 调用链路验证的完整指南-腾讯云开发者社区-腾讯云

qKnow 智能体构建平台配置实践：从模型接入到 Bot 调用链路验证的完整指南

qKnow 智能体构建平台配置实践：从模型接入到 Bot 调用链路验证的完整指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐