tencentcloud-sdk-lkeap 3.0.990 → 3.0.992

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f6e05ffbd927f29ca6c1e20da7a16d1d5c9c82c1
-  data.tar.gz: 2e142e4fa0db68aba9d663f2805dd2e5f0e0a845
+  metadata.gz: 3c7926661ae4f3534bced3b8c0f24bc9ce8a5f27
+  data.tar.gz: 4b6d220e67e9f61203f38a6bac1ad54af57d3582
 SHA512:
-  metadata.gz: f4f267790843d2164a5fd4dcb17c6b3c502c2f7cdc48c240a76eb2029b8ed5dc0eb3c18b74cd98cc8dcd4e4579bb85d4acf84e3af869ff1af92c64050a7cc1ae
-  data.tar.gz: 4bf0264465a6c6383d9f87f5393fccf313edd7d50deb417d9523b996dfb136545bce89ff8f00ee393cc97eda478f7260f756f0e8b3786526ec5e31ed6ba09414
+  metadata.gz: 41af88b6d45199f92342afcc0931768c058ea5d3a35cc32d3157fcd6240b4c0d6652e974e0b0d0ee2ce627486acdcf3d06d7f110e5dfbbe3212d44990702f5ec
+  data.tar.gz: ce1cea53469dde359002376a0e6abdee0dafac75e76e499508f47c776fd60ccd30880bf20e84d07ea98c51bc9fd1e24f5a2c9fac36804f9013695fb82df4c60d

data/lib/VERSION

@@ -1 +1 @@
-3.0.990
+3.0.992

data/lib/v20240522/client.rb

@@ -29,6 +29,117 @@ module TencentCloud
         end
 
 
