tencentcloud-sdk-es 3.0.1125 → 3.0.1140

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8b02116368f3c42c49cc8469894910101a5b765e
-  data.tar.gz: 5f64e8c26989529605cf56d178a68bf402f7b8cf
+  metadata.gz: ea9a7323224786467b3806446f15e4ecc0757896
+  data.tar.gz: 55f49d1a6cc55fabda2641b73e80a4a7c893d93a
 SHA512:
-  metadata.gz: 8e2d317bb067bcbbee50b5e4f466dba9a716bf9edb33545c98846d4769d9ba0eb9f4e00a0f22a4e9de33d91f7faa947e07e35cbbbf77dec604788f90cbf41106
-  data.tar.gz: 0be9362cd42604ac34626a9af7c600da4b90689f336ec8884e22ad108790d5bc1b929be799ca1e1f33333c3692852214c72471c7ea3a353cbf441e28883579d1
+  metadata.gz: 8d81b8ec991c79f75b3dd2d0441602ce8c74bdbead2adb40ba94255c5373196222d65386887225e220bafc8722bd5b90e256a2eb4754723a5756257aeae4fab5
+  data.tar.gz: f28ed270f9a38a21f9fcd3feb8be3fe8e2edd9db28b094f1f27e7567594f953e59a5c0e49838bb50840859bf2a4233da5b188019bf4f549bd09424b16658a7a3

data/lib/VERSION

@@ -1 +1 @@
-3.0.1125
+3.0.1140

data/lib/v20250101/models.rb

@@ -33,10 +33,16 @@ module TencentCloud
         # @type OnlineSearch: Boolean
         # @param OnlineSearchOptions: 当 OnlineSearch 为 true 时，指定的搜索引擎，默认为 bing。
         # @type OnlineSearchOptions: :class:`Tencentcloud::Es.v20250101.models.OnlineSearchOptions`
+        # @param Tools: 可调用的工具列表，当前支持模型：hunyuan-turbo, deepseek-v3。
+        # @type Tools: Array
+        # @param ToolChoice: 工具使用选项，可选值包括 none、auto、custom。说明：1. 仅对 hunyuan-turbo、deepseek-v3 模型生效。2. none：不调用工具；auto：模型自行选择生成回复或调用工具；custom：强制模型调用指定的工具。3. 未设置时，默认值为auto
+        # @type ToolChoice: String
+        # @param CustomTool: 强制模型调用指定的工具，当参数ToolChoice为custom时，此参数为必填
+        # @type CustomTool: :class:`Tencentcloud::Es.v20250101.models.Tool`
 
-        attr_accessor :Messages, :ModelName, :Stream, :TopP, :Temperature, :OnlineSearch, :OnlineSearchOptions
+        attr_accessor :Messages, :ModelName, :Stream, :TopP, :Temperature, :OnlineSearch, :OnlineSearchOptions, :Tools, :ToolChoice, :CustomTool
 
-        def initialize(messages=nil, modelname=nil, stream=nil, topp=nil, temperature=nil, onlinesearch=nil, onlinesearchoptions=nil)
+        def initialize(messages=nil, modelname=nil, stream=nil, topp=nil, temperature=nil, onlinesearch=nil, onlinesearchoptions=nil, tools=nil, toolchoice=nil, customtool=nil)
           @Messages = messages
           @ModelName = modelname
           @Stream = stream
@@ -44,6 +50,9 @@ module TencentCloud
           @Temperature = temperature
           @OnlineSearch = onlinesearch
           @OnlineSearchOptions = onlinesearchoptions
+          @Tools = tools
+          @ToolChoice = toolchoice
+          @CustomTool = customtool
         end
 
         def deserialize(params)
@@ -64,6 +73,19 @@ module TencentCloud
             @OnlineSearchOptions = OnlineSearchOptions.new
             @OnlineSearchOptions.deserialize(params['OnlineSearchOptions'])
           end
+          unless params['Tools'].nil?
+            @Tools = []
+            params['Tools'].each do |i|
+              tool_tmp = Tool.new
+              tool_tmp.deserialize(i)
+              @Tools << tool_tmp
+            end
+          end
+          @ToolChoice = params['ToolChoice']
+          unless params['CustomTool'].nil?
+            @CustomTool = Tool.new
+            @CustomTool.deserialize(params['CustomTool'])
+          end
         end
       end
 
@@ -332,12 +354,20 @@ module TencentCloud
 
       # 文档信息
       class Document < TencentCloud::Common::AbstractModel
