How vigneshwaran100/patient-appointment-agent works
2Care AI is a stateful healthcare receptionist: patients provide multi-turn requests, the agent screens for safety, verifies identity, and routes scheduling or registration actions through deterministic tools backed by SQLite. Separate evaluation and improvement workflows benchmark conversations and database effects, diagnose failures, stage policies, and check candidate changes for regressions. Core runtime calls are visible in the excerpts or SOURCE INDEX; evaluation/improvement links follow documented workflow and indexed imports where noted.
Main entry points: graph.py Conversation Graph · registry.py Tool Registry · loop.py Improvement Loop · database.py Clinic Database
Components 21
Reception Runtime
- Conversation Agent
app/agent.py - Conversation Graph
app/graph.py - Domain State
app/state.py - Safety Screener
app/guardrails.py - Prompts & Policies
app/prompts.py - LLM Providers
app/llm.py
Clinic Operations
- Tool Registry
app/tools/registry.py - Patient Intake
app/tools/patient.py - Availability Search
app/tools/availability.py - Booking
app/tools/booking.py - Cancel & Reschedule
app/tools/cancellation.py - Clinic Database
app/storage/database.py
Evaluation
- Scenario Evaluator
eval/evaluator.py - Scoring Rubric
eval/rubric.py - Benchmark Runner
eval/runner.py - Regression Comparator
eval/regression.py
Policy Improvement
- Failure Analyzer
improvement/failure_analyzer.py - Policy Generator
improvement/improvement_generator.py - Versioned Policy Store
improvement/policy_store.py - Improvement Loop
improvement/loop.py
Other components
- Patient
Connections 28
- Patient → Conversation Agent: sends turns
README.md - Conversation Agent → Conversation Graph: processes turns
app/agent.py - Conversation Graph → Safety Screener: screens requests
README.md - Conversation Graph → Domain State: updates state
app/graph.py - Conversation Graph → Prompts & Policies: uses prompts
app/graph.py - Conversation Graph → LLM Providers: invokes models
app/graph.py - Conversation Graph → Tool Registry: dispatches tools
app/graph.py - LLM Providers → Tool Registry: binds tools
app/llm.py - Tool Registry → Patient Intake: registers
app/tools/registry.py - Tool Registry → Availability Search: registers
app/tools/registry.py - Tool Registry → Booking: registers
app/tools/registry.py - Tool Registry → Cancel & Reschedule: registers
app/tools/registry.py - Patient Intake → Clinic Database: looks up patients
app/tools/patient.py - Availability Search → Clinic Database: queries slots
app/tools/availability.py - Booking → Clinic Database: books appointments
app/tools/booking.py - Cancel & Reschedule → Clinic Database: changes appointments
app/tools/cancellation.py - Benchmark Runner → Conversation Agent: runs scenarios
eval/runner.py - Benchmark Runner → Scenario Evaluator: evaluates runs
eval/runner.py - Scenario Evaluator → Clinic Database: checks effects
eval/evaluator.py - Scenario Evaluator → Scoring Rubric: scores dimensions
eval/evaluator.py - Improvement Loop → Benchmark Runner: runs benchmarks
improvement/loop.py - Improvement Loop → Failure Analyzer: requests diagnoses
improvement/loop.py - Failure Analyzer → Scoring Rubric: reads results
improvement/failure_analyzer.py - Improvement Loop → Policy Generator: creates policies
improvement/loop.py - Improvement Loop → Versioned Policy Store: stages policies
improvement/loop.py - Improvement Loop → Regression Comparator: compares runs
improvement/loop.py - Prompts & Policies → Versioned Policy Store: loads active policies
README.md - Policy Generator → Failure Analyzer: uses diagnoses
improvement/improvement_generator.py