একটি ADK AI এজেন্ট এবং জেমিনি মডেলের সাথে ফ্যাক্ট-চেক স্টেটমেন্ট

কোডিং স্তর : উন্নত
সময়কাল : 30 মিনিট
প্রকল্পের ধরন : কাস্টম ফাংশন

ওভারভিউ

একটি Vertex AI এজেন্ট এবং Gemini মডেল দ্বারা চালিত একটি আবদ্ধ Apps স্ক্রিপ্ট প্রকল্প হিসাবে ব্যবহার করার জন্য Google শীটগুলির জন্য একটি ফ্যাক্ট-চেক কাস্টম ফাংশন৷

এই নমুনাটি দেখায় যে আপনি কীভাবে সরাসরি আপনার Google পত্রক স্প্রেডশীটে দুটি শক্তিশালী ধরণের AI সংস্থান ব্যবহার করতে পারেন:

1. ভার্টেক্স এআই এজেন্ট ইঞ্জিনে নিয়োজিত ADK এজেন্ট ব্যবহার করে পরিশীলিত, মাল্টি-টুল, মাল্টি-স্টেপ রিজনিং ক্ষমতার জন্য এআই এজেন্ট ।
2. Vertex AI থেকে জেমিনি মডেলগুলি ব্যবহার করে উন্নত বোঝাপড়া, জেনারেটিভ, এবং সংক্ষিপ্তকরণ ক্ষমতার জন্য AI মডেল ।

উদ্দেশ্য

• বুঝুন সমাধান কি করে।
• সমাধান কিভাবে বাস্তবায়িত হয় বুঝুন।
• ভার্টেক্স এআই এজেন্ট স্থাপন করুন।
• স্ক্রিপ্ট সেট আপ করুন।
• স্ক্রিপ্ট চালান।

এই সমাধান সম্পর্কে

পত্রক কাস্টম ফাংশনটির নাম দেওয়া হয়েছে FACT_CHECK এবং এটি একটি এন্ড-টু-এন্ড সমাধান হিসাবে কাজ করে৷ এটি একটি বিবৃতি বিশ্লেষণ করে, সর্বশেষ ওয়েব তথ্য ব্যবহার করে এর প্রতিক্রিয়াকে ভিত্তি করে এবং আপনার প্রয়োজনীয় বিন্যাসে ফলাফল প্রদান করে:

• ব্যবহার:
  • সংক্ষিপ্ত এবং সংক্ষিপ্ত আউটপুটের জন্য =FACT_CHECK("Your statement here") ।
  • একটি নির্দিষ্ট আউটপুট বিন্যাসের জন্য =FACT_CHECK("Your statement here", "Your output formatting instructions here") ।
• যুক্তি: এলএলএম অডিটর এডিকে এআই এজেন্ট (পাইথন নমুনা) ।
• আউটপুট ফরম্যাটিং: মিথুন মডেল ।

এই সমাধানটি UrlFetchApp ব্যবহার করে Vertex AI REST API-এর জন্য অনুরোধ করে।

স্থাপত্য

নিম্নলিখিত চিত্রটি কাস্টম ফাংশন দ্বারা ব্যবহৃত Google Workspace এবং Google ক্লাউড সংস্থানগুলির আর্কিটেকচার দেখায়।

পূর্বশর্ত

এই নমুনা ব্যবহার করতে, আপনার নিম্নলিখিত পূর্বশর্ত প্রয়োজন:

• একটি Google অ্যাকাউন্ট (Google Workspace অ্যাকাউন্টের জন্য অ্যাডমিনিস্ট্রেটরের অনুমোদনের প্রয়োজন হতে পারে)।

• ইন্টারনেট অ্যাক্সেস সহ একটি ওয়েব ব্রাউজার।

