sycommon-python-lib 0.1.52a0__tar.gz → 0.1.57b6__tar.gz

{sycommon_python_lib-0.1.52a0 → sycommon_python_lib-0.1.57b6}/PKG-INFO

@@ -1,24 +1,31 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.1.52a0
+Version: 0.1.57b6
 Summary: Add your description here
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Requires-Dist: aio-pika>=9.5.8
-Requires-Dist: aiohttp>=3.13.2
+Requires-Dist: aiohttp>=3.13.3
+Requires-Dist: aiomysql>=0.3.2
 Requires-Dist: decorator>=5.2.1
-Requires-Dist: fastapi>=0.121.2
-Requires-Dist: kafka-python>=2.2.16
+Requires-Dist: fastapi>=0.128.0
+Requires-Dist: kafka-python>=2.3.0
+Requires-Dist: langchain>=1.2.3
+Requires-Dist: langchain-core>=1.2.7
+Requires-Dist: langchain-openai>=1.1.7
+Requires-Dist: langfuse>=3.11.2
+Requires-Dist: langgraph>=1.0.6
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: mysql-connector-python>=9.5.0
-Requires-Dist: nacos-sdk-python>=2.0.9
-Requires-Dist: pydantic>=2.12.4
+Requires-Dist: nacos-sdk-python<3.0,>=2.0.9
+Requires-Dist: psutil>=7.2.1
+Requires-Dist: pydantic>=2.12.5
 Requires-Dist: python-dotenv>=1.2.1
 Requires-Dist: pyyaml>=6.0.3
-Requires-Dist: sqlalchemy>=2.0.44
-Requires-Dist: starlette>=0.49.3
-Requires-Dist: uuid>=1.30
-Requires-Dist: uvicorn>=0.38.0
+Requires-Dist: sentry-sdk[fastapi]>=2.49.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.45
+Requires-Dist: starlette>=0.50.0
+Requires-Dist: uvicorn>=0.40.0
 
 # sycommon-python-lib
 

sycommon_python_lib-0.1.57b6/pyproject.toml

@@ -0,0 +1,40 @@
+[project]
+name = "sycommon-python-lib"
+version = "0.1.57b6"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "aio-pika>=9.5.8",
+    "aiohttp>=3.13.3",
+    "aiomysql>=0.3.2",
+    "decorator>=5.2.1",
+    "fastapi>=0.128.0",
+    "kafka-python>=2.3.0",
+    "langchain>=1.2.3",
+    "langchain-core>=1.2.7",
+    "langchain-openai>=1.1.7",
+    "langfuse>=3.11.2",
+    "langgraph>=1.0.6",
+    "loguru>=0.7.3",
+    "mysql-connector-python>=9.5.0",
+    "nacos-sdk-python>=2.0.9,<3.0",
+    "psutil>=7.2.1",
+    "pydantic>=2.12.5",
+    "python-dotenv>=1.2.1",
+    "pyyaml>=6.0.3",
+    "sentry-sdk[fastapi]>=2.49.0",
+    "sqlalchemy[asyncio]>=2.0.45",
+    "starlette>=0.50.0",
+    "uvicorn>=0.40.0",
+]
+
+[tool.setuptools]
+packages = {find = {where = ["src"]}}
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project.scripts]
+sycommon = "command.cli:main"

{sycommon_python_lib-0.1.52a0 → sycommon_python_lib-0.1.57b6}/src/sycommon/config/Config.py

@@ -15,14 +15,13 @@ class Config(metaclass=SingletonMeta):
         with open(config_file, 'r', encoding='utf-8') as f:
             self.config = yaml.safe_load(f)
         self.MaxBytes = self.config.get('MaxBytes', 209715200)
-        self.Timeout = self.config.get('Timeout', 300000)
-        self.OCR = self.config.get('OCR', None)
-        self.INVOICE_OCR = self.config.get('INVOICE_OCR', None)
-        self.UnstructuredAPI = self.config.get('UnstructuredAPI', None)
+        self.Timeout = self.config.get('Timeout', 600000)
         self.MaxRetries = self.config.get('MaxRetries', 3)
         self.llm_configs = []
         self.embedding_configs = []
         self.reranker_configs = []
+        self.sentry_configs = []
+        self.langfuse_configs = []
         self._process_config()
 
     def get_llm_config(self, model_name):
