huaweicloudsdkversatile 3.1.184__py3-none-any.whl

huaweicloudsdkversatile/v1/versatile_client.py

@@ -0,0 +1,375 @@
+# coding: utf-8
+
+from __future__ import absolute_import
+
+import importlib
+import warnings
+
+from huaweicloudsdkcore.client import Client, ClientBuilder
+from huaweicloudsdkcore.utils import http_utils
+from huaweicloudsdkcore.sdk_stream_request import SdkStreamRequest
+
+try:
+    from huaweicloudsdkcore.invoker.invoker import SyncInvoker
+except ImportError as e:
+    warnings.warn(str(e) + ", please check if you are using the same versions of 'huaweicloudsdkcore' and 'huaweicloudsdkversatile'")
+
+
+class VersatileClient(Client):
+    def __init__(self):
+        super().__init__()
+        self.model_package = importlib.import_module("huaweicloudsdkversatile.v1.model")
+
+    @classmethod
+    def new_builder(cls, clazz=None):
+        if not clazz:
+            client_builder = ClientBuilder(cls)
+        else:
+            if clazz.__name__ != "VersatileClient":
+                raise TypeError("client type error, support client type is VersatileClient")
+            client_builder = ClientBuilder(clazz)
+
+        
+
+        return client_builder
+
+    def search_knowledge_base(self, request):
+        r"""知识库检索
+
+        提供多知识库并行检索能力，支持语义、关键词、混合及FAQ四种检索模式，并允许自定义相似度阈值与返回结果数量，实现精准高效的信息匹配。
+        
+        **适用场景**：
+        - 同时从多个知识库或文档集合中搜索相关内容。
+        - 在预设的问答列表中快速定位最相关的答案（FAQ检索）。
+        - 通过混合模式或调整阈值，兼顾搜索结果的准确性和全面性。
+        
+        Please refer to HUAWEI cloud API Explorer for details.
+
+        :param request: Request instance for SearchKnowledgeBase
+        :type request: :class:`huaweicloudsdkversatile.v1.SearchKnowledgeBaseRequest`
+        :rtype: :class:`huaweicloudsdkversatile.v1.SearchKnowledgeBaseResponse`
+        """
+        http_info = self._search_knowledge_base_http_info(request)
+        return self._call_api(**http_info)
+
+    def search_knowledge_base_invoker(self, request):
+        http_info = self._search_knowledge_base_http_info(request)
+        return SyncInvoker(self, http_info)
+
+    @classmethod
+    def _search_knowledge_base_http_info(cls, request):
+        http_info = {
+            "method": "POST",
+            "resource_path": "/v2/{project_id}/knowledge-bases/retrieve",
+            "request_type": request.__class__.__name__,
+            "response_type": "SearchKnowledgeBaseResponse"
+            }
+
+        local_var_params = {attr: getattr(request, attr) for attr in request.attribute_map if hasattr(request, attr)}
+
+        cname = None
+
+        collection_formats = {}
+
+        path_params = {}
+
+        query_params = []
+
+        header_params = {}
+
+        form_params = {}
+
+        body = None
+        if 'body' in local_var_params:
+            body = local_var_params['body']
+        if isinstance(request, SdkStreamRequest):
+            body = request.get_file_stream()
+
+        response_headers = []
+
+        header_params['Content-Type'] = http_utils.select_header_content_type(
+            ['application/json'])
+
+        auth_settings = []
+
+        http_info["cname"] = cname
+        http_info["collection_formats"] = collection_formats
+        http_info["path_params"] = path_params
+        http_info["query_params"] = query_params
+        http_info["header_params"] = header_params
+        http_info["post_params"] = form_params
+        http_info["body"] = body
+        http_info["response_headers"] = response_headers
+
+        return http_info
+
+    def run_agent(self, request):
+        r"""运行一个智能体
+
+        运行一个智能体，支持流式和非流式
+        
+        Please refer to HUAWEI cloud API Explorer for details.
+
+        :param request: Request instance for RunAgent
+        :type request: :class:`huaweicloudsdkversatile.v1.RunAgentRequest`
+        :rtype: :class:`huaweicloudsdkversatile.v1.RunAgentResponse`
+        """
+        http_info = self._run_agent_http_info(request)
+        return self._call_api(**http_info)
+
+    def run_agent_invoker(self, request):
+        http_info = self._run_agent_http_info(request)
+        return SyncInvoker(self, http_info)
+
+    @classmethod
+    def _run_agent_http_info(cls, request):
+        http_info = {
+            "method": "POST",
+            "resource_path": "/v1/{project_id}/agents/{agent_id}/conversations/{conversation_id}",
+            "request_type": request.__class__.__name__,
+            "response_type": "RunAgentResponse"
+            }
+
+        local_var_params = {attr: getattr(request, attr) for attr in request.attribute_map if hasattr(request, attr)}
+
+        cname = None
+
+        collection_formats = {}
+
+        path_params = {}
+        if 'agent_id' in local_var_params:
+            path_params['agent_id'] = local_var_params['agent_id']
+        if 'conversation_id' in local_var_params:
+            path_params['conversation_id'] = local_var_params['conversation_id']
+
+        query_params = []
+        if 'workspace_id' in local_var_params:
+            query_params.append(('workspace_id', local_var_params['workspace_id']))
+        if 'version' in local_var_params:
+            query_params.append(('version', local_var_params['version']))
+        if 'type' in local_var_params:
+            query_params.append(('type', local_var_params['type']))
+
+        header_params = {}
+        if 'stream' in local_var_params:
+            header_params['stream'] = local_var_params['stream']
+
+        form_params = {}
+
+        body = None
+        if 'body' in local_var_params:
+            body = local_var_params['body']
+        if isinstance(request, SdkStreamRequest):
+            body = request.get_file_stream()
+
+        response_headers = []
+
+        header_params['Content-Type'] = http_utils.select_header_content_type(
+            ['application/json'])
+
+        auth_settings = []
+
+        http_info["cname"] = cname
+        http_info["collection_formats"] = collection_formats
+        http_info["path_params"] = path_params
+        http_info["query_params"] = query_params
+        http_info["header_params"] = header_params
+        http_info["post_params"] = form_params
+        http_info["body"] = body
+        http_info["response_headers"] = response_headers
+
+        return http_info
+
+    def run_workflow(self, request):
+        r"""运行一个工作流
+
+        运行一个工作流，支持流式和非流式
+        
+        Please refer to HUAWEI cloud API Explorer for details.
+
+        :param request: Request instance for RunWorkflow
+        :type request: :class:`huaweicloudsdkversatile.v1.RunWorkflowRequest`
+        :rtype: :class:`huaweicloudsdkversatile.v1.RunWorkflowResponse`
+        """
+        http_info = self._run_workflow_http_info(request)
+        return self._call_api(**http_info)
+
+    def run_workflow_invoker(self, request):
+        http_info = self._run_workflow_http_info(request)
+        return SyncInvoker(self, http_info)
+
+    @classmethod
+    def _run_workflow_http_info(cls, request):
+        http_info = {
+            "method": "POST",
+            "resource_path": "/v1/{project_id}/workflows/{workflow_id}/conversations/{conversation_id}",
+            "request_type": request.__class__.__name__,
+            "response_type": "RunWorkflowResponse"
+            }
+
+        local_var_params = {attr: getattr(request, attr) for attr in request.attribute_map if hasattr(request, attr)}
+
+        cname = None
+
+        collection_formats = {}
+
+        path_params = {}
+        if 'workflow_id' in local_var_params:
+            path_params['workflow_id'] = local_var_params['workflow_id']
+        if 'conversation_id' in local_var_params:
+            path_params['conversation_id'] = local_var_params['conversation_id']
+
+        query_params = []
+        if 'workspace_id' in local_var_params:
+            query_params.append(('workspace_id', local_var_params['workspace_id']))
+        if 'version' in local_var_params:
+            query_params.append(('version', local_var_params['version']))
+
+        header_params = {}
+        if 'stream' in local_var_params:
+            header_params['stream'] = local_var_params['stream']
+
+        form_params = {}
+
+        body = None
+        if 'body' in local_var_params:
+            body = local_var_params['body']
+        if isinstance(request, SdkStreamRequest):
+            body = request.get_file_stream()
+
+        response_headers = []
+
+        header_params['Content-Type'] = http_utils.select_header_content_type(
+            ['application/json'])
+
+        auth_settings = []
+
+        http_info["cname"] = cname
+        http_info["collection_formats"] = collection_formats
+        http_info["path_params"] = path_params
+        http_info["query_params"] = query_params
+        http_info["header_params"] = header_params
+        http_info["post_params"] = form_params
+        http_info["body"] = body
+        http_info["response_headers"] = response_headers
+
+        return http_info
+
+    def upload_agent_file(self, request):
+        r"""上传文件
+
+        上传文件，以供agent或者工作流使用
+        
+        Please refer to HUAWEI cloud API Explorer for details.
+
+        :param request: Request instance for UploadAgentFile
+        :type request: :class:`huaweicloudsdkversatile.v1.UploadAgentFileRequest`
+        :rtype: :class:`huaweicloudsdkversatile.v1.UploadAgentFileResponse`
+        """
+        http_info = self._upload_agent_file_http_info(request)
+        return self._call_api(**http_info)
+
+    def upload_agent_file_invoker(self, request):
+        http_info = self._upload_agent_file_http_info(request)
+        return SyncInvoker(self, http_info)
+
+    @classmethod
+    def _upload_agent_file_http_info(cls, request):
+        http_info = {
+            "method": "POST",
+            "resource_path": "/v1/{project_id}/agent-runtime/upload-file",
+            "request_type": request.__class__.__name__,
+            "response_type": "UploadAgentFileResponse"
+            }
+
+        local_var_params = {attr: getattr(request, attr) for attr in request.attribute_map if hasattr(request, attr)}
+
+        cname = None
+
+        collection_formats = {}
+
+        path_params = {}
+
+        query_params = []
+        if 'workspace_id' in local_var_params:
+            query_params.append(('workspace_id', local_var_params['workspace_id']))
+        if 'expires' in local_var_params:
+            query_params.append(('expires', local_var_params['expires']))
+        if 'is_image' in local_var_params:
+            query_params.append(('is_image', local_var_params['is_image']))
+
+        header_params = {}
+
+        form_params = {}
+        if 'file' in local_var_params:
+            form_params['file'] = local_var_params['file']
+
+        body = None
+        if 'body' in local_var_params:
+            body = local_var_params['body']
+        if isinstance(request, SdkStreamRequest):
+            body = request.get_file_stream()
+
+        response_headers = []
+
+        header_params['Content-Type'] = http_utils.select_header_content_type(
+            ['multipart/form-data'])
+
+        auth_settings = []
+
+        http_info["cname"] = cname
+        http_info["collection_formats"] = collection_formats
+        http_info["path_params"] = path_params
+        http_info["query_params"] = query_params
+        http_info["header_params"] = header_params
+        http_info["post_params"] = form_params
+        http_info["body"] = body
+        http_info["response_headers"] = response_headers
+
+        return http_info
+
+    def _call_api(self, **kwargs):
+        try:
+            return self.do_http_request(**kwargs)
+        except TypeError:
+            import inspect
+            params = inspect.signature(self.do_http_request).parameters
+            http_info = {param_name: kwargs.get(param_name) for param_name in params if param_name in kwargs}
+            return self.do_http_request(**http_info)
+
+    def call_api(self, resource_path, method, path_params=None, query_params=None, header_params=None, body=None,
+                 post_params=None, cname=None, response_type=None, response_headers=None, auth_settings=None,
+                 collection_formats=None, request_type=None):
+        """Makes the HTTP request and returns deserialized data.
+
+        :param resource_path: Path to method endpoint.
+        :param method: Method to call.
+        :param path_params: Path parameters in the url.
+        :param query_params: Query parameters in the url.
+        :param header_params: Header parameters to be placed in the request header.
+        :param body: Request body.
+        :param post_params: Request post form parameters,
+            for `application/x-www-form-urlencoded`, `multipart/form-data`.
+        :param cname: Used for obs endpoint.
+        :param auth_settings: Auth Settings names for the request.
+        :param response_type: Response data type.
+        :param response_headers: Header should be added to response data.
+        :param collection_formats: dict of collection formats for path, query,
+            header, and post parameters.
+        :param request_type: Request data type.
+        :return:
+            Return the response directly.
+        """
+        return self.do_http_request(
+            method=method,
+            resource_path=resource_path,
+            path_params=path_params,
+            query_params=query_params,
+            header_params=header_params,
+            body=body,
+            post_params=post_params,
+            cname=cname,
+            response_type=response_type,
+            response_headers=response_headers,
+            collection_formats=collection_formats,
+            request_type=request_type)

