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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अपने सेटअप को कॉन्फ़िगर करने और उसकी जांच करने के लिए:

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

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

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

मौजूदा निर्देश में बदलाव करें

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

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

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

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

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

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

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

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

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

  1. src/ डायरेक्ट्री में, name.ts नाम की pipet-code-agent/src/comment.ts फ़ाइल की एक कॉपी बनाएं.
  2. बनाम कोड में, 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. बनाम कोड में, 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. बनाम कोड में, 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 कोड एक्सटेंशन डेवलपमेंट होस्ट विंडो में, एडिटर विंडो में कुछ कोड चुनें.
  3. व्यू > कमांड पैलेट चुनकर, निर्देश पैलेट खोलें.
  4. कमांड पैलेट में, Pipet टाइप करें और Pipet: चुने गए फ़ंक्शन को नाम दें कमांड चुनें.

ज़्यादा रिसॉर्स

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

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

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