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

usecortex_ai/embeddings/raw_client.py

@@ -38,28 +38,20 @@ class RawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[EmbeddingsDeleteData]:
         """
-        Delete specific embedding chunks from indexed sources.
+        Delete embedding chunks by chunk ID.
 
-        This endpoint deletes specified embedding chunks from the Findr backend by sending
-        chunk IDs to the backend delete service.
-
-        Args:
-            request (EmbeddingsDeleteRequest): The delete request containing:
-                - chunk_ids (List[str]): List of chunk IDs to delete
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-            api_details (dict): Authentication details obtained from API key validation
-
-        Returns:
-            EmbeddingsDeleteData: Success response with deletion details
+        Use this to remove specific chunks from your embeddings index when they are no longer valid or should not appear in results.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to delete
 
         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
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -185,29 +177,24 @@ class RawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[EmbeddingsSearchData]:
         """
-        Search for similar embedding chunks using vector similarity.
+        Find similar chunks using an embedding vector.
 
-        This endpoint performs semantic search by sending an embedding vector to the Findr backend
-        and returns a list of the most similar chunk IDs based on vector similarity.
+        Use this to retrieve the most similar chunk IDs to a single query embedding.
 
-        Args:
-            request (EmbeddingsSearchRequest): The search request containing:
-                - embeddings (List[float]): Single embedding vector for similarity search
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-                - max_chunks (int, optional): Maximum number of chunk IDs to return (default: 10)
-            api_details (dict): Authentication details obtained from API key validation
 
-        Returns:
-            EmbeddingsSearchData: List of chunk IDs with similarity scores
+        Expected outcome
+        - You receive the closest chunk IDs with optional similarity scores.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         embeddings : typing.Optional[typing.Sequence[float]]
+            The embedding vector for search
 
         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]
 
@@ -335,20 +322,20 @@ class RawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[EmbeddingsGetData]:
         """
-        Get embeddings based on chunk IDs.
+        Retrieve embeddings for specific chunk IDs.
 
-        This endpoint returns embeddings for a list of chunk IDs.
-
-        Returns:
-            EmbeddingsGetData: Embeddings data for the requested chunk IDs
+        Use this when you already know the chunk IDs and need their corresponding embeddings.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to get embeddings for
 
         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
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -468,16 +455,14 @@ class RawEmbeddingsClient:
         self, *, tenant_id: str, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[EmbeddingsCreateCollectionData]:
         """
-        Create an embeddings collection for the given tenant in Findr.
-
-        sub_tenant_id is set to be the same as tenant_id as per requirements.
+        Create an embeddings collection for a tenant.
 
-        Returns:
-            EmbeddingsCreateCollectionData: Success response with collection details
+        Use this to initialize storage so you can index and query embeddings for the tenant.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -601,28 +586,20 @@ class AsyncRawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[EmbeddingsDeleteData]:
         """
-        Delete specific embedding chunks from indexed sources.
+        Delete embedding chunks by chunk ID.
 
-        This endpoint deletes specified embedding chunks from the Findr backend by sending
-        chunk IDs to the backend delete service.
-
-        Args:
-            request (EmbeddingsDeleteRequest): The delete request containing:
-                - chunk_ids (List[str]): List of chunk IDs to delete
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-            api_details (dict): Authentication details obtained from API key validation
-
-        Returns:
-            EmbeddingsDeleteData: Success response with deletion details
+        Use this to remove specific chunks from your embeddings index when they are no longer valid or should not appear in results.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to delete
 
         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
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -748,29 +725,24 @@ class AsyncRawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[EmbeddingsSearchData]:
         """
-        Search for similar embedding chunks using vector similarity.
+        Find similar chunks using an embedding vector.
 
-        This endpoint performs semantic search by sending an embedding vector to the Findr backend
-        and returns a list of the most similar chunk IDs based on vector similarity.
+        Use this to retrieve the most similar chunk IDs to a single query embedding.
 
-        Args:
-            request (EmbeddingsSearchRequest): The search request containing:
-                - embeddings (List[float]): Single embedding vector for similarity search
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-                - max_chunks (int, optional): Maximum number of chunk IDs to return (default: 10)
-            api_details (dict): Authentication details obtained from API key validation
 
-        Returns:
-            EmbeddingsSearchData: List of chunk IDs with similarity scores
+        Expected outcome
+        - You receive the closest chunk IDs with optional similarity scores.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         embeddings : typing.Optional[typing.Sequence[float]]
+            The embedding vector for search
 
         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]
 
@@ -898,20 +870,20 @@ class AsyncRawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[EmbeddingsGetData]:
         """
-        Get embeddings based on chunk IDs.
+        Retrieve embeddings for specific chunk IDs.
 
-        This endpoint returns embeddings for a list of chunk IDs.
-
-        Returns:
-            EmbeddingsGetData: Embeddings data for the requested chunk IDs
+        Use this when you already know the chunk IDs and need their corresponding embeddings.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to get embeddings for
 
         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
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1031,16 +1003,14 @@ class AsyncRawEmbeddingsClient:
         self, *, tenant_id: str, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[EmbeddingsCreateCollectionData]:
         """
-        Create an embeddings collection for the given tenant in Findr.
-
-        sub_tenant_id is set to be the same as tenant_id as per requirements.
+        Create an embeddings collection for a tenant.
 
-        Returns:
-            EmbeddingsCreateCollectionData: Success response with collection details
+        Use this to initialize storage so you can index and query embeddings for the tenant.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.

usecortex_ai/fetch/client.py

@@ -40,14 +40,19 @@ class FetchClient:
         Parameters
         ----------
         file_id : str
+            Unique identifier for the file to fetch
 
         file_type : str
+            Type of file (e.g., 'app', 'file', or other)
 
         tenant_id : str
+            Tenant identifier for multi-tenancy
 
         return_content : typing.Optional[bool]
+            Whether to return the file content along with the URL
 
         sub_tenant_id : typing.Optional[str]
+            Sub-tenant identifier, defaults to tenant_id if not provided
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -104,14 +109,19 @@ class AsyncFetchClient:
         Parameters
         ----------
         file_id : str
+            Unique identifier for the file to fetch
 
         file_type : str
+            Type of file (e.g., 'app', 'file', or other)
 
         tenant_id : str
+            Tenant identifier for multi-tenancy
 
         return_content : typing.Optional[bool]
+            Whether to return the file content along with the URL
 
         sub_tenant_id : typing.Optional[str]
+            Sub-tenant identifier, defaults to tenant_id if not provided
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.

usecortex_ai/fetch/raw_client.py

@@ -40,14 +40,19 @@ class RawFetchClient:
         Parameters
         ----------
         file_id : str
+            Unique identifier for the file to fetch
 
         file_type : str
+            Type of file (e.g., 'app', 'file', or other)
 
         tenant_id : str
+            Tenant identifier for multi-tenancy
 
         return_content : typing.Optional[bool]
+            Whether to return the file content along with the URL
 
         sub_tenant_id : typing.Optional[str]
+            Sub-tenant identifier, defaults to tenant_id if not provided
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -184,14 +189,19 @@ class AsyncRawFetchClient:
         Parameters
         ----------
         file_id : str
+            Unique identifier for the file to fetch
 
         file_type : str
+            Type of file (e.g., 'app', 'file', or other)
 
         tenant_id : str
+            Tenant identifier for multi-tenancy
 
         return_content : typing.Optional[bool]
+            Whether to return the file content along with the URL
 
         sub_tenant_id : typing.Optional[str]
+            Sub-tenant identifier, defaults to tenant_id if not provided
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.

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.