এই কুইকস্টার্টটি আপনাকে দেখাবে কিভাবে গুগল ক্লাউড সিএলআই ব্যবহার করে ডেভেলপার নলেজ এপিআই-এর সাহায্যে কোয়েরির উত্তর দিতে হয় এবং ডেভেলপার ডকুমেন্টেশন অনুসন্ধান ও পুনরুদ্ধার করতে হয়।
শুরু করার আগে
gcloud CLI-এর সাথে ডেভেলপার নলেজ এপিআই ব্যবহার শুরু করার আগে, নিম্নলিখিত ধাপগুলো সম্পন্ন করুন।
gcloud CLI ইনস্টল এবং কনফিগার করুন
gcloud CLI ইনস্টল ও কনফিগার করতে, নিম্নলিখিত ধাপগুলো সম্পন্ন করুন:
যদি আপনি gcloud CLI ইনস্টল না করে থাকেন, তাহলে gcloud CLI ইনস্টল করুন ।
সর্বশেষ সংস্করণটি নিশ্চিত করতে
gcloud components updateকমান্ডটি চালান:gcloud components update
gcloud auth loginকমান্ডটি চালিয়ে আপনার Google Cloud অ্যাকাউন্টে সাইন ইন করুন:gcloud auth login
আপনার সক্রিয় গুগল ক্লাউড প্রজেক্ট সেট করতে
gcloud config setকমান্ডটি চালান:gcloud config set project PROJECT_ID
PROJECT_IDজায়গায় আপনার গুগল ক্লাউড প্রজেক্টের আইডিটি বসান।
এপিআই সক্রিয় করুন
ডেভেলপার নলেজ এপিআই সক্রিয় করতে, নিম্নলিখিত ধাপগুলি সম্পন্ন করুন:
আপনার Google Cloud প্রোজেক্টে ডেভেলপার নলেজ এপিআই (Developer Knowledge API) সক্রিয় করতে
gcloud services enableকমান্ডটি চালান:gcloud services enable developerknowledge.googleapis.com
এপিআই সক্রিয় করতে বা ব্যবহার করতে আপনার কোনো নির্দিষ্ট আইডেন্টিটি অ্যান্ড অ্যাক্সেস ম্যানেজমেন্ট (আইএএম) রোলের প্রয়োজন নেই।
gcloud services listকমান্ডটি চালিয়ে আপনার প্রোজেক্টের জন্য API-টি সক্রিয় আছে কিনা তা যাচাই করুন:gcloud services list --enabled \ --filter="name:developerknowledge.googleapis.com"আউটপুটে এপিআই-এর নাম এবং শিরোনাম তালিকাভুক্ত করা হয়:
NAME TITLE developerknowledge.googleapis.com Developer Knowledge API
ডকুমেন্টেশন থেকে উত্তর তৈরি করুন
gcloud developer-knowledge answer-query কমান্ডটি আপনাকে গুগল পণ্য সম্পর্কে প্রশ্ন জিজ্ঞাসা করতে এবং সরাসরি, স্বাভাবিক ভাষায় উত্তর পেতে সাহায্য করে। এই কমান্ডটি অফিসিয়াল ডকুমেন্টেশন উৎস থেকে তথ্য সংগ্রহ করে এবং উল্লেখিত পৃষ্ঠাগুলির উদ্ধৃতি প্রদান করে।
প্রশ্ন জিজ্ঞাসা করতে ও উত্তর তৈরি করতে, নিম্নলিখিত ধাপগুলো সম্পন্ন করুন:
ক্লাউড স্টোরেজ বাকেট কীভাবে তৈরি করতে হয় তা জানতে নিম্নলিখিত কমান্ডটি চালান:
gcloud developer-knowledge answer-query \ --query="How do I create a Cloud Storage bucket?"নিশ্চিত করুন যে কমান্ডটি 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:answerTextএর মধ্যে থাকা বাইট-অফসেট পরিসর,startIndexএবংendIndex, যাreferenceIndexদ্বারাreferencesসহায়ক এন্ট্রিগুলিতে ম্যাপ করে। -
references: উত্তর তৈরি করতে ব্যবহৃত উৎস ডকুমেন্টেশনের অংশবিশেষ এবং মেটাডেটা, যার মধ্যেdocumentএবংparentঅন্তর্ভুক্ত।
-
ডকুমেন্টের খণ্ডাংশ অনুসন্ধান করুন
স্বয়ংক্রিয়ভাবে তৈরি হওয়া উত্তরের পরিবর্তে গুগলের ডেভেলপার ডকুমেন্টেশন থেকে নির্দিষ্ট পাঠ্যাংশ খুঁজে পেতে, ` gcloud developer-knowledge documents search-chunks কমান্ডটি ব্যবহার করুন। এই কমান্ডটি ডকুমেন্টেশন কর্পাস স্ক্যান করে এবং মিলে যাওয়া কন্টেন্টের অংশগুলো তাদের মূল ডকুমেন্টের রিসোর্স নামসহ ফেরত দেয়।
ডকুমেন্টের অংশবিশেষ অনুসন্ধান করতে, নিম্নলিখিত ধাপগুলো সম্পন্ন করুন:
ক্লাউড স্টোরেজ বাকেট তৈরি করার ডকুমেন্টেশন খুঁজতে নিম্নলিখিত কমান্ডটি চালান:
gcloud developer-knowledge documents search-chunks \ --query="How do I create a Cloud Storage bucket?"নিশ্চিত করুন যে কমান্ডটি 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 কমান্ডটি চালান। উদাহরণস্বরূপ, ক্লাউড স্টোরেজ বাকেট তৈরি করার ডকুমেন্টটি পেতে, নিম্নলিখিত ধাপগুলি সম্পন্ন করুন:
নিম্নলিখিত কমান্ডটি চালান:
gcloud developer-knowledge documents describe \ documents/docs.cloud.google.com/storage/docs/creating-buckets
নিশ্চিত করুন যে কমান্ডটি ডকুমেন্টটির মেটাডেটা এবং সম্পূর্ণ মার্কডাউন কন্টেন্ট ফেরত দেয়:
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: ডকুমেন্টেশন পেজটির পাবলিক ইউআরএল। -
view: ফেরত আসা ডকুমেন্ট ভিউ (DOCUMENT_VIEW_CONTENT,DOCUMENT_VIEW_BASIC, অথবাDOCUMENT_VIEW_FULL)।
-
এরপর কী?
- ডকুমেন্টেশন থেকে কীভাবে উত্তর তৈরি করতে হয় তা শিখুন।
- কীভাবে সার্চ রেজাল্ট ফিল্টার করতে হয়, পেজিনেট করতে হয় এবং ডকুমেন্ট ভিউ নির্দিষ্ট করতে হয় , তা শিখুন।
- অন্তর্ভুক্ত ডকুমেন্টেশনের সম্পূর্ণ তালিকা দেখতে কর্পাস রেফারেন্সটি অন্বেষণ করুন।
- উপলব্ধ সকল কমান্ড ও ফ্ল্যাগ সম্পর্কে বিস্তারিত জানতে
gcloud developer-knowledgeরেফারেন্স দেখুন। - এপিআই মেথডগুলোর সম্পূর্ণ বিবরণের জন্য REST API রেফারেন্স পর্যালোচনা করুন।
- গুগল অ্যান্টিগ্র্যাভিটিতে কীভাবে মডেল কনটেক্সট প্রোটোকল (MCP) সার্ভার সেট আপ করতে হয় তা জানুন।