راه‌اندازی محیط توسعه برای Azure AI Foundry

July 2, 2026 · View on GitHub

این راهنما مدل‌های Azure AI Foundry را برای برنامه‌های جاوای هوش مصنوعی در این دوره با استفاده از احراز هویت بدون کلید (Microsoft Entra ID) تنظیم می‌کند — بدون نیاز به مدیریت کلیدهای API. به ابزارها تازه واردید؟ با راهنمای محیط توسعه شروع کنید.

این راهنما مدل‌های Azure AI Foundry را برای برنامه‌های جاوای هوش مصنوعی در این دوره تنظیم می‌کند. شما دو مسیر دارید:

  • گزینه A — راه‌اندازی با azd + Bicep (توصیه شده): با یک دستور حساب Foundry و مدل‌ها را به عنوان کد مستقر می‌کند. بدون کلیک در پرتال.
  • گزینه B — ایجاد منابع به صورت دستی در پرتال Azure AI Foundry.

هر دو مسیر از احراز هویت بدون کلید (Microsoft Entra ID) استفاده می‌کنند — نیازی به کپی یا افشای کلیدهای API نیست.

فهرست مطالب

چه مواردی ایجاد می‌شوند

قالب‌های Bicep در infra/ موارد زیر را فراهم می‌کنند:

  • یک حساب Azure AI Foundry (Microsoft.CognitiveServices/accounts، نوع AIServices) با یک پروژه
  • یک استقرار گفتگو — gpt-4o-mini
  • یک استقرار تعبیه — text-embedding-3-small (در فصل‌های بعدی استفاده می‌شود)
  • یک تخصیص نقش بدون کلید (Cognitive Services OpenAI User) تا به جای مدیریت کلیدها با az login وارد شوید

پیش‌نیازها

گزینه A: راه‌اندازی با azd + Bicep (توصیه شده)

از پوشه 02-SetupDevEnvironment:

cd 02-SetupDevEnvironment

# ورود به سیستم (هر دو ابزار)
azd auth login
az login

# فراهم‌سازی حساب Foundry + استقرار مدل‌ها
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. دسترسی بدون کلید به خود بدهید: در منبع، به 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 را با نقطه انتهایی خود ویرایش کنید (بدون کلید — احراز هویت بدون کلید است):

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

توجه امنیتی: کلید API برای ذخیره وجود ندارد. شما با Microsoft Entra ID از طریق az login (محلی) یا یک هویت مدیریتی (در Azure) احراز هویت می‌کنید. فایل .env فقط تنظیمات غیرمحرمانه را نگه می‌دارد و در .gitignore لحاظ شده است.

آزمون تنظیمات شما

مطمئن شوید وارد شده‌اید تا احراز هویت بدون کلید بتواند توکن دریافت کند، سپس نمونه را اجرا کنید:

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

az login          # اگر هنوز وارد نشده‌اید
mvn clean spring-boot:run

باید پاسخی از مدل gpt-4o-mini ببینید!

کاربران VS Code: برای اجرا F5 را فشار دهید. برنامه فایل .env شما را به طور خودکار بارگیری می‌کند.

نمونه کامل: برای جزئیات و رفع اشکال به مثال گفتگوی پایه با Azure AI Foundry مراجعه کنید.

بعدی چیست؟

راه‌اندازی کامل شد! شما اکنون دارید:

  • Azure AI Foundry با gpt-4o-mini و text-embedding-3-small مستقر شده
  • احراز هویت بدون کلید (Microsoft Entra ID) — بدون کلید برای مدیریت
  • یک فایل محلی .env با نقطه انتهایی و نام‌های استقرار
  • یک محیط توسعه جاوا آماده به کار

ادامه دهید به فصل ۳: تکنیک‌های اصلی هوش مصنوعی مولد برای شروع ساخت برنامه‌های هوش مصنوعی!

منابع

منابع اضافی

سلب مسئولیت: این سند با استفاده از سرویس ترجمه هوش مصنوعی Co-op Translator ترجمه شده است. در حالی که ما در تلاش برای دقت هستیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است شامل خطاها یا نادرستی‌هایی باشند. سند اصلی به زبان مادری خود باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حیاتی، ترجمه حرفه‌ای انسانی توصیه می‌شود. ما در قبال هرگونه سوء تفاهم یا برداشت نادرست ناشی از استفاده از این ترجمه مسئولیتی نداریم.