@@ -43,6 +42,18 @@ class Config(metaclass=SingletonMeta):
                 return llm
         raise ValueError(f"No configuration found for model: {model_name}")
 
+    def get_sentry_config(self, name):
+        for sentry in self.sentry_configs:
+            if sentry.get('name') == name:
+                return sentry
+        raise ValueError(f"No configuration found for server: {name}")
+
+    def get_langfuse_config(self, name):
+        for langfuse in self.langfuse_configs:
+            if langfuse.get('name') == name:
+                return langfuse
+        raise ValueError(f"No configuration found for server: {name}")
+
     def _process_config(self):
         llm_config_list = self.config.get('LLMConfig', [])
         for llm_config in llm_config_list:
@@ -71,3 +82,17 @@ class Config(metaclass=SingletonMeta):
                 self.reranker_configs.append(validated_config.model_dump())
             except ValueError as e:
                 print(f"Invalid LLM configuration: {e}")
+
+        sentry_config_list = self.config.get('SentryConfig', [])
+        for sentry_config in sentry_config_list:
+            try:
+                from sycommon.config.SentryConfig import SentryConfig
+                validated_config = SentryConfig(**sentry_config)
+                self.sentry_configs.append(validated_config.model_dump())
+            except ValueError as e:
+                print(f"Invalid Sentry configuration: {e}")
+
+    def set_attr(self, share_configs: dict):
+        self.config = {**self.config, **
+                       share_configs.get('llm', {}), **share_configs}
+        self._process_config()

sycommon_python_lib-0.1.57b6/src/sycommon/config/LangfuseConfig.py

@@ -0,0 +1,15 @@
+from pydantic import BaseModel
+
+
+class LangfuseConfig(BaseModel):
+    name: str
+    secretKey: str
+    publicKey: str
+    baseUrl: str
+    enable: bool
+
+    @classmethod
+    def from_config(cls, server_name: str):
+        from sycommon.config.Config import Config
+        langfuse_config = Config().get_langfuse_config(server_name)
+        return cls(**langfuse_config)

{sycommon_python_lib-0.1.52a0 → sycommon_python_lib-0.1.57b6}/src/sycommon/config/RerankerConfig.py

@@ -5,6 +5,7 @@ class RerankerConfig(BaseModel):
     model: str
     provider: str
     baseUrl: str
+    maxTokens: int
 
     @classmethod
     def from_config(cls, model_name: str):

sycommon_python_lib-0.1.57b6/src/sycommon/config/SentryConfig.py

@@ -0,0 +1,13 @@
+from pydantic import BaseModel
+
+
+class SentryConfig(BaseModel):
+    name: str
+    dsn: str
+    enable: bool
+
+    @classmethod
+    def from_config(cls, server_name: str):
+        from sycommon.config.Config import Config
+        sentry_config = Config().get_sentry_config(server_name)
+        return cls(**sentry_config)

sycommon_python_lib-0.1.57b6/src/sycommon/database/async_base_db_service.py

@@ -0,0 +1,36 @@
+from contextlib import asynccontextmanager
+from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
+from sycommon.config.Config import SingletonMeta
+from sycommon.database.async_database_service import AsyncDatabaseService
+from sycommon.logging.kafka_log import SYLogger
+
+
+class AsyncBaseDBService(metaclass=SingletonMeta):
+    """数据库操作基础服务类，封装异步会话管理功能"""
+
+    def __init__(self):
+        # 获取异步引擎 (假设 DatabaseService.engine() 返回的是 AsyncEngine)
+        self.engine = AsyncDatabaseService.engine()
+
+        # 创建异步 Session 工厂
+        # class_=AsyncSession 是必须的，用于指定生成的是异步会话
+        self.Session = async_sessionmaker(
+            bind=self.engine,
+            class_=AsyncSession,
+            expire_on_commit=False
+        )
+
+    @asynccontextmanager
+    async def session(self):
+        """
+        异步数据库会话上下文管理器
+        自动处理会话的创建、提交、回滚和关闭
+        """
+        async with self.Session() as session:
+            try:
+                yield session
+                await session.commit()
+            except Exception as e:
+                await session.rollback()
+                SYLogger.error(f"Database operation failed: {str(e)}")
+                raise

sycommon_python_lib-0.1.57b6/src/sycommon/database/async_database_service.py

