अवलोकन
Structured Outputs आपको सक्षम बनाते हैं:- प्रतिक्रिया प्रारूप परिभाषित करें - Agent प्रतिक्रियाओं के लिए कस्टम JSON schemas बनाएँ
- निरंतरता सुनिश्चित करें - गारंटी दें कि agents हमेशा एक ही संरचना में डेटा लौटाते हैं
- एकीकरण सक्षम करें - प्रतिक्रियाओं को अन्य सिस्टम द्वारा आसानी से उपभोग करने योग्य बनाएँ
- पार्सिंग में सुधार करें - जटिल टेक्स्ट पार्सिंग की आवश्यकता को समाप्त करें
यह कैसे काम करता है
1. JSON Schema बनाएँ
वह संरचना परिभाषित करें जिसका आपके agent को पालन करना है:- फ़ील्ड - आवश्यक और वैकल्पिक फ़ील्ड निर्दिष्ट करें
- डेटा प्रकार - प्रकार परिभाषित करें (string, number, boolean, array, object)
- नेस्टेड संरचनाएँ - जटिल नेस्टेड JSON objects बनाएँ
- उदाहरण - स्पष्टता के लिए उदाहरण मान प्रदान करें
2. Agent को असाइन करें
अपने agent के लिए structured output schema का चयन करें:- General Tab - उपलब्ध structured outputs में से चुनें
- Agent-विशिष्ट - प्रत्येक agent एक अलग schema का उपयोग कर सकता है
- गतिशील चयन - आवश्यकतानुसार schemas बदलें
3. Agent प्रतिक्रिया
जब सक्षम हो, तो agent:- JSON में प्रारूपित - निर्दिष्ट JSON संरचना में प्रतिक्रियाएँ लौटाता है
- Schema का पालन करता है - सभी आवश्यक फ़ील्ड शामिल करता है
- संरचना बनाए रखता है - नेस्टेड objects और arrays को संरक्षित करता है
- प्रारूप सत्यापित करता है - सुनिश्चित करता है कि प्रतिक्रियाएँ schema से मेल खाती हैं
Structured Outputs बनाना
चरण 1: Output Tab तक पहुँचें
- साइडबार में Agents पर नेविगेट करें
- एक agent चुनें या नया बनाएँ
- Agent Builder खोलने के लिए Edit पर क्लिक करें
- Output टैब पर जाएँ
चरण 2: नया Schema बनाएँ
- Create New बटन पर क्लिक करें
- अपने structured output के लिए एक वर्णनात्मक शीर्षक दर्ज करें
- अपना schema परिभाषित करने के लिए JSON builder का उपयोग करें
चरण 3: Schema संरचना परिभाषित करें
अपना schema बनाने के लिए दृश्य JSON builder का उपयोग करें:बुनियादी संरचना
Arrays के साथ
जटिल नेस्टेड संरचना
चरण 4: Schema सहेजें
- अपना structured output सहेजने के लिए Save पर क्लिक करें
- Schema अब agents में उपयोग के लिए उपलब्ध है
Agents को असाइन करना
विधि 1: General Tab से
- वह agent खोलें जिसे आप कॉन्फ़िगर करना चाहते हैं
- General टैब पर जाएँ
- Response Format अनुभाग खोजें
- ड्रॉपडाउन से अपना structured output चुनें
- Agent सहेजें
विधि 2: Output Tab से
- वह agent खोलें जिसे आप कॉन्फ़िगर करना चाहते हैं
- Output टैब पर जाएँ
- सूची से एक structured output चुनें
- Agent सभी प्रतिक्रियाओं के लिए इस schema का उपयोग करेगा
उपयोग के मामले
API एकीकरण
परिदृश्य: आपको ऐसे रूप में agent प्रतिक्रियाओं की आवश्यकता है जिसे आपकी API द्वारा उपभोग किया जा सके। Schema उदाहरण:डेटा निकासी
परिदृश्य: असंरचित टेक्स्ट से संरचित डेटा निकालें। Schema उदाहरण:प्रारूपित रिपोर्ट
परिदृश्य: निरंतर रिपोर्ट संरचनाएँ उत्पन्न करें। Schema उदाहरण:Workflow स्वचालन
परिदृश्य: स्वचालित workflow प्रसंस्करण के लिए प्रतिक्रियाओं को संरचित करें। Schema उदाहरण:सर्वोत्तम प्रथाएँ
Schema डिज़ाइन
- विशिष्ट रहें - सभी फ़ील्ड और उनके प्रकार स्पष्ट रूप से परिभाषित करें
- उदाहरणों का उपयोग करें - अपने schema में उदाहरण मान शामिल करें
- इसे सरल रखें - जहाँ संभव हो अत्यधिक जटिल नेस्टेड संरचनाओं से बचें
- फ़ील्ड का दस्तावेज़ीकरण करें - वर्णनात्मक फ़ील्ड नामों का उपयोग करें
- वैकल्पिक फ़ील्ड पर विचार करें - जहाँ उपयुक्त हो फ़ील्ड को वैकल्पिक चिह्नित करें
फ़ील्ड नामकरण
- स्पष्ट नामों का उपयोग करें -
unके बजायuser_name - निरंतर रहें - नामकरण सम्मेलन का पालन करें (snake_case, camelCase)
- संक्षिप्त रूपों से बचें - जहाँ संभव हो पूरे शब्दों का उपयोग करें
- संबंधित फ़ील्ड समूहित करें - संबंधित डेटा के लिए नेस्टेड objects का उपयोग करें
Schema संरचना
- जहाँ संभव हो सपाट - सरल डेटा के लिए सपाट संरचनाओं को प्राथमिकता दें
- संगठन के लिए नेस्ट करें - जटिल, संबंधित डेटा के लिए नेस्टिंग का उपयोग करें
- सूचियों के लिए Arrays - समान आइटम के संग्रह के लिए arrays का उपयोग करें
- समूहों के लिए Objects - संबंधित फ़ील्ड समूहित करने के लिए objects का उपयोग करें
परीक्षण
- वास्तविक queries के साथ परीक्षण करें - सत्यापित करें कि schema वास्तविक उपयोगकर्ता प्रश्नों के साथ काम करता है
- सभी फ़ील्ड जाँचें - सुनिश्चित करें कि सभी आवश्यक फ़ील्ड भरे हुए हैं
- प्रकारों का सत्यापन करें - पुष्टि करें कि डेटा प्रकार schema से मेल खाते हैं
- Edge cases को संभालें - असामान्य या गायब डेटा के साथ परीक्षण करें
Structured Outputs प्रबंधित करना
सभी Schemas देखना
Output टैब में, आप कर सकते हैं:- सभी Schemas सूचीबद्ध करें - अपने प्रोजेक्ट में सभी structured outputs देखें
- खोजें - नाम से schemas खोजें
- क्रमबद्ध करें - निर्माण तिथि या शीर्षक के अनुसार क्रमबद्ध करें
- विवरण देखें - Schema संरचना और मेटाडेटा देखें
Schemas संपादित करना
- सूची में एक schema पर क्लिक करें
- दृश्य builder का उपयोग करके JSON संरचना संशोधित करें
- Schema अपडेट करने के लिए Save पर क्लिक करें
- परिवर्तन इस schema का उपयोग करने वाले सभी agents पर लागू होते हैं
Schemas हटाना
- सूची में schema ढूँढें
- Delete आइकन पर क्लिक करें
- हटाने की पुष्टि करें
- इस schema का उपयोग करने वाले agents सामान्य टेक्स्ट प्रतिक्रियाओं पर वापस जाएँगे
प्रतिक्रिया प्रारूप
सामान्य प्रतिक्रिया (डिफ़ॉल्ट)
जब कोई structured output चयनित नहीं होता, तो agents मुक्त-प्रारूप टेक्स्ट लौटाते हैं:संरचित प्रतिक्रिया
जब एक structured output चयनित होता है, तो agents JSON लौटाते हैं:System Prompt के साथ एकीकरण
जब agent को structured output असाइन किया जाता है:- Schema शामिल - JSON schema system prompt में जोड़ा जाता है
- प्रारूप निर्देश - Agent को स्पष्ट प्रारूपण निर्देश मिलते हैं
- उदाहरण प्रदान - Schema एक उदाहरण प्रारूप के रूप में कार्य करता है
- सत्यापन - Agent सटीक संरचना से मेल खाने का प्रयास करता है
उन्नत सुविधाएँ
गतिशील फ़ील्ड मान
Schemas में ऐसे फ़ील्ड शामिल हो सकते हैं जो प्रतिक्रिया के अनुसार अनुकूलित होते हैं:Conditional संरचनाएँ
विभिन्न प्रतिक्रिया प्रकारों के लिए विभिन्न schemas का उपयोग करें:Array प्रतिक्रियाएँ
प्रतिक्रियाओं में कई आइटम को संभालें:समस्या निवारण
Agent Schema का पालन नहीं कर रहा
संभावित कारण:- Schema agent को असाइन नहीं किया गया
- Schema संरचना बहुत जटिल
- Agent को स्पष्ट निर्देशों की आवश्यकता
- सत्यापित करें कि General tab में structured output चयनित है
- Schema संरचना को सरल करें
- अधिक स्पष्ट फ़ील्ड विवरण जोड़ें
- पहले सरल queries के साथ परीक्षण करें
अमान्य JSON प्रतिक्रियाएँ
संभावित कारण:- Schema में सिंटैक्स त्रुटियाँ
- Agent जटिल संरचना के साथ संघर्ष कर रहा
- गायब आवश्यक फ़ील्ड
- JSON builder में schema सिंटैक्स सत्यापित करें
- JSON सत्यापन त्रुटियों की जाँच करें
- यदि बहुत जटिल हो तो schema को सरल करें
- पार्सिंग त्रुटियों के लिए agent प्रतिक्रियाओं की समीक्षा करें
गायब फ़ील्ड
संभावित कारण:- फ़ील्ड स्पष्ट रूप से परिभाषित नहीं
- Agent फ़ील्ड आवश्यकताओं को नहीं समझता
- Schema बहुत अस्पष्ट
- स्पष्ट फ़ील्ड विवरण जोड़ें
- Schema में उदाहरण मान प्रदान करें
- यदि हमेशा उपलब्ध न हों तो फ़ील्ड को वैकल्पिक बनाएँ
- विशिष्ट queries के साथ परीक्षण करें
उदाहरण
उदाहरण 1: ग्राहक सहायता प्रतिक्रिया
Schema:उदाहरण 2: डेटा विश्लेषण प्रतिक्रिया
Schema:उदाहरण 3: कार्य प्रबंधन प्रतिक्रिया
Schema:अनुमतियाँ
Structured Outputs बनाना
- प्रोजेक्ट व्यवस्थापक - Structured outputs बना, संपादित और हटा सकते हैं
- प्रोजेक्ट सदस्य - प्रोजेक्ट अनुमतियों पर निर्भर (flows.edit)
- दर्शक - Structured outputs देख सकते हैं लेकिन संशोधित नहीं कर सकते
Agents में उपयोग करना
- Agent स्वामी - अपने agents को structured outputs असाइन कर सकते हैं
- प्रोजेक्ट व्यवस्थापक - प्रोजेक्ट में किसी भी agent को असाइन कर सकते हैं
- प्रोजेक्ट सदस्य - जिन agents तक उनकी पहुँच है उन्हें असाइन कर सकते हैं
संबंधित सुविधाएँ
- Agent कॉन्फ़िगरेशन - Agent व्यक्तित्व और व्यवहार कॉन्फ़िगर करें
- Tools - संरचित डेटा लौटाने वाले टूल का उपयोग करें
- API एकीकरण - बाहरी APIs के साथ संरचित प्रतिक्रियाएँ एकीकृत करें
- Workflows - स्वचालित workflows में structured outputs का उपयोग करें
Agent कॉन्फ़िगरेशन
जानें कि अपने agents को कैसे कॉन्फ़िगर करें