-        # @param FileType: 文件类型。
-        # 支持的文件类型：PDF、DOC、DOCX、PPT、PPTX、MD、TXT、XLS、XLSX、CSV、PNG、JPG、JPEG、BMP、GIF、WEBP、HEIC、EPS、ICNS、IM、PCX、PPM、TIFF、XBM、HEIF、JP2
-        # 支持的文件大小：
-        # - PDF、DOC、DOCX、PPT、PPTX 支持100M
-        # - MD、TXT、XLS、XLSX、CSV 支持10M
-        # - 其他支持20M
+        # @param FileType: 支持的文件类型：PDF、DOC、DOCX、PPT、PPTX、MD、TXT、XLS、
+        # XLSX、CSV、PNG、JPG、JPEG、BMP、GIF、WEBP、HEIC、EPS、ICNS、
+        # IM、PCX、PPM、TIFF、XBM、HEIF、JP2
+
+        # 文档解析支持的文件大小：
+        # -PDF、DOC、DOCX、PPT、PPTX支持100M
+        # -MD、TXT、XLS、XLSX、CSV支特10M
+        # -其他支持20M
+
+        # 文本切片支持的文件大小：
+        # -PDF最大300M
+        # -D0CX、D0C、PPT、PPTX最大200M
+        # -TXT、MD最大10M
+        # -其他最大20M
         # @type FileType: String
         # @param FileUrl: 文件存储于腾讯云的 URL 可保障更高的下载速度和稳定性，使用腾讯云COS 文件地址。
         # @type FileUrl: String
@@ -587,21 +617,36 @@ module TencentCloud
 
       # 会话内容，按对话时间从旧到新在数组中排列，长度受模型窗口大小限制。
       class Message < TencentCloud::Common::AbstractModel
-        # @param Role: 角色, ‘system', ‘user'，'assistant'或者'tool', 在message中, 除了system，其他必须是user与assistant交替(一问一答)
+        # @param Role: 角色，可选值包括 system、user、assistant、 tool。
         # @type Role: String
         # @param Content: 具体文本内容
         # @type Content: String
+        # @param ToolCallId: 当role为tool时传入，标识具体的函数调用
+        # @type ToolCallId: String
+        # @param ToolCalls: 模型生成的工具调用
+        # @type ToolCalls: Array
 
-        attr_accessor :Role, :Content
+        attr_accessor :Role, :Content, :ToolCallId, :ToolCalls
 
-        def initialize(role=nil, content=nil)
+        def initialize(role=nil, content=nil, toolcallid=nil, toolcalls=nil)
           @Role = role
           @Content = content
+          @ToolCallId = toolcallid
+          @ToolCalls = toolcalls
         end
 
         def deserialize(params)
           @Role = params['Role']
           @Content = params['Content']
+          @ToolCallId = params['ToolCallId']
+          unless params['ToolCalls'].nil?
+            @ToolCalls = []
+            params['ToolCalls'].each do |i|
+              toolcall_tmp = ToolCall.new
+              toolcall_tmp.deserialize(i)
+              @ToolCalls << toolcall_tmp
+            end
+          end
         end
       end
 
@@ -629,19 +674,30 @@ module TencentCloud
         # @type Content: String
         # @param ReasoningContent: 推理内容
         # @type ReasoningContent: String
+        # @param ToolCalls: 模型生成的工具调用
+        # @type ToolCalls: Array
 
-        attr_accessor :Role, :Content, :ReasoningContent
+        attr_accessor :Role, :Content, :ReasoningContent, :ToolCalls
 
-        def initialize(role=nil, content=nil, reasoningcontent=nil)
+        def initialize(role=nil, content=nil, reasoningcontent=nil, toolcalls=nil)
           @Role = role
           @Content = content
           @ReasoningContent = reasoningcontent
+          @ToolCalls = toolcalls
         end
 
         def deserialize(params)
           @Role = params['Role']
           @Content = params['Content']
           @ReasoningContent = params['ReasoningContent']
+          unless params['ToolCalls'].nil?
+            @ToolCalls = []
+            params['ToolCalls'].each do |i|
+              toolcall_tmp = ToolCall.new
+              toolcall_tmp.deserialize(i)
+              @ToolCalls << toolcall_tmp
+            end
+          end
         end
       end
 
@@ -663,18 +719,27 @@ module TencentCloud
 
       # 文档信息
       class ParseDocument < TencentCloud::Common::AbstractModel
