Agent blueprint

How to build a clinical scribe agent

Free blueprint for a clinical scribe agent. A code-first, single-agent, self-hosted stack with 14 connected components. Built around Nuance DAX, Glass Health, Vanna AI, LangChain. Copy it, export it, or change the answers to fit your project.

Get the code
Your architecture

Healthcare scribe & intake agent

A code-first, single-agent, self-hosted stack with 14 connected components.

Sign in to save

Architecture map

Tap a component to see its connections

INTERFACE &TRIGGERSORCHESTRATIONREASONINGMEMORY &KNOWLEDGETOOLS &INTEGRATIONSMONITORING &SAFETYCHAT INTERFACEWeb chat widgetAGENT FRAMEWORKLangChainHUMAN APPROVAL STEPBuilt into yourorchestratorOPEN-WEIGHT MODELDeepSeekMODEL SERVERvLLMCONVERSATION MEMORYBuilt into yourorchestratorDOCUMENT INGESTIONLlamaIndexVECTOR DATABASEQdrantDATABASE / SQLVanna AICLINICAL NOTE-TAKERNuance DAXCLINICAL REFERENCEGlass HealthHEALTH RECORDSYour EHR (Epic,Cerner…)GUARDRAILSInput & outputchecksTRACING & EVALUATIONLangfuse

Swipe sideways to see the whole map

Tool configuration

Interface & triggers

  • Chat interface

    Where people talk to the agent

    Web chat widget

    or Slack or Teams bot

Orchestration

  • Agent framework

    Agent loop, tool calling and state in code

    LangChain

    or LlamaIndex, CrewAI

  • Human approval step

    Pauses risky actions until a person approves

    Built into your orchestrator

    or n8n wait node, Slack approval message

Reasoning

  • Open-weight model

    Reasoning model that never leaves your servers

    DeepSeek

    or Mistral, Qwen

  • Model server

    Runs the model on your own hardware

    vLLM

    or Ollama

Memory & knowledge

  • Conversation memory

    Keeps track of the current chat or task

    Built into your orchestrator
  • Document ingestion

    Splits and indexes your files and pages

    LlamaIndex

    or Firecrawl

  • Vector database

    Finds the most relevant passages for each question

    Qdrant

    or ChromaDB, Weaviate

Tools & integrations

  • Database / SQL

    Answers questions by querying your data

    Vanna AI

    or Direct SQL tool, Julius AI

  • Clinical note-taker

    Drafts visit notes from the doctor–patient conversation

    Nuance DAX
  • Clinical reference

    Suggests possibilities for a clinician to check

    Glass Health
  • Health records

    Patient records — read-only to start

    Your EHR (Epic, Cerner…)

Monitoring & safety

  • Guardrails

    Blocks unsafe input, prompt injection and data leaks

    Input & output checks

    or Allow-list of tool actions

  • Tracing & evaluation

    Records every step, cost and answer quality

    Langfuse

    or LangSmith, Weights & Biases

Set up your agent, step by step

Tick each step as you finish it. Your progress is saved with this plan in your AItooling account.

0 of 24 done

AItooling never signs up for you and never asks for your passwords or keys. You create each account yourself on the tool's own website, and only your ticks are saved here.

Sign in and save this plan to keep your progress in your account.

  1. 1Create your accounts

    • Sign up or install it, then make a new project for this agent.

    • Install it on your own server. No account is needed, and your data stays with you.

    • Install it on your own server. No account is needed, and your data stays with you.

    • Sign up and create a new database or index just for this agent.

    • Sign up and create a new database or index just for this agent.

    • Sign up and connect only the apps this agent needs, with read-only access where you can.

    • Sign up and connect only the apps this agent needs, with read-only access where you can.

    • Sign up and connect only the apps this agent needs, with read-only access where you can.

    • Use the account you already have, and give the agent its own login with only the access it needs.

    • Sign up and turn on logging so you can review what the agent does.

  2. 2Build it in this order

  3. 3Launch your agent

    • Copy the ready-made code for this agent. It hides secrets and personal data before the AI model sees them.

    • Put each key in a password manager or your hosting's secret settings. Never paste keys or passwords into AItooling or a chat.

    • Start small, read every answer yourself, and only then let other people use it.

Want to go deeper?

Read our step-by-step guides on building agents. Browse guides

More AI agent blueprints