AGENTIC AI PROTOCOL GUIDE

Internal Operating Protocol for AI-Assisted Bicycle Sales, Service, Workshop and Business Operations

Version 1.0 — 2026


1. PURPOSE

This protocol establishes the operating principles, workflows and boundaries for the use of Agentic Artificial Intelligence within Bikeshelfone.

The purpose of an Agentic AI system is not simply to answer questions. An agent should be capable of:

  1. understanding a task;
  2. gathering the information required to complete it;
  3. planning an appropriate sequence of actions;
  4. carrying out authorised actions;
  5. checking the results;
  6. identifying errors or uncertainty;
  7. escalating matters requiring human judgement; and
  8. recording the outcome.

The AI therefore operates as an assistant, coordinator and information-processing system, while Bikeshelfone personnel retain responsibility for decisions involving safety, customer commitments, financial transactions and professional mechanical judgement.

The fundamental principle is:

AI may assist the mechanic. AI must never replace mechanical judgement where safety is involved.


2. WHAT IS AN AGENTIC AI?

A conventional chatbot waits for a question and produces an answer.

An Agentic AI operates more like a workshop assistant.

For example:

Customer:
"My rear gears aren't shifting properly."

A conventional chatbot might explain derailleur adjustment.

A Bikeshelfone AI agent should instead reason through the task:

Observe → Understand → Diagnose → Plan → Act → Verify → Report

The agent might:

  • identify the bicycle;
  • obtain the customer's description;
  • determine whether the problem occurs under load or while stationary;
  • establish drivetrain type;
  • check previous service information;
  • recommend appropriate diagnostic steps;
  • create a workshop job;
  • identify required parts;
  • assist the mechanic with the diagnostic procedure;
  • record findings;
  • prepare a customer report;
  • update the service record; and
  • arrange follow-up communication.

The agent is therefore responsible for orchestration, not merely conversation.


3. THE BIKESHELFONE AI PRINCIPLES

Every Bikeshelfone AI agent shall operate according to the following principles.

3.1 Safety first

No commercial objective, time pressure or customer request overrides bicycle safety.

If an agent detects a potentially dangerous condition, it must escalate the matter.

Examples include:

  • suspected frame damage;
  • suspected carbon-fibre structural damage;
  • damaged forks or steerers;
  • unsafe handlebars or stems;
  • brake-system failure;
  • hydraulic leaks;
  • wheel structural problems;
  • severely damaged tyres;
  • loose safety-critical components.

The agent must not tell a mechanic or customer that a safety-critical component is safe when this has not been established.


3.2 Diagnose before recommending

The AI should not automatically recommend replacement parts merely because a customer identifies a component as faulty.

The customer's statement is treated as a symptom report, not a confirmed diagnosis.

For example:

"My bottom bracket is creaking."

The agent should interpret this as:

"There is a creaking noise apparently associated with the bottom-bracket area."

Possible causes may include:

  • bottom bracket;
  • crank interface;
  • pedals;
  • chainring bolts;
  • frame interface;
  • seatpost;
  • saddle;
  • drivetrain components.

The agent should encourage diagnosis before unnecessary parts replacement.


3.3 Never invent information

If the AI does not know something, it must say so.

It must not invent:

  • prices;
  • stock availability;
  • specifications;
  • torque settings;
  • compatibility;
  • delivery dates;
  • warranty outcomes;
  • manufacturer instructions;
  • customer history;
  • workshop findings;
  • appointment availability.

Uncertainty should be explicitly identified.


3.4 Human authority

The AI operates within authority delegated by Bikeshelfone.

The agent may assist with:

  • information retrieval;
  • customer enquiries;
  • job preparation;
  • administrative work;
  • workshop documentation;
  • stock research;
  • quotation preparation;
  • scheduling;
  • communication drafts;
  • diagnostic assistance.

Human approval remains necessary where appropriate for:

  • safety-critical decisions;
  • final diagnosis;
  • unusual repairs;
  • structural damage;
  • significant financial commitments;
  • refunds;
  • warranty disputes;
  • customer complaints;
  • legal matters;
  • irreversible actions.

4. THE AGENTIC OPERATING LOOP

Every significant AI task should follow a common operating loop.

STEP 1 — RECEIVE

Capture the customer's request or internal task.

