# TCAI search hints mechanism

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/9230535760028.png) Getting started

<div id="bkmrk-in-this-article%2C-you"><div><span>In this article, you will find information about the TCAI search hints mechanism **<span style="color: #4054a0;">(1)</span>**. TCAI is standalone and separate from the TC administration panel platform that collaborates with the Elastic engine</span><span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">. <span>The search engine was developed to address the need for quick access to relevant and more accurate query results. The TCAI search hints mechanism is a feature that helps users refine their search queries and find the desired product they need more efficiently.</span> The search engine additionally checks for misspellings and searches for similar, words in case there is a mistake. The engine itself performs two searches at the same time using different phrase weights, which allows us to make sure the customer gets the best and most accurate results. This new version of the TC search engine allows for fast, scalable, and flexible full-text search and analytics. </span></div><div><span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;"><span></span></span></div><div><span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;"><span>It is worth emphasizing that the mechanism allows for advanced analysis of what the customer is searching for.</span></span><span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;"></span></div></div><span class="wysiwyg-color-black" style="color: #44549b;">![info2.svg](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/9230549509532.png) **Remember**</span><span class="wysiwyg-color-black" style="display: block; margin-top: 10px;"><span><span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Elasticsearch is an external integrated engine that helps optimize, manage, and analyze search results.</span></span></span>

