MB Logo
Home Work Projects Notes Practice About

Moxa Point Finder

State-aware AI assistant combining retrieval, workflow logic, and conversational guidance to make complex knowledge easier to access.

Project Moxa Point Finder
Status
Last Updated June 2026
Key Tags State-Aware AI, RAG, Conversational UX
Moxa Point Finder Architecture Diagram

System Architecture

Moxa AI Simulator Conversation Outcome

Diagnostic Conversation Flow

Moxa Point Finder helping users navigate moxibustion points and traditional wellness concepts through conversational guidance.

Project Outcomes

  • Working AI assistant
  • Telegram integration
  • Structured TCM knowledge retrieval
  • Visual point guidance
  • WhatsApp integration in progress
  • Planned Flow Temple integration

Overview

Moxa Point Finder began as a practical question.

While researching moxibustion, I noticed that beginners often struggle with the same challenges:

  • unfamiliar terminology
  • difficulty locating points
  • uncertainty about where to begin
  • overwhelming amounts of information

Many existing resources assume prior knowledge.

The goal of Moxa Point Finder is to make these concepts more approachable through guided conversation, visual support, and structured knowledge retrieval.

What started as a learning aid gradually evolved into an exploration of AI-assisted education and conversational system design.

Why I Built It

One of the recurring challenges in Traditional Chinese Medicine is accessibility.

Experienced practitioners can navigate concepts such as meridians, points, constitutions, and symptom patterns naturally.

Beginners often cannot.

I wanted to explore whether an AI assistant could reduce that barrier while still remaining grounded in reliable source material.

The project also became an opportunity to experiment with retrieval systems, conversational UX, and constrained AI interactions.

Core Question

How can conversational AI make complex knowledge easier to access without sacrificing accuracy or overwhelming the user?

Architecture

Telegram / WhatsApp / Web
Botpress
Railway Backend
Google Gemini
Knowledge Layer
Safety & Validation
Structured Response

The assistant combines conversational AI with retrieval, workflow logic, safety validation, and visual learning support.

Rather than relying on the language model alone, multiple layers help guide responses toward useful and reliable outcomes.

Key Components

Knowledge

  • • Structured TCM references
  • • Semantic search
  • • Context injection

State

  • • Tracks conversation progress
  • • Prevents repetitive questioning
  • • Guides outcomes

Visuals

  • • Point diagrams
  • • Verified image assets
  • • Beginner-friendly explanations

Safety

  • • Validation rules
  • • Turn limits
  • • Response checks

Product Evolution

Iteration 1 — Body Mapping Interface

Early Web Prototype

3D Body Interface

Initially I experimented with a visual body interface where users selected pain locations directly.

The concept looked interesting but introduced unnecessary friction and required users to visit a dedicated website.

Iteration 2 — Web Assistant

Advanced Web Chat Prototype Advanced Web Plan Prototype

ZenMoxa Web Assistant

The next version evolved into a conversational web assistant capable of generating recommendations and treatment plans.

While technically more capable, it still required users to leave their existing workflows and visit a separate platform.

Final Direction — Messaging First

The project ultimately shifted toward Telegram and WhatsApp.

Messaging platforms dramatically reduced friction because users could access the assistant within tools they already used daily.

This decision improved accessibility more than any individual AI improvement.

Technology Stack

AI Layer

  • Google AI Studio
  • Gemini API
  • Prompt Engineering
  • State-Aware Workflows

Backend

  • Node.js
  • TypeScript
  • Express
  • Railway

Conversation Layer

  • Botpress
Botpress Visual Workflow

Botpress Routing Logic

Channels

  • Telegram
  • WhatsApp (In Progress)

Knowledge Layer

  • RAG
  • Semantic Search
  • Structured Knowledge Base

Frontend Prototypes

  • React
  • Tailwind CSS

Current Status

The assistant is currently deployed through Telegram, with WhatsApp integration in progress.

Current work focuses on improving conversational quality, expanding knowledge coverage, refining retrieval workflows, and integrating the system into the broader Flow Temple platform.

Lessons Learned

The biggest surprise was how much of the challenge existed outside the language model itself.

Generating responses was relatively straightforward.

Designing workflows, handling edge cases, validating outputs, managing conversation state, and creating a smooth user experience turned out to be the more interesting engineering problem.

The project reinforced the idea that useful AI products are rarely just prompts—they are systems.

← All Projects Markus Berlit