How puri-adityakumar/agentic-ai works
The repository is a learning-oriented collection of three AI-agent products: email assistance, healthcare appointments, and sales representation. The email workflow is the best-supported: a user submits a chat message, the API stores it and invokes a supervisor, which can use email-related tools; users can also retrieve recent chat messages. Healthcare exposes appointment operations through a Supabase-backed API. Sales has workflow and prompt assets, but their runtime wiring is not shown. Healthcare and sales details are limited to the README, tree, and sampled healthcare endpoint.
Main entry points: routing.py Chat API · tools.py Email tools · main.py API application · agents.py Agent supervisor
Components 24
Email agent
- Chat API
email_agent/backend/src/api/chat/routing.py - API application
email_agent/backend/src/main.py - Chat records
email_agent/backend/src/api/chat/models.py - Database access
email_agent/backend/src/api/db.py - Agent supervisor
email_agent/backend/src/api/ai/agents.py - Email tools
email_agent/backend/src/api/ai/tools.py - Message generation
email_agent/backend/src/api/ai/services.py - LLM client
email_agent/backend/src/api/ai/llms.py - Inbox reader
email_agent/backend/src/api/emailer/inbox_reader.py - Gmail IMAP parser
email_agent/backend/src/api/emailer/gmail_imap_parser.py - Mail sender
email_agent/backend/src/api/emailer/sender.py
Healthcare agent
- Appointments API
healthcare_agent/src/servless/index.ts - Appointments
healthcare_agent/src/schema.sql - Agent workflow
healthcare_agent/src/workflow/workflow.json - Agent prompts
healthcare_agent/prompts
Sales agent
- Sales workflow
sales_rep_agent/workflow.json - Sales prompts
sales_rep_agent/prompts
Other components
- User
- OpenAI-compatible model
- Gmail IMAP
- SMTP email service
- Patient or staff
- Supabase
- Sales user
Connections 20
- User → API application: sends requests
- API application → Chat API: mounts routes
- Chat API → Database access: gets session
- Chat API → Chat records: stores and lists
- Chat API → Agent supervisor: invokes
- Agent supervisor → Email tools: tool use
- Email tools → Message generation: generates research
- Message generation → LLM client: gets model
- LLM client → OpenAI-compatible model: calls
- Email tools → Inbox reader: reads inbox
- Inbox reader → Gmail IMAP parser: fetches messages
- Gmail IMAP parser → Gmail IMAP: searches mail
- Email tools → Mail sender: sends message
- Mail sender → SMTP email service: delivers email
- Patient or staff → Appointments API: requests appointments
- Appointments API → Supabase: reads and writes
- Supabase → Appointments: stores records
- Sales user → Sales workflow: uses agent
- Sales workflow → Sales prompts: prompt wiring unclear
- Agent workflow → Agent prompts: prompt wiring unclear