Pipet Code एजेंट की मदद से एआई कोड असिस्टेंट बनाएं

कोड लिखना, एक ऐसा काम है जिससे आपको खुशी मिलती है और आपका मन भी शांत होता है. हालांकि, अपने कोड को काम करने वाले से प्रज़ेंट करने लायक बनाने में अक्सर परेशानी होती है. एआई के जनरेटिव मॉडल की मदद से, कोड में टिप्पणियां जोड़ी जा सकती हैं. साथ ही, समीक्षा करने वाले लोगों से पहले गड़बड़ियां ढूंढी जा सकती हैं. इसके अलावा, कोडिंग वर्कफ़्लो को आसान बनाने के लिए, कई अन्य काम भी किए जा सकते हैं.

इस ट्यूटोरियल में, Pipet Code Agent को एक्सटेंशन करने का तरीका बताया गया है. यह एआई की मदद से काम करने वाला कोड असिस्टेंस टूल है. इसे Google की एआई डेवलपर रिलेशन टीम ने बनाया है. यह ओपन सोर्स प्रोजेक्ट, Microsoft Visual Studio Code (VS Code) का एक एक्सटेंशन है. इससे आपको कोडिंग के कुछ अहम, लेकिन कम मज़ेदार टास्क पूरे करने में मदद मिलती है. जैसे, अपने कोड पर टिप्पणी करना, गड़बड़ियां ढूंढना, और सुधार के सुझाव देना. यह एक्सटेंशन, Gemini API को कोड से जुड़ी मदद के अनुरोध भेजता है. साथ ही, कोड में बदलाव करने की विंडो में जवाब शामिल करता है.

इन मौजूदा फ़ंक्शन को आपके लिए बेहतर बनाने के लिए, Pipet में बदलाव किया जा सकता है. इसके अलावा, डेवलपमेंट वर्कफ़्लो को बेहतर बनाने के लिए नए निर्देश बनाए जा सकते हैं.

इस प्रोजेक्ट के बारे में खास जानकारी देने वाला वीडियो देखें. इसमें, इस प्रोजेक्ट को बनाने वाले लोगों की अहम जानकारी के साथ-साथ, इसे इस्तेमाल करने का तरीका भी बताया गया है. इसके लिए, एआई कोड असिस्टेंट - Google के एआई की मदद से बनाएं देखें. इसके अलावा, नीचे दिए गए निर्देशों का पालन करके, प्रोजेक्ट को बढ़ाया जा सकता है.

प्रोजेक्ट सेटअप करना

इन निर्देशों की मदद से, डेवलपमेंट और टेस्टिंग के लिए Pipet Code Agent प्रोजेक्ट को सेट अप किया जा सकता है. आम तौर पर, कुछ ज़रूरी सॉफ़्टवेयर इंस्टॉल करना, कुछ एनवायरमेंट वैरिएबल सेट करना, कोड रिपॉज़िटरी से प्रोजेक्ट को क्लोन करना, और कॉन्फ़िगरेशन इंस्टॉलेशन चलाना होता है.

ज़रूरी शर्तें इंस्टॉल करना

Pipet Code Agent प्रोजेक्ट, Microsoft Visual Studio Code के एक्सटेंशन के तौर पर काम करता है. साथ ही, पैकेज मैनेज करने और ऐप्लिकेशन चलाने के लिए, Node.js और npm टूल का इस्तेमाल करता है. इंस्टॉल करने के लिए यहां दिए गए निर्देश, Linux होस्ट मशीन के लिए हैं.

ज़रूरी सॉफ़्टवेयर इंस्टॉल करने के लिए:

  1. अपने प्लैटफ़ॉर्म के लिए, Visual Studio Code इंस्टॉल करें.
  2. अपने प्लैटफ़ॉर्म के लिए, इंस्टॉल करने के निर्देशों का पालन करके node और npm इंस्टॉल करें.

प्रोजेक्ट का क्लोन बनाना और उसे कॉन्फ़िगर करना

प्रोजेक्ट कोड डाउनलोड करें और ज़रूरी डिपेंडेंसी डाउनलोड करने और प्रोजेक्ट को कॉन्फ़िगर करने के लिए, npm इंस्टॉलेशन कमांड का इस्तेमाल करें. प्रोजेक्ट का सोर्स कोड वापस पाने के लिए, आपके पास git सोर्स कंट्रोल सॉफ़्टवेयर होना चाहिए.

