ఈ పాఠం ఈ కోర్సు యొక్క కోడ్ ఉదాహరణలు ఎలా నడుపాలో వివరిస్తుంది.
మీ రెపోను క్లోన్ చేయడం ప్రారంభించే ముందు, సెటప్కు ఏమైనా సహాయం, కోర్సుపై ప్రశ్నలు లేదా ఇతర విద్యార్థుల దగ్గర చేరడానికి AI Agents For Beginners Discord channel లో చేరండి.
ప్రారంభించడానికి, గిట్హబ్ రిపాజిటరీని క్లోన్ లేదా ఫోర్క్ చేయండి. ఇది మీ సొంత వర్షన్ను సృష్టిస్తుంది, దీనితో మీరు కోడ్ను నడిపించవచ్చు, పరీక్షించవచ్చు మరియు మార్చవచ్చు!
ఇది ఫోర్క్ చేయడానికి లింకును క్లిక్ చేయడం ద్వారా చేయవచ్చు
ఇప్పుడు మీకు ఈ కోర్సు యొక్క మీ స్వంత ఫోర్క్డ్ వెర్షన్ ఈ కింది లింకులో ఉండాలి:

పూర్తి రిపాజిటరీ పూర్తి చరిత్ర మరియు అన్ని ఫైళ్లను డౌన్లోడ్ చేస్తే పెద్దది అయి (~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
ఇది partial clone మరియు sparse-checkout ఉపయోగిస్తుంది (Git 2.25+ అవసరం మరియు partial cloneకి మోడ్రన్ Git సూచించబడింది):
git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git
రిపో ఫోల్డర్లోకి వెళ్లండి:
cd ai-agents-for-beginners
తర్వాత మీరు అవసరమైన ఫోల్డర్లను నిర్దారించండి (కింది ఉదాహరణ రెండు ఫోల్డర్లను చూపిస్తుంది):
git sparse-checkout set 00-course-setup 01-intro-to-ai-agents
క్లోన్ చేసి ఫైళ్లు పరిశీలించిన తర్వాత, మీరు కేవలం ఫైళ్లు కావాలని మరియు స్థలాన్ని తొలగించాలనుకుంటే (గిట్ చరిత్ర లేదు), దయచేసి రిపాజిటరీ మెటాడేటాను తొలగించండి (💀మార్చలేని — మీరు అన్ని Git కార్యకలాపాలను కోల్పోతారు: కమిట్లు, పుల్స్, పుష్లు లేదా చరిత్ర యాక్సెస్ లేవు).
# zsh/bash
rm -rf .git
# పవర్ షెల్
Remove-Item -Recurse -Force .git
ఈ రెపోకు కోసం GitHub UI ద్వారా కొత్త కోడ్స్పేస్ సృష్టించండి.
ఈ కోర్సు AI ఏజెంట్స్ నిర్మాణంలో అనుభవం పొందడానికి నడిపించదగిన జ్యూపిటర్ నోట్బుక్స్ ల సంకలనాన్ని అందిస్తుంది.
కోడ్ ఉదాహరణలు Microsoft Agent Framework (MAF) ను ఉపయోగిస్తూ ఉంటాయి, FoundryChatClient తో, ఇది Microsoft Foundry ద్వారా Microsoft Foundry Agent Service V2 (Responses API) కు కనెక్ట్ అవుతుంది.
అన్ని పైనథాన్ నోట్బుక్స్ *-python-agent-framework.ipynb అనే లేబుల్ కలిగి ఉంటాయి.
గమనిక: మీకు Python3.12 ఇన్స్టాల్ లేకపోతే, దయచేసి ముందుగా దాన్ని ఇన్స్టాల్ చేయండి. తరువాత కొన్ని అవసరమైన వెర్షన్ల కోసం requirements.txt ఫైల్ నుండి సరైన ప్యాకేజీలు పొందడానికి python3.12 ఉపయోగించి మీ వర్చువల్ ఎన్విరాన్మెంట్ క్రియేట్ చేయండి.
ఉదాహరణ
Python వర్చువల్-env డైరెక్టరీని సృష్టించండి:
python -m venv venv
తరువాత వర్చువల్-envని చురుకుచేయండి:
# zsh/bash
source venv/bin/activate
# Command Prompt for Windows
venv\Scripts\activate
.NET 10+: .NET ఉపయోగించే సాంపిల్ల కోసం .NET 10 SDK లేదా తర్వాతి వర్షన్ ఇన్స్టాల్ చేయండి. తర్వాత మీరు ఇన్స్టాల్ చేసిన .NET SDK వెర్షన్ పరిశీలించండి:
dotnet --list-sdks
gpt-5-mini). కింది Step 1 చూడండి.ఈ రెపో యొక్క రూట్ లో అవసరమైన అన్ని Python ప్యాకేజీలతో కూడిన requirements.txt ఫైల్ ను చేర్చాము.
ఈ క్రింది ఆదేశాన్ని రూట్ డైరెక్టరీలో మీ టెర్మినల్ లో నడిపించాలి:
pip install -r requirements.txt
వివిధ సమస్యలు లేకుండా Python వర్చువల్ ఎన్విరాన్మెంట్ సృష్టించమని సూచించబడింది.
మీరు VSCodeలో సరైన Python వెర్షన్ ఉపయోగిస్తున్నదో లేదో నిర్ధారించుకోండి.
నోట్బుక్స్ నడపడానికి Microsoft Foundry హబ్ మరియు డిప్లాయ్ అయిన మోడల్ ఉన్న ప్రాజెక్ట్ అవసరం.
gpt-5-mini) ని డిప్లాయ్ చేయండి.మీ Microsoft Foundry పోర్టల్ లోని ప్రాజెక్ట్ నుండి:

gpt-5-mini) గుర్తించండి.az login తో Azure లో సైన్ ఇన్ అవ్వండిఅన్ని నోట్బుక్స్ AzureCliCredential ఉపయోగించి అథెంటికేట్ అవుతాయి — ఏ API కీలు అవసరం లేదు. ఇది Azure CLI ద్వారా సైన్ ఇన్ కావటం అవసరం.
Azure CLI ఇన్స్టాల్ చేయండి (మీరు ఇంతలాగే చేయకపోతే): aka.ms/installazurecli
సైన్ ఇన్ అవ్వండి ఈ విధంగా:
az login
లేదా మీరు రిమోట్/కోడ్స్పేస్ వాతావరణంలో బ్రౌజర్ లేకుండా ఉంటే:
az login --use-device-code
మీ సబ్స్క్రిప్షన్ ఎంచుకోండి (ప్రాంప్ట్ వస్తే) — మీ Foundry ప్రాజెక్ట్ ఉన్నది ఎంచుకోండి.
మీరు సైన్ ఇన్ అయ్యారు అని ధృవీకరించుకోండి:
az account show
ఎందుకు
az login? నోట్బుక్స్azure-identityప్యాకేజీ నుండిAzureCliCredentialఉపయోగించి అథెంటికేట్ చేస్తాయి. అంటే మీ Azure CLI సెషన్ క్రెడెన్షియల్స్ అందిస్తుంది —.envఫైలులో API కీలు లేదా సీక్రెట్స్ అవసరం లేదు. ఇది భద్రత ఉత్తమ అభ్యాసం.
.env ఫైల్ సృష్టించండిఉదాహరణ ఫైల్ ని కాపీ చేయండి:
# zsh/bash
cp .env.example .env
# పవర్షెల్
Copy-Item .env.example .env
.env ని తెరవండి మరియు ఈ రెండు విలువలను నింపండి:
AZURE_AI_PROJECT_ENDPOINT=https://<your-project>.services.ai.azure.com/api/projects/<your-project-id>
AZURE_AI_MODEL_DEPLOYMENT_NAME=gpt-5-mini
| వేరియబుల్ | దొరకడానికి స్థలం |
|---|---|
AZURE_AI_PROJECT_ENDPOINT |
Foundry పోర్టల్ → మీ ప్రాజెక్ట్ → Overview పేజీ |
AZURE_AI_MODEL_DEPLOYMENT_NAME |
Foundry పోర్టల్ → Models + Endpoints → మీ డిప్లాయ్ చేసిన మోడల్ పేరు |
ఎక్కువ వాడుతున్న పాఠాల కోసం అంతే! నోట్బుక్స్ మీ az login సెషన్ ద్వారా ఆటోమేటిక్ అథెంటికేట్ అవుతాయి.
pip install -r requirements.txt
మీరు ముందుగా సృష్టించిన వర్చువల్ ఎన్విరాన్మెంట్ లో దీనిని నడపాలని సూచించబడింది.
పాఠం 5 రిట్రీవల్-ఆగ్మెంటెడ్ జనరేషన్ కోసం Azure AI Search ఉపయోగిస్తుంది. మీరు ఆ పాఠం నడపాలనుకుంటే, ఈ వేరియబుల్స్ ను .env ఫైల్ లో చేర్చండి:
| వేరియబుల్ | దొరకడానికి స్థలం |
|---|---|
AZURE_SEARCH_SERVICE_ENDPOINT |
Azure పోర్టల్ → మీ Azure AI Search వనరు → Overview → URL |
AZURE_SEARCH_API_KEY |
Azure పోర్టల్ → మీ Azure AI Search వనరు → Settings → Keys → ప్రాధమిక అడ్మిన్ కీ |
కొంతమంది పాఠాలు 6 మరియు 8 లో కాస్త నేరుగా Azure OpenAI (Responses API ద్వారా) పిలుస్తాయి, Microsoft Foundry ప్రాజెక్టు ద్వారా కాకుండా. ఈ నమూనాలు గతంలో GitHub Models ఉపయోగించాయి, ఇవి నిలిపివేయబడ్డాయి (2026 జూలైలో రిటైర్ అవుతాయి) మరియు Responses APIకి మద్దతు ఇవ్వవు. మీరు ఆ నమూనాలు నడపాలనుకుంటే, ఈ వేరియబుల్స్ .envలో చేర్చండి:
| వేరియబుల్ | దొరకడానికి స్థలం |
|---|---|
AZURE_OPENAI_ENDPOINT |
Azure పోర్టల్ → మీ Azure OpenAI వనరు → Keys and Endpoint → ఎండ్పాయింట్ (ఉదా: https://<your-resource>.openai.azure.com) |
AZURE_OPENAI_DEPLOYMENT |
మీరు డిప్లాయ్ చేసిన మోడల్ పేరు (ఉదా: gpt-5-mini) ఇది Responses APIకి మద్దతు ఇస్తుంది |
AZURE_OPENAI_API_KEY |
ఐచ్ఛికం — key-based auth ఉపయోగిస్తే మాత్రమే అవసరం, az login / Entra ID స్థానంలో |
Responses API స్థిరమైన
/openai/v1/ఎండ్పాయింట్ ఉపయోగిస్తుంది, అందువల్లapi-versionఅవసరం లేదు. కీ-లెస్ Entra ID అథెంటికేషన్ కోసంaz loginతో సైన్ ఇన్ అవ్వండి.
MiniMax పెద్ద కాన్టెక్స్ మోడల్స్ (204K టోకెన్ల వరకు) OpenAI అనుకూల API ద్వారా అందిస్తుంది. Microsoft Agent Frameworkలోని OpenAIChatClient ఏ OpenAI-అనుకూల ఎండ్పాయింట్తోనైనా పని చేయగలదు, కాబట్టి MiniMax ను Azure OpenAI లేదా OpenAI కు ప్రత్యామ్నాయం గా ఉపయోగించవచ్చు.
ఈ వేరియబుల్స్ ను .env ఫైల్ లో చేర్చండి:
| వేరియబుల్ | దొరకడానికి స్థలం |
|---|---|
MINIMAX_API_KEY |
MiniMax Platform → API కీలను పొందండి |
MINIMAX_BASE_URL |
https://api.minimax.io/v1 (డిఫాల్ట్ విలువు) ఉపయోగించండి |
MINIMAX_MODEL_ID |
వాడదలచిన మోడల్ పేరు (ఉదా: MiniMax-M3) |
ఉదాహరణ మోడల్స్: MiniMax-M3 (సూచించబడింది), MiniMax-M2.7, MiniMax-M2.7-highspeed (వేలిగా సమాధానాలు). మోడల్ పేర్లు మరియు అందుబాటు కాలం తో మారవచ్చు, మోడల్ యాక్సెస్ మీ అకౌంట్ లేదా ప్రాంతం ఆధారంగా ఉండవచ్చు — తాజా జాబితా కోసం MiniMax Platform చూసుకోండి. MiniMax-M3 మీకు అందుబాటులో లేకుంటే, మీకు అందుబాటులో ఉన్న మోడల్ (ఉదా: MiniMax-M2.7)కి MINIMAX_MODEL_ID సెట్ చేయండి.
OpenAIChatClient ఉపయోగించే ఉదాహరణలు (ఉదా: పాఠం 14 హోటల్ బుకింగ్ వర్క్ఫ్లో) ఆటోమేటిగానే MINIMAX_API_KEY సెట్ అయితే మీ MiniMax సెట్టింగ్స్ ని గుర్తించి ఉపయోగిస్తాయి.
Foundry Local ఒక లైట్వెయిట్ రన్టైమ్, మీరు మీ కంప్యూటర్ మీద భాషా మోడల్స్ని డౌన్లోడ్ చేసి, నిర్వహించి, OpenAI-అనుకూల API ద్వారా సర్వ్ చేస్తుంది — క్లౌడ్ లేదూ, Azure సబ్స్క్రిప్షన్ లేదూ, API కీలు అవసరం లేకుండా. ఇది ఆఫ్లైన్ డెవలప్మెంట్, క్లౌడ్ ఖర్చులు లేకుండా ఎక్స్పెరిజ్ చేయడానికి, లేదా డేటాను డివైస్ లోనే ఉంచడానికి అద్భుతమైన ఆప్షన్.
Microsoft Agent Frameworkలోని OpenAIChatClient ఏ OpenAI అనుకూల ఎండ్పాయింట్తోనైనా పని చేయగలదు కాబట్టి, Foundry Local Azure OpenAIకి స్థానిక ప్రత్యామ్నాయం.
1. Foundry Local ఇన్స్టాల్ చేయండి
# విండోస్
winget install Microsoft.FoundryLocal
# మాక్OS
brew install foundrylocal
2. ఒక మోడల్ డౌన్లోడ్ చేసి నడపండి (ఇది స్థానిక సర్వీస్ను కూడా ప్రారంభిస్తుంది):
foundry model list # అందుబాటులో ఉన్న మోడళ్లను చూడండి
foundry model run phi-4-mini
3. స్థానిక ఎండ్పాయింట్ను కనుగొనేందుకు Python SDK ని ఇన్స్టాల్ చేయండి:
pip install foundry-local-sdk
4. Microsoft Agent Frameworkని మీ స్థానిక మోడల్ వైపు సూచించండి:
from foundry_local import FoundryLocalManager
from agent_framework.openai import OpenAIChatClient
# అవసరమైతే డౌన్లోడ్ చేసి, స్థానికంగా మోడల్ను అందిస్తుంది, తర్వాత ఎండ్పాయింట్/పోర్ట్ను కనుగొంటుంది.
manager = FoundryLocalManager("phi-4-mini")
chat_client = OpenAIChatClient(
base_url=manager.endpoint, # ఉదా: http://localhost:<port>/v1
api_key=manager.api_key, # Foundry Local కోసం ఎల్లప్పుడూ "అవసరం లేదు"
model_id=manager.get_model_info("phi-4-mini").id,
)
agent = chat_client.as_agent(
name="LocalAgent",
instructions="You are a helpful assistant running fully on-device.",
)
గమనిక: Foundry Local OpenAI అనుకూల చాట్ కంప్లీషన్ ఎండ్పాయింట్ను ఎక్స్పోస్ చేస్తుంది. స్థానిక డెవలప్మెంట్ మరియు ఆఫ్లైన్ సన్నివేశాల కోసం దీనిని ఉపయోగించండి. పూర్తి Responses API ఫీచర్ సెట్ కోసం (స్థితిగత సంభాషణలు, లోతైన టూల్ ఆర్కెస్ట్రేషన్, ఏజెంట్-స్టైల్ డెవలప్మెంట్), పాఠాలలో చూపినట్లు Azure OpenAI లేదా Microsoft Foundry ప్రాజెక్ట్ను టార్గెట్ చేయండి. తాజా మోడల్ క్యాటలాగ్ మరియు ప్లాట్ఫారమ్ మద్దతు కోసం Foundry Local డాక్యుమెంటేషన్ చూడండి.
పాఠం 8 లోని షరతుల ప్రేరిత పని పుస్తకం Microsoft Foundry ద్వారా Bing గ్రౌండింగ్ ను ఉపయోగిస్తుంది. మీరు ఆ నమూనాను నడపాలని ప్లాన్ చేస్తే, ఈ వేరియబుల్ ను మీ .env ఫైల్లో జోడించండి:
| వేరియబుల్ | ఎక్కడ కనుగొనాలి |
|---|---|
BING_CONNECTION_ID |
Microsoft Foundry పోర్టల్ → మీ ప్రాజెక్ట్ → Management → Connected resources → మీ Bing కనెక్షన్ → కనెక్షన్ IDని కాపీ చేయండి |
మీరు macOS పై ఉంటే మరియు క్రింది లాంటి లోపాన్ని ఎదుర్కుంటే:
ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self-signed certificate in certificate chain
ఇది macOSపై Pythonకి సంబంధించిన తెలిసిన సమస్య, ఎక్కడ సిస్టమ్ SSL సర్టిఫికెట్లను ఆటోమేటిక్గా నమ్మదు. కింది పరిష్కారాలను క్రమంగా ప్రయత్నించండి:
వికల్పం 1: Python యొక్క Install Certificates స్క్రిప్ట్ ని నడపండి (సిఫారసు చేయబడింది)
# మీ ఇన్స్టాల్ చేసిన Python వెర్షన్తో 3.XX ను మార్చండి (ఉదా., 3.12 లేదా 3.13):
/Applications/Python\ 3.XX/Install\ Certificates.command
వికల్పం 2: మీ నోట్బుక్లో connection_verify=False ఉపయోగించండి (GitHub Models నోట్బుక్స్ కోసం మాత్రమే)
పాఠం 6 నోట్బుక్ (06-building-trustworthy-agents/code_samples/06-system-message-framework.ipynb) లో, ఒక వ్యాఖ్యాన చేస్త ఉన్న వర్క్ అరౌండ్ ఇప్పటికే ఉంది. క్లయింట్ సృష్టిస్తున్నప్పుడు connection_verify=False ను వ్యాఖ్యా లేకుండా చేయండి:
client = ChatCompletionsClient(
endpoint=endpoint,
credential=AzureKeyCredential(token),
connection_verify=False, # సర్టిఫికెట్ లోపాలు ఎదురైనప్పుడు SSL నిర్ధారణను డిసేబుల్ చేయండి
)
⚠️ హెచ్చరిక: SSL ధృవీకరణను నిష్క్రియం చేయడం (
connection_verify=False) సర్టిఫికెట్ చెల్లింపును ఎగవేసి భద్రతను తగ్గిస్తుంది. దీన్ని డెవలప్మెంట్ వాతావరణాల్లో తాత్కాలిక పరిష్కారంగా మాత్రమే ఉపయోగించండి, ఉత్పత్తి వాతావరణంలో ఎప్పుడూ కాదు.
వికల్పం 3: truststore ని ఇన్స్టాల్ చేసి ఉపయోగించండి
pip install truststore
ఆపై మీ నోట్బుక్ లేదా స్క్రిప్ట్ లో ఎటువంటి నెట్వర్క్ కాల్స్ జరగక ముందు క్రింద చెప్పినది జత చేయండి:
import truststore
truststore.inject_into_ssl()
ఈ సెటప్ నడపడంలో మీకు ఏదైనా సమస్యలు ఉంటే, మా Azure AI Community Discord లో చేరండి లేదా ఒక ఇష్యూ సృష్టించండి.
మీరు ఇప్పుడు ఈ కోర్సు కోసం కోడ్ నడపడానికి సిద్ధంగా ఉన్నారు. AI ఏజెంట్స్ ప్రపంచం గురించి మరింత నేర్చుకోవడానికి సంతోషంగా ఉండండి!
AI ఏజెంట్స్ మరియు ఏజెంట్ ఉపయోగ సందర్భాలకి పరిచయం
అస్వీకరణ: ఈ పత్రం AI అనువాద సేవ Co-op Translator ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నిస్తున్నప్పటికీ, ఆటోమేటెడ్ అనువాదాలు తప్పులు లేదా అసమగ్రతలను కలిగి ఉండవచ్చు. దాని స్వదేశ భాషలో ఉన్న అసలు పత్రాన్ని అధికారం కలిగిన మూలంగా పరిగణించాలి. కీలకమైన సమాచారం కోసం, ప్రొఫెషనల్ మానవ అనువాదాన్ని సిఫారసు చేస్తాము. ఈ అనువాదం ఉపయోగం వల్ల కలిగే ఏవైనా అపార్థాలు లేదా తప్పుదారులు కోసం మేము బాధ్యత వహించము.