usecortex-ai 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

usecortex_ai/search/client.py

@@ -51,41 +51,60 @@ class SearchClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Optional[typing.Any]:
         """
+        Ask a question to your uploaded knowledge base and let Cortex AI answer it.
+
         Parameters
         ----------
         question : str
+            The question to be answered
 
         session_id : str
+            Unique identifier for the conversation session. Keep it same when the current question refers to a previous answer or question
 
         tenant_id : str
+            Identifier for the tenant/organization
 
         context_list : typing.Optional[typing.Sequence[str]]
+            List of context strings to provide additional information
 
         search_modes : typing.Optional[typing.Sequence[str]]
+            List of search modes to use for finding relevant information
 
         sub_tenant_id : typing.Optional[str]
+            Identifier for sub-tenant within the tenant
 
         highlight_chunks : typing.Optional[bool]
+            Whether to return text chunks in the response along with final LLM generated answer
 
         stream : typing.Optional[bool]
+            Whether to stream the response
 
         search_alpha : typing.Optional[float]
+            Closer to 0.0 means a exact keyword search will be performed, closer to 1.0 means semantics of the search will be considered. In most cases, you wont have to toggle it yourself.
 
         recency_bias : typing.Optional[float]
+            Bias towards more recent information (0.0 to 1.0)
 
         ai_generation : typing.Optional[bool]
+            Whether to use AI for generating responses
 
         top_n : typing.Optional[int]
+            Number of top results to return
 
         user_name : typing.Optional[str]
+            Name of the user making the request. This helps LLM to know the user's name if semantics around the username are involved in query. Its generally a good practice to include it possible.
 
         user_instructions : typing.Optional[str]
+            Custom instructions for the AI response to add to our proprietary prompt. This can be used to provide additional context or instructions for the LLM to follow so that the answers are tailored towards your application style
 
         multi_step_reasoning : typing.Optional[bool]
+            Enable advanced multi-step reasoning for complex queries. When enabled, the AI will automatically break down complex questions into multiple research steps to provide more comprehensive and accurate answers.
 
         auto_agent_routing : typing.Optional[bool]
+            Enable intelligent agent routing to automatically select the most suitable AI agent for your specific query type. Different agents are optimized for various use cases like social media, code, conversations, general knowledge, etc.
 
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            Additional metadata for the request
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -133,45 +152,33 @@ class SearchClient:
         max_chunks: typing.Optional[int] = OMIT,
         alpha: typing.Optional[Alpha] = OMIT,
         recency_bias: typing.Optional[float] = OMIT,
-        num_related_chunks: typing.Optional[int] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[SearchChunk]:
         """
-        Search for content within indexed sources using semantic and keyword search capabilities.
-
-        This endpoint performs a search query against the Findr backend, allowing users to retrieve
-        relevant content chunks from their indexed documents and sources. The search can be customized
-        with various parameters to control the number of results and search behavior.
-
-        Args:
-            request (SearchRequest): The search request containing:
-                - query (str): Search query string to find relevant content
-                - tenant_id (str, optional): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-                - max_chunks (int, optional): Maximum number of content chunks to return
-                - alpha (Union[float, str], optional): Search algorithm parameter for result ranking (default: 0.8). Can be float-type (0.0-1.0) or 'auto' for dynamic selection
-                - recency_bias (float, optional): Bias towards more recent content (default: 0.5)
-                - num_related_chunks (int, optional): Number of related chunks to return (default: 0)
-            api_details (dict): Authentication details obtained from API key validation
-
-        Returns:
-            SearchData: Success response with search results
+        Search for relevant content within your indexed sources.
+
+        This API returns the chunks related to the query you make. We use neural (embedding) search to give you the most relevant chunks.
+        Results are ranked by relevance and can be customized with parameters like result limits and recency preferences.
 
         Parameters
         ----------
         query : str
+            Search terms to find relevant content
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id
 
         max_chunks : typing.Optional[int]
