AI Chatbot Agent

Översikt

AI Chatbot Agent svarar besökare i webshopens Live Chat med OpenAI tool calling inne i klientens Odoo. Butikerna säljer fordon, reservdelar och erbjuder verkstad. Agenten täcker FAQ, fordonssök (fordonskort), produktsökning och fordonsfitment via vehicle.compatibility.

Avsiktsflöde (grafisk plan)

Så här dirigerar agenten ett meddelande som “Mercury F15” eller “jag vill ha en fyrhjuling”:

Fordonskort

Säljbara fordon märks på product.template med nilfish_is_vehicle_card (ägs av nilfish_vehicle_support). Verktyget search_vehicles filtrerar på flaggan när den finns. Tills modulen är installerad returnerar agenten ändå butikskategorilänken (MC, ATV, snöskoter, marin, släpvagn) men inga fordonsproduktkort.

Inställning

1. Aktivera AI Chatbot Agent under Inställningar → Powersport Intelligence → Webbplats & butik.
2. Konfigurera delad OpenAI API-nyckel och modell under AI-anslutning.
3. Öppna blocket AI-chatbot: slå på Aktivera AI-autosvar (så “väljer” du vår agent — det finns ingen separat Live Chat-operatörsruta), välj person och ikon. Med autosvar på förblir chatbubblan tillgänglig även utan online mänsklig operatör.
4. Redigera butiksinfo en gång under Webbplats → Konfiguration → Butiksinfo (öppettider + FAQ). Samma innehåll driver /opening-hours, /faq och AI-verktyget get_faq_info — inga dubbla FAQ-fält under AI-inställningar.
5. Konfigurera Live Chat så att chatbubblan syns på webshoppen (Webbplats → Konfiguration → Live Chat) och välj en kanal. Ha gärna minst en mänsklig operatör för överlämning; koppla inte Odoos scriptade chatbot om vår AI ska svara.
6. Testa på den publika butiken som gäst (inkognito). Du behöver inte sitta i Discuss/Live Chat som admin för att AI:n ska svara.

Så fungerar det

1. En besökare öppnar Live Chat-widgeten på webshoppen och skickar ett meddelande.
2. Odoo kör AI-hooken på discuss.channel automatiskt.
3. GPT kan anropa verktygen get_faq_info, search_products, search_products_by_fitment eller search_vehicles.
4. Slutsvar postas som bot-partnern (med vald ikon som avatar).

Butiksinfo (smart AI-hjälp)

Öppettider och FAQ ligger på ett ställe. Ändra dem för webben så svarar boten från samma data. Länka gärna till /opening-hours eller /faq när kunden vill se hela sidan.

Produkt- och passformssök

För delar kopplade till ett fordon (märke / modell / år) används search_products_by_fitment. Den söker lokal vehicle.compatibility och master-leverantörens passformskataloger (Excel uppladdad en gång på master); SKU matchas mot publicerade lokala default_code. Modellnamn normaliseras så MT10, MT-10 och MT 10 matchar. Valfria delnyckelord filtrerar inom passform; om inget matchar kan andra kompatibla publicerade produkter returneras.

Gör-det-själv-service

När kunden vill serva fordonet själv hjälper agenten att hitta rätt delar via passform. Den hittar inte på servicespecifikationer (växelhusvolym, moment, intervall). Exakta uppgifter kommer senare (servicedata / manualer). Tills dess erbjuder boten hittade delar och verkstadskontakt via butiksinfo.

Personlighet

Standardtonen är vänlig och lätt humoristisk. Den skämtar aldrig om säkerhetskritisk passform, prisnoggrannhet, betalningar eller klagomål.

Överlämning till människa

När en mänsklig operatör redan har svarat i kanalen är AI:n tyst. Be om att få prata med en människa för eskalering.

Krav

• Moduler: website_livechat, nilfish_vehicle_filter, nilfish_powersport, nilfish_powersport_website.
• Python-paket: openai (samma som Product Supplier Scraper).
• Valfritt: nilfish_vehicle_support för nilfish_is_vehicle_card på produkter (Fordonsstöd).