OpenAI Agents SDK से WhatsApp एजेंट कैसे बनाएँ

OpenAI Agents SDK एजेंट बनाने के लिए OpenAI का ओपन-सोर्स फ़्रेमवर्क है: निर्देशों वाला मॉडल, उसके कॉल करने लायक टूल, दूसरे एजेंट को हैंडऑफ़ और उसके इनपुट व आउटपुट के चारों ओर गार्डरेल, सब एक लूप में तब तक चलते हैं जब तक काम पूरा न हो। एजेंट बनाने का यह बढ़िया तरीक़ा है। पर यह अपने आप में आपको WhatsApp नंबर, टीम इनबॉक्स, टेम्पलेट मैसेज या किसी इंसान के कमान संभालने का तरीक़ा नहीं देता। MonoChat के Agent Harness के साथ आप OpenAI Agents SDK को AI हार्नेस के रूप में चुनते हैं, फ़्लो में AI एजेंट नोड रखते हैं, WhatsApp कनेक्ट करते हैं और टेस्ट करते हैं, और बाकी MonoChat संभालता है।

यह गाइड बताती है कि SDK आपको क्या देता है, MonoChat में OpenAI एजेंट इस्तेमाल करने के तीन तरीक़े, चरण-दर-चरण सेटअप, और WhatsApp के वे विवरण जो तय करते हैं कि ग्राहक एजेंट पर भरोसा करेंगे या नहीं।

OpenAI Agents SDK आपको क्या देता है

SDK कुछ गिने-चुने विचारों के इर्द-गिर्द बना है:

• एजेंट: एक मॉडल और उसका काम बताने वाले निर्देश।
• टूल: वे फ़ंक्शन जिन्हें एजेंट कॉल कर सकता है, जैसे “ऑर्डर देखें” या “टाइम स्लॉट जाँचें”, साथ में MCP सर्वर।
• हैंडऑफ़: एक एजेंट का काम उस दूसरे एजेंट को सौंपना जो उसमें माहिर है, उदाहरण के लिए सामान्य सपोर्ट एजेंट से रिटर्न एजेंट को।
• गार्डरेल: एजेंट के साथ चलने वाली जाँचें, जो ऐसे इनपुट या आउटपुट रोकती हैं जो आप नहीं चाहते।
• सेशन और ट्रेसिंग: टर्न के आर-पार मेमोरी और इसका रिकॉर्ड कि एजेंट ने चरण-दर-चरण क्या किया।

ये सब मिलकर एजेंट हार्नेस बनाते हैं: वह लूप जो मॉडल को एक बार जवाब देने के बजाय काम करने, अपना काम जाँचने और आगे बढ़ने देता है। कस्टमर मैसेजिंग में यही फ़र्क़ है आपकी रिटर्न पॉलिसी समझाने और सचमुच रिटर्न बनाने के बीच।

WhatsApp समस्या में क्या जोड़ता है

एजेंट बनाना आधा काम है। उसे WhatsApp पर ग्राहकों के सामने रखने के लिए इन्हें संभालना पड़ता है:

• WhatsApp Business Platform। एक आधिकारिक API कनेक्शन, सत्यापित बिज़नेस और अप्रूव्ड नंबर।
• 24 घंटे की विंडो। फ़्री-फ़ॉर्म जवाब ग्राहक के आख़िरी मैसेज के 24 घंटे के भीतर दिए जा सकते हैं; उसके बाद अप्रूव्ड टेम्पलेट चाहिए।
• पॉलिसी। 15 जनवरी 2026 से WhatsApp सामान्य-उद्देश्य AI असिस्टेंट को प्लैटफ़ॉर्म से बाहर रखता है। आपके अपने ग्राहकों की सेवा करने वाला एजेंट अनुमत है, और जवाब ऑटोमेटेड होने पर इंसान तक पहुँचने का साफ़ रास्ता अपेक्षित है।
• लोग। कुछ बातचीत हिस्ट्री के साथ किसी इंसान के पास जानी चाहिए, उसी टूल के भीतर जो आपकी टीम पहले से इस्तेमाल करती है।
• दूसरे चैनल। जो ग्राहक Instagram, Messenger या आपकी वेबसाइट पर लिखते हैं, वे वही जवाब चाहते हैं।