-        # @param FileType: 文件类型。
-        # 支持的文件类型：PDF、DOC、DOCX、PPT、PPTX、MD、TXT、XLS、XLSX、CSV、PNG、JPG、JPEG、BMP、GIF、WEBP、HEIC、EPS、ICNS、IM、PCX、PPM、TIFF、XBM、HEIF、JP2
-        # 支持的文件大小：
-        # - PDF、DOC、DOCX、PPT、PPTX 支持100M
-        # - MD、TXT、XLS、XLSX、CSV 支持10M
-        # - 其他支持20M
+        # @param FileType: 支持的文件类型：PDF、DOC、DOCX、PPT、PPTX、MD、TXT、XLS、
+        # XLSX、CSV、PNG、JPG、JPEG、BMP、GIF、WEBP、HEIC、EPS、ICNS、
+        # IM、PCX、PPM、TIFF、XBM、HEIF、JP2
+
+        # 文档解析支持的文件大小：
+        # -PDF、DOC、DOCX、PPT、PPTX支持100M
+        # -MD、TXT、XLS、XLSX、CSV支特10M
+        # -其他支持20M
+
+        # 文本切片支持的文件大小：
+        # -PDF最大300M
+        # -D0CX、D0C、PPT、PPTX最大200M
+        # -TXT、MD最大10M
+        # -其他最大20M
         # @type FileType: String
         # @param FileUrl: 文件存储于腾讯云的 URL 可保障更高的下载速度和稳定性，使用腾讯云COS 文件地址。
         # @type FileUrl: String
         # @param FileContent: 文件的 base64 值，携带 MineType前缀信息。编码后的后的文件不超过 10M。
         # 支持的文件大小：所下载文件经Base64编码后不超过 8M。文件下载时间不超过3秒。
         # 支持的图片像素：单边介于20-10000px之间。
+        # 文件的 FileUrl、FileContent必须提供一个，如果都提供只使用 FileUrl。
         # @type FileContent: String
         # @param DocumentParseConfig: 文档解析配置
         # @type DocumentParseConfig: :class:`Tencentcloud::Es.v20250101.models.DocumentParseConfig`
@@ -925,6 +990,104 @@ module TencentCloud
         end
       end
 
+      # 用户指定模型使用的工具
+      class Tool < TencentCloud::Common::AbstractModel
+        # @param Type: 工具类型，当前只支持function
+        # @type Type: String
+        # @param Function: 具体要调用的function
+        # @type Function: :class:`Tencentcloud::Es.v20250101.models.ToolFunction`
+
+        attr_accessor :Type, :Function
+
+        def initialize(type=nil, function=nil)
+          @Type = type
+          @Function = function
+        end
+
+        def deserialize(params)
+          @Type = params['Type']
+          unless params['Function'].nil?
+            @Function = ToolFunction.new
+            @Function.deserialize(params['Function'])
+          end
+        end
+      end
+
+      # 模型生成的工具调用
+      class ToolCall < TencentCloud::Common::AbstractModel
+        # @param Id: 工具调用id
+        # @type Id: String
+        # @param Type: 工具调用类型，当前只支持function
+        # @type Type: String
+        # @param Function: 具体的function调用
+        # @type Function: :class:`Tencentcloud::Es.v20250101.models.ToolCallFunction`
+        # @param Index: 索引值
+        # @type Index: Integer
+
+        attr_accessor :Id, :Type, :Function, :Index
+
+        def initialize(id=nil, type=nil, function=nil, index=nil)
+          @Id = id
+          @Type = type
+          @Function = function
+          @Index = index
+        end
+
+        def deserialize(params)
+          @Id = params['Id']
+          @Type = params['Type']
+          unless params['Function'].nil?
+            @Function = ToolCallFunction.new
+            @Function.deserialize(params['Function'])
+          end
+          @Index = params['Index']
+        end
+      end
+
+      # 具体的function调用
+      class ToolCallFunction < TencentCloud::Common::AbstractModel
+        # @param Name: function名称
+        # @type Name: String
+        # @param Arguments: function参数，一般为json字符串
+        # @type Arguments: String
+
+        attr_accessor :Name, :Arguments
+
+        def initialize(name=nil, arguments=nil)
+          @Name = name
+          @Arguments = arguments
+        end
+
+        def deserialize(params)
+          @Name = params['Name']
+          @Arguments = params['Arguments']
+        end
+      end
+
+      # function定义
+      class ToolFunction < TencentCloud::Common::AbstractModel
+        # @param Name: function名称，只能包含a-z，A-Z，0-9，_或-
+        # @type Name: String
+        # @param Parameters: function参数，一般为json字符串
+        # @type Parameters: String
+        # @param Description: function的简单描述
+        # @type Description: String
+
+        attr_accessor :Name, :Parameters, :Description
+
+        def initialize(name=nil, parameters=nil, description=nil)
+          @Name = name
+          @Parameters = parameters
+          @Description = description
+        end
+
+        def deserialize(params)
+          @Name = params['Name']
+          @Parameters = params['Parameters']
+          @Description = params['Description']
+        end
+      end
+
       # token消耗总数
       class Usage < TencentCloud::Common::AbstractModel
         # @param TotalTokens: tokens总数

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-es
 version: !ruby/object:Gem::Version
-  version: 3.0.1125
+  version: 3.0.1140
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-08-18 00:00:00.000000000 Z
+date: 2025-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common