কুইকস্টার্ট: Developer Knowledge API-এর সাথে gcloud CLI ব্যবহার করা

এই ক্যুইকস্টার্টে দেখানো হয়েছে যে কীভাবে Google Cloud CLI ব্যবহার করে Developer Knowledge API-এর সাহায্যে কোয়েরির উত্তর দিতে এবং ডেভেলপার ডকুমেন্টেশন সার্চ ও রিট্রিভ করতে হয়।

শুরু করার আগে

gcloud CLI-এর সাথে Developer Knowledge API ব্যবহার করা শুরু করার আগে, নিচের ধাপগুলি সম্পূর্ণ করুন।

gcloud CLI ইনস্টল ও কনফিগার করা

gcloud CLI ইনস্টল ও কনফিগার করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

  1. আপনি gcloud CLI ইনস্টল না করে থাকলে, gcloud CLI ইনস্টল করুন।

  2. আপনার কাছে লেটেস্ট ভার্সন আছে কিনা তা নিশ্চিত করতে, gcloud components update কমান্ড রান করুন:

    gcloud components update

  3. Google Cloud অ্যাকাউন্টে সাইন-ইন করতে, gcloud auth login কমান্ড চালান:

    gcloud auth login

  4. gcloud config set কমান্ড চালিয়ে আপনার অ্যাক্টিভ Google Cloud প্রোজেক্ট সেট করুন:

    gcloud config set project PROJECT_ID

    আপনার Google Cloud প্রোজেক্টের আইডি দিয়ে PROJECT_ID পাল্টে দিন।

API চালু করুন

Developer Knowledge API চালু করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

  1. আপনার Google Cloud প্রোজেক্টে Developer Knowledge API চালু করতে, এই gcloud services enable কমান্ড রান করান:

    gcloud services enable developerknowledge.googleapis.com

    API চালু বা ব্যবহার করার জন্য আপনার নির্দিষ্ট পরিচয় ও অ্যাক্সেস ম্যানেজমেন্ট (IAM) রোলের প্রয়োজন নেই।

  2. আপনার প্রোজেক্টের জন্য API চালু করা আছে কিনা তা যাচাই করতে, gcloud services list কমান্ড রান করান:

    gcloud services list --enabled \
    --filter="name:developerknowledge.googleapis.com"

    আউটপুটে API-এর নাম ও শীর্ষক দেখানো হয়:

    NAME                                     TITLE
developerknowledge.googleapis.com  Developer Knowledge API

ডকুমেন্টেশন থেকে উত্তর তৈরি করা

gcloud developer-knowledge answer-query কমান্ড আপনাকে Google প্রোডাক্ট সম্পর্কে প্রশ্ন জিজ্ঞাসা করতে এবং সরাসরি, প্রাকৃতিক-ভাষা উত্তর পেতে দেয়। কমান্ডটি অফিসিয়াল ডকুমেন্টেশন সোর্স থেকে তথ্য নেয় এবং রেফারেন্স করা পৃষ্ঠাগুলির জন্য উদ্ধৃতি প্রদান করে।