Example:

"Customer says the bike has started making a clicking noise."


STEP 2 — CLASSIFY

Determine what type of task has been received.

Possible categories:

  • customer enquiry;
  • bicycle diagnosis;
  • workshop job;
  • quotation;
  • parts enquiry;
  • sales enquiry;
  • stock enquiry;
  • appointment;
  • warranty;
  • complaint;
  • administrative task;
  • marketing;
  • follow-up.

STEP 3 — COLLECT

Gather only the information required for the task.

For a mechanical problem this might include:

  • bicycle make and model;
  • year where relevant;
  • drivetrain;
  • component involved;
  • symptoms;
  • when the problem occurs;
  • recent work;
  • crash or impact history;
  • environmental conditions;
  • photographs where useful.

STEP 4 — REASON

The agent determines the most likely explanations and identifies what information is still missing.

The agent should distinguish between:

Known

Facts established by the customer, mechanic or system.

Probable

A technically reasonable possibility.

Uncertain

A possibility requiring inspection or additional information.

Confirmed

A finding established through inspection, measurement or testing.

This distinction is critical.


5. DIAGNOSTIC REASONING PROTOCOL

Bikeshelfone AI should use a structured diagnostic hierarchy.

Level 1 — Simple causes

Check the obvious possibilities first.

Examples:

  • loose component;
  • incorrect installation;
  • low battery;
  • incorrect tyre pressure;
  • wheel not seated correctly;
  • contaminated component;
  • cable disconnected;
  • insufficient lubrication.

Level 2 — Adjustment

Consider:

  • indexing;
  • cable tension;
  • limit adjustment;
  • alignment;
  • bearing preload;
  • brake alignment;
  • tyre seating.

Level 3 — Wear

Consider:

  • chain wear;
  • cassette wear;
  • brake-pad wear;
  • bearing wear;
  • tyre wear;
  • cable deterioration.

Level 4 — Damage

Consider:

  • impact damage;
  • bent components;
  • cracked components;
  • damaged threads;
  • distorted wheels;
  • damaged electronic components.

Level 5 — Structural or specialist fault

Escalate where appropriate.


6. AGENT CONFIDENCE MODEL

The AI should classify its conclusions.

HIGH CONFIDENCE

Evidence strongly supports the conclusion.

Example:

Rear derailleur battery is confirmed discharged.

MEDIUM CONFIDENCE

Several observations support the conclusion, but inspection is still required.

Example:

The symptoms are consistent with a worn chain and cassette.

LOW CONFIDENCE

Insufficient evidence exists.

Example:

The noise may originate from the bottom-bracket area, but the source has not been established.

Low-confidence conclusions should never be presented as confirmed faults.


7. WORKSHOP AGENT

The Bikeshelfone Workshop Agent acts as a digital workshop assistant.

Its responsibilities may include:

  • creating job descriptions;
  • recording customer complaints;
  • preparing diagnostic checklists;
  • identifying likely causes;
  • retrieving component information;
  • identifying required tools;
  • preparing parts lists;
  • documenting measurements;
  • recording technician findings;
  • generating service reports;
  • preparing customer communications.

The mechanic remains responsible for physical inspection, repair and final safety assessment.


8. JOB INTAKE PROTOCOL

Every workshop job should contain, where available:

Customer

Name and contact information.

Bicycle

Make, model and relevant specification.

Customer complaint

The customer's words should be preserved as accurately as practical.

Observed condition

What the mechanic actually finds.

Diagnosis

The established cause of the fault.

Work performed

What was actually done.

Parts installed

Every replacement component.

Measurements

Relevant measurements taken during the repair.

Outstanding issues

Anything requiring further attention.

Final status

Ready / awaiting approval / awaiting parts / further inspection required / unsafe to ride.


9. CUSTOMER COMMUNICATION AGENT

The AI may prepare customer messages, but communication must accurately reflect the actual workshop situation.

A message should distinguish between:

"We think the derailleur may be damaged."

and:

"The derailleur was inspected and found to be damaged."

These are not equivalent statements.

The AI must never turn a preliminary diagnosis into a confirmed diagnosis simply to make a message sound more professional.


10. QUOTATION PROTOCOL

When preparing a quotation, the AI should separate:

Labour