@@ -0,0 +1,96 @@
+from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
+from sqlalchemy import text
+
+from sycommon.config.Config import SingletonMeta
+from sycommon.config.DatabaseConfig import DatabaseConfig, convert_dict_keys
+from sycommon.logging.kafka_log import SYLogger
+from sycommon.logging.async_sql_logger import AsyncSQLTraceLogger
+from sycommon.synacos.nacos_service import NacosService
+
+
+class AsyncDatabaseService(metaclass=SingletonMeta):
+    _engine = None
+
+    @staticmethod
+    async def setup_database(config: dict, shareConfigKey: str):
+        common = NacosService(config).share_configs.get(shareConfigKey, {})
+        if common and common.get('spring', {}).get('datasource', None):
+            databaseConfig = common.get('spring', {}).get('datasource', None)
+            converted_dict = convert_dict_keys(databaseConfig)
+            db_config = DatabaseConfig.model_validate(converted_dict)
+
+            # 初始化 DatabaseConnector (传入配置)
+            connector = AsyncDatabaseConnector(db_config)
+
+            # 赋值 engine
+            AsyncDatabaseService._engine = connector.engine
+
+            # 执行异步测试连接
+            if not await connector.test_connection():
+                raise Exception("Database connection test failed")
+
+    @staticmethod
+    def engine():
+        return AsyncDatabaseService._engine
+
+
+class AsyncDatabaseConnector(metaclass=SingletonMeta):
+    def __init__(self, db_config: DatabaseConfig):
+        # 从 DatabaseConfig 中提取数据库连接信息
+        self.db_user = db_config.username
+        self.db_password = db_config.password
+
+        # 提取 URL 中的主机、端口和数据库名
+        url_parts = db_config.url.split('//')[1].split('/')
+        host_port = url_parts[0].split(':')
+        self.db_host = host_port[0]
+        self.db_port = host_port[1]
+        self.db_name = url_parts[1].split('?')[0]
+
+        # 提取 URL 中的参数
+        params_str = url_parts[1].split('?')[1] if len(
+            url_parts[1].split('?')) > 1 else ''
+        params = {}
+        for param in params_str.split('&'):
+            if param:
+                key, value = param.split('=')
+                params[key] = value
+
+        # 在params中去掉指定的参数
+        for key in ['useUnicode', 'characterEncoding', 'serverTimezone', 'zeroDateTimeBehavior']:
+            if key in params:
+                del params[key]
+
+        # 构建数据库连接 URL
+        # 注意：这里将 mysqlconnector 替换为 aiomysql 以支持异步
+        self.db_url = f'mysql+aiomysql://{self.db_user}:{self.db_password}@{self.db_host}:{self.db_port}/{self.db_name}'
+
+        SYLogger.info(f"Database URL: {self.db_url}")
+
+        # 优化连接池配置
+        # 使用 create_async_engine 替代 create_engine
+        self.engine = create_async_engine(
+            self.db_url,
+            connect_args=params,
+            pool_size=10,  # 连接池大小
+            max_overflow=20,  # 最大溢出连接数
+            pool_timeout=30,  # 连接超时时间（秒）
+            pool_recycle=3600,  # 连接回收时间（秒）
+            pool_pre_ping=True,  # 每次获取连接前检查连接是否有效
+            echo=False,  # 打印 SQL 语句
+        )
+
+        # 注册 SQL 日志拦截器 (注意：SQLTraceLogger 需要支持异步引擎，或者您可能需要调整日志逻辑)
+        # 假设 SQLTraceLogger.setup_sql_logging 能够处理 AsyncEngine
+        AsyncSQLTraceLogger.setup_sql_logging(self.engine)
+
+    async def test_connection(self):
+        try:
+            # 异步上下文管理器
+            async with self.engine.connect() as connection:
+                # 执行简单查询
+                await connection.execute(text("SELECT 1"))
+                return True
+        except Exception as e:
+            SYLogger.error(f"Database connection test failed: {e}")
+            return False

sycommon_python_lib-0.1.57b6/src/sycommon/llm/embedding.py