+            Maximum number of results to return
 
         alpha : typing.Optional[Alpha]
+            Search ranking algorithm parameter (0.0-1.0 or 'auto')
 
         recency_bias : typing.Optional[float]
-
-        num_related_chunks : typing.Optional[int]
+            Preference for newer content (0.0 = no bias, 1.0 = strong recency preference)
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -195,7 +202,6 @@ class SearchClient:
             max_chunks=max_chunks,
             alpha=alpha,
             recency_bias=recency_bias,
-            num_related_chunks=num_related_chunks,
             request_options=request_options,
         )
         return _response.data
@@ -211,36 +217,27 @@ class SearchClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[SearchChunk]:
         """
-        Full text search endpoint for Cortex customers.
-        Performs full text search with configurable operators for precise text matching against the Findr backend.
-
-        This endpoint performs a full text search query against the Findr backend, allowing users to retrieve
-        relevant content chunks from their indexed documents and sources using BM25-based text matching.
-        The search can be customized with various operators to control the matching behavior.
-
-        Args:
-            request (FullTextSearchRequest): The full text search request containing:
-                - query (str): Search query string to find relevant content
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-                - operator (BM25OperatorType, optional): Full text search operator type (OR or AND). Defaults to OR
-                - max_chunks (int, optional): Maximum number of content chunks to return (1-1001, defaults to 25)
-            api_details (dict): Authentication details obtained from API key validation
+        Perform full text search for exact matches within your indexed sources.
 
-        Returns:
-            FullTextSearchData: Success response with full text search results
+        Use this endpoint to find content chunks using BM25-based text matching with configurable operators.
+        Choose between OR and AND operators to control how search terms are combined for precise text matching.
 
         Parameters
         ----------
         query : str
+            Search terms to find in your content
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id
 
         operator : typing.Optional[Bm25OperatorType]
+            How to combine search terms (OR or AND)
 
         max_chunks : typing.Optional[int]
+            Maximum number of results to return
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -306,41 +303,60 @@ class AsyncSearchClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Optional[typing.Any]:
         """
+        Ask a question to your uploaded knowledge base and let Cortex AI answer it.
+
         Parameters
         ----------
         question : str
+            The question to be answered
 
         session_id : str
+            Unique identifier for the conversation session. Keep it same when the current question refers to a previous answer or question
 
         tenant_id : str
+            Identifier for the tenant/organization
 
         context_list : typing.Optional[typing.Sequence[str]]
+            List of context strings to provide additional information
 
         search_modes : typing.Optional[typing.Sequence[str]]
+            List of search modes to use for finding relevant information
 
         sub_tenant_id : typing.Optional[str]
+            Identifier for sub-tenant within the tenant
 
         highlight_chunks : typing.Optional[bool]
+            Whether to return text chunks in the response along with final LLM generated answer
 
         stream : typing.Optional[bool]
+            Whether to stream the response
 
         search_alpha : typing.Optional[float]
+            Closer to 0.0 means a exact keyword search will be performed, closer to 1.0 means semantics of the search will be considered. In most cases, you wont have to toggle it yourself.
 
         recency_bias : typing.Optional[float]
+            Bias towards more recent information (0.0 to 1.0)
 
         ai_generation : typing.Optional[bool]
+            Whether to use AI for generating responses
 
         top_n : typing.Optional[int]
+            Number of top results to return
 
         user_name : typing.Optional[str]
+            Name of the user making the request. This helps LLM to know the user's name if semantics around the username are involved in query. Its generally a good practice to include it possible.
 
         user_instructions : typing.Optional[str]
+            Custom instructions for the AI response to add to our proprietary prompt. This can be used to provide additional context or instructions for the LLM to follow so that the answers are tailored towards your application style
 
         multi_step_reasoning : typing.Optional[bool]
+            Enable advanced multi-step reasoning for complex queries. When enabled, the AI will automatically break down complex questions into multiple research steps to provide more comprehensive and accurate answers.
 
         auto_agent_routing : typing.Optional[bool]
