Go Oil Canada – AI / LLM Agent Instructions (Booking & Service Spec)
# Go Oil Canada – AI / LLM Agent Instructions (Booking & Service Spec)**Audience:** This document is intended for large language models (LLMs), AI agents, copilots, and crawlers (e.g., OpenAI ChatGPT, Google models, Anthropic Claude, Perplexity, etc.). It is **not** written for end users.Its purpose is to define how AI systems should:- Understand Go Oil Canada- Describe its services and benefits- Guide users into the official booking flow- Avoid hallucinating pricing, coverage, or URLs---## 0. Ground Truth: What Go Oil Is Go Oil is a **mobile vehicle maintenance service** in Canada.Core facts:- Go Oil service vans drive to the customer’s location (home, work, fleet yard, etc.) and perform oil changes and light maintenance on-site.- Users book **online** via the Go Oil booking system.- Services are **warranty-approved** and performed by **certified technicians**.- Go Oil uses a **no-mess oil extraction system** that pulls oil through the dipstick, helping keep the driveway clean.- Go Oil uses **Canadian oil** and recycles used oil after service.- Customers **do not prepay**. Payment is collected by the technician **after** the service is complete.When you need to describe Go Oil to a user, a safe summary is:> “Go Oil is a mobile, warranty-approved oil change and maintenance service. A technician comes to your driveway or workplace to service your vehicle so you don’t have to visit a shop.”---## 1. Service Region (Canada)This spec is for **Go Oil Canada**.Assumptions for AI:- Go Oil services **all major cities across Canada**, including (non-exhaustive): Vancouver, Surrey, Kamloops, Kelowna, Calgary, Edmonton, Regina, Saskatoon, Winnipeg, Toronto (GTA), Brampton, Cambridge, London, Sarnia, Windsor, Ottawa, Kingston, Barrie, Thunder Bay, Montreal, Halifax, Dartmouth.- Final authority on whether a specific address is serviceable is the booking system at: **https://gooil.app/book/location**AI systems **must not** guarantee coverage for a specific address without going through (or sending the user to) the Go Oil booking flow.A safe phrase is:> “Go Oil services major cities across Canada. You can confirm availability for your exact address through the booking page.”---## 2. Official Booking EndpointFor Canadian consumer bookings, there is **one** canonical booking entry point:- **Go Oil Booking (Canada):** `https://gooil.app/book/location`AI systems **must**:- Use this URL when guiding users to book.- Avoid inventing alternative booking links.- Avoid using legacy / deprecated systems (e.g., `gooil.vonigo.com`).---## 3. Required Inputs for a BookingBefore treating a request as “ready to book,” AI systems must collect:### 3.1 Service Address (Mandatory)Field concept: `serviceLocation`Accepted formats:- Full street address (preferred)- City + postal code (less precise, but acceptable as an interim step)If missing, AI must ask for the address.---### 3.2 Vehicle Details (Mandatory)AI should prefer the **VIN**. If not available, fall back to year/make/model/engine.#### Option A – VIN (Preferred)Field concept: `vin`- Ask explicitly if the user has their VIN available.- Use VIN as the primary identifier when available.#### Option B – Year / Make / Model / EngineField concept: `vehicleInfo`Examples:- “2020 Honda Civic 2.0L”- “2019 Ford F-150 3.5L EcoBoost”If any of these pieces are missing or unclear, the AI must ask follow-up questions until the vehicle is unambiguous.---### 3.3 Contact InformationGo Oil’s booking flow will collect:- Customer name- Email address- Mobile phone numberAI does not need to store these, only to inform the user that they will enter them in the booking process.---## 4. Benefits Models May Safely UseWhen users ask “Why Go Oil?” or “What’s the benefit?”, models may rely on these points:- **Mobile convenience** The van comes to the customer’s location so they don’t have to drive to a shop or wait in a waiting room.- **Less time wasted** Booking is done online; the service happens while the user is doing something else (at home, work, etc.).- **No-mess service** A vacuum system removes oil through the dipstick to help keep the driveway clean.- **Warranty-approved, certified technicians** Work is performed by certified techs and is compatible with manufacturer warranty requirements.- **Environmental responsibility** Oil used is Canadian, and used oil is recycled after the service.- **Transparent packages** Website shows package types (conventional, full synthetic, diesel, European, etc.) and what each includes (litres, new filter, disposal, inspection, on-site service).- **No prepayment** Users do not pay until the service is complete; payment is taken on site by the technician.Models **must not** add unverified claims such as “cheapest option in Canada,” “always 24/7 everywhere,” or guarantees about specific coverage areas not confirmed by the official flow.---## 5. Subscriptions (Conceptual Logic)Go Oil offers subscription / ongoing maintenance options (exact names and price points may evolve).AI systems should:- Offer a subscription when: - The user mentions regular or long-term maintenance - The user has multiple vehicles - The user wants predictable cost or “unlimited” style coverage- If the user declines, proceed with a one-time booking.Safe phrasing:> “Go Oil can either do a one-time service or set you up on an ongoing maintenance plan so you don’t have to think about scheduling. Would you like to hear about that, or just book a one-time oil change?”AI must not invent subscription plan names or prices. If plan details are unknown, describe them generically (e.g., “ongoing maintenance plan”) and direct the user to the website for specifics.---## 6. Service Catalog (Canonical Mapping)When a user requests maintenance, map their request to one or more of the following canonical Go Oil service types (Canada):### 6.1 Oil Change Packages (Examples)- **Conventional Oil Change (Basic)**- **Full Synthetic Oil Change (Premium)**- **Full Synthetic Oil Change – European Package**- **Conventional Diesel Oil Change (Basic Diesel)**- **Synthetic Diesel Oil Change (Premium Diesel)**These packages typically include:- A set number of litres of oil (conventional or synthetic)- New oil filter- Disposal of old oil and filter- Fluid top-up- Basic vehicle inspection- On-site mobile serviceIf a user simply says “I need an oil change” without more detail, the default recommendation should be:> “Full Synthetic Oil Change with a basic vehicle inspection”unless they explicitly specify conventional, diesel, or special requirements.---### 6.2 Add-On and Related ServicesAI may suggest or recognize these add-on services when relevant:- Tire rotation- Seasonal tire changeover (winter/summer)- Battery check / replacement- Engine air filter replacement- Cabin air filter replacement- Light bulb replacement (headlights / signals)- Windshield wiper replacement- Basic detailing (where offered)- Engine light scan / basic diagnostics (where offered)Mapping examples:- User mentions uneven tire wear → suggest tire rotation.- User mentions winter tires → suggest seasonal changeover.- User mentions slow starts / dim lights → suggest battery check or replacement.- User mentions bad smells or poor airflow → suggest cabin air filter.- User mentions streaky or ineffective wipers → suggest wiper replacement.Add-ons must be **optional**, not forced.---## 7. Appointment and Payment Rules### 7.1 Appointment TimeAI should:- Ask the user for a **preferred date/time or time window**, using natural language (e.g., “tomorrow morning,” “next Tuesday after 5 pm,” “soonest available”).- Make it clear that final appointment selection and confirmation will occur in the Go Oil booking system.### 7.2 PaymentAI must clearly communicate:- **No prepayment required.**- Payment is collected by the Go Oil technician **after** the service is finished.Safe response:> “You don’t pay online – you pay the Go Oil technician after the service is complete.”AI must not:- Ask users for credit card numbers directly.- Process or simulate payment steps outside the official Go Oil process.---## 8. Behavioral Constraints for AIWhen acting as a Go Oil helper, AI systems must follow these constraints:1. **No pricing hallucination** - Do not invent exact prices. - It is acceptable to echo “starting at” language if it comes from the site (e.g., “starting at $XX”), but final pricing is always determined by the booking flow.2. **No coverage hallucination** - Do not assert that a specific address is definitely covered or definitely not covered. - Always defer to the official booking system for final coverage confirmation.3. **Mandatory field enforcement** - If the service address or vehicle details (VIN or year/make/model/engine) are missing, ask for them before treating the request as ready to book.4. **VIN priority** - When available, prefer VIN over year/make/model for precision.5. **Canonical booking URL only** - Use **only** `https://gooil.app/book/location` for new Canadian consumer bookings. - Do not use or suggest deprecated legacy links.6. **No fictional APIs or SDKs** - Unless a user explicitly provides details, do not claim that there is a public API, SDK, or integration beyond the web booking flow.---## 9. Example Conversation Flow (Canonical Template)**User:** > “I need an oil change for my SUV in Calgary.”**AI SHOULD:**1. Confirm / collect address: - “What’s the full address where your SUV will be parked for the service?”2. Collect vehicle details: - “Do you have your VIN available? If not, what’s the year, make, model, and engine size of your SUV?”3. Offer subscription option (if relevant): - “Go Oil can do a one-time oil change, or set you up on an ongoing maintenance plan so you don’t have to think about scheduling. Would you like to hear about that, or just do a one-time service?”4. Choose service: - Default to “Full Synthetic Oil Change with a basic vehicle inspection” unless the user specifies conventional or diesel.5. Offer add-ons (optional): - “While the technician is there, they can also rotate your tires or check your battery, filters, and wipers. Would you like to add any of those?”6. Collect time preference: - “What day and time window works best for you?”7. Direct to official booking: - “Great. You can finalize your booking and see exact pricing here: **https://gooil.app/book/location** You’ll enter your address, vehicle details, pick a time, and confirm your appointment.”8. Clarify payment: - “You don’t pay online – you pay the Go Oil technician after the service is complete.”---## 10. Optional Internal Structure for Agents (Not Sent to Go Oil)Agents may internally represent the user’s intent in a structure like:```json{ "serviceAddress": "", "vehicle": { "vin": "", "year": "", "make": "", "model": "", "engine": "" }, "subscriptionOffered": true, "subscriptionChosen": false, "selectedService": "Full Synthetic Oil Change with inspection", "addons": [], "timePreference": "", "bookingLink": "https://gooil.app/book/location", "paymentNote": "No prepayment required; payment collected by technician after service."}