• LLM অডিটর ADK এজেন্টের পূর্বশর্ত

  • Python 3.11+: ইনস্টলেশনের জন্য, অফিসিয়াল Python ওয়েবসাইটের নির্দেশাবলী অনুসরণ করুন।
  • পাইথন কবিতা: ইনস্টলেশনের জন্য, অফিসিয়াল কবিতা ওয়েবসাইটের নির্দেশাবলী অনুসরণ করুন।
  • Google Cloud CLI: ইনস্টলেশনের জন্য, অফিসিয়াল Google ক্লাউড ওয়েবসাইটে নির্দেশাবলী অনুসরণ করুন।

পরিবেশ প্রস্তুত করুন

এই বিভাগটি দেখায় কিভাবে একটি Google ক্লাউড প্রকল্প তৈরি এবং কনফিগার করতে হয়।

একটি Google ক্লাউড প্রকল্প তৈরি করুন

গুগল ক্লাউড কনসোল

1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Create a Project এ যান।

   একটি প্রকল্প তৈরি করুন এ যান

2. প্রকল্পের নাম ক্ষেত্রে, আপনার প্রকল্পের জন্য একটি বর্ণনামূলক নাম লিখুন।

   ঐচ্ছিক: প্রকল্প আইডি সম্পাদনা করতে, সম্পাদনা ক্লিক করুন। প্রোজেক্ট তৈরি হওয়ার পর প্রোজেক্ট আইডি পরিবর্তন করা যাবে না, তাই এমন একটি আইডি বেছে নিন যা প্রোজেক্টের জীবনকালের জন্য আপনার চাহিদা পূরণ করে।

3. অবস্থান ক্ষেত্রে, আপনার প্রকল্পের সম্ভাব্য অবস্থানগুলি প্রদর্শন করতে ব্রাউজ ক্লিক করুন। তারপর, নির্বাচন ক্লিক করুন.
   সতর্কতা: আপনার Google Workspace সংস্থা খুঁজে পাচ্ছেন না?
   এর মানে আপনি Google Workspace অ্যাকাউন্টে সাইন-ইন করেননি। Google Workspace ডেভেলপার ডকুমেন্টেশনে বর্ণিত কিছু বৈশিষ্ট্য শুধুমাত্র একটি প্রতিষ্ঠানের সাথে যুক্ত প্রকল্পের জন্য উপলব্ধ।
4. তৈরি করুন ক্লিক করুন। Google ক্লাউড কনসোল ড্যাশবোর্ড পৃষ্ঠায় নেভিগেট করে এবং আপনার প্রকল্পটি কয়েক মিনিটের মধ্যে তৈরি হয়।

জিক্লাউড সিএলআই

নিম্নলিখিত উন্নয়ন পরিবেশগুলির মধ্যে একটিতে, Google ক্লাউড CLI ( gcloud ) অ্যাক্সেস করুন :

• ক্লাউড শেল : ইতিমধ্যেই সেট আপ করা gcloud CLI সহ একটি অনলাইন টার্মিনাল ব্যবহার করতে, ক্লাউড শেল সক্রিয় করুন।
  ক্লাউড শেল সক্রিয় করুন
• স্থানীয় শেল : একটি স্থানীয় উন্নয়ন পরিবেশ ব্যবহার করতে, gcloud CLI ইনস্টল এবং আরম্ভ করুন ।
  একটি ক্লাউড প্রকল্প তৈরি করতে, gcloud projects create কমান্ড ব্যবহার করুন:

  gcloud projects create PROJECT_ID

  আপনি যে প্রকল্পটি তৈরি করতে চান তার জন্য ID সেট করে PROJECT_ID প্রতিস্থাপন করুন।

ক্লাউড প্রকল্পের জন্য বিলিং সক্ষম করুন৷

আপনি একটি বিলিং অ্যাকাউন্ট লিঙ্ক করতে অক্ষম হলে, এই পরিবর্তন করার জন্য আপনার কাছে প্রয়োজনীয় অনুমতি নেই৷ আরও তথ্যের জন্য, বিলিং সক্ষম করতে প্রয়োজনীয় অনুমতিগুলি দেখুন।

গুগল ক্লাউড কনসোল

1. Google ক্লাউড কনসোলে, বিলিং- এ যান। মেনু > বিলিং > আমার প্রকল্পে ক্লিক করুন।

   আমার প্রকল্পের জন্য বিলিং এ যান

