File size: 4,980 Bytes
363cda9 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 |
# ⚙️ Tools Required for MVP (Phases 1–5)
The system consists of a **Supervisor Agent** (central orchestrator) and several **specialized subagents**.
Each tool corresponds to a specific capability needed for the single-candidate MVP flow — from CV upload to interview scheduling.
---
## 🧠 **Supervisor Agent (Core Orchestrator)**
### **Role**
Acts as the **central controller**:
- Interfaces with HR (via UI or chat)
- Handles reasoning, status reporting, and command interpretation
- Orchestrates subagents (screening, Gmail, calendar)
- Updates both the database and checklist after each atomic action
### **Tools Required**
| Tool | Purpose | Used in Phase |
|------|----------|---------------|
| 🗃️ **Database Tool / ORM Adapter** | Read, create, and update `Candidate` records (status, CV paths, results). | 1–5 |
| 📄 **File I/O Tool** | Read/write per-candidate checklist and parsed CV files. | 1–5 |
| 📊 **Reporting Helper / Aggregation Utility** | Query DB and summarize candidate counts (new, screened, passed, failed). | 2 |
| 🧩 **Subagent Dispatch Interface** | Send structured tasks to subagents (screening, Gmail, calendar). | 3–5 |
| 🧱 **State Manager** | Load and update candidate’s deterministic state object (`state`, `checklist`, `status`). | 4–5 |
| 🕵️ **HR Command Parser / Intent Handler** | Interpret HR’s natural-language instructions (e.g., “process new applicants”). | 2 |
---
## 🤖 **Subagents & Their Tools**
### **1. CV Screening Subagent**
**Phase:** 3
**Purpose:** Automatically screen and score CVs.
| Tool | Purpose |
|------|----------|
| 📄 **CV Parser** | Extract structured text from uploaded CV (PDF/DOCX). |
| 🧮 **Screening Model / Classifier** | Evaluate parsed CV using rules or an ML/LLM-based model. |
| 🗃️ **DB Access Tool** | Save screening results and update `Candidate.status = cv_screened`. |
| 📄 **Checklist Writer** | Mark `[x] Screening started` and `[x] Screening completed` in the checklist. |
---
### **2. Gmail Subagent**
**Phase:** 4
**Purpose:** Send automated emails to candidates based on screening results.
| Tool | Purpose |
|------|----------|
| 📬 **Gmail API Wrapper** | Send templated emails (rejection or invitation). |
| 🧠 **Template Manager** | Store and select appropriate email templates. |
| 🗃️ **DB Access Tool** | Record email activity and update candidate state. |
| 📄 **Checklist Writer** | Mark `[x] Candidate notified` and `[x] Email status recorded`. |
---
### **3. Calendar / Scheduling Subagent**
**Phase:** 5
**Purpose:** Automate interview scheduling for passed candidates.
| Tool | Purpose |
|------|----------|
| 🗓️ **Google Calendar API Wrapper** | Retrieve HR availability and create interview events. |
| 📬 **Gmail API (reuse)** | Send scheduling confirmations and time slot requests. |
| 🧠 **Availability Matcher** | Compare candidate-provided slots vs HR calendar availability. |
| 🗃️ **DB Access Tool** | Update `Candidate.status = interview_scheduled`. |
| 📄 **Checklist Writer** | Mark `[x] HR availability checked`, `[x] Interview scheduled`, `[x] Confirmation sent`. |
---
## 🧾 **Cross-Cutting Utilities (Shared by All Agents)**
| Utility | Purpose | Used by |
|----------|----------|----------|
| 🧩 **Checklist Manager** | CRUD operations on per-candidate Markdown checklist files (load, mark, persist). | All |
| 🧱 **State Sync Layer** | Sync checklist milestone boundaries with DB `status` updates. | Supervisor |
| ⏱️ **Logging & Audit Utility** | Record all actions, errors, and state transitions. | All |
| 🧮 **Config / Environment Loader** | Manage API keys, paths, and credentials for Gmail & Calendar. | All networked agents |
---
## 🧭 **Tool Overview by Phase**
| Phase | Supervisor Tools | Subagents / Tools |
|-------|-------------------|------------------|
| **1 — Candidate I/O + Storage** | DB Adapter, File I/O, Checklist Manager | CV Parser (manual for MVP) |
| **2 — Supervisor + UI** | HR Command Parser, DB Reporter, Checklist Manager | — |
| **3 — CV Screening** | Subagent Dispatcher, Checklist Manager | CV Parser, Screening Model, DB Writer |
| **4 — Candidate Communication** | Subagent Dispatcher, Checklist Manager | Gmail API, Template Manager |
| **5 — Interview Scheduling** | Subagent Dispatcher, Checklist Manager | Calendar API, Availability Matcher, Gmail API |
---
## ✅ **Summary**
- **Supervisor Agent Tools:**
- DB Adapter
- Checklist Manager
- HR Interface (UI or CLI)
- Subagent Dispatcher
- State Sync Logic
- **Subagents:**
- **Screening Subagent:** CV Parser + Screening Model
- **Gmail Subagent:** Email Templating + Send API
- **Calendar Subagent:** Scheduling + Availability Matching
Together, these tools form the complete single-candidate MVP pipeline —
from candidate intake → CV screening → communication → interview scheduling.
|