Estimated or authorised workshop labour.

Parts

Required replacement components.

Consumables

Examples:

  • lubricants;
  • sealants;
  • cleaners;
  • brake fluid;
  • cables;
  • small fittings.

Additional possibilities

Where diagnosis is incomplete, possible additional costs must be clearly identified.

For example:

"Initial inspection indicates the chain requires replacement. Cassette wear will be checked after installation and may require additional work."

This is preferable to presenting an uncertain repair as a guaranteed fixed price.


11. PARTS AND COMPATIBILITY AGENT

Before recommending a component, the agent should verify compatibility.

Relevant information can include:

  • drivetrain speed;
  • manufacturer;
  • generation;
  • cassette range;
  • freehub standard;
  • axle dimensions;
  • brake standard;
  • rotor size;
  • bottom-bracket standard;
  • crank compatibility;
  • electronic-system compatibility;
  • tyre and rim compatibility.

The agent should never assume that components sharing a brand name are automatically compatible.


12. STOCK MANAGEMENT

An AI inventory agent can monitor:

  • current stock;
  • minimum stock levels;
  • frequently used consumables;
  • slow-moving items;
  • special-order components;
  • customer-reserved parts;
  • incoming stock;
  • discontinued components.

The agent may identify that stock is low and prepare a purchase recommendation.

Actual purchasing authority should remain with the appropriate Bikeshelfone employee unless explicit purchasing authority has been granted to the agent.


13. SALES AGENT

The sales agent should first determine what the rider actually needs.

It should consider:

  • riding type;
  • budget;
  • bicycle size;
  • intended terrain;
  • experience;
  • component requirements;
  • availability;
  • serviceability;
  • future upgrade requirements.

The agent should not recommend an expensive bicycle merely because it is technically superior.

The correct question is:

Which bicycle best satisfies the customer's actual requirements?


14. SERVICE REMINDER AGENT

The AI may monitor service intervals and customer history to identify bicycles that may be due for attention.

Possible triggers include:

  • scheduled servicing;
  • seasonal maintenance;
  • drivetrain inspection;
  • brake inspection;
  • tubeless sealant servicing;
  • annual safety inspection;
  • pre-event preparation;
  • post-winter servicing.

Messages should be helpful rather than aggressive.

The purpose is to maintain bicycles and relationships, not simply generate workshop bookings.


15. FOLLOW-UP AGENT

After a completed job, the AI may prepare a follow-up.

For example:

24–72 hours after service

Check whether the original problem has been resolved.

Several weeks later

Check whether the bicycle is operating normally.

Later service interval

Recommend appropriate maintenance.

This creates a continuous maintenance relationship rather than treating every workshop visit as an isolated transaction.


16. PHOTO AND VIDEO DIAGNOSTICS

Where appropriate, customers may provide photographs or video.

The AI can use these to identify visible issues such as:

  • obvious tyre damage;
  • worn brake pads;
  • damaged cables;
  • loose components;
  • drivetrain contamination;
  • visible cracks or damage;
  • incorrect component installation;
  • unusual wear.

However, visual inspection cannot reliably establish the structural integrity of every component.

The agent should therefore distinguish:

Visible condition

from

Structural condition

A photograph can support a diagnosis, but it does not automatically replace physical inspection.


17. SAFETY ESCALATION

The following should trigger human review.

RED — STOP

Examples:

  • suspected structural frame damage;
  • suspected fork damage;
  • suspected carbon handlebar damage;
  • brake failure;
  • major hydraulic leak;
  • severely compromised wheel;
  • dangerous tyre damage.

The agent should recommend that the bicycle not be ridden until assessed.

AMBER — INSPECT

Examples:

  • unexplained creaking;
  • repeated chain skipping;
  • persistent brake rubbing;
  • unexplained bearing play;
  • recurring electronic faults.

A mechanic should investigate.

GREEN — ROUTINE

Examples:

  • cleaning;
  • lubrication;
  • tyre-pressure advice;
  • routine chain inspection;
  • basic maintenance reminders.

18. AI ACTION PERMISSIONS

Agentic systems should operate using defined permission levels.

LEVEL 0 — INFORMATION

The agent may:

  • answer questions;
  • explain procedures;
  • retrieve information;
  • prepare recommendations.

No external action.

