ai-agents-for-beginners

பாடநெறி அமைப்பு

அறிமுகம்

இந்த பாடத்தில், இந்த பாடநெறியின் குறியீட்டு மாதிரிகளை எவ்வாறு இயக்குவது என்பதைப் பற்றி கற்றுக்கொள்வீர்கள்.

மற்ற கற்றலாளர்களுடன் இணைந்து உதவி பெறுங்கள்

உங்கள் ரெப்போவை கிளோன் செய்யத் தொடங்குவதற்கு முன், AI Agents For Beginners Discord channel இல் இணைந்து அமைப்புக்கு உதவி பெறவும், பாடநெறி தொடர்பான கேள்விகளை கேட்கவும் அல்லது மற்ற கற்றலாளர்களுடன் தொடர்பு கொள்ளவும்.

இந்த ரெப்போவை கிளோன் செய்யவும் அல்லது ஃபோர்க் செய்யவும்

தொடங்க, தயவுசெய்து GitHub Repository ஐ கிளோன் செய்யவும் அல்லது ஃபோர்க் செய்யவும். இது உங்களுக்கான பாடநெறி பொருளின் தனிப்பட்ட பதிப்பை உருவாக்கும், இதனால் நீங்கள் குறியீட்டை இயக்க, சோதிக்க மற்றும் மாற்றலாம்!

இதைச் செய்ய, ரெப்போவை ஃபோர்க் செய்ய இணைப்பைக் கிளிக் செய்யவும்.

இப்போது, இந்த பாடநெறியின் ஃபோர்க் செய்யப்பட்ட பதிப்பு கீழே உள்ள இணைப்பில் இருக்கும்:

Forked Repo

சுருக்கமான கிளோன் (வார்ப்படம் / Codespaces க்கு பரிந்துரைக்கப்படுகிறது)

முழு ரெப்போசிடரி பெரியதாக இருக்கலாம் (~3 GB) முழு வரலாற்றையும் அனைத்து கோப்புகளையும் பதிவிறக்கும்போது. நீங்கள் வெறும் வார்ப்படத்தில் கலந்துகொள்வதற்காக அல்லது சில பாடநெறி கோப்புறைகளை மட்டுமே தேவைப்படும் போது, ​​சுருக்கமான கிளோன் (அல்லது ஒரு சுருக்கமான கிளோன்) பெரும்பாலான பதிவிறக்கத்தை தவிர்க்கிறது.

விரைவான சுருக்கமான கிளோன் — குறைந்த வரலாறு, அனைத்து கோப்புகளும்

கீழே உள்ள கட்டளைகளில் <your-username> ஐ உங்கள் ஃபோர்க் URL (அல்லது உங்களுக்கு விருப்பமானது என்றால் மேலோட்ட URL) உடன் மாற்றவும்.

சமீபத்திய கமிட் வரலாற்றை மட்டுமே கிளோன் செய்ய:

git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git

குறிப்பிட்ட கிளையை கிளோன் செய்ய:

git clone --depth 1 --branch <branch-name> https://github.com/<your-username>/ai-agents-for-beginners.git

பகுதி (சுருக்கமான) கிளோன் — குறைந்த ப்ளாப்ஸ் + தேர்ந்தெடுக்கப்பட்ட கோப்புறைகள் மட்டுமே

இது பகுதி கிளோன் மற்றும் சுருக்கமான-சேமிப்பு (Git 2.25+ மற்றும் பகுதி கிளோன் ஆதரவு கொண்ட நவீன Git பரிந்துரைக்கப்படுகிறது) பயன்படுத்துகிறது:

git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git

ரெப்போ கோப்புறைக்கு செல்லவும்:

bash க்கு:

cd ai-agents-for-beginners

Powershell க்கு:

Set-Location ai-agents-for-beginners

பின்னர் நீங்கள் எந்த கோப்புறைகளை விரும்புகிறீர்கள் என்பதை குறிப்பிடவும் (கீழே உள்ள உதாரணம் இரண்டு கோப்புறைகளை காட்டுகிறது):

git sparse-checkout set 00-course-setup 01-intro-to-ai-agents