+        # #### 接口功能
+
+        # 调用接口，发起一次对话请求。
+
+        # #### 已支持的模型
+        # - DeepSeek-V3（model 参数值为**deepseek-v3**）
+        #     - DeepSeek-V3为671B参数MoE模型，在百科知识、数学推理等多项任务上优势突出，评测成绩在主流榜单中位列开源模型榜首。
+        #     - 支持64K上下文长度，最大支持8K输出长度。
+        # - DeepSeek-R1（model 参数值为**deepseek-r1**）
+        #     - DeepSeek-R1为671B模型，使用强化学习训练，推理过程包含大量反思和验证，思维链长度可达数万字。 该系列模型在数学、代码以及各种复杂逻辑推理任务上推理效果优异，并为用户展现了完整的思考过程。
+        #     - 支持64K上下文长度，最大支持8K输出长度。
+
+        # #### 计费说明
+        # - 限时免费
+
+        # 本接口调用DeepSeek系列模型限时免费。即日至北京时间2025年2月25日23:59:59，所有腾讯云用户均可享受DeepSeek-V3、DeepSeek-R1模型限时免费服务，单账号限制接口并发上限为5。在此之后，模型价格将恢复至原价。
+        # - 标准计费（2025年2月26日起生效）
+        # ![image](https://cdn.xiaowei.qq.com/static/lke/deepseek-token.png)
+
+
+        # #### 快速接入
+        # 1. 完成[实名认证](https://console.cloud.tencent.com/developer/auth)。
+        # 2. 主账户前往[控制台](https://console.cloud.tencent.com/lkeap)开通服务。若为子账户，需由主账号在[权限管理](https://console.cloud.tencent.com/cam)中为子账号授权，关联预设策略，策略名称：QcloudLKEAPFullAccess。
+        # 3. 通过API Explorer[在线调试](https://console.cloud.tencent.com/api/explorer?Product=lkeap&Version=2024-05-22&Action=ChatCompletions)。
+        # 4. 使用[官方 SDK ](https://cloud.tencent.com/document/product/1772/115963#SDK)调用本接口（支持Python/Java/PHP/Go/Node.js/.NET等语言）。
+
+        # -----------
+
+        # ### SDK调用示例
+        # 通过本地代码调用本接口（支持Python/Java/PHP/Go/Node.js/.NET等语言）：下面的代码以 Python 语言为例，展示如何访问腾讯云上的DeepSeek模型API的样例。
+        # （1）安装环境
+        # ```
+        # python3 -m pip install --upgrade tencentcloud-sdk-python-common
+        # python3 -m pip install --upgrade tencentcloud-sdk-python-lkeap
+        # ```
+
+        # （2）示例代码
+
+        # - 其中SecretKey和SecretID需要从腾讯云控制台获取
+
+        # - 参数params中模型Model字段可以选择“deepseek-r1“和“deepseek-v3”
+
+        # ```
+        # # -*- coding: utf-8 -*-
+        # import json
+
+        # from tencentcloud.common.common_client import CommonClient
+        # from tencentcloud.common import credential
+        # from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
+        # from tencentcloud.common.profile.client_profile import ClientProfile
+        # from tencentcloud.common.profile.http_profile import HttpProfile
+
+        # class NonStreamResponse(object):
+        #     def __init__(self):
+        #         self.response = ""
+
+        #     def _deserialize(self, obj):
+        #         self.response = json.dumps(obj)
+
+        # try:
+        #     # 实例化一个认证对象，入参需要传入腾讯云账户 SecretId 和 SecretKey，此处还需注意密钥对的保密
+        #     # 代码泄露可能会导致 SecretId 和 SecretKey 泄露，并威胁账号下所有资源的安全性。以下代码示例仅供参考，建议采用更安全的方式来使用密钥，请参见：https://cloud.tencent.com/document/product/1278/85305
+        #     # 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取
+        #     cred = credential.Credential("", "")
+
+        #     httpProfile = HttpProfile()
+        #     httpProfile.endpoint = "lkeap.tencentcloudapi.com"
+        #     httpProfile.reqTimeout = 40000  # 流式接口可能耗时较长
+        #     clientProfile = ClientProfile()
+        #     clientProfile.httpProfile = httpProfile
+
+        #     params = "{\"Model\":\"deepseek-r1\",\"Messages\":[{\"Role\":\"user\",\"Content\":\"你好\"}],\"Stream\":true}";
+        #     common_client = CommonClient("lkeap", "2024-05-22", cred, "ap-guangzhou", profile=clientProfile)
+        #     resp = common_client._call_and_deserialize("ChatCompletions", json.loads(params), NonStreamResponse)
+        #     if isinstance(resp, NonStreamResponse):  # 非流式响应
+        #         print(resp.response)
+        #     else:  # 流式响应
+        #         for event in resp:
+        #             print(event)
+        # except TencentCloudSDKException as err:
+        #     print(err)
+
+        # ```
+
+        # **DeepSeek-R1使用建议**
+
+        # 1. 将温度设置在 0.5-0.7 范围内（建议为0.6），以防止无休止的重复或不连贯的输出。
+        # 2. 避免添加system prompt，所有说明都应包含在user prompt中。
+
+        # @param request: Request instance for ChatCompletions.
+        # @type request: :class:`Tencentcloud::lkeap::V20240522::ChatCompletionsRequest`
+        # @rtype: :class:`Tencentcloud::lkeap::V20240522::ChatCompletionsResponse`
+        def ChatCompletions(request)
+          body = send_request('ChatCompletions', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ChatCompletionsResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 用于为问答对创建属性标签，以便对内容进行分类和管理。 使用场景：当需要为问答对添加分类标签和属性标记时使用，比如为问答对添加“售后”标签。
 
         # @param request: Request instance for CreateAttributeLabel.

data/lib/v20240522/models.rb

@@ -100,6 +100,153 @@ module TencentCloud
         end
       end
 
+      # ChatCompletions请求参数结构体
+      class ChatCompletionsRequest < TencentCloud::Common::AbstractModel
+        # @param Model: 模型名称
+        # @type Model: String
+        # @param Messages: 会话列表
+        # @type Messages: Array
+        # @param Stream: 是否流式输出
+        # @type Stream: Boolean
+        # @param Temperature: 控制生成的随机性，较高的值会产生更多样化的输出。
+        # @type Temperature: Float
+        # @param MaxTokens: 最大生成的token数量
+        # @type MaxTokens: Integer
+
+        attr_accessor :Model, :Messages, :Stream, :Temperature, :MaxTokens
+
+        def initialize(model=nil, messages=nil, stream=nil, temperature=nil, maxtokens=nil)
+          @Model = model
+          @Messages = messages
+          @Stream = stream
+          @Temperature = temperature
+          @MaxTokens = maxtokens
+        end
+
+        def deserialize(params)
+          @Model = params['Model']
+          unless params['Messages'].nil?
+            @Messages = []
+            params['Messages'].each do |i|
+              message_tmp = Message.new
+              message_tmp.deserialize(i)
+              @Messages << message_tmp
+            end
+          end
+          @Stream = params['Stream']
+          @Temperature = params['Temperature']
+          @MaxTokens = params['MaxTokens']
+        end
+      end
+
+      # ChatCompletions返回参数结构体
+      class ChatCompletionsResponse < TencentCloud::Common::AbstractModel
+        # @param Created: Unix 时间戳，单位为秒。
+        # @type Created: Integer
+        # @param Usage: Token 统计信息。
+        # 按照总 Token 数量计费。
+        # @type Usage: :class:`Tencentcloud::Lkeap.v20240522.models.ChatUsage`
+        # @param Id: 本次请求的 RequestId。
+        # @type Id: String
+        # @param Choices: 回复内容。
+        # @type Choices: Array
+        # @param Model: 模型名称。
+        # @type Model: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
+        # @type RequestId: String
+
+        attr_accessor :Created, :Usage, :Id, :Choices, :Model, :RequestId
+
+        def initialize(created=nil, usage=nil, id=nil, choices=nil, model=nil, requestid=nil)
+          @Created = created
+          @Usage = usage
+          @Id = id
+          @Choices = choices
+          @Model = model
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Created = params['Created']
+          unless params['Usage'].nil?
+            @Usage = ChatUsage.new
+            @Usage.deserialize(params['Usage'])
+          end
+          @Id = params['Id']
+          unless params['Choices'].nil?
+            @Choices = []
+            params['Choices'].each do |i|
+              choice_tmp = Choice.new
+              choice_tmp.deserialize(i)
+              @Choices << choice_tmp
+            end
+          end
+          @Model = params['Model']
+          @RequestId = params['RequestId']
+        end
+      end
+
+      # 消耗量
+      class ChatUsage < TencentCloud::Common::AbstractModel
+        # @param PromptTokens: 输入token数
+        # @type PromptTokens: Integer
+        # @param CompletionTokens: 输出token数
+        # @type CompletionTokens: Integer
+        # @param TotalTokens: 总token数
+        # @type TotalTokens: Integer
+
+        attr_accessor :PromptTokens, :CompletionTokens, :TotalTokens
+
+        def initialize(prompttokens=nil, completiontokens=nil, totaltokens=nil)
+          @PromptTokens = prompttokens
+          @CompletionTokens = completiontokens
+          @TotalTokens = totaltokens
+        end
+
+        def deserialize(params)
+          @PromptTokens = params['PromptTokens']
+          @CompletionTokens = params['CompletionTokens']
+          @TotalTokens = params['TotalTokens']
+        end
+      end
+
+      # 返回的回复, 支持多个
+      class Choice < TencentCloud::Common::AbstractModel
+        # @param FinishReason: 结束标志位，可能为 stop、 sensitive或者tool_calls。
+        # stop 表示输出正常结束。
+        # sensitive 只在开启流式输出审核时会出现，表示安全审核未通过。
+        # tool_calls 标识函数调用。
+        # @type FinishReason: String
+        # @param Delta: 增量返回值，流式调用时使用该字段。
+        # @type Delta: :class:`Tencentcloud::Lkeap.v20240522.models.Delta`
+        # @param Message: 返回值，非流式调用时使用该字段。
+        # @type Message: :class:`Tencentcloud::Lkeap.v20240522.models.Message`
+        # @param Index: 索引值，流式调用时使用该字段。
+        # @type Index: Integer
+
+        attr_accessor :FinishReason, :Delta, :Message, :Index
+
+        def initialize(finishreason=nil, delta=nil, message=nil, index=nil)
+          @FinishReason = finishreason
+          @Delta = delta
+          @Message = message
+          @Index = index
+        end
+
+        def deserialize(params)
+          @FinishReason = params['FinishReason']
+          unless params['Delta'].nil?
+            @Delta = Delta.new
+            @Delta.deserialize(params['Delta'])
+          end
+          unless params['Message'].nil?
+            @Message = Message.new
+            @Message.deserialize(params['Message'])
+          end
+          @Index = params['Index']
+        end
+      end
+
       # CreateAttributeLabel请求参数结构体
       class CreateAttributeLabelRequest < TencentCloud::Common::AbstractModel
         # @param Labels: 属性标签信息
@@ -337,10 +484,10 @@ module TencentCloud
 
         attr_accessor :TableResultType, :ResultType, :EnableMllm, :MaxChunkSize
         extend Gem::Deprecate
-        deprecate :TableResultType, :none, 2025, 1
-        deprecate :TableResultType=, :none, 2025, 1
-        deprecate :ResultType, :none, 2025, 1
-        deprecate :ResultType=, :none, 2025, 1
+        deprecate :TableResultType, :none, 2025, 2
+        deprecate :TableResultType=, :none, 2025, 2
+        deprecate :ResultType, :none, 2025, 2
+        deprecate :ResultType=, :none, 2025, 2
 
         def initialize(tableresulttype=nil, resulttype=nil, enablemllm=nil, maxchunksize=nil)
           @TableResultType = tableresulttype
@@ -393,8 +540,8 @@ module TencentCloud
 
         attr_accessor :FileType, :FileUrl, :FileName, :FileBase64, :FileStartPageNumber, :FileEndPageNumber, :Config
         extend Gem::Deprecate
-        deprecate :FileBase64, :none, 2025, 1
-        deprecate :FileBase64=, :none, 2025, 1
+        deprecate :FileBase64, :none, 2025, 2
+        deprecate :FileBase64=, :none, 2025, 2
 
         def initialize(filetype=nil, fileurl=nil, filename=nil, filebase64=nil, filestartpagenumber=nil, fileendpagenumber=nil, config=nil)
           @FileType = filetype
@@ -554,6 +701,26 @@ module TencentCloud
         end
       end
 
+      # 返回的内容
+      class Delta < TencentCloud::Common::AbstractModel
+        # @param Role: 角色名称。
+        # @type Role: String
+        # @param Content: 内容详情。
+        # @type Content: String
+
+        attr_accessor :Role, :Content
+
+        def initialize(role=nil, content=nil)
+          @Role = role
+          @Content = content
+        end
+
+        def deserialize(params)
+          @Role = params['Role']
+          @Content = params['Content']
+        end
+      end
+
       # DescribeDoc请求参数结构体
       class DescribeDocRequest < TencentCloud::Common::AbstractModel
 
@@ -654,8 +821,8 @@ module TencentCloud
 
         attr_accessor :PageNumber, :TotalToken, :TotalTokens
         extend Gem::Deprecate
-        deprecate :TotalToken, :none, 2025, 1
-        deprecate :TotalToken=, :none, 2025, 1
+        deprecate :TotalToken, :none, 2025, 2
+        deprecate :TotalToken=, :none, 2025, 2
 
         def initialize(pagenumber=nil, totaltoken=nil, totaltokens=nil)
           @PageNumber = pagenumber
@@ -838,8 +1005,8 @@ module TencentCloud
 
         attr_accessor :Status, :DocumentRecognizeResultUrl, :FailedPages, :Usage, :RequestId
         extend Gem::Deprecate
-        deprecate :FailedPages, :none, 2025, 1
-        deprecate :FailedPages=, :none, 2025, 1
+        deprecate :FailedPages, :none, 2025, 2
+        deprecate :FailedPages=, :none, 2025, 2
 
         def initialize(status=nil, documentrecognizeresulturl=nil, failedpages=nil, usage=nil, requestid=nil)
           @Status = status
@@ -1035,17 +1202,22 @@ module TencentCloud
         # @type Role: String
         # @param Content: 内容
         # @type Content: String
+        # @param ReasoningContent: 思维链内容。
+        # ReasoningConent参数仅支持出参，且只有deepseek-r1模型会返回。
+        # @type ReasoningContent: String
 
-        attr_accessor :Role, :Content
+        attr_accessor :Role, :Content, :ReasoningContent
 
-        def initialize(role=nil, content=nil)
+        def initialize(role=nil, content=nil, reasoningcontent=nil)
           @Role = role
           @Content = content
+          @ReasoningContent = reasoningcontent
         end
 
         def deserialize(params)
           @Role = params['Role']
           @Content = params['Content']
+          @ReasoningContent = params['ReasoningContent']
         end
       end
 
@@ -1679,8 +1851,8 @@ module TencentCloud
 
         attr_accessor :KnowledgeBaseId, :FileName, :FileType, :FileUrl, :AttributeLabel, :AttributeLabels, :Config
         extend Gem::Deprecate
-        deprecate :AttributeLabel, :none, 2025, 1
-        deprecate :AttributeLabel=, :none, 2025, 1
+        deprecate :AttributeLabel, :none, 2025, 2
+        deprecate :AttributeLabel=, :none, 2025, 2
 
         def initialize(knowledgebaseid=nil, filename=nil, filetype=nil, fileurl=nil, attributelabel=nil, attributelabels=nil, config=nil)
           @KnowledgeBaseId = knowledgebaseid

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-lkeap
 version: !ruby/object:Gem::Version
-  version: 3.0.990
+  version: 3.0.992
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-01-26 00:00:00.000000000 Z
+date: 2025-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common