<table id="bkmrk-visualization-of-the" style="margin-right: auto; margin-left: auto; height: 32px; width: 630px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 10px; width: 618px;">![Screenshot_2023-04-05_at_17.57.28.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/8345746169244.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 618px;"><span class="wysiwyg-font-size-medium">*Visualization of the TCAI search mechanism UI (desktop)* </span></td></tr></tbody></table>

<table id="bkmrk-visualization-of-the-1" style="margin-right: auto; margin-left: auto; height: 44px; width: 620px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 608px;">![Screenshot_2023-04-04_at_15.36.07.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/8330133307932.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 608px;"><span class="wysiwyg-font-size-medium">*Visualization of the TCAI search mechanism UI (mobile)* </span></td></tr></tbody></table>

<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Table of contents:</span>

1. [TCAI search engine configuration](#bkmrk-tcai-search-engine-c-1)
2. [ TCAI description of operation - front-end and business perspective](#bkmrk-tcai-description-of-)
3. [ TCAI keywords](#bkmrk-tcai-keywords)

---

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/9230535760028.png) TCAI search engine configuration

All settings regarding TCAI you'll find <span>in the admin panel, navigating to:</span>

***System &gt; System / settings &gt; Integrations tab &gt; TCAI***

<span>You can easily search for TCAI settings by typing a dedicated phrase into the system settings browser (as shown in the screenshot).</span> Below you will find a description of all visible settings:

<table id="bkmrk-visualization-of-the-2" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">![POWERPNT_ST5N62G4Pm.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/9230535768092.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the TCAI admin panel settings* </span></td></tr></tbody></table>

- **Enabled** **-** a s<span>witch that decides if the TCAI function is enabled and whether TCAI is the primary search engine.</span>

<span class="wysiwyg-color-black" style="color: #44549b;">![info2.svg](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/9230549509532.png) **Remember**</span><span class="wysiwyg-color-black" style="display: block; margin-top: 10px;"><span>TC platform provides three types of search engines. TCAI has the highest priority, which means it works as the main search engine and ignores the SLI mechanism, which has a lower priority than TCAI. The standard version of the TC search engine has the lowest priority, which means it is ignored when any of the above two browsers are enabled.</span></span>

- **Enabled suggested phrases** - switch which enables the phrase suggestions during the search.
- **Host url -** the URL where <span><span class="ui-provider bvp bvq c d e f g h i j k l m n o p q r s t bvr bvs w x y z ab ac ae af ag ah ai aj ak" dir="ltr">TCAI</span></span> can be found.
- **Auth token -** the identifier used to authenticate the TCAI platform to ensure proper collaboration with the TC admin panel. <label class="control-label" for="settings_tcai_search_main_category_name"><label class="control-label" for="settings_tcai_search_main_category_name"><span></span></label></label>**The parameter is sensitive, and any changes should be consulted with the TC team.**
- <label class="control-label" for="settings_tcai_search_main_category_name"><label class="control-label" for="settings_tcai_search_main_category_name">**Search feed main category name -** a<span> parameter indicating the category based on which the search will be conducted. The parameter that is taken into consideration is the `url_name` It's the parameter, which appears, among others, in the mass import of products. You can find more information on the topic of mass import of products at [Product catalog export   
    and import](https://knowledge.tauceti-digital.com/books/e-commerce/page/product-catalog-export-and-import). **The parameter is sensitive, and any changes should be consulted with   
    the TC team.**</span></label></label>
- <label class="control-label" for="settings_tcai_search_batch_size">**Search feed batch size -**<span> the parameter determining the number of products that are sent to TCAI at once, in one batch. The functionality is currently being expanded. **The parameter is sensitive, and any changes should be consulted with the TC team.**</span></label>
- <span>**Debug mode -** a mode of operation for identifying and correcting errors in a program, allowing programmers to observe program behavior and track variable values. The parameter should be disabled in the production environment unless it is necessary for debugging purposes.  
    </span><span></span>

<div class="group w-full text-gray-800 dark:text-gray-100 border-b border-black/10 dark:border-gray-900/50 bg-gray-50 dark:bg-[#444654]" id="bkmrk--1"><div class="text-base gap-4 md:gap-6 md:max-w-2xl lg:max-w-xl xl:max-w-3xl p-4 md:py-6 flex lg:px-0 m-auto"></div></div>---

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/9230535760028.png) TCAI <span>description of operation - front-end and business perspective</span>

#  

#  

<span>In the following section, you will find a description of the mechanism's behavior from the frontend user's perspective and the main features of the search engine from the Yves Rocher business point of view. </span>

### <span>Front-end perspective</span>

<span>The search engine saves the user's last searches **<span style="color: #4054a0;">(1)</span>** in local storage. </span><span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">The view with the last searches is visible when the user clicks on the search field for the product.</span>

<span>These are searches that ended with the user pressing the enter key or clicking on the search button.</span>

<table id="bkmrk-visualization-of-the-3" style="margin-right: auto; margin-left: auto; height: 32px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 10px; width: 688px;">![Screenshot_2023-04-05_at_14.42.11.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/8342829614492.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 688px;"><span class="wysiwyg-font-size-medium">*Visualization of the TCAI - last phrases UI (mobile&amp;desktop)* </span></td></tr></tbody></table>

<span>TCAI intelligently matches search results based on the entered query. The search is performed by the main category **<span style="color: #4054a0;">(2)</span>** (defined in the ***Search feed main category name*** parameter), product name and properties. In the main search results **<span style="color: #4054a0;">(3)</span>**, we will find a maximum of 8 products that have the best scoring. The mechanism also helps the user by predicting and generating suggested clickable phrases **<span style="color: #4054a0;">(4)</span>**.</span>

<span>Clicking on the cart button (located in the product box) adds the product to the cart, while clicking on the product name will redirect the user to the page with the details of the selected product.</span>

<span>TCAI is able to track user clicks and group them accordingly for analysis purposes. For example, each click on a product name or image in the main search results **<span style="color: #4054a0;">(3)</span>** will be counted for the ***"hints\_product\_tile"*** tag, while a click on the cart icon will be counted for the ***"add\_to\_cart"*** tag.</span>

<span>Tracking and analysis of clicks also occur after submitting the search form on the target product list. In this case, clicking on the product name, image, or review will record a click for the ***"product\_tile"*** tag, while clicking on the cart will increase the value for the ***"add\_to\_cart"*** tag.</span>

<span> These tags are present in the TCAI analytics module.</span>

<table id="bkmrk-visualization-of-the-4" style="margin-right: auto; margin-left: auto; height: 32px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 10px; width: 688px;">![Screenshot_2023-04-05_at_17.58.44.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/8345755565084.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 688px;"><span class="wysiwyg-font-size-medium">*Visualization of the Tau Ceti AI search mechanism UI (desktop)* </span></td></tr></tbody></table>

<table id="bkmrk-visualization-of-the-5" style="margin-right: auto; margin-left: auto; height: 32px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 10px; width: 688px;">![Screenshot_2023-04-05_at_15.55.05.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/8343964465436.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 688px;"><span class="wysiwyg-font-size-medium">*Visualization of the Tau Ceti AI search mechanism UI (mobile)* </span></td></tr></tbody></table>

### <span>Business perspective</span>

- <span>The user experience is equivalent to that of current solutions on CEE websites</span>
- <span></span><span>The TCAI platform is standalone and separate from the TC e-commerce platform.</span>
- <span>It has the capability to integrate with various production and non-production sites. </span>
- <span>It's compatible with the current multi-language catalog product content obtained from different sources.</span><span></span>
- <span>Open architecture allows for adaptation to future changes such as new catalog product schemas, additional dictionaries, and new sources. </span>
- <span>Search functionality based on Elasticsearch.</span>
- <span></span><span>In terms of appearance and user experience, we are basing on the current layout and behavior of the existing Persoo solution for YR, allowing for minor improvements (</span><span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">among other things):</span>
    
    
    - <span>TCAI mechanism includes search phrase suggestions</span>
    - <span>The ability to add products to the cart directly from the suggestion window.</span>
- <span></span><span>Business users have access to statistical information, it allows among other things:</span>
    
    
    - <span>how the search volume is distributed over weeks</span>
    - <span>when the highest traffic occurs during the day</span>
    - <span>which products and what phrases lead to which user clicks</span>
- <span></span><span>Ability to add synonyms (there is a possibility of bulk importing synonyms (up to a maximum of 256 synonym groups).</span><span></span>
- <span></span><span>The data of the search tool is based and recognized on: altshops, category, name, tag, property, keywords, EAN, SKU, and colors as search keywords. </span>
- <div class="group w-full text-token-text-primary border-b border-black/10 dark:border-gray-900/50 bg-gray-50 dark:bg-[#444654]" style="width: 876.667px;"><div class="flex p-4 gap-4 text-base md:gap-6 md:max-w-2xl lg:max-w-[38rem] xl:max-w-3xl md:py-6 lg:px-0 m-auto"><div class="relative flex w-[calc(100%-50px)] flex-col gap-1 md:gap-3 lg:w-[calc(100%-115px)]" style="width: calc(100% - 115px);"><div class="flex flex-grow flex-col gap-3"><div class="min-h-[20px] flex flex-col items-start gap-3 overflow-x-auto whitespace-pre-wrap break-words"><div class="markdown prose w-full break-words dark:prose-invert light" style="width: 492.995px;">The search tool results are passed to the native results page.
    
    </div></div></div></div></div></div>
- <span></span><span>Suggested categories will be displayed by the search box based on the identified keyword.</span>
- <span></span><span>Products with zero stock aren't excluded from the search results as the user may be interested in seeing the details of the product. Such results are placed at the very end of the product list.</span>
- <span></span><span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Ability to manually optimize the results directly in the search platform. The platform allows optimization based on the following parameters:</span>
    
    
    - *<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Product is new</span>*
    - *<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Product is bestseller</span>*
    - *<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Product is green point</span>*
    - *<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Product is limited edition</span>*
    - *<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Product is outlet</span>*
    - *<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Product capacity</span>*
    - *<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Product reviews rating</span>*
    - *<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;">Product reviews count</span>*<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;"></span><span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;"></span>

<div class="group w-full text-gray-800 dark:text-gray-100 border-b border-black/10 dark:border-gray-900/50 bg-gray-50 dark:bg-[#444654]" id="bkmrk-%C2%A0-5"></div>---

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/9230535760028.png) TCAI <span>keywords</span>

<span>TCAI keywords functionality uses AI to generate product keywords that can be searched in the TCAI search. The keywords are generated based on the product description, and this process is fully automated and keywords are generated once a day, even when the product description has been updated.</span>

<span> High-quality product descriptions aid in generating significantly better quality keywords, directly related to the product. Additionally, if keywords generated for a particular product aren't strictly related to it, the user doesn't lose anything. They may only gain the advantage that by entering one of the generated keywords, the product will still be found.</span>

<span>Generated keywords can be found in</span>

***Catalog &gt; Products / list &gt; Edit on the desired product &gt; TCAI Search***

<table id="bkmrk-visualization-of-the-6" style="margin-right: auto; margin-left: auto; height: 32px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 10px; width: 688px;"><span>![POWERPNT_lbSmV6xxIh.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/13132631704604.png)</span></td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 688px;"><span class="wysiwyg-font-size-medium">*Visualization of the TCAI keywords* </span></td></tr></tbody></table>

These keywords are added to the keywords in the **Description &gt; Keywords** field, so when customers are searching by non-standard phrasing like "Anti-age global" (to find all of the anti-age global products) they will find all of the products that have "Anti-age Global" keyword generated.

<table id="bkmrk-visualization-of-the-7" style="margin-right: auto; margin-left: auto; height: 32px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 10px; width: 688px;"><span>![POWERPNT_BmkVi8dqkY.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/13132660966812.png)</span></td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 688px;"><span class="wysiwyg-font-size-medium">*Visualization of the searching of a keyword in the TCAI search* </span></td></tr></tbody></table>