फ्रेमवर्क का चयन कैसे करें
आपने पहले ही एक Agent स्वयं लिखा है और जानते हैं कि लूप का हर कदम क्या करता है। इस सेक्शन में देखें कि मुख्यधारा के फ्रेमवर्क आपके लिए क्या-क्या काम करते हैं, कौन-से परिदृश्य के लिए उपयुक्त हैं, और उनमें से एक का उपयोग करके दूसरे अध्याय का उदाहरण फिर से लिखा गया है।
Anthropic की "Building effective agents" में दी गई सलाह पहले याद रखने लायक है: पहले सीधे बड़े मॉडल का इंटरफ़ेस उपयोग करें, कई पैटर्न कुछ ही लाइनों के कोड से लागू हो जाते हैं; फ्रेमवर्क उपयोग करें तो समझें कि वह नीचे की परत में क्या कर रहा है।
एक तालिका
| क्या है | भाषा | क्या घरेलू मॉडल / स्थानीय मॉडल उपयोग किया जा सकता है | उपयुक्त | |
|---|---|---|---|---|
| स्वयं लिखा (यह पाठ) | एक while लूप | कोई भी | हाँ, कोई भी OpenAI-संगत इंटरफ़ेस | सिद्धांत सीखने के लिए; ज़रूरतें सरल हों और पूर्ण नियंत्रण चाहिए |
| OpenAI Agents SDK | हल्का Agent फ्रेमवर्क: Agent, टूल, Handoff, गार्डरेल, सेशन, ट्रेसिंग | Python (0.25.0) | हाँ, आधिकारिक दस्तावेज़ में अन्य सेवा प्रदाताओं से जुड़ने का तरीका दिया गया है, हमने स्थानीय Ollama से परीक्षण करके चलाया | तैयार मल्टी-Agent सहयोग और गार्डरेल चाहिए, पर एक मॉडल कंपनी से बंधना नहीं चाहते |
| Claude Agent SDK | Claude Code को लाइब्रेरी की तरह उपयोग करना: वही टूल, लूप, संदर्भ प्रबंधन | Python, TypeScript | आधिकारिक दस्तावेज़ में केवल Bedrock, Google Cloud, Microsoft Foundry जैसे प्लेटफ़ॉर्म के ज़रिए Claude के उपयोग का उल्लेख है, अन्य निर्माताओं के मॉडल जोड़ने का तरीका नहीं बताया गया | एक ऐसा शक्तिशाली प्रोग्रामिंग-प्रकार का Agent चाहिए जो फ़ाइलें पढ़-लिख सके, कमांड चला सके |
| LangGraph | निम्न-स्तरीय ऑर्केस्ट्रेशन फ्रेमवर्क: "स्टेट + नोड + एज" के ग्राफ़ से प्रवाह परिभाषित करें | Python | हाँ | लंबे समय तक चलने वाली, परसिस्टेंस, मानवीय हस्तक्षेप, हर कदम के स्पष्ट नियंत्रण वाली जटिल प्रक्रियाएँ |
| Dify | ओपन-सोर्स AI ऐप बिल्डिंग प्लेटफ़ॉर्म, विज़ुअल ऑर्केस्ट्रेशन | कोड लिखने की ज़रूरत नहीं | हाँ | गैर-प्रोग्रामर आंतरिक टूल बना सकते हैं; प्राइवेट डिप्लॉयमेंट की ज़रूरत हो तो |
| 扣子(Coze) | ByteDance का प्लेटफ़ॉर्म; ओपन-सोर्स संस्करण का नाम Coze Studio है | कोड लिखने की ज़रूरत नहीं | — | विज़ुअल तरीके से बिल्ड करें |
कुछ बातें स्पष्ट करना ज़रूरी हैं:
- क्या Claude Agent SDK के साथ घरेलू (चीनी) मॉडल इस्तेमाल किए जा सकते हैं? यह सर्च में आम सवाल है। हमें जो आधिकारिक दस्तावेज़ मिले, उनमें केवल Anthropic की API Key से प्रमाणीकरण, या Amazon Bedrock, Google Cloud, Microsoft Foundry जैसे क्लाउड प्लेटफ़ॉर्म के ज़रिए Claude के इस्तेमाल का ज़िक्र है; दूसरे वेंडर के मॉडल जोड़ने का उल्लेख नहीं है।
- Dify का लाइसेंस मानक Apache 2.0 नहीं है, बल्कि "संशोधित Apache 2.0" है: अनुमति के बिना इसके सोर्स कोड से मल्टी-टेनेंट सेवा नहीं चलाई जा सकती, और फ्रंटएंड का लोगो व कॉपीराइट जानकारी हटाई नहीं जा सकती। नवीनतम संस्करण 1.20.0 (2026-11-18)।
- 扣子: coze.cn अब "AI ऑफिस असिस्टेंट" पर फोकस करता है; ओपन-सोर्स Coze Studio Apache 2.0 लाइसेंस का इस्तेमाल करता है, लेकिन इसकी सबसे हालिया रिलीज़ v0.5.1 (2026-2-5) है।
दूसरे अध्याय को OpenAI Agents SDK से दोबारा लिखें
pip install openai-agents, और फिर (step_sdk.py डाउनलोड करें):
import os
from agents import Agent, Runner, AsyncOpenAI, OpenAIChatCompletionsModel, set_tracing_disabled
from agents.decorators import tool
set_tracing_disabled(disabled=True) # 没有 OpenAI 平台的 key 时要关掉 tracing
client = AsyncOpenAI(base_url=os.environ.get("AGENT_BASE_URL", "http://localhost:11434/v1"),
api_key=os.environ.get("AGENT_API_KEY", "ollama"))
model = OpenAIChatCompletionsModel(model=os.environ.get("AGENT_MODEL", "qwen3:8b"), openai_client=client)
@tool
def add(a: float, b: float) -> float:
"""计算两个数的和"""
return a + b
@tool
def multiply(a: float, b: float) -> float:
"""计算两个数的积"""
return a * b
agent = Agent(name="计算助手", instructions="用工具做计算,最后用中文回答。", tools=[add, multiply], model=model)
result = Runner.run_sync(agent, "一箱苹果 24 个,我买了 17 箱,又多拿了 9 个。一共多少个?请用工具计算。")
print(result.final_output)आपको यह दिखना चाहिए (लोकल मशीन पर qwen3:8b):
कुल मिलाकर 417 सेब खरीदे गए। गणना इस प्रकार है:
1. 17 डिब्बे सेब: 17 × 24 = 408 सेब
2. अतिरिक्त लिए गए 9 सेब जोड़ें: 408 + 9 = 417 सेबदूसरे अध्याय से तुलना करें: tools का JSON Schema हाथ से लिखने की ज़रूरत नहीं (टाइप एनोटेशन और डॉकस्ट्रिंग से जनरेट होता है), लूप, tool_call_id मिलान चिह्न और मैसेज जोड़ना — सब Runner करता है।
नॉन-OpenAI मॉडल जोड़ते समय तीन बातें (आधिकारिक दस्तावेज़ों से):
OpenAIChatCompletionsModelका इस्तेमाल करें: SDK डिफ़ॉल्ट रूप से OpenAI के नए Responses इंटरफ़ेस पर चलता है, जिसे कई अन्य प्रोवाइडर सपोर्ट नहीं करते और 404 एरर आता है।- अगर OpenAI प्लेटफ़ॉर्म की key नहीं है, तो
set_tracing_disabled(True)करें, वरना ट्रेसिंग अपलोड पर 401 एरर मिलेगा। @toolनए संस्करण में@function_toolका संक्षिप्त रूप है, और पुराने ऑनलाइन ट्यूटोरियलों में लिखा@function_toolभी अभी भी काम करता है।
कैसे चुनें
खोजेंमेरी स्थिति यह है……
एक पर क्लिक करके देखें।
आपकी परीक्षाOpenAI Agents SDK से लोकल Ollama जोड़ते समय OpenAIChatCompletionsModel क्यों इस्तेमाल करें?
एक बार जाँच लें
- मैं पाँचों तरीकों में से हर एक के लिए बता सकता हूँ कि वह किस स्थिति के लिए उपयुक्त है
- मैंने OpenAI Agents SDK से लोकल मॉडल जोड़ने का उदाहरण सफलतापूर्वक चलाया है
- मुझे पता है कि Claude Agent SDK और Dify में किन-किन बातों का ध्यान रखना ज़रूरी है
अगला भाग: सुरक्षा: अनुमतियाँ, सैंडबॉक्स और प्रॉम्प्ट इंजेक्शन।