+            Enable intelligent agent routing to automatically select the most suitable AI agent for your specific query type. Different agents are optimized for various use cases like social media, code, conversations, general knowledge, etc.
 
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            Additional metadata for the request
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -392,45 +408,33 @@ class AsyncSearchClient:
         max_chunks: typing.Optional[int] = OMIT,
         alpha: typing.Optional[Alpha] = OMIT,
         recency_bias: typing.Optional[float] = OMIT,
-        num_related_chunks: typing.Optional[int] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[SearchChunk]:
         """
-        Search for content within indexed sources using semantic and keyword search capabilities.
-
-        This endpoint performs a search query against the Findr backend, allowing users to retrieve
-        relevant content chunks from their indexed documents and sources. The search can be customized
-        with various parameters to control the number of results and search behavior.
-
-        Args:
-            request (SearchRequest): The search request containing:
-                - query (str): Search query string to find relevant content
-                - tenant_id (str, optional): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-                - max_chunks (int, optional): Maximum number of content chunks to return
-                - alpha (Union[float, str], optional): Search algorithm parameter for result ranking (default: 0.8). Can be float-type (0.0-1.0) or 'auto' for dynamic selection
-                - recency_bias (float, optional): Bias towards more recent content (default: 0.5)
-                - num_related_chunks (int, optional): Number of related chunks to return (default: 0)
-            api_details (dict): Authentication details obtained from API key validation
-
-        Returns:
-            SearchData: Success response with search results
+        Search for relevant content within your indexed sources.
+
+        This API returns the chunks related to the query you make. We use neural (embedding) search to give you the most relevant chunks.
+        Results are ranked by relevance and can be customized with parameters like result limits and recency preferences.
 
         Parameters
         ----------
         query : str
+            Search terms to find relevant content
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id
 
         max_chunks : typing.Optional[int]
+            Maximum number of results to return
 
         alpha : typing.Optional[Alpha]
+            Search ranking algorithm parameter (0.0-1.0 or 'auto')
 
         recency_bias : typing.Optional[float]
-
-        num_related_chunks : typing.Optional[int]
+            Preference for newer content (0.0 = no bias, 1.0 = strong recency preference)
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -458,7 +462,6 @@ class AsyncSearchClient:
             max_chunks=max_chunks,
             alpha=alpha,
             recency_bias=recency_bias,
-            num_related_chunks=num_related_chunks,
             request_options=request_options,
         )
         return _response.data
@@ -474,36 +477,27 @@ class AsyncSearchClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[SearchChunk]:
         """
-        Full text search endpoint for Cortex customers.
-        Performs full text search with configurable operators for precise text matching against the Findr backend.
-
-        This endpoint performs a full text search query against the Findr backend, allowing users to retrieve
-        relevant content chunks from their indexed documents and sources using BM25-based text matching.
-        The search can be customized with various operators to control the matching behavior.
-
-        Args:
-            request (FullTextSearchRequest): The full text search request containing:
-                - query (str): Search query string to find relevant content
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-                - operator (BM25OperatorType, optional): Full text search operator type (OR or AND). Defaults to OR
-                - max_chunks (int, optional): Maximum number of content chunks to return (1-1001, defaults to 25)
-            api_details (dict): Authentication details obtained from API key validation
+        Perform full text search for exact matches within your indexed sources.
 
-        Returns:
-            FullTextSearchData: Success response with full text search results
+        Use this endpoint to find content chunks using BM25-based text matching with configurable operators.
+        Choose between OR and AND operators to control how search terms are combined for precise text matching.
 
         Parameters
         ----------
         query : str
+            Search terms to find in your content
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id
 
         operator : typing.Optional[Bm25OperatorType]
+            How to combine search terms (OR or AND)
 
         max_chunks : typing.Optional[int]
+            Maximum number of results to return
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.