প্রশ্ন জিজ্ঞাসা করতে এবং উত্তর জেনারেট করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

  1. Cloud Storage বাকেট কীভাবে তৈরি করতে হয় তা জানতে এই কমান্ড রান করুন:

    gcloud developer-knowledge answer-query \
    --query="How do I create a Cloud Storage bucket?"

  2. কনফার্ম করুন যে কমান্ডটি YAML ফর্ম্যাটে একটি জেনারেটেড উত্তর এবং সোর্স রেফারেন্স রিটার্ন করে:

    answer:
  answerText: |-
    To create a Cloud Storage bucket, you can use the Google Cloud console,
    the gcloud CLI (`gcloud storage buckets create`), client libraries, or
    the REST API...
  citations:
  - endIndex: 158
    sources:
    - referenceIndex: 0
    startIndex: 0
  references:
  - documentReference:
      documentChunk:
        content: |-
          This document shows you how to create a Cloud Storage
          [bucket](https://docs.cloud.google.com/storage/docs/buckets)...
        document:
          dataSource: docs.cloud.google.com
          name: documents/docs.cloud.google.com/storage/docs/creating-buckets
          title: Create a bucket
          uri: https://docs.cloud.google.com/storage/docs/creating-buckets
        parent: documents/docs.cloud.google.com/storage/docs/creating-buckets

    আউটপুটে answer অবজেক্টে নিম্নলিখিত ফিল্ড থাকে:

    • answerText: আপনার কোয়েরির জন্য তৈরি করা স্বাভাবিক ভাষায় উত্তর।
    • citations: বাইট-অফসেট রেঞ্জ, startIndex এবং endIndex, যা answerText references-এর মধ্যে কাজ করে এমন এন্ট্রিকে ম্যাপ করে referenceIndex।
    • references: উত্তর তৈরি করতে ব্যবহৃত সোর্স ডকুমেন্টেশন চ্যাঙ্ক ও মেটাডেটা, যার মধ্যে document ও parent অন্তর্ভুক্ত।

ডকুমেন্ট চ্যাঙ্ক সার্চ করা

জেনারেট করা উত্তরের পরিবর্তে Google-এর ডেভেলপার ডকুমেন্টেশনে নির্দিষ্ট টেক্সট এক্সসার্প্ট খুঁজতে, gcloud developer-knowledge documents search-chunks কমান্ড ব্যবহার করুন। এই কমান্ডটি ডকুমেন্টেশন কর্পাস স্ক্যান করে এবং সেটির পেরেন্ট ডকুমেন্টের রিসোর্স নামের সাথে ম্যাচ করা কন্টেন্ট চ্যাঙ্ক রিটার্ন করে।

ডকুমেন্ট চ্যাঙ্ক সার্চ করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

  1. Cloud Storage বাকেট তৈরি করার বিষয়ে ডকুমেন্টেশন সার্চ করতে, নিম্নলিখিত কমান্ড রান করুন:

    gcloud developer-knowledge documents search-chunks \
    --query="How do I create a Cloud Storage bucket?"

  2. কমান্ডটি YAML ফর্ম্যাটে মিলে যাওয়া ডকুমেন্ট চঙ্কের একটি তালিকা রিটার্ন করে কিনা তা কনফার্ম করুন:

    ---
content: |-
  This document shows you how to create a Cloud Storage
  [bucket](https://docs.cloud.google.com/storage/docs/buckets). If not otherwise
  specified in your request, buckets are created in the
  [US multi-region](https://docs.cloud.google.com/storage/docs/locations)...
document:
  contentLengthBytes: 31842
  dataSource: docs.cloud.google.com
  description: World-wide storage and retrieval of data in Google Cloud.
  name: documents/docs.cloud.google.com/storage/docs/creating-buckets
  title: Create a bucket
  updateTime: '2026-09-10T20:05:41Z'
  uri: https://docs.cloud.google.com/storage/docs/creating-buckets
  view: DOCUMENT_VIEW_BASIC
id: c1
parent: documents/docs.cloud.google.com/storage/docs/creating-buckets
relevanceScore: 0.856608

    আউটপুটের প্রতিটি চ্যাঙ্কে নিম্নলিখিত ফিল্ড অন্তর্ভুক্ত থাকে:

    • content: ডকুমেন্টেশন থেকে ম্যাচ করা টেক্সট স্নিপেট।
    • document: সোর্স ডকুমেন্ট সম্পর্কিত মেটাডেটা, যার মধ্যে title, description, uri, dataSource ও updateTime অন্তর্ভুক্ত।
    • id: ডকুমেন্টের মধ্যে চঙ্কের শনাক্তকারী।
    • parent: মূল ডকুমেন্টের রিসোর্স নাম। সম্পূর্ণ ডকুমেন্ট পেতে, আপনি এই ভ্যালু describe কমান্ডে পাস করতে পারেন।
    • relevanceScore: সার্চ কোয়েরির সাথে চঙ্কের প্রাসঙ্গিকতার স্কোর।

ডকুমেন্ট ফিরিয়ে আনা

প্রাসঙ্গিক ডকুমেন্ট চ্যাঙ্ক খুঁজে পাওয়ার পরে, সেইসব সার্চ ফলাফল থেকে parent ফিল্ড ব্যবহার করে ডকুমেন্টটির সম্পূর্ণ মার্কডাউন কন্টেন্ট ফেচ করুন।

ডকুমেন্টের রিসোর্স নামের সাথে gcloud developer-knowledge documents describe কমান্ড রান করান। যেমন, Cloud Storage বাকেট তৈরি করার বিষয়ে ডকুমেন্ট পেতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

  1. নিম্নলিখিত কমান্ড রান করুন:

    gcloud developer-knowledge documents describe \
  documents/docs.cloud.google.com/storage/docs/creating-buckets

  2. কমান্ডটি ডকুমেন্টের মেটাডেটা ও সম্পূর্ণ মার্কডাউন কন্টেন্ট রিটার্ন করে কিনা তা কনফার্ম করুন:

    content: |
  This document shows you how to create a Cloud Storage [bucket](https://docs.cloud.google.com/storage/docs/buckets). If not otherwise specified in your request, buckets are
  created in the [`US` multi-region](https://docs.cloud.google.com/storage/docs/locations)
  with a default storage class of [Standard storage](https://docs.cloud.google.com/storage/docs/storage-classes)
  and have a seven-day [soft delete](https://docs.cloud.google.com/storage/docs/soft-delete)
  retention duration...
contentLengthBytes: 31842
dataSource: docs.cloud.google.com
description: World-wide storage and retrieval of data in Google Cloud.
name: documents/docs.cloud.google.com/storage/docs/creating-buckets
title: Create a bucket
updateTime: '2026-09-10T20:05:41Z'
uri: https://docs.cloud.google.com/storage/docs/creating-buckets
view: DOCUMENT_VIEW_CONTENT

    আউটপুটে নিম্নলিখিত ফিল্ড অন্তর্ভুক্ত থাকে:

    • content: ডকুমেন্টের সম্পূর্ণ মার্কডাউন টেক্সট।
    • contentLengthBytes: ডকুমেন্টের কন্টেন্টের মোট সাইজ বাইটে।
    • dataSource: ডকুমেন্ট হোস্ট করা ডকুমেন্টেশন ডোমেন।
    • description: ডকুমেন্টের সংক্ষিপ্ত সারসংক্ষেপ।
    • name: ডকুমেন্টের অনন্য রিসোর্স নাম।
    • title: ডকুমেন্টের শীর্ষক।
    • updateTime: ডকুমেন্ট শেষবার আপডেট করার টাইমস্ট্যাম্প।
    • uri: ডকুমেন্টেশন পৃষ্ঠার সর্বজনীন URL.
    • view: ডকুমেন্ট ভিউ রিটার্ন করা হয়েছে (DOCUMENT_VIEW_CONTENT, DOCUMENT_VIEW_BASIC অথবা DOCUMENT_VIEW_FULL)।

এর পরে কী করতে হবে