इस कोडलैब (कोड बनाना सीखने के लिए ट्यूटोरियल) के बारे में जानकारी
1. शुरू करने से पहले
Perspective API (एपीआई) एक मुफ़्त एपीआई है जो आपको बेहतर बातचीत को ऑनलाइन होस्ट करने में मदद करता है. एपीआई, टेक्स्ट की एक स्ट्रिंग का विश्लेषण करने के लिए मशीन लर्निंग (एमएल) का इस्तेमाल करता है. साथ ही, बातचीत पर इसके असर का अनुमान भी लगाता है.
इस कोडलैब में, आप Perspective एपीआई सेट अप करते हैं.
आप इन चीज़ों के बारे में जानेंगे
- मॉडरेशन का एआई (AI) के साथ काम करने वाला यह तरीका, कॉन्टेंट के बनाते ही उसे फ़्लैग कर देता है.
आपको इनकी ज़रूरत होगी
- Google Cloud के ऐक्सेस के लिए Google खाता
- उचित इंटरनेट गति
2. अपनी प्रोफ़ाइल बनाना शुरू करें
शुरू करने के लिए, आपको अपने Google Cloud API प्रोजेक्ट की पुष्टि करनी होगी.
- Google Cloud Console में, कोई मौजूदा प्रोजेक्ट इस्तेमाल करें.
- अगर ज़रूरी हो, तो नया प्रोजेक्ट बनाने के लिए यह तरीका अपनाएं:
- अपने Google खाते से साइन इन करें.
- Cloud Console खोलें.
- प्रोजेक्ट बनाएं पर क्लिक करें या प्रोजेक्ट चुनें मेन्यू खोलें और उसके बाद डायलॉग में नया प्रोजेक्ट पर क्लिक करें.
- अपने प्रोजेक्ट को नाम दें और बनाएं पर क्लिक करें.
प्रोजेक्ट अब ड्रॉप-डाउन मेन्यू में दिखता है.
एपीआई ऐक्सेस का अनुरोध करें
- एपीआई ऐक्सेस का अनुरोध करने के लिए, यह फ़ॉर्म भरें.
एक घंटे के अंदर, आपको एक ईमेल मिलेगा, जो पुष्टि करेगा कि आप Google Cloud में एपीआई देख सकते हैं और उसे चालू कर सकते हैं.
3. एपीआई को चालू करें
- Cloud Console में, खास जानकारी वाले एपीआई की खास जानकारी पेज पर जाएं. इसके बाद, चालू करें पर क्लिक करें.
4. एपीआई कुंजी जनरेट करना
- नेविगेशन मेन्यू में, API और सेवाएं; > क्रेडेंशियल > क्रेडेंशियल बनाएं > एपीआई कुंजी पर क्लिक करें.
आपकी एपीआई कुंजी कुछ ही मिनटों में काम करनी चाहिए, लेकिन इसमें एक घंटा भी लग सकता है. तब तक, आपको गड़बड़ी का मैसेज मिल सकता है.
- एपीआई कुंजी को कॉपी करें.
5. नमूना अनुरोध
आप Google API क्लाइंट लाइब्रेरी का इस्तेमाल करके, एपीआई क्लाइंट लाइब्रेरी जनरेट कर सकते हैं. यह उदाहरण कुछ सामान्य भाषाओं में आपकी एपीआई लाइब्रेरी सेट अप करने का तरीका बताता है.
AnalyzeCommentके लिए अनुरोध करें.- Perspective एपीआई से स्कोर पाने के लिए, इनमें से कोई एक सैंपल एपीआई कॉल चलाएं.
AnalyzeComment तरीका, requestedAttributes के लिए comment.text फ़ील्ड का विश्लेषण करने के लिए, एपीआई अनुरोध जारी करता है. इस मामले में, TOXICITY मॉडल.
- अपनी एपीआई कुंजी को
API_KEYफ़ील्ड में चिपकाएं.
अगर आप चाहें, तो doNotStore फ़्लैग का इस्तेमाल करके यह पक्का कर सकते हैं कि सबमिट की गई सभी टिप्पणियां, स्कोर मिलने के बाद अपने-आप मिट जाएं.
- सभी अनुरोध और रिस्पॉन्स फ़ील्ड की जानकारी के साथ-साथ
requestedAttributesके लिए उपलब्ध वैल्यू के बारे में जानने के लिए, एपीआई के रेफ़रंस दस्तावेज़ पढ़ें.
प्रयोग से जुड़े एट्रिब्यूट, जैसे कि OBSCENE, ATTACK_ON_AdX, और SPAM का इस्तेमाल किया जा सकता है.
Python
यह सैंपल अनुरोध और जवाब, Google API क्लाइंट लाइब्रेरी के Python वर्शन का इस्तेमाल करता है.
- Python की क्लाइंट लाइब्रेरी इंस्टॉल करें.
- ये निर्देश चलाएं:
आपको कुछ इस तरह का आउटपुट दिखेगा:
आपके स्वागत मैसेज को कम स्कोर मिला है.
Node.js के लिए
यह सैंपल अनुरोध और जवाब, Google API क्लाइंट लाइब्रेरी के Node.js वर्शन का इस्तेमाल करता है.
- Node.js के लिए क्लाइंट लाइब्रेरी या npm पैकेज
googleapisइंस्टॉल करें. - ये निर्देश चलाएं:
आपको कुछ इस तरह का आउटपुट दिखेगा:
cURL
यह सैंपल अनुरोध और जवाब, cURL निर्देश का इस्तेमाल करता है. यह निर्देश ज़्यादातर MacOS और Linux उपयोगकर्ताओं के लिए काम करना चाहिए. इस निर्देश को चलाने के लिए, आपको cURL इंस्टॉल करना पड़ सकता है.
YOUR_KEY_HEREको अपनी एपीआई कुंजी से बदलें.
इस रिस्पॉन्स में, attributeScores.TOXICITY.summaryScore.value फ़ील्ड, टिप्पणी के लिए टॉक्सीसिटी मॉडल's का स्कोर दिखाता है. टिप्पणी को 1.0 में से 0.9 स्कोर मिला.
6. बधाई हो
आपके लिए Perspective API (एपीआई) चालू है!
ज़्यादा जानें
- Perspective वेबसाइट वेबसाइट में एपीआई के बारे में ज़्यादा जानकारी शामिल है. इसमें केस स्टडी भी शामिल है.
- Perspective API डेवलपर वेबसाइट में एट्रिब्यूट, भाषाओं, और तरीकों के बारे में ज़्यादा जानकारी शामिल है. अगर आप तुरंत शुरू करना चाहते हैं, तो तरीका पेज पर
AnalyzeCommentऔरSuggestCommentScoreतरीकों को इस्तेमाल करने का तरीका बताया गया है.