Tutorial: Medical Appointment Bot

A guided tour of Picoflow’s MedicalFlow: a two-step agent that acts like a clinic receptionist, triages symptoms with tool calls, suggests doctors, and books an appointment before closing the chat. You will:

Stand up the NestJS/FlowEngine service that powers medical-appointment-bot.
Register Gemini 2.5 Pro as the model and expose /ai/run + /ai/end endpoints.
Understand how SymptomsStep and BookingStep share state, tools, and transitions.
Inspect the session document lifecycle so you can extend the bot safely.
Run the API from curl or your own front end.

Note

This tutorial is self-contained. The source it explains lives in medical-appointment-bot/src, and the runtime concepts match the internal Picoflow engine docs included in this repo.