এই পাঠে আমরা দেখব কীভাবে এই কোর্সের কোড নমুনাগুলি চালানো যায়।
আপনার রিপোজিটরি ক্লোন করার আগে, AI Agents For Beginners Discord চ্যানেলে যোগ দিন। এখানে আপনি সেটআপে সাহায্য, কোর্স সম্পর্কিত প্রশ্ন, বা অন্যান্য শিক্ষার্থীদের সাথে সংযোগ স্থাপন করতে পারবেন।
শুরু করার জন্য, অনুগ্রহ করে GitHub রিপোজিটরি ক্লোন বা ফর্ক করুন। এটি আপনার নিজস্ব কোর্স উপকরণের সংস্করণ তৈরি করবে যাতে আপনি কোড চালাতে, পরীক্ষা করতে এবং পরিবর্তন করতে পারেন!
এটি করতে রিপোজিটরি ফর্ক করার লিঙ্কে ক্লিক করুন।
এখন আপনার কাছে এই কোর্সের ফর্ক করা সংস্করণ থাকবে নিম্নলিখিত লিঙ্কে:
এই কোর্সে Jupyter Notebooks-এর একটি সিরিজ রয়েছে যা আপনাকে AI Agents তৈরি করার হাতে-কলম অভিজ্ঞতা দেবে।
কোড নমুনাগুলি নিম্নলিখিত ব্যবহার করে:
GitHub অ্যাকাউন্ট প্রয়োজন - বিনামূল্যে:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace। লেবেল করা হয়েছে (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace। লেবেল করা হয়েছে (autogen.ipynb)
Azure সাবস্ক্রিপশন প্রয়োজন: 3) Azure AI Foundry + Azure AI Agent Service। লেবেল করা হয়েছে (azureaiagent.ipynb)
আমরা আপনাকে তিনটি উদাহরণই চেষ্টা করার পরামর্শ দিই যাতে আপনি দেখতে পারেন কোনটি আপনার জন্য সবচেয়ে ভালো কাজ করে।
আপনি যেটি বেছে নেবেন, সেটি নির্ধারণ করবে নিচের সেটআপ ধাপগুলি:
NOTE: যদি আপনার কাছে Python3.12 ইনস্টল না থাকে, নিশ্চিত করুন যে আপনি এটি ইনস্টল করেছেন। তারপর requirements.txt ফাইল থেকে সঠিক সংস্করণগুলি ইনস্টল করতে python3.12 ব্যবহার করে আপনার venv তৈরি করুন।
উদাহরণ
Python venv ডিরেক্টরি তৈরি করুন:
python3 -m venv venv
তারপর venv পরিবেশ সক্রিয় করুন:
macOS এবং Linux
source venv/bin/activate
Windows
venv\Scripts\activate
আমরা এই রিপোজিটরির মূল অংশে একটি requirements.txt
ফাইল অন্তর্ভুক্ত করেছি যা কোড নমুনাগুলি চালানোর জন্য প্রয়োজনীয় সমস্ত Python প্যাকেজ ধারণ করে।
আপনি এটি ইনস্টল করতে পারেন আপনার টার্মিনালে নিম্নলিখিত কমান্ড চালিয়ে:
pip install -r requirements.txt
আমরা কোনো দ্বন্দ্ব এবং সমস্যা এড়াতে একটি Python ভার্চুয়াল পরিবেশ তৈরি করার সুপারিশ করি।
নিশ্চিত করুন যে আপনি VSCode-এ সঠিক Python সংস্করণ ব্যবহার করছেন।
এই কোর্স GitHub Models Marketplace ব্যবহার করে, যা আপনাকে বিনামূল্যে Large Language Models (LLMs) অ্যাক্সেস প্রদান করে যা আপনি AI Agents তৈরি করতে ব্যবহার করবেন।
GitHub Models ব্যবহার করতে, আপনাকে একটি GitHub Personal Access Token তৈরি করতে হবে।
এটি আপনার GitHub অ্যাকাউন্টের Personal Access Tokens settings এ গিয়ে করা যেতে পারে।
অনুগ্রহ করে Principle of Least Privilege অনুসরণ করুন যখন আপনি আপনার টোকেন তৈরি করবেন। এর অর্থ হলো টোকেনকে শুধুমাত্র সেই অনুমতিগুলি দিন যা এই কোর্সের কোড নমুনাগুলি চালানোর জন্য প্রয়োজন।
Developer settings-এ গিয়ে স্ক্রিনের বাম পাশে Fine-grained tokens
অপশনটি নির্বাচন করুন।
তারপর Generate new token
নির্বাচন করুন।
আপনার টোকেনের জন্য একটি বর্ণনামূলক নাম লিখুন যা এর উদ্দেশ্য প্রতিফলিত করে, যাতে এটি পরে সহজে চিহ্নিত করা যায়।
🔐 টোকেনের মেয়াদকাল সুপারিশ
সুপারিশকৃত মেয়াদকাল: ৩০ দিন
আরও নিরাপদ অবস্থানের জন্য, আপনি একটি ছোট সময়কাল বেছে নিতে পারেন—যেমন ৭ দিন 🛡️
এটি একটি ব্যক্তিগত লক্ষ্য নির্ধারণ করার এবং কোর্স সম্পন্ন করার একটি দুর্দান্ত উপায় 🚀।
টোকেনের স্কোপ আপনার এই রিপোজিটরির ফর্কে সীমাবদ্ধ করুন।
টোকেনের অনুমতিগুলি সীমিত করুন: Permissions এর অধীনে Account ট্যাবটি ক্লিক করুন এবং “+ Add permissions” বোতামটি ক্লিক করুন। একটি ড্রপডাউন উপস্থিত হবে। অনুগ্রহ করে Models অনুসন্ধান করুন এবং এটি চেক করুন।
টোকেন তৈরি করার আগে প্রয়োজনীয় অনুমতিগুলি যাচাই করুন।
টোকেন তৈরি করার আগে নিশ্চিত করুন যে আপনি এটি একটি নিরাপদ স্থানে সংরক্ষণ করতে প্রস্তুত, যেমন একটি পাসওয়ার্ড ম্যানেজার ভল্ট, কারণ এটি তৈরি করার পরে এটি আবার দেখানো হবে না।
আপনার সদ্য তৈরি করা টোকেনটি কপি করুন। এখন এটি এই কোর্সে অন্তর্ভুক্ত .env
ফাইলে যোগ করুন।
.env
ফাইল তৈরি করুনআপনার টার্মিনালে নিম্নলিখিত কমান্ড চালিয়ে .env
ফাইল তৈরি করুন।
cp .env.example .env
এটি উদাহরণ ফাইলটি কপি করবে এবং আপনার ডিরেক্টরিতে একটি .env
তৈরি করবে যেখানে আপনি পরিবেশ ভেরিয়েবলগুলির জন্য মানগুলি পূরণ করবেন।
আপনার টোকেনটি কপি করে, আপনার প্রিয় টেক্সট এডিটরে .env
ফাইলটি খুলুন এবং GITHUB_TOKEN
ফিল্ডে আপনার টোকেনটি পেস্ট করুন।
এখন আপনি এই কোর্সের কোড নমুনাগুলি চালাতে সক্ষম হবেন।
Azure AI Foundry-এ একটি হাব এবং প্রকল্প তৈরি করার ধাপগুলি অনুসরণ করুন এখানে: Hub resources overview
আপনার প্রকল্প তৈরি করার পরে, আপনাকে আপনার প্রকল্পের সংযোগ স্ট্রিং সংগ্রহ করতে হবে।
এটি Azure AI Foundry পোর্টালের Overview পৃষ্ঠায় গিয়ে করা যেতে পারে।
.env
ফাইল তৈরি করুনআপনার টার্মিনালে নিম্নলিখিত কমান্ড চালিয়ে .env
ফাইল তৈরি করুন।
cp .env.example .env
এটি উদাহরণ ফাইলটি কপি করবে এবং আপনার ডিরেক্টরিতে একটি .env
তৈরি করবে যেখানে আপনি পরিবেশ ভেরিয়েবলগুলির জন্য মানগুলি পূরণ করবেন।
আপনার টোকেনটি কপি করে, আপনার প্রিয় টেক্সট এডিটরে .env
ফাইলটি খুলুন এবং PROJECT_ENDPOINT
ফিল্ডে আপনার টোকেনটি পেস্ট করুন।
নিরাপত্তার সেরা অনুশীলন হিসাবে, আমরা keyless authentication ব্যবহার করব Microsoft Entra ID দিয়ে Azure OpenAI-তে প্রমাণীকরণের জন্য।
পরবর্তী ধাপে, একটি টার্মিনাল খুলুন এবং az login --use-device-code
চালিয়ে আপনার Azure অ্যাকাউন্টে সাইন ইন করুন।
আপনি লগ ইন করার পরে, টার্মিনালে আপনার সাবস্ক্রিপশন নির্বাচন করুন।
Agentic RAG পাঠ - পাঠ ৫ - এর জন্য কিছু নমুনা রয়েছে যা Azure Search এবং Azure OpenAI ব্যবহার করে।
যদি আপনি এই নমুনাগুলি চালাতে চান, তাহলে আপনাকে .env
ফাইলে নিম্নলিখিত পরিবেশ ভেরিয়েবলগুলি যোগ করতে হবে:
AZURE_SUBSCRIPTION_ID
- Overview পৃষ্ঠার Project details চেক করুন।
AZURE_AI_PROJECT_NAME
- আপনার প্রকল্পের Overview পৃষ্ঠার শীর্ষে দেখুন।
AZURE_OPENAI_SERVICE
- Overview পৃষ্ঠার Included capabilities ট্যাবে Azure OpenAI Service এর জন্য এটি খুঁজুন।
AZURE_OPENAI_RESOURCE_GROUP
- Management Center এর Overview পৃষ্ঠার Project properties এ যান।
GLOBAL_LLM_SERVICE
- Connected resources এর অধীনে Azure AI Services সংযোগের নাম খুঁজুন। যদি তালিকাভুক্ত না থাকে, তাহলে Azure portal-এ আপনার রিসোর্স গ্রুপের অধীনে AI Services রিসোর্সের নাম চেক করুন।
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME
- আপনার embedding মডেল (যেমন, text-embedding-ada-002
) নির্বাচন করুন এবং মডেল বিবরণ থেকে Deployment name নোট করুন।
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
- আপনার chat মডেল (যেমন, gpt-4o-mini
) নির্বাচন করুন এবং মডেল বিবরণ থেকে Deployment name নোট করুন।
AZURE_OPENAI_ENDPOINT
- Azure AI services খুঁজুন, এটি ক্লিক করুন, তারপর Resource Management, Keys and Endpoint-এ যান, “Azure OpenAI endpoints”-এ স্ক্রোল করুন এবং “Language APIs” এর জন্য কপি করুন।
AZURE_OPENAI_API_KEY
- একই স্ক্রিন থেকে KEY 1 বা KEY 2 কপি করুন।
AZURE_SEARCH_SERVICE_ENDPOINT
- আপনার Azure AI Search রিসোর্স খুঁজুন, এটি ক্লিক করুন এবং Overview দেখুন।
AZURE_SEARCH_API_KEY
- তারপর Settings এবং Keys-এ যান এবং প্রাথমিক বা মাধ্যমিক অ্যাডমিন কী কপি করুন।
AZURE_OPENAI_API_VERSION
- API version lifecycle পৃষ্ঠার Latest GA API release এর অধীনে যান।আপনার শংসাপত্রগুলি হার্ডকোড করার পরিবর্তে, আমরা Azure OpenAI-এর সাথে একটি keyless সংযোগ ব্যবহার করব। এটি করতে, আমরা DefaultAzureCredential
আমদানি করব এবং পরে DefaultAzureCredential
ফাংশন কল করব শংসাপত্র পেতে।
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
যদি আপনার এই সেটআপ চালাতে কোনো সমস্যা হয়, আমাদের Azure AI Community Discord-এ যোগ দিন অথবা একটি সমস্যা তৈরি করুন।
আপনি এখন এই কোর্সের কোড চালানোর জন্য প্রস্তুত। AI Agents-এর জগৎ সম্পর্কে আরও শিখতে শুভকামনা!
AI Agents এবং Agent Use Cases-এর পরিচিতি
অস্বীকৃতি:
এই নথিটি AI অনুবাদ পরিষেবা Co-op Translator ব্যবহার করে অনুবাদ করা হয়েছে। আমরা যথাসাধ্য সঠিকতার জন্য চেষ্টা করি, তবে অনুগ্রহ করে মনে রাখবেন যে স্বয়ংক্রিয় অনুবাদে ত্রুটি বা অসঙ্গতি থাকতে পারে। মূল ভাষায় থাকা নথিটিকে প্রামাণিক উৎস হিসেবে বিবেচনা করা উচিত। গুরুত্বপূর্ণ তথ্যের জন্য, পেশাদার মানব অনুবাদ সুপারিশ করা হয়। এই অনুবাদ ব্যবহারের ফলে কোনো ভুল বোঝাবুঝি বা ভুল ব্যাখ্যা হলে আমরা দায়বদ্ধ থাকব না।