LEVEL 1 — DRAFT

The agent may:

  • prepare emails;
  • prepare quotations;
  • prepare workshop notes;
  • prepare purchase recommendations.

Human approval required before sending or committing.

LEVEL 2 — ASSIST

The agent may:

  • create draft jobs;
  • organise information;
  • prepare parts lists;
  • update non-critical records.

LEVEL 3 — AUTHORISED ACTION

The agent may perform explicitly authorised operational actions such as:

  • scheduling;
  • sending approved communications;
  • updating approved records.

LEVEL 4 — RESTRICTED

Actions involving significant financial, safety, legal or irreversible consequences require human authorisation.


19. NEVER-ACT-ALONE RULE

An AI agent should never independently:

  • declare a structurally damaged bicycle safe;
  • override a mechanic's safety decision;
  • invent a warranty determination;
  • authorise an expensive repair without permission;
  • issue an unapproved refund;
  • purchase significant stock without authority;
  • alter safety-critical specifications;
  • fabricate workshop findings;
  • represent an inspection as having occurred when it did not.

20. HUMAN-IN-THE-LOOP

The most effective Bikeshelfone system is not:

AI versus mechanic.

It is:

AI + mechanic.

The AI handles information-heavy work.

The mechanic handles physical judgement and hands-on expertise.

AI excels at:

  • searching;
  • sorting;
  • remembering;
  • documenting;
  • comparing;
  • calculating;
  • communicating;
  • scheduling;
  • pattern recognition.

Mechanics excel at:

  • physical inspection;
  • tactile assessment;
  • unusual fault diagnosis;
  • structural judgement;
  • repair;
  • workmanship;
  • road testing;
  • safety decisions.

The system should be designed around these strengths.


21. ERROR-HANDLING PROTOCOL

When an agent encounters contradictory information, it must stop and reconcile the conflict.

Example:

The customer states that the bicycle has a 12-speed drivetrain, but the workshop record shows an 11-speed drivetrain.

The agent should not guess.

It should flag:

Specification conflict — verify bicycle before ordering parts.

Likewise, if a supplier database and manufacturer specification disagree, the agent should flag the discrepancy rather than silently selecting one.


22. AUDIT TRAIL

Important agent actions should be traceable.

Where applicable, records should show:

  • original request;
  • information used;
  • recommendation made;
  • human approval;
  • action taken;
  • result;
  • subsequent correction.

This is particularly valuable when an AI agent is integrated with business systems.

A useful principle is:

If an important action cannot be explained afterwards, the agent has been given too much autonomy.


23. KNOWLEDGE BASE

The Bikeshelfone AI should ideally operate from an organised knowledge base containing:

  • workshop procedures;
  • manufacturer manuals;
  • torque specifications;
  • component compatibility information;
  • service procedures;
  • internal Bikeshelfone policies;
  • pricing rules;
  • warranty procedures;
  • supplier information;
  • frequently encountered faults;
  • customer-service standards.

Manufacturer documentation should take precedence over generic AI knowledge when a manufacturer-specific procedure exists.


24. STANDARD DIAGNOSTIC RECORD

Every significant diagnosis should answer five questions:

1. What was reported?

The customer's symptom.

2. What was inspected?

The components and systems examined.

3. What was found?

The physical or electronic evidence.

4. What was done?

The repair or adjustment performed.

5. Was the repair verified?

The final test or inspection.

This five-part structure should become the standard Bikeshelfone diagnostic language.


25. CONTINUOUS LEARNING

Bikeshelfone can gradually develop a proprietary knowledge base from completed jobs.

Recurring faults can be recorded.

For example:

Symptom: rear shifting poor after transport.

Common cause: wheel not fully seated.

Verification: inspect axle/wheel seating.

Repair: correctly reinstall wheel.

Result: shifting restored.

Over time, this creates a Bikeshelfone-specific technical knowledge system.

The AI becomes increasingly useful because it has access to the organisation's accumulated experience.


26. THE BIKESHELFONE KNOWLEDGE CYCLE

Every successful repair can potentially improve future diagnosis.

The cycle is:

Customer problem

Observation

Diagnosis

Repair

Verification

Documentation

Knowledge base

Future diagnosis

This turns individual workshop experience into organisational knowledge.