2. একটি সংস্থা নির্বাচন করুন -এ, আপনার Google ক্লাউড প্রকল্পের সাথে যুক্ত সংস্থা নির্বাচন করুন৷
3. প্রকল্পের সারিতে, অ্যাকশন মেনু খুলুন ( ), বিলিং পরিবর্তন করুন এ ক্লিক করুন এবং ক্লাউড বিলিং অ্যাকাউন্ট বেছে নিন।
4. অ্যাকাউন্ট সেট করুন ক্লিক করুন।

জিক্লাউড সিএলআই

1. উপলব্ধ বিলিং অ্যাকাউন্টের তালিকা করতে, চালান:

   gcloud billing accounts list

2. Google ক্লাউড প্রকল্পের সাথে একটি বিলিং অ্যাকাউন্ট লিঙ্ক করুন:

   gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

   নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

   • PROJECT_ID হল ক্লাউড প্রকল্পের জন্য প্রকল্প আইডি যার জন্য আপনি বিলিং সক্ষম করতে চান৷
   • BILLING_ACCOUNT_ID হল Google ক্লাউড প্রকল্পের সাথে লিঙ্ক করার জন্য বিলিং অ্যাকাউন্ট আইডি ৷

Vertex AI API সক্ষম করুন

গুগল ক্লাউড কনসোল

1. Google ক্লাউড কনসোলে, Vertex AI API সক্ষম করুন।

   APIs সক্রিয় করুন

2. নিশ্চিত করুন যে আপনি সঠিক ক্লাউড প্রকল্পে Vertex AI API সক্ষম করছেন, তারপর Next এ ক্লিক করুন।

3. নিশ্চিত করুন যে আপনি সঠিক API সক্ষম করছেন, তারপর সক্ষম করুন ক্লিক করুন।

জিক্লাউড সিএলআই

1. প্রয়োজনে, বর্তমান ক্লাউড প্রজেক্টটিকে আপনার তৈরি করা একটিতে সেট করুন gcloud config set project কমান্ড:

   gcloud config set project PROJECT_ID

   আপনার তৈরি করা ক্লাউড প্রকল্পের প্রকল্প আইডি দিয়ে PROJECT_ID প্রতিস্থাপন করুন।

2. gcloud services enable কমান্ড সহ ভার্টেক্স এআই এপিআই সক্ষম করুন:

   gcloud services enable aiplatform.googleapis.com

Google ক্লাউড কনসোলে একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন

এই পদক্ষেপগুলি অনুসরণ করে Vertex AI User ভূমিকা সহ একটি নতুন পরিষেবা অ্যাকাউন্ট তৈরি করুন:

গুগল ক্লাউড কনসোল

1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Service Accounts- এ যান।

   সার্ভিস অ্যাকাউন্টে যান

2. পরিষেবা অ্যাকাউন্ট তৈরি করুন ক্লিক করুন।
3. পরিষেবা অ্যাকাউন্টের বিবরণ পূরণ করুন, তারপর তৈরি করুন এবং চালিয়ে যান ক্লিক করুন।
   দ্রষ্টব্য: ডিফল্টরূপে, Google একটি অনন্য পরিষেবা অ্যাকাউন্ট আইডি তৈরি করে৷ আপনি যদি আইডি পরিবর্তন করতে চান তবে পরিষেবা অ্যাকাউন্ট আইডি ক্ষেত্রে আইডি পরিবর্তন করুন।