huaweicloudsdkversatile-3.1.184.dist-info/METADATA

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: huaweicloudsdkversatile
+Version: 3.1.184
+Summary: Versatile
+Project-URL: Homepage, https://github.com/huaweicloud/huaweicloud-sdk-python-v3
+Author-email: HuaweiCloud SDK <hwcloudsdk@huawei.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: Versatile,huaweicloud,sdk
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Requires-Python: >=3.6
+Requires-Dist: huaweicloudsdkcore>=3.1.184
+Description-Content-Type: text/markdown
+
+See detailed information in [huaweicloud-sdk-python-v3](https://github.com/huaweicloud/huaweicloud-sdk-python-v3).

huaweicloudsdkversatile-3.1.184.dist-info/RECORD

@@ -0,0 +1,35 @@
+huaweicloudsdkversatile/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+huaweicloudsdkversatile/v1/__init__.py,sha256=Cpv2-d9gaJw-QKXVEm4GdCjESb3OkOmEdvMfuYTv9QQ,2226
+huaweicloudsdkversatile/v1/versatile_async_client.py,sha256=5Wo6gJPK09CSDEY9Htq4H9pYYvufuWssEZW7JSCfjeA,13804
+huaweicloudsdkversatile/v1/versatile_client.py,sha256=Qu3X2Vm_0WaJpCvQOjVBYm8mxXbA4Zuioloa7yq_q0k,13712
+huaweicloudsdkversatile/v1/model/__init__.py,sha256=KhDCkuceyeWUEx8K-qxNey25Mjv2eTtK7Vc5WeOkjwI,2104
+huaweicloudsdkversatile/v1/model/agent_run_req.py,sha256=DjszrvNS6f-U4VTknA5QVJwk_d09knOrhIgvmJFmwJw,8808
+huaweicloudsdkversatile/v1/model/conversation.py,sha256=n0hF0dVO1CxTzQ63HsJ0x_kuMMNSHhF6QxNo6ZgFo38,3887
+huaweicloudsdkversatile/v1/model/feedback_reason.py,sha256=lVUYbCzUGXBxaUhMhUTzMOKg8CMT-S4q6goOB-Nn0wA,3512
+huaweicloudsdkversatile/v1/model/knowledge_base_retrieval_req.py,sha256=xT9MvyseKQa9wULyK5Yd4bzJHaqBg0FV900UM0qI_ls,11557
+huaweicloudsdkversatile/v1/model/message.py,sha256=DdaHO0mGvurwQ8GR9obkV6V5t-Pl1dHcVlQJV1nA6f4,13182
+huaweicloudsdkversatile/v1/model/node_message.py,sha256=-VMehIbkLQUPI2ZCCyoVcfsfKDg2Tlk0nf3ZpKlpjH8,7123
+huaweicloudsdkversatile/v1/model/node_run_info.py,sha256=KhPFBJptWRBua_iLg_41hS66hjhPWLM8oraz0xObY-s,20574
+huaweicloudsdkversatile/v1/model/node_run_info_inner_error.py,sha256=RDyeZTX2g_T2VK-9NNFpLJiQaF21qimd0pIwNDK1xO8,3933
+huaweicloudsdkversatile/v1/model/node_run_info_inner_error_error_body.py,sha256=fpbqrIt6Frxjiv_zIfxu11rJxyX3kHraZB8LE2SXUUA,3928
+huaweicloudsdkversatile/v1/model/plugin_config.py,sha256=OH9NUwAL84tiTcXq615B4ux6Cuvrc5Yn_dnEbVnZfKo,3617
+huaweicloudsdkversatile/v1/model/retrieval_result_info.py,sha256=9feXdR3za4ZmKRMdIVK6582uLn3G-RBvAE2Vh6D-gOs,9516
+huaweicloudsdkversatile/v1/model/run_agent_request.py,sha256=VaQZ7iv_nOu0VCrsb4kxZrN6EUknvZLXZYBYaGyHyjs,9593
+huaweicloudsdkversatile/v1/model/run_agent_response.py,sha256=ouvcMXVXbL9pktUa4TKlIcWq7VQbQk9vmb0bMvWiSJc,11325
+huaweicloudsdkversatile/v1/model/run_workflow_request.py,sha256=yCIA0OUehdMy0ClBSLagKWvdPLFTRa1qlUIJGJye6zA,8745
+huaweicloudsdkversatile/v1/model/run_workflow_response.py,sha256=HBqZAO_emfV6WfZAt5v-HcZHvVARBn6xA8C_QARlE7s,11469
+huaweicloudsdkversatile/v1/model/search_knowledge_base_request.py,sha256=gN7f7L-qIHwHkyZrpF-ZS1GR8o0rokcOmfzVgyFdzK0,3029
+huaweicloudsdkversatile/v1/model/search_knowledge_base_response.py,sha256=1sr3nL5f1TFJrG32PGOKzPrHmUCA_4BXp8wG9rXmR6s,4833
+huaweicloudsdkversatile/v1/model/status.py,sha256=0FR4Oh-M-6r9rQDkmBMhpNq6qEIzgGVeBNIXx8QhzEI,3271
+huaweicloudsdkversatile/v1/model/upload_agent_file_request.py,sha256=ZYHyuwuvGq9LEBk5GryupKmEd7-D9QdPsujSsj3SvEc,5856
+huaweicloudsdkversatile/v1/model/upload_agent_file_request_body.py,sha256=S_EJaOP-prpAtSHXhw2iAkOl0L_zA--WU4az8JYEpyQ,2978
+huaweicloudsdkversatile/v1/model/upload_agent_file_response.py,sha256=MgmblQSIBxV5uVNIFEkfnNZuWiAcpMFg6tiunsyMC5s,4677
+huaweicloudsdkversatile/v1/model/user_profile.py,sha256=52QTYhkwBacMT7sB2QUlmXLm_LF3zH6st6sWZriFq8M,4012
+huaweicloudsdkversatile/v1/model/workflow_run_req.py,sha256=kk9EtsDgNvOuMiVNVjk5kv5uogJjtYCzpkHwxdjWaxk,10406
+huaweicloudsdkversatile/v1/model/workflow_run_stream_rsp.py,sha256=xAJeWBuFI_5MyDxZI6GyoH8f2qtujZmZ578eKqQ_AcA,6319
+huaweicloudsdkversatile/v1/region/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+huaweicloudsdkversatile/v1/region/versatile_region.py,sha256=RUEXPSDt7xZEN2Va0JKxULze4s36EcEW7Hh15OMMtYc,985
+huaweicloudsdkversatile-3.1.184.dist-info/METADATA,sha256=f9Ttcf6KrkUyOJY-VvwzJNe0EkTRXqge_5wJj6Na_Q0,1090
+huaweicloudsdkversatile-3.1.184.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+huaweicloudsdkversatile-3.1.184.dist-info/licenses/LICENSE,sha256=4_VSTLuxcsybRG9N4Isktlj1rAIBBsfl0Tjc0gBTijo,604
+huaweicloudsdkversatile-3.1.184.dist-info/RECORD,,

huaweicloudsdkversatile-3.1.184.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

huaweicloudsdkversatile-3.1.184.dist-info/licenses/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) Huawei Technologies Co., Ltd. 2020-present. 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.