User Guide for Odoo AI Semantic Search

Odoo AI Semantic Search helps users find relevant products and records by understanding the meaning behind their search queries instead of relying only on exact keywords.

This module uses AI-powered embeddings to provide more accurate search results, instant search suggestions, and related product recommendations within Odoo.

It helps businesses improve product discovery, enhance user experience, and deliver smarter search results directly from the Odoo backend.

1. Enable or disable semantic search directly from the Odoo backend.
2. Search products based on meaning and intent instead of exact keywords.
3. Manage all reservations from one centralized system
4. Display instant search suggestions while users type.
5. Generate AI-powered embeddings for improved search accuracy.
6. Configure search threshold values to control result relevance.
7. Save and track customer search terms for analysis.
8. Improve product discovery with AI-powered search results.

1. Once you purchase the App from the Webkul store, you will receive a link to download the module’s zip file.
   
2. Extract the file on your system after the download finishes. As a result, you will be able to see a folder named ‘odoo_semantic_search’.
   
3. Copy and paste this folder inside your Odoo Add-Ons path.
   
4. Install pgvector
   The module requires the pgvector extension for PostgreSQL to store and search image embeddings.

apt update
apt install -y git build-essential postgresql-server-dev-<postgres_version>
cd /tmp
git clone --branch v0.4.4 https://github.com/pgvector/pgvector.git
cd pgvector
make
make install

5. Install Python Dependencies

```bash pip3 install -r odoo_ai_semantic_search/requirements.txt

6. Note:
   The sentence-transformers package will download the all-mpnet-base-v2 model on first use and cache it locally inside the module directory. An internet connection is only needed for this one-time download.

7. Now, open Odoo App and click on the Settings menu. Here, click on Activate Developer Mode.
8. Then, open the Apps menu and click on ‘Update Modules List.’
9. In the search bar, remove all the filters and search ‘odoo_semantic_search’.
10. You will be able to see the module in the search results. Click on ‘Activate’ to install it.

1. After installing the module, navigate to Configuration → Settings → Website.
   Under the Product Semantic Search section, enable the Enable Semantic Search option to activate semantic search functionality

2. Navigate to Website → Configuration → Semantic Search Configuration.
   
   Create a configuration, select the model, language, website, and fields to index.
   Mark the required fields as searchable, then click Store Embeddings to let AI process the data. Once the status becomes Stored, publish the configuration to enable AI-powered semantic search on your website

3. Navigate to the Extra Info tab
   Configure the threshold value to control search relevance.
   You can also enable related products and search suggestions to improve customer search results.
   Adjust the number of suggested products as needed, and use Reset to Draft if you want to update the configuration and regenerate embeddings.

4. Now navigate to Odoo shop page. When a customer enters a search term in the search bar, the AI-powered search dropdown automatically shows matching details and related suggestions in real time.

5. Now navigate to Website → Configuration → Related Search Items.
   This section provides a record of the search terms entered by website visitors, along with their Frequency, indicating how often each search term has been used.

Hope you find the guide helpful! Please feel free to share your feedback in the comments below.

If you still have any issues/queries, please create a ticket at the UV Desk.

I hope this helps. In case of any further queries, contact us at our support mail.

Thanks for paying attention!!