AI Chatbot Agent

Overview

The AI Chatbot Agent answers storefront Live Chat visitors using OpenAI tool calling inside the tenant Odoo database. Shops sell vehicles, spare parts, and offer workshop service. The agent covers FAQ, vehicle browsing (vehicle cards), published product lookup, and vehicle fitment via vehicle.compatibility.

Intent flow (graphical plan)

How the agent routes a message such as “Mercury F15” or “I need an ATV”:

Vehicle cards

Sellable vehicles are marked on product.template with nilfish_is_vehicle_card (owned by nilfish_vehicle_support). The search_vehicles tool filters on that flag when present. Until the module is installed, the agent still returns the shop category link (MC, ATV, Snowmobile, Marine, Trailer) but no vehicle product cards.

Setup

1. Enable AI Chatbot Agent under Settings → Powersport Intelligence → Website & Storefront.
2. Configure the shared OpenAI API key and model under AI Connection.
3. Open the AI Chatbot block: turn on Enable AI Auto-Reply (this is how you “select” our agent — there is no separate Live Chat operator picker), set bot name and icon. With auto-reply on, the chat bubble stays available even when no human operator is online.
4. Edit Store Info once under Website → Configuration → Store Info (opening hours + FAQ). The same content powers /opening-hours, /faq, and the AI tool get_faq_info — no duplicate FAQ fields in AI settings.
5. Configure Website Live Chat so the chat widget appears on the storefront (Website → Configuration → Live Chat) and select a Channel. Keep at least one human operator for handover if needed; do not attach Odoo’s scripted Chatbot if you want our AI to answer.
6. Test on the public shop as a guest (incognito). You do not need to sit in Discuss/Live Chat as admin for the AI to reply.

How it works

1. A visitor opens the Live Chat widget on the webshop and sends a message.
2. Odoo runs the AI hook on discuss.channel automatically.
3. GPT may call tools: get_faq_info, search_products, search_products_by_fitment, or search_vehicles.
4. The final answer is posted as the dedicated bot partner (with the selected icon as avatar).

Store Info (smart AI help)

Opening hours and FAQ live in one place. Change them for the website and the bot answers from the same data. Prefer linking customers to /opening-hours or /faq when they want the full page.

Product and fitment search

For parts tied to a vehicle (brand / model / year), the agent uses search_products_by_fitment. It searches local vehicle.compatibility and also master supplier fitment catalogs (Excel uploaded once on master); SKUs are intersected with published local default_code. Model names are normalized so MT10, MT-10, and MT 10 match. Optional part keywords filter within fitment; if none match, other compatible published products may be returned.

DIY service

When the customer wants to service a vehicle themselves, the agent helps find the right parts via fitment. It does not invent service specifications (gear oil volume, torque, intervals). Exact specs will come later (service data / manuals). Until then the bot offers found parts and workshop contact via Store Info.

Personality

Default tone is friendly and lightly humorous. It never jokes about safety-critical fitment, pricing accuracy, payments, or complaints.

Human handover

When a human operator has already replied in the channel, the AI stays quiet. Ask to speak with a human for escalation.

Requirements

• Modules: website_livechat, nilfish_vehicle_filter, nilfish_powersport, nilfish_powersport_website.
• Python package: openai (same as Product Supplier Scraper).
• Optional: nilfish_vehicle_support for nilfish_is_vehicle_card on products (Vehicle Sale Support).