प्रोजेक्ट कोड डाउनलोड और कॉन्फ़िगर करने के लिए:

  1. नीचे दिए गए कमांड का इस्तेमाल करके, Git डेटा स्टोर करने की जगह को क्लोन करें.
    git clone https://github.com/google/generative-ai-docs
  2. इसके अलावा, अपनी लोकल git रिपॉज़िटरी को स्पैर्स चेकआउट का इस्तेमाल करने के लिए कॉन्फ़िगर करें, ताकि आपके पास सिर्फ़ Docs एजेंट प्रोजेक्ट की फ़ाइलें हों. 
    cd generative-ai-docs/
git sparse-checkout init --cone
git sparse-checkout set examples/gemini/node/pipet-code-agent/
  3. Pipet Code Agent प्रोजेक्ट की रूट डायरेक्ट्री पर जाएं. 
    cd generative-ai-docs/examples/gemini/node/pipet-code-agent/
  4. दूसरे ज़रूरी सॉफ़्टवेयर डाउनलोड करने और प्रोजेक्ट को कॉन्फ़िगर करने के लिए, इंस्टॉल कमांड चलाएं: 
    npm install

एक्सटेंशन को कॉन्फ़िगर करना और उसका टेस्ट करना

अब आपके पास अपने डिवाइस पर VS Code में, डेवलपमेंट एक्सटेंशन के तौर पर Pipet Code Agent को चलाकर, इंस्टॉलेशन की जांच करने का विकल्प है. जांच करने पर, VS Code की एक अलग एक्सटेंशन डेवलपमेंट होस्ट विंडो खुलती है. इसमें नया एक्सटेंशन उपलब्ध होता है. इस नई विंडो में, उस एपीआई पासकोड को कॉन्फ़िगर करें जिसका इस्तेमाल, एक्सटेंशन Google Gemini API को ऐक्सेस करने के लिए करता है.

एक्सटेंशन डेवलपमेंट होस्ट विंडो में चल रहा Pipet कोड एजेंट पहली इमेज. Pipet एक्सटेंशन के निर्देशों के साथ, VS Code एक्सटेंशन डेवलपमेंट होस्ट विंडो.

अपने सेटअप को कॉन्फ़िगर और टेस्ट करने के लिए:

  1. VS Code ऐप्लिकेशन शुरू करें.
  2. VS Code में, फ़ाइल > नई विंडो चुनकर नई विंडो बनाएं.
  3. फ़ाइल > फ़ोल्डर खोलें को चुनकर, Pipet Code Agent प्रोजेक्ट खोलें. इसके बाद, pipet-code-agent/ फ़ोल्डर को चुनें.
  4. pipet-code-agent/package.json फ़ाइल खोलें.
  5. रन करें > डीबग करना शुरू करें को चुनकर, एक्सटेंशन को डीबग मोड में चलाएं. इस चरण में, VS Code की एक अलग एक्सटेंशन डेवलपमेंट होस्ट विंडो खुलती है.
  6. कोड > सेटिंग > सेटिंग चुनकर, VS Code की सेटिंग खोलें.
  7. जनरेटिव एआई डेवलपर साइट से Google Gemini API पासकोड पाएं और पासकोड की स्ट्रिंग कॉपी करें.
  8. एपीआई पासकोड को कॉन्फ़िगरेशन सेटिंग के तौर पर सेट करें. Search की सेटिंग फ़ील्ड में pipet टाइप करें. इसके बाद, उपयोगकर्ता टैब चुनें. इसके बाद, Google > Gemini: एपीआई पासकोड सेटिंग में जाकर, settings.json में बदलाव करें लिंक पर क्लिक करें और अपनी Gemini एपीआई पासकोड जोड़ें: 
    "google.gemini.apiKey": "your-api-key-here"
  9. settings.json फ़ाइल में किए गए बदलावों को सेव करें और सेटिंग टैब बंद करें.

एक्सटेंशन के निर्देशों की जांच करने के लिए:

  1. VS Code एक्सटेंशन डेवलपमेंट होस्ट विंडो में, एडिटर विंडो में कोई भी कोड चुनें.
  2. व्यू > निर्देश पैलेट चुनकर, निर्देश पैलेट खोलें.
  3. कमांड पैलेट में, Pipet टाइप करें और उस प्रीफ़िक्स वाले किसी एक निर्देश को चुनें.

मौजूदा कमांड में बदलाव करना

Pipet Code Agent में दिए गए निर्देशों में बदलाव करके, एक्सटेंशन के व्यवहार और सुविधाओं में आसानी से बदलाव किया जा सकता है. टिप्पणी करने और समीक्षा करने के लिए दिए गए निर्देश, कुछ सवालों के जवाब के तौर पर दिए जाते हैं. इनमें कोड के उदाहरण और उस कोड के लिए टिप्पणियां शामिल होती हैं. साथ ही, जनरेटिव एआई मॉडल के लिए कुछ सामान्य निर्देश भी दिए जाते हैं. प्रॉम्प्ट के कॉन्टेक्स्ट की जानकारी, Gemini के जनरेटिव मॉडल को जवाब देने में मदद करती है. टिप्पणी या समीक्षा करने के लिए दिए गए निर्देशों, उदाहरणों या दोनों में से किसी एक को बदलकर, मौजूदा निर्देशों के काम करने के तरीके में बदलाव किया जा सकता है.