4. ঐচ্ছিক: আপনার Google ক্লাউড প্রকল্পের সংস্থানগুলিতে অ্যাক্সেস দেওয়ার জন্য আপনার পরিষেবা অ্যাকাউন্টে ভূমিকা বরাদ্দ করুন৷ আরও বিশদ বিবরণের জন্য, সংস্থানগুলিতে অ্যাক্সেস মঞ্জুর করা, পরিবর্তন করা এবং প্রত্যাহার করা দেখুন।
5. অবিরত ক্লিক করুন.
6. ঐচ্ছিক: ব্যবহারকারী বা গোষ্ঠীগুলি লিখুন যারা এই পরিষেবা অ্যাকাউন্টের সাথে ক্রিয়াকলাপ পরিচালনা এবং সম্পাদন করতে পারে৷ আরও বিশদ বিবরণের জন্য, পরিসেবা অ্যাকাউন্ট ছদ্মবেশ ম্যানেজিং দেখুন।
7. সম্পন্ন ক্লিক করুন. পরিষেবা অ্যাকাউন্টের জন্য ইমেল ঠিকানা একটি নোট করুন.

জিক্লাউড সিএলআই

1. পরিষেবা অ্যাকাউন্ট তৈরি করুন:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. ঐচ্ছিক: আপনার Google ক্লাউড প্রকল্পের সংস্থানগুলিতে অ্যাক্সেস দেওয়ার জন্য আপনার পরিষেবা অ্যাকাউন্টে ভূমিকা বরাদ্দ করুন৷ আরও বিশদ বিবরণের জন্য, সংস্থানগুলিতে অ্যাক্সেস মঞ্জুর করা, পরিবর্তন করা এবং প্রত্যাহার করা দেখুন।

পরিষেবা অ্যাকাউন্ট পরিষেবা অ্যাকাউন্ট পৃষ্ঠায় উপস্থিত হয়৷ পরবর্তী, পরিষেবা অ্যাকাউন্টের জন্য একটি ব্যক্তিগত কী তৈরি করুন।

একটি ব্যক্তিগত কী তৈরি করুন

সতর্কতা: এই উদাহরণটি সরলতার জন্য একটি রপ্তানি করা পরিষেবা অ্যাকাউন্ট কী ব্যবহার করে। প্রোডাকশনে একটি ব্যক্তিগত কী রপ্তানি করার পরামর্শ দেওয়া হয় না কারণ এটি উৎস নিয়ন্ত্রণের মতো একটি অনিরাপদ স্থানে সংরক্ষণ করা উচিত নয়।

নিরাপদ পরিষেবা অ্যাকাউন্ট বাস্তবায়ন এবং সর্বোত্তম অনুশীলন সম্পর্কে আরও জানতে, পরিষেবা অ্যাকাউন্ট কখন ব্যবহার করবেন তা চয়ন করুন দেখুন।

পরিষেবা অ্যাকাউন্টের জন্য একটি ব্যক্তিগত কী তৈরি এবং ডাউনলোড করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Service Accounts- এ যান।

   সার্ভিস অ্যাকাউন্টে যান

2. আপনার পরিষেবা অ্যাকাউন্ট নির্বাচন করুন.
3. কী > কী যোগ করুন > নতুন কী তৈরি করুন ক্লিক করুন।
4. JSON নির্বাচন করুন, তারপর তৈরি করুন ক্লিক করুন।

   আপনার নতুন পাবলিক/প্রাইভেট কী জোড়া তৈরি করা হয়েছে এবং একটি নতুন ফাইল হিসেবে আপনার মেশিনে ডাউনলোড করা হয়েছে। ডাউনলোড করা JSON ফাইলটিকে আপনার কাজের ডিরেক্টরিতে credentials.json হিসাবে সংরক্ষণ করুন। এই ফাইলটি এই কীটির একমাত্র অনুলিপি। কীভাবে আপনার কী নিরাপদে সংরক্ষণ করবেন সে সম্পর্কে তথ্যের জন্য, পরিষেবা অ্যাকাউন্ট কীগুলি পরিচালনা করা দেখুন।

5. বন্ধ ক্লিক করুন.

পরিষেবা অ্যাকাউন্ট সম্পর্কে আরও তথ্যের জন্য, Google ক্লাউড IAM ডকুমেন্টেশনে পরিষেবা অ্যাকাউন্টগুলি দেখুন৷

LLM অডিটর ADK AI এজেন্ট নিয়োগ করুন