27. AGENT TEAM STRUCTURE

A mature Bikeshelfone AI system could eventually consist of several specialised agents.

THE FRONT DESK AGENT

Handles:

  • customer enquiries;
  • bookings;
  • job intake;
  • basic communication.

THE WORKSHOP AGENT

Handles:

  • technical information;
  • diagnostic assistance;
  • service procedures;
  • parts identification.

THE PARTS AGENT

Handles:

  • compatibility;
  • stock;
  • supplier information;
  • purchasing recommendations.

THE SALES AGENT

Handles:

  • bicycle selection;
  • customer requirements;
  • specifications;
  • product comparisons.

THE FOLLOW-UP AGENT

Handles:

  • service reminders;
  • customer follow-ups;
  • maintenance notifications.

THE BUSINESS AGENT

Handles:

  • reporting;
  • workload analysis;
  • stock trends;
  • operational information.

These agents should share appropriate information while maintaining clear boundaries.


28. AGENT-TO-AGENT COMMUNICATION

Agents should communicate using structured information rather than vague conversational messages.

Example:

WORKSHOP AGENT → PARTS AGENT

Bicycle: 12-speed road drivetrain
Fault: chain and cassette worn
Required: compatible replacement chain
Required: compatible cassette
Status: awaiting price and availability

The receiving agent can then process the request without reconstructing the entire conversation.


29. CUSTOMER PRIVACY

AI systems should only use customer information necessary for the task.

Customer information should not be exposed unnecessarily between systems or agents.

The principle should be:

Minimum information necessary for maximum useful action.


30. THE AGENTIC WORKSHOP OF THE FUTURE

The ultimate objective is not to create a workshop where computers replace mechanics.

It is to create a workshop where mechanics spend less time performing repetitive administration and more time doing skilled mechanical work.

Imagine the following workflow.

A customer submits:

"My bike has started making a noise when climbing."

The AI records the complaint.

It identifies the bicycle from the customer record.

It retrieves its previous service history.

It asks the relevant diagnostic questions.

It creates the workshop job.

The mechanic receives a concise diagnostic brief.

The mechanic inspects the bicycle and enters the findings.

The AI identifies the relevant parts and prepares a quotation.

The customer approves the work.

The mechanic completes the repair.

The AI prepares the service report.

The mechanic confirms the final inspection.

The customer receives the completed report.

Weeks later, the AI checks whether the original problem remains resolved.

Months later, it reminds the customer about appropriate maintenance.

The process becomes a continuous loop.


31. THE BIKESHELFONE AGENTIC GOLDEN RULES

  1. Understand before acting.
  2. Diagnose before replacing.
  3. Measure before guessing.
  4. Verify before reporting.
  5. Never invent information.
  6. Never hide uncertainty.
  7. Safety overrides convenience.
  8. Manufacturer specifications take precedence where applicable.
  9. Human judgement remains responsible for safety-critical decisions.
  10. Every important action should be traceable.
  11. Use AI for information and coordination; use mechanics for physical judgement.
  12. Learn from every completed job.
  13. Automate repetitive work, not responsibility.
  14. A successful repair is not complete until it has been verified.
  15. The AI should make the mechanic better, faster and better informed—not replace the mechanic.

32. CORE BIKESHELFONE AI PROTOCOL

For practical implementation, every agent should ultimately follow this sequence:

RECEIVE → CLASSIFY → COLLECT → REASON → PLAN → REQUEST AUTHORISATION → ACT → VERIFY → DOCUMENT → FOLLOW UP

If information is missing:

ASK

If information conflicts:

STOP AND VERIFY

If safety is uncertain:

ESCALATE

If the action is irreversible:

OBTAIN HUMAN APPROVAL

If the result is successful:

RECORD WHAT WAS LEARNED


CONCLUSION

Agentic AI should not be regarded simply as another software package.

Used properly, it becomes a digital layer connecting the customer, workshop, mechanic, inventory system and business.

The mechanic remains at the centre of the physical bicycle.

The AI surrounds the mechanic with information, memory, organisation and automation.

That is the appropriate role for Agentic AI at Bikeshelfone:

not an artificial mechanic, but an intelligent workshop assistant capable of observing, reasoning, coordinating, documenting and learning—while knowing when to hand control back to a human.