文章目录
- 腾讯云大模型知识引擎创建 DeepSeek 应用文档
- 一、前期准备
- 二、创建应用
- 1. 进入应用管理界面
- 2. 应用配置
- 3. 发布应用
- 三、管理应用
- 四、测试应用
- 五、API接入应用
- API接入文档详细链接
- HTTP 对话端接口文档
- WebSocket对话端接口文档
- 六、常见问题
- 七、注意事项
腾讯云大模型知识引擎创建 DeepSeek 应用文档
一、前期准备
在开始创建应用之前,请确保您已经完成了以下准备工作:
-
注册腾讯云账户:如果还没有腾讯云账户,您需要首先注册一个腾讯云账户,并完成实名认证。可以前往腾讯云官网进行注册。
-
开通腾讯云大模型知识引擎 LKE:点击产品体验,开通腾讯云大模型知识引擎 LKE。
产品地址:腾讯云DeepSeek
二、创建应用
1. 进入应用管理界面
登录腾讯云大模型知识引擎管理界面,点击“新建应用”。
2. 应用配置
点击应用查看按钮 在应用配置界面,您可以进行以下设置:
- 选择模型:在模型配置中选择“DeepSeek - R1”作为生成模型。
- 设置提示词:可以设定应用的角色名称及相关特点。如果您不确定如何填写,可以点击模板并按照模板进行修改。此外,您还可以通过AI一键优化提示词,直接应用优化后的提示词。
- 设置欢迎语:在这里可以设置欢迎语,以便在初次使用时显示。
- 知识库、联网搜索、输出配置:根据您的需求,决定是否开启知识库、联网搜索等功能。例如,如果您希望智能客服仅基于知识库回答问题,可以关闭联网搜索。
在这里插入图片描述
3. 发布应用
完成配置后,点击发布按钮,使用默认配置。发布后等待两分钟左右,发布成功后可以看到调用按钮。
完成应用配置和效果调试后,可单击发布按钮,成功发布将获得体验分享链接并支持创建 API 调用密钥,您可通过分享该链接给用户或相关测试运营人员,使他们能够在 web 体验页立即体验您的大模型应用 demo;同时也可以直接通过应用 API 调用接口,以 API 形式进行调用。
三、管理应用
已创建的大模型应用,将展示于 应用管理 页,可以便捷地进行查看、调用、删除等操作。
这里查看应用的对接调用信息和体验界面
四、测试应用
在应用管理界面,您可以直接进行测试:
- 测试生成模型:此时应用已经接通了DeepSeek - R1,您可以在这里提问进行测试,查看它的回答是否符合预期。
- 测试输出配置:输入一个不在知识库中的内容,测试应用是否会按照预设回答。
- 调用信息里面的体验:
五、API接入应用
API接入文档详细链接
接入总体概述:https://cloud.tencent.com/document/product/1759/109380
HTTP 对话端接口文档
-
1、获取 AppKey
在应用管理界面,找到您处于运行中的应用(需要先发布),单击调用,会弹出“调用信息”窗口。
在调用信息窗口可以看到 AppKey,单击复制即可。
-
2、接口信息
请求地址:https://wss.lke.cloud.tencent.com/v1/qbot/chat/sse
请求方式:POST
详细参数参考官方文档:参数说明
- 3、开始调用
curl 调用示例
curl -XPOST -vvv --no-buffer --location 'https://wss.lke.cloud.tencent.com/v1/qbot/chat/sse' \
--header 'Content-Type: application/json' \
--data '{"content": "消息内容","bot_app_key": "<your appkey>","visitor_biz_id": "<your visitor id>","session_id": "<your session_id>","visitor_labels": []
}'
postman 调用示例
apiFox调用示例
请求代码
curl --location --request POST 'https://wss.lke.cloud.tencent.com/v1/qbot/chat/sse' \
--header 'Accept-Language: zh-cn' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Host: wss.lke.cloud.tencent.com' \
--header 'Connection: keep-alive' \
--data-raw '{"content": "西安明天的天气预报","bot_app_key": "appKey","visitor_biz_id": "2025031901","session_id": "2025031901"
}'
响应结果
- 4、HTTP SSE 接口返回
- 详细响应结果参数解释官方文档:响应参数
quote_infos 示例 (此处只展示,省略了部分结构):
["reply",{"type": "reply","payload": {"can_feedback": true,"can_rating": false,"content": "2025年2月13日腾讯股价情况如下:\n\n### 腾讯控股(00700.HK)港股市场表现\n\n- **股价波动**:腾讯控股股价在2025年2月13日经历了显著的波动,盘中振幅达到4.35%。这一波动既反映了市场情绪与资金博弈的短期影响,也体现了行业环境与公司基本面的长期逻辑。\n- **股价范围**:腾讯股价在当天最高达到464.6港币,最低跌至437港币。\n\n### 腾讯控股(TCTZF.us)美股市场表现\n\n- **股价上涨**:在美股市场,腾讯控股(TCTZF.us)股价在2025年2月13日盘中一度上涨5.05%,最新报58.10美元/股。\n- **市场反应**:这一异动引发了市场的广泛关注,投资者纷纷开始挖掘其背后的原因及影响。\n\n请注意,以上信息仅供参考,投资有风险,入市请谨慎。","quote_infos": [{"index": 1,"position": 323}],},"message_id": "xxxxxxxxxxxxxxxxxxxxxxx"}
]
WebSocket对话端接口文档
参考官网地址:WebSocket对话端接口文档
- 1.获取WS Token
接口请求:
curl -X POST https://lke.tencentcloudapi.com
-H "Authorization: TC3-HMAC-SHA256 Credential=AKIDoIuV5UMbBWWryms6EsnqBhw7NL7DAH8AKLhjXyvMrRhkA7mxr5mbpIrT_Zvvf_9p/2025-03-20/lke/tc3_request, SignedHeaders=content-type;host, Signature=2b5586b695db29f99d62b052c73374382307533a3bffef223b5d4fe7f06d3879"
-H "Content-Type: application/json"
-H "Host: lke.tencentcloudapi.com"
-H "X-TC-Action: GetWsToken"
-H "X-TC-Timestamp: 1742436557"
-H "X-TC-Version: 2023-11-30"
-H "X-TC-Region: ap-guangzhou"
-H "X-TC-Language: zh-CN"
-H "X-TC-Token: QTniGkivoN7jkiUq10IzshlU1Ek8sepae34556bc5909a952f86b370d18c24b35SXK0r_OOofJIPygrAednXTf-SCjZmb2CxrWOxbWAFrPXcEjoA2HbxzzkxwRY2yZkCsA6POsIhBfyuXdLwX08iWrDI0arP2ZWp9-DnyE88iOPJNCwrQJKjMRO_GJLMpax17bx-Fsxt_-Y6of_4IqdWeSfE_CuI9eGWshbIuyo-CCJteEIQr0TZieYVoj28Cm01l0D83-0W16_mZDThw1Dpw"
-d '{"Type":5,"BotAppKey":"appKey"}'
响应结果
{"Response": {"Balance": 1,"InputLenLimit": 2500,"Pattern": "standard","RequestId": "feb246ed-0dcb-460b-b2a6-d312b64d22ad","SingleWorkflow": {"IsEnable": false,"Status": "","WorkflowDesc": "","WorkflowId": "","WorkflowName": ""},"Token": "780617dd-cbf6-492a-95d9-3850ec703ad5"}
}
- 2.使用 Token 建立 Websocket 连接
apifox使用Websocket :教程链接
六、常见问题
-
Q:如何处理知识库更新延迟?
-
A:确保开启实时同步模式,若使用批量更新建议错峰操作
-
Q:API返回403错误如何排查?
-
A:检查:
- AppKey/Secret是否有效
- 账号余额是否充足
- 接口调用频率是否超限
七、注意事项
- 网络环境:确保您的网络环境可以正常访问腾讯云的API地址。
- 请求频率:注意请求的频率限制,避免触发限流机制。
- 数据安全:对于敏感数据,建议使用安全的方式存储和传输,避免泄露。
- 应用配置:根据实际需求合理配置应用的各项参数,以达到最佳的使用效果。