Azure AI Foundry کے لیے ترقیاتی ماحول مرتب کرنا

July 2, 2026 · View on GitHub

یہ رہنما اس کورس میں جاوا AI ایپس کے لیے Azure AI Foundry ماڈلز کو keyless تصدیق (Microsoft Entra ID) کے استعمال سے سیٹ اپ کرتا ہے — کوئی API کیز منیج کرنے کی ضرورت نہیں۔ ٹولنگ کے بارے میں نیا ہیں؟ ترقیاتی ماحول کی رہنما سے شروع کریں۔

یہ رہنما اس کورس میں جاوا AI ایپس کے لیے Azure AI Foundry ماڈلز کو سیٹ اپ کرتا ہے۔ آپ کے پاس دو راستے ہیں:

  • آپشن A — azd + Bicep کے ساتھ پرویژنس کریں (تجویز کردہ): ایک کمانڈ سے Foundry اکاؤنٹ اور ماڈلز کو بطور کوڈ ڈیپلائے کرتا ہے۔ کوئی پورٹل کلک کرنے کی ضرورت نہیں۔
  • آپشن B — Azure AI Foundry پورٹل میں دستی طور پر وسائل بنائیں۔

دونوں راستے keyless تصدیق (Microsoft Entra ID) استعمال کرتے ہیں — کوئی API کیز کاپی یا لیک نہیں ہوں گی۔

فہرست مضامین

کیا بنایا جاتا ہے

infra/ میں موجود Bicep ٹیمپلیٹس درج ذیل چیزیں فراہم کرتے ہیں:

  • ایک Azure AI Foundry اکاؤنٹ (Microsoft.CognitiveServices/accounts, قسم AIServices) جس میں ایک پروجیکٹ
  • ایک چیٹ ڈیپلائمنٹ — gpt-4o-mini
  • ایک ایمبیڈنگ ڈیپلائمنٹ — text-embedding-3-small (جو بعد کے ابواب میں استعمال ہوگی)
  • ایک keyless رول تفویض (Cognitive Services OpenAI User) تاکہ آپ az login کے ذریعے سائن ان کریں بغیر کیز کے انتظام کے

ضروریات

آپشن A: azd + Bicep کے ساتھ پرویژنس (تجویز کردہ)

02-SetupDevEnvironment فولڈر سے:

cd 02-SetupDevEnvironment

# سائن ان کریں (دونوں ٹولز)
azd auth login
az login

# فاؤنڈری اکاؤنٹ + ماڈل کی تعیناتی فراہم کریں
azd up

azd آپ سے ایک ماحول کا نام (مثلاً genai-java) اور ایک علاقہ پوچھتا ہے۔ ایسا علاقہ منتخب کریں جہاں gpt-4o-mini اور text-embedding-3-small دستیاب ہوں — مثلاً eastus2 یا swedencentral۔

پرویژنس مکمل ہونے پر، azd:

  1. سب کچھ جو infra/main.bicep میں ڈیفائن کیا گیا ہے، ڈیپلائے کرتا ہے۔
  2. ایک پوسٹ پروویژن ہک چلتا ہے جو آپ کے اینڈپوائنٹ اور ڈیپلائمنٹ ناموں کے ساتھ examples/basic-chat-azure/.env لکھتا ہے (کوئی سیکریٹس نہیں)۔

مشورہ: تبدیلیوں کو لاگو کرنے کے لیے کسی بھی وقت azd up دوبارہ چلائیں۔ سب کچھ حذف کرنے اور خرچ روکنے کے لیے azd down چلائیں۔

بنائی گئی ترتیبات دیکھنے کے لیے:

azd env get-values

اب اپنے سیٹ اپ کی جانچ کریں پر جائیں۔

آپشن B: دستی طور پر وسائل بنائیں