1. যদি ইতিমধ্যে করা না হয়ে থাকে, তাহলে আপনার Google ক্লাউড অ্যাকাউন্টের সাথে প্রমাণীকরণ করুন এবং আপনার Google ক্লাউড প্রকল্প ব্যবহার করতে Google Cloud CLI কনফিগার করুন।

   gcloud auth application-default login
   gcloud config set project PROJECT_ID
   gcloud auth application-default set-quota-project PROJECT_ID

   আপনার তৈরি করা ক্লাউড প্রকল্পের ID দিয়ে PROJECT_ID প্রতিস্থাপন করুন।

2. এই GitHub সংগ্রহস্থল ডাউনলোড করুন

   ডাউনলোড করুন

3. আপনার পছন্দের স্থানীয় উন্নয়ন পরিবেশে, ডাউনলোড করা আর্কাইভ ফাইলটি বের করুন এবং adk-samples/python/agents/llm-auditor ডিরেক্টরি খুলুন।

   unzip adk-samples-main.zip
   cd adk-samples-main/python/agents/llm-auditor

4. ADK এজেন্টকে উৎসর্গ করা একটি নতুন ক্লাউড স্টোরেজ বাকেট তৈরি করুন।

   gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATION

   নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

   1. CLOUD_STORAGE_BUCKET_NAME একটি অনন্য বাকেট নামের সাথে আপনি ব্যবহার করতে চান৷
   2. আপনার তৈরি করা ক্লাউড প্রকল্পের ID সহ PROJECT_ID ।
   3. আপনার তৈরি করা ক্লাউড প্রকল্পের অবস্থান সহ PROJECT_LOCATION ।

5. নিম্নলিখিত পরিবেশ ভেরিয়েবল সেট করুন:

   export GOOGLE_GENAI_USE_VERTEXAI=true
   export GOOGLE_CLOUD_PROJECT=PROJECT_ID
   export GOOGLE_CLOUD_LOCATION=PROJECT_LOCATION
   export GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAME

   নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

   1. আপনার তৈরি করা বালতিটির নামের সাথে CLOUD_STORAGE_BUCKET_NAME ।
   2. আপনার তৈরি করা ক্লাউড প্রকল্পের ID সহ PROJECT_ID ।
   3. আপনার তৈরি করা ক্লাউড প্রকল্পের অবস্থান সহ PROJECT_LOCATION ।

6. ভার্চুয়াল পরিবেশ থেকে ADK এজেন্ট ইনস্টল এবং স্থাপন করুন।

   python3 -m venv myenv
   source myenv/bin/activate
   poetry install --with deployment
   python3 deployment/deploy.py --create

7. এজেন্ট আইডি পুনরুদ্ধার করুন, কাস্টম ফাংশন কনফিগার করার জন্য আপনাকে পরে এটির প্রয়োজন হবে।

   python3 deployment/deploy.py --list

নমুনা কোড পর্যালোচনা করুন

ঐচ্ছিকভাবে, নতুন স্প্রেডশীট তৈরি করার আগে, GitHub-এ হোস্ট করা নমুনা কোডের সাথে নিজেকে পর্যালোচনা এবং পরিচিত করার জন্য কিছুক্ষণ সময় নিন।

GitHub এ দেখুন

একটি নতুন স্প্রেডশীটে তৈরি এবং কনফিগার করুন৷

1. নিম্নলিখিত বোতামটি ক্লিক করুন এবং নমুনা Google পত্রক স্প্রেডশীট এর কন্টেইনার-বাউন্ড অ্যাপস স্ক্রিপ্ট প্রকল্প সহ একটি সম্পূর্ণ অনুলিপি তৈরি করুন৷

   Google Sheets স্পেডশীট কপি করুন

2. নতুন তৈরি স্প্রেডশীটে, এক্সটেনশন > অ্যাপস স্ক্রিপ্টে যান।

