Maintenance

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 Maintenance
Published June 2026
Key Tags State-Aware AI, RAG, Conversational UX
Moxa Point Finder Architecture Diagram

System Architecture

Moxa AI Simulator Conversation Outcome

Example 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 and broader Flow Temple integration are planned work, not completed outcomes.

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 planned; Web prototype
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, the design uses additional layers to structure responses and handle safety concerns. These safeguards do not make it a diagnostic tool.

Key Components

Knowledge

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

State

  • • Tracks conversation progress
  • • Limits repeated questions
  • • Guides outcomes

Visuals

  • • Point diagrams
  • • Curated 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 required users to visit a dedicated website and navigate a body interface before asking a question. I decided to test a simpler conversational entry point.

Iteration 2 — Web Assistant

Advanced Web Chat Prototype Advanced Web Plan Prototype

ZenMoxa Web Assistant

The next prototype explored conversational explanations and suggested learning paths. Any treatment-like output required careful review and was not a validated treatment plan.

It still required users to visit a separate platform, which led me to test a messaging-based version.

Final Direction — Messaging First

The project ultimately shifted toward Telegram and WhatsApp.

Messaging platforms offered a way to test the assistant in tools people already use. I chose Telegram for the working integration, while WhatsApp remained in progress; I have not measured whether the shift improved accessibility.

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.

The current work is focused on conversational quality, knowledge coverage, and retrieval. WhatsApp and integration into the broader Flow Temple application remain future steps.

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