# Habsziget Webáruház - AI Agent & LLM Documentation

A Habsziget webáruház natívan támogatja a mesterséges intelligencia ágensek (WebMCP, OpenAI, Anthropic) általi automatizált adatlekérést és interakciót.

## AI API és Eszközök (Tools)
Az ágensek számára dedikált, JSON-alapú API végpontok leírása, és a szükséges paraméterek (Function Calling Schema) a hivatalos katalógusunkban találhatók:
- Hivatkozás: [https://habsziget.hu/ai-catalog.json](https://habsziget.hu/ai-catalog.json)

## Elérhető automatizált funkciók
Az `ai_interface.php` végponton (POST kérésekkel) a nyelvi modellek az alábbi műveleteket végezhetik el a vásárlók kiszolgálása érdekében:
- `get_product_schema`: Termékek és kategóriák keresése.
- `get_product_price`: Pontos árak és készletek lekérdezése méretek/tulajdonságok alapján.
- `calculate_custom_cuboid`: Egyedi méretű polisztirol téglatestek/tömbök pontos árazása.
- `get_shipping_info`: Szállítási és fizetési opciók, futárdíjak.
- `get_bank_details`: Banki átutalási adatok lekérése.
- `get_order_status`: Megrendelések aktuális állapotának és csomagszámának lekérdezése (hitelesítés után).
- `get_shop_contact_info`: Ügyfélszolgálati elérhetőségek.
- `send_contact_message`: Közvetlen üzenet/reklamáció beküldése az ügyfélszolgálatnak (GDPR elfogadással).
- `get_faq_answer`: Tudásbázis cikkek és gyártási korlátok (pl. nem gyártható formák) lekérése.

A végpontok használatakor a katalógusban definiált "required" paraméterek átadása kötelező.