# Feature AI-169 - Incorporate semantic search UI into the global search

Project: Stream AI
Status: needs review
URL: https://community.openproject.org/work_packages/AI-169

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 18.1.0 |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

| ID | Subject | Type | Status | Assignee | Target versions | Spent time |
| --- | --- | --- | --- | --- | --- | --- |
| AI-199 | Use the HNSW index for semantic search | Implementation | new |  |  |  |

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module | Artificial Intelligence / Semantic Search (SemS) |
| Feature Flag | Semantic search |
| Requires doc change | Yes |
| Enterprise plan | Enterprise / Professional (PRO) |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |

## People

| Attribute | Value |
| --- | --- |
| Assignee | Joel Koch |
| Accountable |  |
| Product manager | Dominic Bräunlein |
| Developers | Joel Koch |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| Work |  |
| Labor costs |  |

## Description

**As** a user  
**I want to** find work packages by meaning  
**so that** I do not need to know the exact wording of the work package subject or description

**Acceptance criteria**

*   toggle to enable semantic search for work packages is next to the "Advanced filter" button in the search result page
    
*   results of semantic search are displayed in the same paginated view as regular search
    
*   other filters can be combined with semantic search
    
*   an error is displayed when semantic search fails
    
    *   for instance when embedding model provider is down
        
    *   or query is too long for the model context
        
*   empty results page when no index for semantic search exists
    
*   semantic search must make use of the HNSW index
    
*   when semantic search is activated it changes the label in the advanced filters from "Filter by text" to "Search by meaning"
    
*   feature test (?)
    

**Technical notes**

*   reuse existing filter/select system
    
    *   select by semantic similarity needs second condition (e.g. updated\_at) as a tie breaker for stability in pagination etc. (see `ExactMatchSelect`, same issue)
        
*   semantic search must make an API call to embed the query, how to work with that?
    
*   use a toggle in the small version
    

**Permissions and visibility considerations**

*   To whom is this feature visible?
    
    *   all users
        
*   When is it not visible?
    
    *   LLM configuration disabled for instance
        
    *   semantic\_search feature flag disabled
        
    *   semantic search not available because not configured
        

**Translation considerations**

*   _Key terms and phrases in the key languages_ 
    

**Out of scope**

*   <br>
    

_Set the_ **To be informed/consulted teams** _field to include all teams necessary to be informed of the changes._

<br>

**Mockup for &quot;search by meaning&quot; toggle**

**<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/926359/content">**