Jak funguje vyhledávání

🎯 Příklad: Vyhledávání "PRESS Cu oblouk 5001"

1. 📝 Zadání dotazu

Uživatel zadá: "PRESS Cu oblouk 5001"

# Frontend/n8n pošle POST request:
POST http://localhost:8085/api/search
{
  "message": "PRESS Cu oblouk 5001",
  "limit": 5
}
                

2. 🧠 Převod na embedding vektor

Seznam AI model převede text na 768-rozměrný vektor

🤖 Seznam AI Model: simcse-dist-mpnet-paracrawl-cs-en
📏 Dimenze vektoru: 768 čísel
🎯 Optimalizováno pro: Českou sémantiku a technické termíny

Embedding vektor pro "PRESS Cu oblouk 5001":

[0.1234, -0.5678, 0.9876, 0.4321, -0.8765, 0.2468, ...další 762 čísel]

↑ Každé číslo reprezentuje sémantický aspekt (materiál, funkce, typ)

3. 🔍 Vyhledávání v Qdrant

Qdrant najde nejpodobnější vektory pomocí cosine similarity

# Qdrant search query:
POST /collections/heureka_products/points/search
{
  "vector": [0.1234, -0.5678, ...],  // 768 čísel
  "limit": 5,
  "with_payload": true,
  "with_vector": false
}
                

4. 📊 Výpočet podobnosti

Každý produkt má skóre podobnosti (0-1, kde 1 = identické)

PRESS Cu - oblouk 5001 35
Cena: 556,60 Kč
Skóre: 0.275 (27.5%)

Další PRESS komponenty
Podobné měděné fitinky
Skóre: 0.20+ (20%+)

5. 📦 Vrácení výsledků

API vrátí produkty seřazené podle relevance

{
  "status": "success",
  "message": "PRESS Cu oblouk 5001",
  "products": [
    {
      "productname": "PRESS Cu - oblouk 5001 35",
      "price_vat": "556,60",
      "categorytext": "Fitinky | PRESS systém",
      "url": "https://www.esl.cz/press-cu-oblouk-5001-35/",
      "score": 0.54976195
    }
  ],
  "count": 1
}
                

🧠 Proč toto funguje lépe než klasické vyhledávání?

🔤 Klasické vyhledávání

Hledá přesná slova:

"METABO" musí být v textu
"nářadí" musí být přesně napsané
Nezná synonyma
Citlivé na překlepy

🧠 AI Embedding vyhledávání

Rozumí významu:

Najde "nástroje", "vybavení"
Rozpozná značky elektrického nářadí
Pracuje se synonymy
Toleruje překlepy

⚙️ Technická architektura

🤖

Seznam AI Model
simcse-dist-mpnet-paracrawl-cs-en

🗃️

Qdrant Vector DB
768-dim cosine similarity

🐍

FastAPI
Embedding service

📊

13,992 produktů
Heureka XML feed

🔬 Jak si vyzkoušet proces

1. 🌐 Přes dashboard

Jděte na http://localhost:8085/
V sekci "Test vyhledávání" zadejte: "Lisovací čelist SV - měd"
Klikněte "🔍 Vyhledat" pro formátované výsledky
Nebo "📄 Surová data" pro JSON response
        

2. 🔧 Přes API

# Curl test:
curl -X POST "http://localhost:8085/api/search" \
  -H "Content-Type: application/json" \
  -d '{"message": "Lisovací čelist SV - měd", "limit": 3}'

# Python test:
import requests
response = requests.post('http://localhost:8085/api/search', 
  json={"message": "Lisovací čelist SV - měď", "limit": 3})
print(response.json())
        

3. 🔗 Přes n8n

HTTP Request Node:
- Method: POST
- URL: http://localhost:8085/api/search
- Body: {"message": "{{ $json.query }}", "limit": 5}
        

📈 Optimalizace vyhledávání

💡 Tipy pro lepší výsledky:

Popisné dotazy: "bezdrátové sluchátka bluetooth" místo jen "sluchátka"
Kontext: "kávovar pro domácnost" místo jen "kávovar"
Synonyma: Model rozumí "mobil", "telefon", "smartphone"
Parametry: "notebook 15 palců" nebo "auto do 500 tisíc"

⚙️ Parametry API:

{
  "message": "váš dotaz",
  "limit": 10,           // Max 20 výsledků
  "threshold": 0.1       // Min. skóre podobnosti (volitelné)
}
        

🔍 Jak funguje vyhledávání