MonoChat एजेंट के आसपास यह सब संभालता है, ताकि आपका काम एजेंट पर ही रहे।

MonoChat में OpenAI एजेंट इस्तेमाल करने के तीन तरीक़े

विकल्प	यह कहाँ चलता है	आपको क्या चाहिए
OpenAI Agents SDK	MonoChat के अंदर	कुछ अतिरिक्त नहीं; आपके AI मॉडल इस्तेमाल होते हैं
OpenAI Agents API (OpenAI द्वारा होस्टेड)	OpenAI का क्लाउड	आपकी OpenAI API कुंजी
कस्टम (आपकी अपनी Agents SDK सर्विस)	आपका अपना सर्वर	एक एंडपॉइंट URL और एक शेयर्ड सीक्रेट

अगर आप बिना कुछ डिप्लॉय किए OpenAI-स्टाइल एजेंट चाहते हैं तो OpenAI Agents SDK हार्नेस से शुरू करें। अगर आपके एजेंट पहले से OpenAI के होस्टेड प्लैटफ़ॉर्म पर हैं तो OpenAI Agents API चुनें। अगर आपके डेवलपर ने SDK से अपने टूल, हैंडऑफ़ और टेस्ट के साथ अपना एजेंट लिखा है और उसी कोड को चलाते रहना चाहते हैं तो कस्टम चुनें; देखें अपना AI एजेंट WhatsApp से कैसे कनेक्ट करें।

चरण-दर-चरण: WhatsApp पर OpenAI Agents SDK एजेंट

1. AI हार्नेस जोड़ें

MonoChat में AI हार्नेस जोड़ें और प्रदाता के रूप में OpenAI Agents SDK चुनें। यह MonoChat के अंदर चलता है और आपके पहले से सेट किए AI मॉडल इस्तेमाल करता है, इसलिए इस चरण के लिए कोई अतिरिक्त कुंजी या सर्वर नहीं चाहिए।

2. फ़्लो में AI एजेंट नोड जोड़ें

जिस फ़्लो में आपकी WhatsApp बातचीत आती है, उसमें AI एजेंट नोड जोड़ें और हार्नेस चुनें। एजेंट के निर्देश लिखें: वह किसकी सेवा करता है, क्या कर सकता है, क्या कभी नहीं करना है और कब हैंडओवर करना है।

3. मुख्य, फ़ॉलबैक और तेज़ मॉडल चुनें

हर AI एजेंट नोड में तीन मॉडल भूमिकाएँ होती हैं:

• मुख्य मॉडल सोचता है और जवाब लिखता है।
• फ़ॉलबैक मॉडल सॉफ़्ट लिमिट या विफलता के बाद कमान संभालता है।
• तेज़ मॉडल बैकग्राउंड का काम संभालता है।

हर रन की बजट सीमा जोड़ें ताकि कोई एक असामान्य बातचीत बड़ा बिल न बना दे। पक्का नहीं कि फ़ॉलबैक कैसे चुनें? पढ़ें आपके ग्राहकों से बात करने वाले AI एजेंट को फ़ॉलबैक मॉडल क्यों चाहिए।

4. अपने टूल कनेक्ट करें

एजेंट को वे टूल दें जो आपके सबसे बार-बार आने वाले अनुरोधों से मेल खाते हैं:

• स्ट्रक्चर्ड इनपुट के साथ अपनी API कॉल के लिए AI फ़ंक्शन टूल।
• MCP-संगत सिस्टम के टूल के लिए MCP इंटीग्रेशन।
• आपके दस्तावेज़ों और पॉलिसी पर आधारित जवाबों के लिए AI नॉलेज बेस।
• बातचीत के भीतर चलने वाले लॉजिक के लिए कस्टम फ़ंक्शन।

तीन अच्छे टूल, पंद्रह आधे-टेस्ट किए टूल से बेहतर हैं। असली बातचीत देखने के बाद और जोड़ें।

