tencentcloud-sdk-python 3.0.1296__py2.py3-none-any.whl → 3.0.1297__py2.py3-none-any.whl

tencentcloud/lkeap/v20240522/lkeap_client.py

@@ -0,0 +1,573 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2021 THL A29 Limited, a Tencent company. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+
+from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
+from tencentcloud.common.abstract_client import AbstractClient
+from tencentcloud.lkeap.v20240522 import models
+
+
+class LkeapClient(AbstractClient):
+    _apiVersion = '2024-05-22'
+    _endpoint = 'lkeap.tencentcloudapi.com'
+    _service = 'lkeap'
+
+
+    def CreateAttributeLabel(self, request):
+        """用于为问答对创建属性标签，以便对内容进行分类和管理。 使用场景：当需要为问答对添加分类标签和属性标记时使用，比如为问答对添加“售后”标签。
+
+        :param request: Request instance for CreateAttributeLabel.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.CreateAttributeLabelRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.CreateAttributeLabelResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateAttributeLabel", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateAttributeLabelResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def CreateKnowledgeBase(self, request):
+        """用于在系统中创建一个新的知识库。知识库是一个用于存储和管理知识条目的集合，可以包括文档、问答对、属性标签等。创建知识库后，可以向其中添加各种知识条目，以便在后续的知识检索中使用。 使用场景：当需要在系统中建立一个新的知识库以存储和管理特定领域或项目的知识条目时使用。例如，一个用户可能需要创建一个知识库，以存储用户指南、常见问题解答和技术文档。
+
+        :param request: Request instance for CreateKnowledgeBase.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.CreateKnowledgeBaseRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.CreateKnowledgeBaseResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateKnowledgeBase", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateKnowledgeBaseResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def CreateQA(self, request):
+        """用于创建新的问答对。问答对可以在SearchKnowledge接口知识检索时提供匹配的答案。 使用场景：当需要添加新的知识点和对应的问答对时使用，比如为产品添加新的常见问题解答。
+
+        :param request: Request instance for CreateQA.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.CreateQARequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.CreateQAResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateQA", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateQAResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def CreateReconstructDocumentFlow(self, request):
+        """本接口为异步接口的发起请求接口，用于发起文档解析任务。
+        文档解析支持将图片或PDF文件转换成Markdown格式文件，可解析包括表格、公式、图片、标题、段落、页眉、页脚等内容元素，并将内容智能转换成阅读顺序。
+
+        体验期间单账号限制qps仅为1，若有正式接入需要请与产研团队沟通开放。
+
+        :param request: Request instance for CreateReconstructDocumentFlow.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.CreateReconstructDocumentFlowRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.CreateReconstructDocumentFlowResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateReconstructDocumentFlow", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateReconstructDocumentFlowResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def CreateSplitDocumentFlow(self, request):
+        """创建文档拆分任务
+
+        :param request: Request instance for CreateSplitDocumentFlow.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.CreateSplitDocumentFlowRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.CreateSplitDocumentFlowResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateSplitDocumentFlow", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateSplitDocumentFlowResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DeleteAttributeLabels(self, request):
+        """用于删除不再需要的属性标签。 使用场景：当某个标签不再使用时，可以将其删除以保持标签系统的整洁。
+
+        :param request: Request instance for DeleteAttributeLabels.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.DeleteAttributeLabelsRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.DeleteAttributeLabelsResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DeleteAttributeLabels", params, headers=headers)
+            response = json.loads(body)
+            model = models.DeleteAttributeLabelsResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DeleteDocs(self, request):
+        """用于删除已有的文档。 使用场景：当某个文档不再需要时，可以将其删除以保持文档库的整洁。
+
+        :param request: Request instance for DeleteDocs.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.DeleteDocsRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.DeleteDocsResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DeleteDocs", params, headers=headers)
+            response = json.loads(body)
+            model = models.DeleteDocsResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DeleteKnowledgeBase(self, request):
+        """用于从系统中删除一个现有的知识库。删除知识库将移除该知识库及其所有关联的知识条目（如文档、问答对、属性标签等）。该操作是不可逆的，请在执行前确认是否需要删除。**使用场景**：当某个知识库不再需要时，可以使用此接口将其从系统中删除。例如，一个项目结束后，其相关的知识库可能不再需要存储，可以使用该接口进行删除。
+
+        :param request: Request instance for DeleteKnowledgeBase.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.DeleteKnowledgeBaseRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.DeleteKnowledgeBaseResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DeleteKnowledgeBase", params, headers=headers)
+            response = json.loads(body)
+            model = models.DeleteKnowledgeBaseResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DeleteQAs(self, request):
+        """用于删除已有的问答对。 使用场景：当某个问答对不再适用或需要移除时使用。
+
+        :param request: Request instance for DeleteQAs.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.DeleteQAsRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.DeleteQAsResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DeleteQAs", params, headers=headers)
+            response = json.loads(body)
+            model = models.DeleteQAsResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DescribeDoc(self, request):
+        """用于查询特定文档的详细信息。 使用场景：当需要查看某个文档的具体内容和属性时使用。
+
+        :param request: Request instance for DescribeDoc.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.DescribeDocRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.DescribeDocResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeDoc", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeDocResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def GetEmbedding(self, request):
+        """本接口（GetEmbedding）调用文本表示模型，将文本转化为用数值表示的向量形式，可用于文本检索、信息推荐、知识挖掘等场景。
+        本接口（GetEmbedding）有单账号调用上限控制，如您有提高并发限制的需求请 [联系我们](https://cloud.tencent.com/act/event/Online_service) 。
+
+        :param request: Request instance for GetEmbedding.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.GetEmbeddingRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.GetEmbeddingResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("GetEmbedding", params, headers=headers)
+            response = json.loads(body)
+            model = models.GetEmbeddingResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def GetReconstructDocumentResult(self, request):
+        """本接口为异步接口的查询结果接口，用于获取文档解析处理结果。
+
+        :param request: Request instance for GetReconstructDocumentResult.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.GetReconstructDocumentResultRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.GetReconstructDocumentResultResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("GetReconstructDocumentResult", params, headers=headers)
+            response = json.loads(body)
+            model = models.GetReconstructDocumentResultResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def GetSplitDocumentResult(self, request):
+        """查询文档拆分任务结果
+
+        :param request: Request instance for GetSplitDocumentResult.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.GetSplitDocumentResultRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.GetSplitDocumentResultResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("GetSplitDocumentResult", params, headers=headers)
+            response = json.loads(body)
+            model = models.GetSplitDocumentResultResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def ImportQAs(self, request):
+        """用于批量导入问答对，最多支持50,000条数据导入。通过此接口，可以将多个问答对一次性导入系统中，以便在后续的知识检索中使用。导入的问答对可以来自外部系统、文件或其他数据源。使用场景：当需要一次性导入大量的问答对时使用。例如，一个公司可能需要将其产品的常见问题解答从一个文档或外部系统批量导入到知识库中，以便用户可以通过知识检索系统进行查询。
+
+        :param request: Request instance for ImportQAs.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.ImportQAsRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.ImportQAsResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ImportQAs", params, headers=headers)
+            response = json.loads(body)
+            model = models.ImportQAsResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def ListAttributeLabels(self, request):
+        """用于获取所有属性标签的列表。 使用场景：用于查看当前系统中所有已有的属性标签，方便进行管理和维护。
+
+        :param request: Request instance for ListAttributeLabels.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.ListAttributeLabelsRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.ListAttributeLabelsResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ListAttributeLabels", params, headers=headers)
+            response = json.loads(body)
+            model = models.ListAttributeLabelsResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def ListDocs(self, request):
+        """用于获取所有文档的列表。 使用场景：用于查看当前系统中所有已有的文档，方便进行管理和维护。
+
+        :param request: Request instance for ListDocs.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.ListDocsRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.ListDocsResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ListDocs", params, headers=headers)
+            response = json.loads(body)
+            model = models.ListDocsResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def ListQAs(self, request):
+        """用于获取所有问答对的列表。 使用场景：用于查看当前系统中所有已有的问答对，方便进行管理和维护。
+
+        :param request: Request instance for ListQAs.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.ListQAsRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.ListQAsResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ListQAs", params, headers=headers)
+            response = json.loads(body)
+            model = models.ListQAsResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def ModifyAttributeLabel(self, request):
+        """用于修改已有的属性标签。 使用场景：当需要更改属性标签的名称或描述时使用，比如将“售后”标签改为“售前”。
+
+        :param request: Request instance for ModifyAttributeLabel.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.ModifyAttributeLabelRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.ModifyAttributeLabelResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ModifyAttributeLabel", params, headers=headers)
+            response = json.loads(body)
+            model = models.ModifyAttributeLabelResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def ModifyQA(self, request):
+        """用于修改已有的问答对。 使用场景：当需要更新问答对的内容或答案时使用。
+
+        :param request: Request instance for ModifyQA.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.ModifyQARequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.ModifyQAResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ModifyQA", params, headers=headers)
+            response = json.loads(body)
+            model = models.ModifyQAResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def ReconstructDocumentSSE(self, request):
+        """准实时文档解析接口，使用HTTP SSE 协议通信。
+
+        :param request: Request instance for ReconstructDocumentSSE.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.ReconstructDocumentSSERequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.ReconstructDocumentSSEResponse`
+
+        """
+        try:
+            params = request._serialize()
+            return self._call_and_deserialize("ReconstructDocumentSSE", params, models.ReconstructDocumentSSEResponse, headers=request.headers)
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def RetrieveKnowledge(self, request):
+        """用于检索知识库中的文档和问答对内容。 使用场景：适用于查询长期存储在知识库中的文档和问答对，比如产品手册、用户指南等内容的检索。
+
+        :param request: Request instance for RetrieveKnowledge.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.RetrieveKnowledgeRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.RetrieveKnowledgeResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("RetrieveKnowledge", params, headers=headers)
+            response = json.loads(body)
+            model = models.RetrieveKnowledgeResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def RunRerank(self, request):
+        """基于知识引擎精调模型技术的rerank模型，支持对多路召回的结果进行重排序，根据query与切片内容的相关性，按分数由高到低对切片进行排序，并输出对应的打分结果。
+
+        :param request: Request instance for RunRerank.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.RunRerankRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.RunRerankResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("RunRerank", params, headers=headers)
+            response = json.loads(body)
+            model = models.RunRerankResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def UploadDoc(self, request):
+        """用于上传文档内容。上传的文档将存储在知识库中，可以通过SearchKnowledge知识库内容检索接口进行检索。
+        使用场景：适用于需要长期存储和检索的文档内容，如产品手册、用户指南等。
+
+        :param request: Request instance for UploadDoc.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.UploadDocRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.UploadDocResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("UploadDoc", params, headers=headers)
+            response = json.loads(body)
+            model = models.UploadDocResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def UploadDocRealtime(self, request):
+        """用于上传实时文档内容。实时文档在上传后可以立即通过SearchRealtime进行实时检索，适用于在会话中对文档进行问答的场景。
+
+        :param request: Request instance for UploadDocRealtime.
+        :type request: :class:`tencentcloud.lkeap.v20240522.models.UploadDocRealtimeRequest`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.UploadDocRealtimeResponse`
+
+        """
+        try:
+            params = request._serialize()
+            return self._call_and_deserialize("UploadDocRealtime", params, models.UploadDocRealtimeResponse, headers=request.headers)
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))