கிளோன் செய்து கோப்புகளை சரிபார்த்த பிறகு, நீங்கள் கோப்புகளை மட்டுமே தேவைப்படும் போது மற்றும் இடத்தை விடுவிக்க (git வரலாறு இல்லை), ரெப்போசிடரி மெட்டாடேட்டாவை நீக்கவும் (💀மீளமுடியாதது — நீங்கள் அனைத்து Git செயல்பாடுகளையும் இழக்கிறீர்கள்: கமிட்கள், புல்கள், புஷ்கள் அல்லது வரலாற்று அணுகல்).

Linux/macOS க்கு:

rm -rf .git

Windows க்கு:

Remove-Item -Recurse -Force .git

GitHub Codespaces பயன்படுத்துதல் (உள்ளூர் பெரிய பதிவிறக்கங்களைத் தவிர்க்க பரிந்துரைக்கப்படுகிறது)

குறிப்புகள்

குறியீட்டை இயக்குதல்

இந்த பாடநெறி, AI Agents உருவாக்குவதற்கான அனுபவத்தைப் பெறுவதற்கான Jupyter Notebooks தொடர் வழங்குகிறது.

குறியீட்டு மாதிரிகள் கீழே உள்ளவற்றில் ஏதாவது ஒன்றைப் பயன்படுத்துகின்றன:

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) என லேபிள் செய்யப்பட்டுள்ளது.

இந்த மூன்று வகையான உதாரணங்களை முயற்சிக்குமாறு உங்களை ஊக்குவிக்கிறோம், எது உங்களுக்கு சிறந்தது என்பதைப் பார்க்க.

நீங்கள் எந்த விருப்பத்தைத் தேர்ந்தெடுத்தாலும், கீழே உள்ள அமைப்பு படிகளை நீங்கள் பின்பற்ற வேண்டும்:

தேவைகள்

இந்த ரெப்போசிடரியின் மூலத்தில் உள்ள requirements.txt கோப்பில், குறியீட்டு மாதிரிகளை இயக்க தேவையான அனைத்து Python தொகுதிகளும் உள்ளன.

நீங்கள் அதை ரெப்போசிடரியின் மூலத்தில் உங்கள் டெர்மினலில் கீழே உள்ள கட்டளையை இயக்குவதன் மூலம் நிறுவலாம்:

pip install -r requirements.txt

Python மெய்நிகர் சூழலை உருவாக்க பரிந்துரைக்கிறோம், எந்த முரண்பாடுகள் மற்றும் சிக்கல்களையும் தவிர்க்க.

VSCode அமைப்பு

VSCode இல் சரியான Python பதிப்பைப் பயன்படுத்துகிறீர்கள் என்பதை உறுதிப்படுத்தவும்.

image

GitHub Models ஐப் பயன்படுத்தி மாதிரிகளை அமைக்கவும்

படி 1: உங்கள் GitHub தனிப்பட்ட அணுகல் டோக்கனை (PAT) பெறவும்

இந்த பாடநெறி GitHub Models Marketplace ஐ பயன்படுத்துகிறது, இது உங்களுக்கு AI Agents உருவாக்க பயன்படுத்தப்படும் பெரிய மொழி மாதிரிகளை (LLMs) இலவசமாக அணுக அனுமதிக்கிறது.

GitHub Models ஐப் பயன்படுத்த, நீங்கள் GitHub Personal Access Token ஐ உருவாக்க வேண்டும்.

இது உங்கள் GitHub கணக்கில் உள்ள Personal Access Tokens settings க்கு சென்று செய்யலாம்.

