🏗️ QA बॉट से कार्य एजेंट तक: एक आर्किटेक्चर गाइड

TL;DR: ऐसे चैटबॉट बनाना बंद करें जो केवल प्रश्नों का उत्तर देते हैं। ऐसे कार्य एजेंट बनाना शुरू करें जो वास्तव में काम करते हैं।

यह गाइड एकल QA बॉट से कार्य एजेंटों की आर्किटेक्चरल शिफ्ट को स्टैटिक नियमों, डायनामिक स्किल्स और डिटरमिनिस्टिक हुक्स का उपयोग करके समझाती है—कंक्रीट कोड उदाहरणों और ओपन-सोर्स संदर्भों के साथ।

कार्य एजेंट प्रणाली आर्किटेक्चर का चित्रण जो विभिन्न घटकों के बीच बातचीत को दिखाता है

1. कोर शिफ्ट: QA बॉट → कार्य एजेंट

आज के अधिकांश एआई सिस्टम अभी भी संदर्भ-भरे QA बॉट हैं:

• वे प्रश्नों का अच्छा उत्तर देते हैं

• वे दबाव में भ्रांतियाँ पैदा करते हैं

• वे निष्पादन, सुरक्षा और स्थिरता के चारों ओर गारंटी की कमी रखते हैं

💡 मुख्य अंतर्दृष्टि: संदर्भ का विस्तार न करें। इसे संरचना दें।

2. तीन-स्तरीय आर्किटेक्चर

🧱 1. स्थिर संदर्भ — नियम (हमेशा चालू)

•मानसिक मॉडल: कर्मचारी हैंडबुक
•हमेशा लोडेड
•पहचान, कोडिंग मानक, व्यवहारात्मक सीमाओं को परिभाषित करता है
•भ्रमण और शैली के प्रवाह को रोकता है
•छोटा, स्थिर, मानव-संपादनीय

🛠️ 2. गतिशील संदर्भ — कौशल (आवश्यकतानुसार)

•मानसिक मॉडल: टूलबॉक्स
•केवल आवश्यकता होने पर लोडेड
•प्रत्येक कौशल एक आत्म-contained क्षमता है
•संदर्भ विंडो को साफ रखता है

⚓ 3. निर्धारक हुक — गार्डरेल

•मानसिक मॉडल: सुरक्षा + अनुपालन परत
•संभाव्य नहीं
•LLM तर्क से पहले / बाद में चलता है
•ऐसे नियम लागू करता है जो कभी विफल नहीं होने चाहिए

3. अनुशंसित परियोजना संरचना

my-task-agent/
├── .cursorrules
├── main.py
├── tools/
│   └── linear_mcp.py
└── README.md

4. स्थिर संदर्भ उदाहरण: .cursorrules

# भूमिका
आप एक वरिष्ठ पायथन इंजीनियर हैं जो उत्पादन-ग्रेड सिस्टम पर ध्यान केंद्रित कर रहे हैं।

# नियम
- डिबगिंग के लिए कभी भी print() का उपयोग न करें
- हमेशा फ़ंक्शंस के लिए टाइप-हिंट करें
- यदि 3 से अधिक फ़ाइलों को छूना है तो एक योजना प्रस्तावित करें

# व्यवहार
- संक्षिप्त रहें
- यदि आवश्यक हो तो स्पष्टता के लिए प्रश्न पूछें

संदर्भ: https://github.com/PatrickJS/awesome-cursorrules

5. गतिशील कौशल उदाहरण (MCP)

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("DevTools")

@mcp.tool()
def create_linear_ticket(title: str, priority: str = "low") -> str:
    ticket_id = f"LIN-{hash(title) % 10000}"
    return f"Created ticket {ticket_id} with priority={priority}"

if __name__ == "__main__":
    mcp.run()

संदर्भ: https://github.com/modelcontextprotocol/python-sdk

6. निर्धारक हुक उदाहरण

def compliance_check_hook(state):
    user_input = state["messages"][-1].content.lower()
    if "password" in user_input or "api_key" in user_input:
        return {"error": "सुरक्षा उल्लंघन का पता चला"}
    return agent_node(state)

संदर्भ: https://langchain-ai.github.io/langgraph/

यदि आपका एजेंट केवल प्रश्नों का उत्तर देता है, तो यह एक चैटबॉट है। यदि यह विश्वसनीय रूप से कार्य करता है, तो यह एक कार्य एजेंट है।