پورٹل استعمال کرنا پسند ہے؟ تو وسائل خود بنائیں:

  1. Azure AI Foundry پورٹل پر جائیں اور سائن ان کریں۔
  2. پروجیکٹ بنائیں (یہ AI Foundry ریسورس بھی بناتا ہے)۔ اسے GenAIJava جیسا کوئی نام دیں۔
  3. اپنے پروجیکٹ میں، Models + endpoints → Deploy model → Deploy base model کھولیں۔
  4. gpt-4o-mini (ڈیپلائمنٹ نام gpt-4o-mini) کو ڈیپلائے کریں۔ اگر ایمبیڈنگ کی مثالیں چاہییں تو text-embedding-3-small کے لیے بھی یہی کریں۔
  5. Overview سے endpoint کاپی کریں (مثلاً https://<resource>.openai.azure.com/)۔
  6. خود کو keyless رسائی دیں: ریسورس پر جائیں، Access control (IAM) → Add role assignment → Cognitive Services OpenAI User کو اپنے اکاؤنٹ کو تفویض کریں۔

ابھی بھی مسئلہ ہے؟ Azure AI Foundry کی دستاویزات دیکھیں۔

اپنا ماحول ترتیب دیں

اگر آپ نے آپشن A (azd up) استعمال کیا ہے تو آپ کی سیٹنگ فائل پہلے ہی لکھی جا چکی ہے — ترتیب دینے کی ضرورت نہیں۔ اپنے سیٹ اپ کی جانچ کریں پر جائیں۔

اگر آپ نے آپشن B (دستی) استعمال کیا ہے تو مثال کا .env فائل خود بنائیں:

cd 02-SetupDevEnvironment/examples/basic-chat-azure
cp .env.example .env

اپنے اینڈپوائنٹ کے ساتھ .env ایڈیٹ کریں (کوئی کی نہیں — تصدیق keyless ہے):

AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT=gpt-4o-mini

سیکورٹی نوٹ: کوئی API کی اسٹور کرنے کی ضرورت نہیں۔ آپ Microsoft Entra ID کے ذریعے az login (لوکل) یا managed identity (Azure میں) سے تصدیق کرتے ہیں۔ .env میں صرف غیر خفیہ ترتیبات ہوتی ہیں اور یہ پہلے ہی .gitignore میں شامل ہے۔

اپنے سیٹ اپ کی جانچ کریں

یقینی بنائیں کہ آپ سائن ان ہیں تاکہ keyless تصدیق ٹوکن حاصل کر سکے، پھر مثال چلائیں:

cd 02-SetupDevEnvironment/examples/basic-chat-azure

az login          # اگر آپ پہلے سے سائن ان نہیں ہیں
mvn clean spring-boot:run

آپ کو gpt-4o-mini ماڈل سے ردعمل دیکھنا چاہئے!

VS Code استعمال کرنے والے: چلانے کے لیے F5 دبائیں۔ ایپ خودکار طریقے سے آپ کی .env لوڈ کر لیتی ہے۔

مکمل مثال: تفصیلات اور مسئلے حل کرنے کے لیے Basic Chat with Azure AI Foundry example دیکھیں۔

اگلا کیا ہے؟

سیٹ اپ مکمل ہو گیا! اب آپ کے پاس ہے:

  • Azure AI Foundry جس میں gpt-4o-mini اور text-embedding-3-small تعینات ہیں
  • Keyless تصدیق (Microsoft Entra ID) — کوئی کیز منیج کرنے کی ضرورت نہیں
  • ایک مقامی .env جس میں آپ کے اینڈپوائنٹ اور ڈیپلائمنٹ کے نام ہیں
  • تیار جاوا ترقیاتی ماحول

چلیں اگلے مرحلے کی طرف باب 3: کور جنریٹو AI تکنیکیں تاکہ AI ایپلیکیشنز بنانا شروع کریں!

وسائل

اضافی وسائل

ڈس کلیمر: یہ دستاویز AI ترجمہ سروس Co-op Translator کے ذریعے ترجمہ کی گئی ہے۔ جبکہ ہم درستگی کے لیے کوشاں ہیں، براہ کرم اس بات سے آگاہ رہیں کہ خودکار ترجمے میں غلطیاں یا عدم درستیاں ہو سکتی ہیں۔ اصل دستاویز اپنے مادری زبان میں مستند ماخذ سمجھی جائے گی۔ حساس معلومات کے لیے پیشہ ور انسانی ترجمہ کی سفارش کی جاتی ہے۔ اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تشریح کی ذمہ داری ہم قبول نہیں کرتے۔