உங்கள் டோக்கனை உருவாக்கும்போது Principle of Least Privilege ஐ பின்பற்றவும். இது இந்த பாடநெறியில் குறியீட்டு மாதிரிகளை இயக்க டோக்கனுக்கு தேவையான அனுமதிகளை மட்டுமே வழங்க வேண்டும் என்பதைக் குறிக்கிறது.

  1. Developer settings க்கு சென்று உங்கள் திரையின் இடது பக்கத்தில் உள்ள Fine-grained tokens விருப்பத்தைத் தேர்ந்தெடுக்கவும்.

    பின்னர் Generate new token ஐத் தேர்ந்தெடுக்கவும்.

    Generate Token

  2. உங்கள் டோக்கனின் நோக்கத்தை பிரதிபலிக்கும் ஒரு விளக்கமான பெயரை உள்ளீடு செய்யவும், பின்னர் அதை எளிதாக அடையாளம் காணலாம்.

    🔐 டோக்கன் காலாவதியான பரிந்துரை

    பரிந்துரைக்கப்பட்ட காலம்: 30 நாட்கள் மேலும் பாதுகாப்பான நிலைப்பாட்டிற்காக, குறுகிய காலத்தைத் தேர்ந்தெடுக்கலாம்—7 நாட்கள் 🛡️ போன்றவை இது ஒரு தனிப்பட்ட இலக்கை அமைத்து, உங்கள் கற்றல் வேகத்தை அதிகரிக்கும் போது பாடநெறியை முடிக்க ஒரு சிறந்த வழி 🚀.

    Token Name and Expiration

  3. இந்த ரெப்போசிடரியின் ஃபோர்க் வரைபடத்திற்கு டோக்கனின் அளவை வரையறுக்கவும்.

    Limit scope to fork repository

  4. டோக்கனின் அனுமதிகளை வரையறுக்கவும்: Permissions கீழ், Account தாவலை கிளிக் செய்து, “+ Add permissions” பொத்தானை கிளிக் செய்யவும். ஒரு டிராப்டவுன் தோன்றும். தயவுசெய்து Models ஐ தேடி, அதற்கான பெட்டியைச் சரிபார்க்கவும். Add Models Permission

  5. டோக்கனை உருவாக்குவதற்கு முன், தேவையான அனுமதிகளை சரிபார்க்கவும். Verify Permissions

  6. டோக்கனை உருவாக்குவதற்கு முன், நீங்கள் அதை ஒரு பாதுகாப்பான இடத்தில், பாஸ்வேர்ட் மேலாளர் வால்ட் போன்றவற்றில் சேமிக்க தயாராக இருக்க வேண்டும், ஏனெனில் நீங்கள் அதை உருவாக்கிய பிறகு மீண்டும் காண முடியாது. Store Token Securely

நீங்கள் தற்போது உருவாக்கிய புதிய டோக்கனை நகலெடுக்கவும். இந்த பாடநெறியில் உள்ள .env கோப்பில் இதைச் சேர்க்க வேண்டும்.

படி 2: உங்கள் .env கோப்பை உருவாக்கவும்

உங்கள் டெர்மினலில் கீழே உள்ள கட்டளையை இயக்கி உங்கள் .env கோப்பை உருவாக்கவும்.

cp .env.example .env

இது உதாரண கோப்பை நகலெடுத்து, உங்கள் கோப்புறையில் .env ஐ உருவாக்கும், மேலும் நீங்கள் சுற்றுச்சூழல் மாறிகள் மதிப்புகளை நிரப்ப வேண்டும்.

உங்கள் டோக்கனை நகலெடுத்து, உங்கள் விருப்பமான உரை திருத்தியில் .env கோப்பைத் திறந்து, உங்கள் டோக்கனை GITHUB_TOKEN புலத்தில் ஒட்டவும். GitHub Token Field

இப்போது நீங்கள் இந்த பாடநெறியின் குறியீட்டு மாதிரிகளை இயக்க முடியும்.

Azure AI Foundry மற்றும் Azure AI Agent Service ஐப் பயன்படுத்தி மாதிரிகளை அமைக்கவும்

படி 1: உங்கள் Azure திட்ட இறுதிப்புள்ளியைப் பெறவும்

Azure AI Foundry இல் ஒரு ஹப் மற்றும் திட்டத்தை உருவாக்குவதற்கான படிகளை பின்பற்றவும்: Hub resources overview

திட்டத்தை உருவாக்கிய பிறகு, உங்கள் திட்டத்திற்கான இணைப்பு சரத்தைப் பெற வேண்டும்.

இது Azure AI Foundry போர்டலின் Overview பக்கத்திற்கு சென்று செய்யலாம்.