निर्देशों के इस सेट में, कमांड के प्रॉम्प्ट टेक्स्ट को बदलकर, review.ts कमांड में बदलाव करने का तरीका बताया गया है.

review.ts निर्देश में बदलाव करने के लिए:

  1. VS Code ऐप्लिकेशन शुरू करें.
  2. VS Code में, फ़ाइल > नई विंडो चुनकर नई विंडो बनाएं.
  3. फ़ाइल > फ़ोल्डर खोलें को चुनकर, Pipet Code Agent प्रोजेक्ट खोलें. इसके बाद, pipet-code-agent/ फ़ोल्डर को चुनें.
  4. pipet-code-agent/src/review.ts फ़ाइल खोलें.

review.ts निर्देश के काम करने के तरीके में बदलाव करने के लिए:

  1. review.ts फ़ाइल में, PROMPT के शुरू में मौजूद कंसटेंट को अलग निर्देशों में बदलें. 
    const PROMPT = '
Write review comments for following code, identifying bugs and ways to improve code quality. Examples of bugs are syntax errors or typos, out of memory errors, and boundary value errors. Examples of improving code quality are reducing complexity of code, eliminating duplicate code, and ensuring other developers
are able to understand the code.
${CODE_LABEL}
...
  2. इसके अलावा, review.ts फ़ाइल में, कोड और कोड की समीक्षा के उदाहरणों की सूची में एक और उदाहरण जोड़ें. 
    ...
${REVIEW_LABEL}
There are duplicate lines of code in this control structure.
${CODE_LABEL}
const fixed_value = 128;
${REVIEW_LABEL}
Make sure constant names are in all capitals (FIXED_VALUE) for clarity.
';
  3. review.ts फ़ाइल में किए गए बदलाव सेव करें.

बदले गए निर्देश की जांच करने के लिए:

  1. VS Code Pipet एक्सटेंशन प्रोजेक्ट विंडो में, रन > डीबगिंग रीस्टार्ट करें को चुनकर डीबगर को रीस्टार्ट करें.
  2. VS Code एक्सटेंशन डेवलपमेंट होस्ट विंडो में, एडिटर विंडो में कोई भी कोड चुनें.
  3. व्यू > निर्देश पैलेट चुनकर, निर्देश पैलेट खोलें.
  4. कमांड पैलेट में, Pipet टाइप करें और पिपेट: चुने गए कोड की समीक्षा करें कमांड चुनें.

नया निर्देश बनाना

Gemini API की मदद से, नए टास्क पूरे करने वाले नए निर्देश बनाकर, Pipet की सुविधाओं को बढ़ाया जा सकता है. हर कमांड फ़ाइल (comment.ts और review.ts) में ज़्यादातर कोड होता है. इसमें, चालू एडिटर से टेक्स्ट इकट्ठा करने, प्रॉम्प्ट बनाने, Gemini API से कनेक्ट करने, प्रॉम्प्ट भेजने, और जवाब मैनेज करने का कोड शामिल होता है.

चुने गए फ़ंक्शन का नाम दिखाने वाला Pipet Code Agent दूसरी इमेज. VS Code एक्सटेंशन डेवलपमेंट होस्ट विंडो में, फ़ंक्शन के नाम का सुझाव देने वाला नया कमांड.

निर्देशों के इस सेट में, टेंप्लेट के तौर पर किसी मौजूदा कमांड, comment.ts के कोड का इस्तेमाल करके, नया कमांड बनाने का तरीका बताया गया है.

फ़ंक्शन के नामों के सुझाव देने वाला कमांड बनाने के लिए:

  1. src/ डायरेक्ट्री में मौजूद, name.ts नाम की pipet-code-agent/src/comment.ts फ़ाइल की कॉपी बनाएं.
  2. VS Code में, src/name.ts फ़ाइल खोलें.
  3. PROMPT वैल्यू में बदलाव करके, name.ts फ़ाइल में प्रॉम्प्ट के निर्देश बदलें. 
    // Provide instructions for the AI generative model
