service-finder/docs/V02/22_Robot_Ecosystem.md

22. Robot Ökoszisztéma & AI Intelligence (v2.0)

Ez a dokumentum az autonóm ágensek technikai specifikációját és koordinációját tartalmazza.

22.1 Robot 1: Catalog Scout (The Discovery)

• Feladat: Új járműmodellek importálása külső forrásokból (RDW, NHTSA).
• Működés: unverified státuszú alaprekordokat hoz létre. Ha a forrás blokkol (Ban-Detection), a robot automatikusan "Silent Mode"-ba vált.

22.2 Robot 2: Technical Enricher (The Detective v1.2.6)

A legfejlettebb modul, amely a nyers adatokat master-adatokká dúsítja.

AI Search RAG (Retrieval-Augmented Generation):

• Mivel a Google Search tool használatakor a Gemini letiltja a kényszerített JSON formátumot, a robot Regex-alapú JSON bányászatot alkalmaz a nyers válaszból.
• Cél: Modellkódok, évjáratok és szervizintervallumok kinyerése közvetlenül az internetről.

Safe-Merge & Not-Null védelem:

• Fallback Kódok: Ha az AI nem talál kódot, a robot N/A-{id} vagy UNKNOWN-{id} ál-kódokat generál az SQL kényszerek (Unique, Not-Null) betartása érdekében.
• Deduplikáció: Csak akkor von össze rekordokat, ha a technikai kód ÉS a hengerűrtartalom (CCM) is megegyezik.

22.3 Robot 3: OCR & Multimodal Document AI

• Feladat: Számlák, forgalmik és kilométerórák elemzése.
• Integráció: A felismerés során kinyert szervizadatokat keresztellenőrzi a data.organizations táblával. Ha ellentmondást talál, a szervizt flagged státuszba teszi.

22.4 Robot 4: Service Hunter (Tervezett)

• Cél: A dúsított technikai adatok alapján szerviz-csomagok és árak automatizált keresése.
• Működés: A specifications mezőben tárolt folyadékmennyiségek és alkatrész-típusok alapján generál ajánlat-tervezeteket.

22.5 Robot Koordináció (Orchestration)

A robotok az adatbázist használják "jelzőtáblának", elkerülve az ütközéseket:

1. R1 rögzíti az alapot.
2. R2 dúsít és validál.
3. R3 (OCR) bizonyítékokat csatol a jármű életútjához.
4. Minden művelet a ProcessLog táblában kerül rögzítésre az auditálhatóság érdekében.