5. WhatsApp (और बाकी सब) कनेक्ट करें

अपना WhatsApp Business नंबर MonoChat के ज़रिए कनेक्ट करें, जो एक आधिकारिक Meta Business Partner है। वही फ़्लो Instagram, Messenger, TikTok, Telegram, वेब चैट, SMS और वॉयस पर चल सकता है, इसलिए एक एजेंट हर चैनल कवर करता है।

6. असली मैसेज से टेस्ट करें

पिछले महीने की बातचीत को अपना टेस्ट सेट बनाएँ। मुश्किल वाली शामिल करें: नाराज़ ग्राहक, अस्पष्ट सवाल, एक मैसेज में कई अनुरोध, ऐसा ग्राहक जो तुरंत इंसान माँगे। टूल कॉल, लहजा और हैंडओवर जाँचें। फिर लाइव करें।

WhatsApp पर अच्छे काम करने वाले पैटर्न

हर मैसेज में एक सवाल। वेब पर चैट के लिए बने एजेंट अक्सर लंबी सूचियों से जवाब देते हैं। फ़ोन पर छोटे मैसेज और एक बार में एक साफ़ सवाल से ग्राहकों के बेहतर जवाब मिलते हैं।

वापस न होने वाले एक्शन से पहले पुष्टि करें। कैंसलेशन, रिफ़ंड या बुकिंग बदलने से पहले एजेंट प्रस्ताव रखे और ग्राहक पुष्टि करे।

विशेषज्ञ हैंडऑफ़ से, इंसान इनबॉक्स से। SDK के हैंडऑफ़ एजेंट के बीच रूटिंग (सेल्स, सपोर्ट, रिटर्न) के लिए बढ़िया हैं। किसी इंसान को हैंडओवर MonoChat के शेयर्ड टीम इनबॉक्स में होता है, जहाँ बातचीत पूरी हिस्ट्री के साथ पहुँचती है।

निर्देश जो सीमाएँ बताएँ। “€50 तक के रिफ़ंड आप मंज़ूर कर सकते हैं; उससे ऊपर बिलिंग टीम को हैंडओवर करें।” साफ़ संख्याएँ अस्पष्ट नियमों से बेहतर हैं।

इसे अपने बिज़नेस तक रखें। आपके ग्राहकों की मदद करने वाला एजेंट WhatsApp पर अनुमत है। जो कुछ भी जवाब दे दे, वह WhatsApp के 2026 के नियम तोड़ने का जोखिम उठाता है; हमारी WhatsApp AI चैटबॉट पॉलिसी गाइड बताती है कि रेखा कहाँ है।

लागत

तीन चीज़ें जुड़ती हैं: आपका MonoChat प्लान, AI मॉडल का इस्तेमाल और Meta के WhatsApp मैसेज शुल्क। 1 अक्टूबर 2026 से Meta हर बिज़नेस नंबर पर हर महीने के पहले 1,000 के बाद सर्विस जवाबों पर शुल्क लेता है; हमारी WhatsApp API प्राइसिंग गाइड देखें।

AI की ओर, जब आप अपनी प्रदाता कुंजियाँ इस्तेमाल करते हैं तो MonoChat कोई मार्कअप नहीं जोड़ता। हर रन की बजट सीमा, बैकग्राउंड काम के लिए सस्ता तेज़ मॉडल और भरोसेमंद फ़ॉलबैक बिल को अनुमानित रखते हैं।

किसी एक में बँधे नहीं

Agent Harness आपको सिर्फ़ मॉडल नहीं, फ़्रेमवर्क चुनने देता है। अगर आप बाद में Claude Agent SDK, Pi, Claude Managed Agents या अपना फ़्रेमवर्क आज़माना चाहें, तो दूसरा AI हार्नेस जोड़ें और AI एजेंट नोड को उस पर इंगित करें। आपके चैनल, टूल और हैंडओवर जैसे हैं वैसे रहते हैं। सभी प्रदाताओं की तुलना Agent Harness पेज पर करें।