const PROMPT = `Recommend a name for this function. Explain your
reasoning in 3 sentences or less:`;
  4. कमांड फ़ंक्शन और उसके जानकारी वाले मैसेज का नाम बदलें. 
    export async function generateName() {
  vscode.window.showInformationMessage('Generating function name...');
  5. प्रॉम्प्ट असेंबली कोड को अपडेट करें, ताकि सिर्फ़ PROMPT वैल्यू और एडिटर में चुना गया टेक्स्ट शामिल हो. 
      // Build the full prompt using the template.
  const fullPrompt = `${PROMPT}
"
${selectedCode}
"
`;
  6. जवाब के आउटपुट में बदलाव करके, यह बताएं कि वह क्या जनरेट कर रहा है. 
        // update prefix to describe output
    let commentIntro = padding + commentPrefix + "Recommended name: (generated)\n";
    editBuilder.insert(selection.start, commentIntro);
    editBuilder.insert(selection.start, pyComment);
  7. review.ts फ़ाइल में किए गए बदलाव सेव करें.

नया निर्देश इंटिग्रेट करना

नए निर्देश के लिए कोड पूरा करने के बाद, आपको उसे बाकी एक्सटेंशन के साथ इंटिग्रेट करना होगा. extension.ts और package.json फ़ाइलों को अपडेट करें, ताकि नया कमांड एक्सटेंशन का हिस्सा बन सके. साथ ही, VS Code को नया कमांड इस्तेमाल करने के लिए चालू करें.

name कमांड को एक्सटेंशन कोड के साथ इंटिग्रेट करने के लिए:

  1. VS Code में, pipet-code-agent/src/extension.ts फ़ाइल खोलें.
  2. नया इंपोर्ट स्टेटमेंट जोड़कर, एक्सटेंशन में नई कोड फ़ाइल जोड़ें. 
    import { generateName } from './name';
  3. activate() फ़ंक्शन में यह कोड जोड़कर, नया निर्देश रजिस्टर करें. 
    export function activate(context: vscode.ExtensionContext) {
    ...
    vscode.commands.registerCommand('pipet-code-agent.nameFunction', generateName);
}
  4. extension.ts फ़ाइल में किए गए बदलाव सेव करें.

name कमांड को एक्सटेंशन पैकेज के साथ इंटिग्रेट करने के लिए:

  1. VS Code में, pipet-code-agent/package.json फ़ाइल खोलें.
  2. पैकेज फ़ाइल के commands सेक्शन में नया निर्देश जोड़ें. 
      "contributes": {
    "commands": [
      ...
      {
        "command": "pipet-code-agent.nameFunction",
        "title": "Pipet: Name the selected function."
      }
    ],
  3. package.json फ़ाइल में किए गए बदलाव सेव करें.

नए निर्देश को आज़माना

निर्देश कोड करने और उसे एक्सटेंशन के साथ इंटिग्रेट करने के बाद, उसकी जांच की जा सकती है. आपका नया निर्देश सिर्फ़ VS Code की एक्सटेंशन डेवलपमेंट होस्ट विंडो में उपलब्ध है. यह उस VS Code विंडो में उपलब्ध नहीं है जिसमें आपने एक्सटेंशन के कोड में बदलाव किया था.

बदले गए निर्देश की जांच करने के लिए:

  1. VS Code Pipet एक्सटेंशन प्रोजेक्ट विंडो में, रन > डीबगिंग फिर से शुरू करें को चुनकर डीबगर को रीस्टार्ट करें. इससे, एक्सटेंशन डेवलपमेंट होस्ट की एक अलग विंडो रीस्टार्ट हो जाती है.
  2. VS Code एक्सटेंशन डेवलपमेंट होस्ट विंडो में, एडिटर विंडो में कुछ कोड चुनें.
  3. व्यू > निर्देश पैलेट चुनकर, निर्देश पैलेट खोलें.
  4. कमांड पैलेट में, Pipet टाइप करें और पिपेट: चुने गए फ़ंक्शन का नाम दें कमांड चुनें.

अन्य संसाधन

Pipet Code Agent प्रोजेक्ट के बारे में ज़्यादा जानने के लिए, कोड रिपॉज़िटरी देखें. अगर आपको ऐप्लिकेशन बनाने में मदद चाहिए या आपको साथ मिलकर काम करने वाले डेवलपर चाहिए, तो Google Developers Community Discord सर्वर पर जाएं.

प्रोडक्शन ऐप्लिकेशन

अगर आपको बड़ी ऑडियंस के लिए Docs एजेंट को डिप्लॉय करना है, तो ध्यान रखें कि Google Gemini API के इस्तेमाल पर, अनुरोध की दर को सीमित करने और इस्तेमाल से जुड़ी अन्य पाबंदियां लागू हो सकती हैं. अगर आपको Docs Agent जैसे Gemini API की मदद से, प्रोडक्शन ऐप्लिकेशन बनाना है, तो अपने ऐप्लिकेशन को ज़्यादा स्केलेबल और भरोसेमंद बनाने के लिए, Google Cloud Vertex AI की सेवाएं देखें.