@@ -0,0 +1,353 @@
+import asyncio
+import aiohttp
+import atexit
+from typing import Union, List, Optional, Dict
+from sycommon.config.Config import SingletonMeta
+from sycommon.config.EmbeddingConfig import EmbeddingConfig
+from sycommon.config.RerankerConfig import RerankerConfig
+from sycommon.logging.kafka_log import SYLogger
+
+
+class Embedding(metaclass=SingletonMeta):
+    def __init__(self):
+        # 1. 并发限制
+        self.max_concurrency = 20
+        # 保留默认模型名称
+        self.default_embedding_model = "bge-large-zh-v1.5"
+        self.default_reranker_model = "bge-reranker-large"
+
+        # 初始化默认模型的基础URL
+        self.embeddings_base_url = EmbeddingConfig.from_config(
+            self.default_embedding_model).baseUrl
+        self.reranker_base_url = RerankerConfig.from_config(
+            self.default_reranker_model).baseUrl
+
+        # [修复] 缓存配置URL，避免高并发下重复读取配置文件
+        self._embedding_url_cache: Dict[str, str] = {
+            self.default_embedding_model: self.embeddings_base_url
+        }
+        self._reranker_url_cache: Dict[str, str] = {
+            self.default_reranker_model: self.reranker_base_url
+        }
+
+        # 并发信号量
+        self.semaphore = asyncio.Semaphore(self.max_concurrency)
+        self.default_timeout = aiohttp.ClientTimeout(total=None)
+
+        # 核心优化：创建全局可复用的ClientSession（连接池复用）
+        self.session = None
+
+        # [修复] 注册退出钩子，确保程序结束时关闭连接池
+        atexit.register(self._sync_close_session)
+
+    async def init_session(self):
+        """初始化全局ClientSession（仅创建一次）"""
+        if self.session is None or self.session.closed:
+            # 配置连接池参数，适配高并发
+            connector = aiohttp.TCPConnector(
+                limit=self.max_concurrency,  # 连接池最大连接数
+                limit_per_host=self.max_concurrency,  # 每个域名的最大连接数
+                ttl_dns_cache=300,  # DNS缓存时间
+                enable_cleanup_closed=True  # 自动清理关闭的连接
+            )
+            self.session = aiohttp.ClientSession(
+                connector=connector,
+                timeout=self.default_timeout
+            )
+
+    async def close_session(self):
+        """关闭全局Session（程序退出时调用）"""
+        if self.session and not self.session.closed:
+            await self.session.close()
+
+    def _sync_close_session(self):
+        """同步关闭Session的封装，供atexit调用"""
+        try:
+            loop = asyncio.get_event_loop()
+            if loop.is_running():
+                # [修复] 修正缩进，确保 create_task 的异常能被捕获
+                try:
+                    loop.create_task(self.close_session())
+                except Exception:
+                    pass
+            else:
+                try:
+                    loop.run_until_complete(self.close_session())
+                except Exception:
+                    pass
+        except Exception:
+            # 捕获获取 loop 时的异常
+            pass
+
+    def _get_embedding_url(self, model: str) -> str:
+        """获取Embedding URL（带缓存）"""
+        if model not in self._embedding_url_cache:
+            self._embedding_url_cache[model] = EmbeddingConfig.from_config(
+                model).baseUrl
+        return self._embedding_url_cache[model]
+
+    def _get_reranker_url(self, model: str) -> str:
+        """获取Reranker URL（带缓存）"""
+        if model not in self._reranker_url_cache:
+            self._reranker_url_cache[model] = RerankerConfig.from_config(
+                model).baseUrl
+        return self._reranker_url_cache[model]
+
+    async def _get_embeddings_http_core(
+        self,
+        input: Union[str, List[str]],
+        encoding_format: str = None,
+        model: str = None,
+        timeout: aiohttp.ClientTimeout = None,
+        **kwargs
+    ):
+        """embedding请求核心逻辑"""
+        await self.init_session()  # 确保Session已初始化
+        async with self.semaphore:
+            request_timeout = timeout or self.default_timeout
+            target_model = model or self.default_embedding_model
+
+            # [修复] 使用缓存获取URL
+            target_base_url = self._get_embedding_url(target_model)
+            url = f"{target_base_url}/v1/embeddings"
+
+            request_body = {
+                "model": target_model,
+                "input": input,
+                "encoding_format": encoding_format or "float"
+            }
+            request_body.update(kwargs)
+
+            # 复用全局Session
+            try:
+                async with self.session.post(
+                    url,
+                    json=request_body,
+                    timeout=request_timeout
+                ) as response:
+                    if response.status != 200:
+                        error_detail = await response.text()
+                        # [日志] 记录详细的HTTP错误响应
+                        SYLogger.error(
+                            f"Embedding request HTTP Error. Status: {response.status}, "
+                            f"Model: {target_model}, URL: {url}. Detail: {error_detail}"
+                        )
+                        return None
+                    return await response.json()
+            except (aiohttp.ClientConnectionResetError, asyncio.TimeoutError, aiohttp.ClientError) as e:
+                # [日志] 记录网络错误
+                SYLogger.error(
+                    f"Embedding request Network Error. Model: {target_model}, URL: {url}. "
+                    f"Error: {e.__class__.__name__} - {str(e)}"
+                )
+                return None
+            except Exception as e:
+                # 记录其他未预期的异常
+                SYLogger.error(
+                    f"Unexpected error in _get_embeddings_http_core: {str(e)}", exc_info=True)
+                return None
+
+    async def _get_embeddings_http_async(
+        self,
+        input: Union[str, List[str]],
+        encoding_format: str = None,
+        model: str = None,
+        timeout: aiohttp.ClientTimeout = None, ** kwargs
+    ):
+        """对外暴露的embedding请求方法"""
+        return await self._get_embeddings_http_core(
+            input, encoding_format, model, timeout, ** kwargs
+        )
+
+    async def _get_reranker_http_core(
+        self,
+        documents: List[str],
+        query: str,
+        top_n: Optional[int] = None,
+        model: str = None,
+        max_chunks_per_doc: Optional[int] = None,
+        return_documents: Optional[bool] = True,
+        return_len: Optional[bool] = True,
+        timeout: aiohttp.ClientTimeout = None, ** kwargs
+    ):
+        """reranker请求核心逻辑"""
+        await self.init_session()  # 确保Session已初始化
+        async with self.semaphore:
+            request_timeout = timeout or self.default_timeout
+            target_model = model or self.default_reranker_model
+
+            # [修复] 使用缓存获取URL
+            target_base_url = self._get_reranker_url(target_model)
+            url = f"{target_base_url}/v1/rerank"
+
+            request_body = {
+                "model": target_model,
+                "documents": documents,
+                "query": query,
+                "top_n": top_n or len(documents),
+                "max_chunks_per_doc": max_chunks_per_doc,
+                "return_documents": return_documents,
+                "return_len": return_len,
+            }
+            request_body.update(kwargs)
+
+            # 复用全局Session
+            try:
+                async with self.session.post(
+                    url,
+                    json=request_body,
+                    timeout=request_timeout
+                ) as response:
+                    if response.status != 200:
+                        error_detail = await response.text()
+                        # [日志] 记录详细的HTTP错误响应
+                        SYLogger.error(
+                            f"Reranker request HTTP Error. Status: {response.status}, "
+                            f"Model: {target_model}, URL: {url}. Detail: {error_detail}"
+                        )
+                        return None
+                    return await response.json()
+            except (aiohttp.ClientConnectionResetError, asyncio.TimeoutError, aiohttp.ClientError) as e:
+                # [日志] 记录网络错误
+                SYLogger.error(
+                    f"Reranker request Network Error. Model: {target_model}, URL: {url}. "
+                    f"Error: {e.__class__.__name__} - {str(e)}"
+                )
+                return None
+            except Exception as e:
+                # 记录其他未预期的异常
+                SYLogger.error(
+                    f"Unexpected error in _get_reranker_http_core: {str(e)}", exc_info=True)
+                return None
+
+    async def _get_reranker_http_async(
+        self,
+        documents: List[str],
+        query: str,
+        top_n: Optional[int] = None,
+        model: str = None,
+        max_chunks_per_doc: Optional[int] = None,
+        return_documents: Optional[bool] = True,
+        return_len: Optional[bool] = True,
+        timeout: aiohttp.ClientTimeout = None, ** kwargs
+    ):
+        """对外暴露的reranker请求方法"""
+        return await self._get_reranker_http_core(
+            documents, query, top_n, model, max_chunks_per_doc,
+            return_documents, return_len, timeout, **kwargs
+        )
+
+    def _get_dimension(self, model: str) -> int:
+        """获取模型维度，用于生成兜底零向量"""
+        try:
+            config = EmbeddingConfig.from_config(model)
+            if hasattr(config, 'dimension'):
+                return int(config.dimension)
+        except Exception:
+            pass
+        # 默认兜底 1024
+        return 1024
+
+    async def get_embeddings(
+        self,
+        corpus: List[str],
+        model: str = None,
+        timeout: Optional[Union[int, float]] = None
+    ):
+        """
+        获取语料库的嵌入向量，结果顺序与输入语料库顺序一致
+
+        Args:
+            corpus: 待生成嵌入向量的文本列表
+            model: 可选，指定使用的embedding模型名称，默认使用bge-large-zh-v1.5
+            timeout: 可选，超时时间（秒）：
+                     - 传int/float：表示总超时时间（秒）
+                     - 不传/None：使用默认永不超时配置
+        """
+        request_timeout = None
+        if timeout is not None:
+            if isinstance(timeout, (int, float)):
+                request_timeout = aiohttp.ClientTimeout(total=timeout)
+            else:
+                SYLogger.warning(
+                    f"Invalid timeout type: {type(timeout)}, must be int/float, use default timeout")
+
+        actual_model = model or self.default_embedding_model
+
+        SYLogger.info(
+            f"Requesting embeddings for corpus: {len(corpus)} items (model: {actual_model}, max_concurrency: {self.max_concurrency}, timeout: {timeout or 'None'})")
+
+        all_vectors = []
+
+        # [修复] 增加 Chunk 处理逻辑，防止 corpus 过大导致内存溢出或协程过多
+        # 每次最多处理 max_concurrency * 2 个请求，避免一次性创建几十万个协程
+        batch_size = self.max_concurrency * 2
+
+        for i in range(0, len(corpus), batch_size):
+            batch_texts = corpus[i: i + batch_size]
+
+            # 给每个异步任务传入模型名称和超时配置
+            tasks = [self._get_embeddings_http_async(
+                text, model=model, timeout=request_timeout) for text in batch_texts]
+            results = await asyncio.gather(*tasks)
+
+            for result in results:
+                if result is None:
+                    dim = self._get_dimension(actual_model)
+
+                    zero_vector = [0.0] * dim
+                    all_vectors.append(zero_vector)
+                    # [日志] 补充日志，明确是补零操作
+                    SYLogger.warning(
+                        f"Embedding request failed (returned None), appending zero vector ({dim}D) for model {actual_model}")
+                    continue
+
+                # 从返回结果中提取向量
+                try:
+                    for item in result["data"]:
+                        embedding = item["embedding"]
+                        all_vectors.append(embedding)
+                except (KeyError, TypeError) as e:
+                    SYLogger.error(f"Failed to parse embedding result: {e}")
+                    dim = self._get_dimension(actual_model)
+                    all_vectors.append([0.0] * dim)
+
+        SYLogger.info(
+            f"Embeddings for corpus created: {len(all_vectors)} vectors (model: {actual_model})")
+        return all_vectors
+
+    async def get_reranker(
+        self,
+        top_results: List[str],
+        query: str,
+        model: str = None,
+        timeout: Optional[Union[int, float]] = None
+    ):
+        """
+        对搜索结果进行重排序
+
+        Args:
+            top_results: 待重排序的文本列表
+            query: 排序参考的查询语句
+            model: 可选，指定使用的reranker模型名称，默认使用bge-reranker-large
+            timeout: 可选，超时时间（秒）：
+                     - 传int/float：表示总超时时间（秒）
+                     - 不传/None：使用默认永不超时配置
+        """
+        request_timeout = None
+        if timeout is not None:
+            if isinstance(timeout, (int, float)):
+                request_timeout = aiohttp.ClientTimeout(total=timeout)
+            else:
+                SYLogger.warning(
+                    f"Invalid timeout type: {type(timeout)}, must be int/float, use default timeout")
+
+        actual_model = model or self.default_reranker_model
+        SYLogger.info(
+            f"Requesting reranker for top_results: {top_results} (model: {actual_model}, max_concurrency: {self.max_concurrency}, timeout: {timeout or 'None'})")
+
+        data = await self._get_reranker_http_async(
+            top_results, query, model=model, timeout=request_timeout)
+        SYLogger.info(
+            f"Reranker for top_results completed (model: {actual_model})")
+        return data