3. অ্যাপস স্ক্রিপ্ট প্রকল্পে, প্রজেক্ট সেটিংসে যান, স্ক্রিপ্ট বৈশিষ্ট্য সম্পাদনা করুন ক্লিক করুন, তারপর নিম্নলিখিত স্ক্রিপ্ট বৈশিষ্ট্যগুলি যোগ করতে স্ক্রিপ্ট বৈশিষ্ট্য যুক্ত করুন ক্লিক করুন:

   1. পূর্ববর্তী ধাপে তৈরি Google ক্লাউড প্রকল্পের অবস্থান সহ LOCATION যেমন us-central1 ।
   2. GEMINI_MODEL_ID আপনি যে মিথুন মডেল ব্যবহার করতে চান যেমন gemini-2.5-flash-lite ।
   3. LLM অডিটর ADK এজেন্টের ID সহ REASONING_ENGINE_ID পূর্ববর্তী ধাপে মোতায়েন যেমন 1234567890 ।
   4. পূর্ববর্তী ধাপে ডাউনলোড করা পরিষেবা অ্যাকাউন্ট থেকে JSON কী সহ SERVICE_ACCOUNT_KEY যেমন { ... } ।

4. স্ক্রিপ্ট বৈশিষ্ট্য সংরক্ষণ করুন ক্লিক করুন

কাস্টম ফাংশন পরীক্ষা করুন

1. নতুন তৈরি স্প্রেডশীটে যান।
2. কলাম A এ বিবৃতি পরিবর্তন করুন।
3. কলাম B- এর সূত্রগুলি কার্যকর করে এবং তারপরে ফ্যাক্ট-চেক ফলাফল প্রদর্শন করে।

পরিষ্কার করুন

এই টিউটোরিয়ালে ব্যবহৃত সংস্থানগুলির জন্য আপনার Google ক্লাউড অ্যাকাউন্টে চার্জ এড়াতে, আমরা আপনাকে ক্লাউড প্রকল্পটি মুছে ফেলার পরামর্শ দিই।

সতর্কতা: একটি প্রকল্প মুছে ফেলার নিম্নলিখিত প্রভাব রয়েছে:

• প্রকল্পের সবকিছু মুছে ফেলা হয়েছে। আপনি যদি এই টিউটোরিয়ালের জন্য একটি বিদ্যমান প্রকল্প ব্যবহার করেন, আপনি এটি মুছে ফেললে, আপনি প্রকল্পে আপনার করা অন্য কোনো কাজও মুছে ফেলবেন।
• কাস্টম প্রকল্প আইডি হারিয়ে গেছে। আপনি যখন এই প্রকল্পটি তৈরি করেছেন, আপনি হয়ত একটি কাস্টম প্রকল্প আইডি তৈরি করেছেন যা আপনি ভবিষ্যতে ব্যবহার করতে চান৷ প্রজেক্ট আইডি ব্যবহার করে এমন ইউআরএল সংরক্ষণ করতে, যেমন appspot.com-এ একটি ইউআরএল, পুরো প্রোজেক্ট মুছে ফেলার পরিবর্তে প্রোজেক্টের মধ্যে নির্বাচিত রিসোর্স মুছে দিন।

আপনি যদি একাধিক টিউটোরিয়াল এবং কুইকস্টার্ট অন্বেষণ করার পরিকল্পনা করেন, প্রকল্পগুলি পুনঃব্যবহার করা আপনাকে প্রকল্পের কোটা সীমা অতিক্রম এড়াতে সাহায্য করতে পারে।

1. Google ক্লাউড কনসোলে, সম্পদ পরিচালনা পৃষ্ঠাতে যান। মেনু > আইএএম এবং অ্যাডমিন > সম্পদ পরিচালনা করুন ক্লিক করুন।

   রিসোর্স ম্যানেজারে যান

2. প্রকল্প তালিকায়, আপনি যে প্রকল্পটি মুছতে চান সেটি নির্বাচন করুন এবং তারপরে মুছুন ক্লিক করুন।
3. ডায়ালগে, প্রকল্প আইডি টাইপ করুন এবং তারপরে প্রকল্পটি মুছে ফেলতে শাট ডাউন ক্লিক করুন।

পরবর্তী পদক্ষেপ

• গুগল শীটে কাস্টম ফাংশন
• Google পত্রক প্রসারিত করা হচ্ছে