Project Connection String

படி 2: உங்கள் .env கோப்பை உருவாக்கவும்

உங்கள் டெர்மினலில் கீழே உள்ள கட்டளையை இயக்கி உங்கள் .env கோப்பை உருவாக்கவும்.

cp .env.example .env

இது உதாரண கோப்பை நகலெடுத்து, உங்கள் கோப்புறையில் .env ஐ உருவாக்கும், மேலும் நீங்கள் சுற்றுச்சூழல் மாறிகள் மதிப்புகளை நிரப்ப வேண்டும்.

உங்கள் டோக்கனை நகலெடுத்து, உங்கள் விருப்பமான உரை திருத்தியில் .env கோப்பைத் திறந்து, உங்கள் டோக்கனை PROJECT_ENDPOINT புலத்தில் ஒட்டவும்.

படி 3: Azure இல் உள்நுழையவும்

ஒரு பாதுகாப்பு சிறந்த நடைமுறையாக, Microsoft Entra ID உடன் Azure OpenAI க்கு அங்கீகாரம் செய்ய keyless authentication ஐப் பயன்படுத்துவோம்.

அடுத்ததாக, ஒரு டெர்மினலைத் திறந்து az login --use-device-code ஐ இயக்கி உங்கள் Azure கணக்கில் உள்நுழைக.

நீங்கள் உள்நுழைந்த பிறகு, டெர்மினலில் உங்கள் சந்தாவைத் தேர்ந்தெடுக்கவும்.

கூடுதல் சுற்றுச்சூழல் மாறிகள் - Azure Search மற்றும் Azure OpenAI

Agentic RAG பாடம் - பாடம் 5 - Azure Search மற்றும் Azure OpenAI ஐப் பயன்படுத்தும் மாதிரிகளை உள்ளடக்கியது.

இந்த மாதிரிகளை இயக்க விரும்பினால், உங்கள் .env கோப்பில் பின்வரும் சுற்றுச்சூழல் மாறிகளைச் சேர்க்க வேண்டும்:

மேற்பார்வை பக்கம் (திட்டம்)

மேலாண்மை மையம்

மாதிரிகள் + இறுதிப்புள்ளிகள் பக்கம்

Azure Portal

வெளிப்புற வலைப்பக்கம்

Keyless authentication அமைக்கவும்

உங்கள் சான்றுகளை கடினமாக்காமல், Azure OpenAI உடன் keyless இணைப்பைப் பயன்படுத்துவோம். இதற்காக, DefaultAzureCredential ஐ இறக்குமதி செய்து, பின்னர் DefaultAzureCredential செயல்பாட்டை அழைத்து சான்றை பெறுவோம்.

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

ஏதேனும் இடத்தில் சிக்கியுள்ளீர்களா?

இந்த அமைப்பை இயக்குவதில் ஏதேனும் சிக்கல்கள் இருந்தால், எங்கள் Azure AI Community Discord அல்லது ஒரு பிரச்சினையை உருவாக்கவும்.

அடுத்த பாடம்

இந்த பாடத்திற்கான குறியீட்டை இயக்க தயாராக உள்ளீர்கள். AI முகவர்களின் உலகத்தை மேலும் அறிந்து மகிழுங்கள்!

AI முகவர்கள் மற்றும் முகவர் பயன்பாட்டு வழக்குகள் அறிமுகம்


குறிப்பு:
இந்த ஆவணம் AI மொழிபெயர்ப்பு சேவை Co-op Translator பயன்படுத்தி மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் துல்லியத்திற்காக முயற்சிக்கிறோம், ஆனால் தானியங்கி மொழிபெயர்ப்புகளில் பிழைகள் அல்லது தவறுகள் இருக்கக்கூடும் என்பதை கவனத்தில் கொள்ளவும். அதன் தாய்மொழியில் உள்ள மூல ஆவணம் அதிகாரப்பூர்வ ஆதாரமாக கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பு பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பைப் பயன்படுத்துவதால் ஏற்படும் எந்த தவறான புரிதல்கள் அல்லது தவறான விளக்கங்களுக்கு நாங்கள் பொறுப்பல்ல.