Configurarea Mediului de Dezvoltare pentru Azure AI Foundry

July 2, 2026 · View on GitHub

Acest ghid configurează modelele Azure AI Foundry pentru aplicațiile Java AI din acest curs, folosind autentificare fără chei (Microsoft Entra ID) — fără chei API de gestionat. Ești nou cu această unealtă? Începe cu ghidul mediului de dezvoltare.

Acest ghid configurează modelele Azure AI Foundry pentru aplicațiile Java AI din acest curs. Ai două opțiuni:

  • Opțiunea A — Provisionare cu azd + Bicep (recomandat): o singură comandă implementează contul Foundry și modelele ca cod. Fără clicuri în portal.
  • Opțiunea B — Creează resursele manual în portalul Azure AI Foundry.

Ambele opțiuni folosesc autentificare fără chei (Microsoft Entra ID) — nu există chei API de copiat sau scurs accidental.

Cuprins

Ce se creează

Șabloanele Bicep din infra/ creează:

  • Un cont Azure AI Foundry (Microsoft.CognitiveServices/accounts, tip AIServices) cu un proiect
  • O implementare chat — gpt-4o-mini
  • O implementare embedding — text-embedding-3-small (folosită în capitolele ulterioare)
  • O atribuire de rol fără cheie (Cognitive Services OpenAI User) astfel încât să te poți autentifica cu az login în loc să gestionezi chei

Precondiții

Opțiunea A: Provisionare cu azd + Bicep (Recomandat)

Din folderul 02-SetupDevEnvironment:

cd 02-SetupDevEnvironment

# Autentificare (ambele unelte)
azd auth login
az login

# Asigură contul Foundry + implementările modelelor
azd up

azd solicită un nume de mediu (de exemplu genai-java) și o regiune. Alege o regiune unde gpt-4o-mini și text-embedding-3-small sunt disponibile — de exemplu eastus2 sau swedencentral.

Când provisioning-ul se termină, azd:

  1. Implementează tot ce este definit în infra/main.bicep.
  2. Rulează un hook post-provisionare care scrie examples/basic-chat-azure/.env cu endpoint-ul tău și numele implementărilor (fără secrete).

Sfat: Rulează din nou azd up oricând pentru a aplica modificări. Rulează azd down pentru a șterge totul și a opri acumularea costurilor.

Pentru a vedea setările generate:

azd env get-values

Acum săriți la Testarea configurației.

Opțiunea B: Creare resurse manual

Preferi portalul? Creează resursele manual:

  1. Accesează portalul Azure AI Foundry și autentifică-te.
  2. Creează un proiect (acesta creează și o resursă AI Foundry). Dă-i un nume, de exemplu GenAIJava.
  3. În proiectul tău, deschide Models + endpoints → Deploy model → Deploy base model.
  4. Implementează gpt-4o-mini (numele implementării gpt-4o-mini). Repetă pentru text-embedding-3-small dacă dorești exemplele cu embedding.
  5. Din Overview, copiază endpoint-ul (de exemplu https://<resource>.openai.azure.com/).
  6. Acordă-ți acces fără cheie: pe resursă, deschide Access control (IAM) → Add role assignment → atribuie Cognitive Services OpenAI User contului tău.

Încă ai probleme? Vezi documentația Azure AI Foundry.

Configurarea mediului

Dacă ai folosit Opțiunea A (azd up), fișierul tău de setări este deja scris — nu mai ai nimic de configurat. Sari la Testarea configurației.

Dacă ai folosit Opțiunea B (manual), creează tu fișierul .env al exemplului:

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

Editează .env cu endpoint-ul tău (fără cheie — autentificarea este fără chei):

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

Notă de securitate: Nu există nici o cheie API de stocat. Te autentifici cu Microsoft Entra ID prin az login (local) sau o identitate gestionată (în Azure). Fișierul .env conține doar setări non-secrete și este deja inclus în .gitignore.

Testarea configurației

Asigură-te că ești autentificat pentru ca autentificarea fără chei să poată obține un token, apoi rulează exemplul:

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

az login          # dacă nu sunteți deja autentificat
mvn clean spring-boot:run

Ar trebui să vezi un răspuns de la modelul gpt-4o-mini!

Utilizatori VS Code: Apasă F5 pentru a rula. Aplicația încarcă automat fișierul tău .env.

Exemplu complet: Vezi exemplul Basic Chat cu Azure AI Foundry pentru detalii și depanare.

Ce urmează?

Configurarea este completă! Acum ai:

  • Azure AI Foundry cu gpt-4o-mini și text-embedding-3-small implementate
  • Autentificare fără chei (Microsoft Entra ID) — fără chei de gestionat
  • Un .env local cu endpoint-ul și numele implementărilor tale
  • Un mediu de dezvoltare Java gata de folosit

Continuă cu Capitolul 3: Tehnici de bază în AI generativ pentru a începe să construiești aplicații AI!

Resurse

Resurse suplimentare

Declinare a responsabilității: Acest document a fost tradus folosind serviciul de traducere AI Co-op Translator. În timp ce ne străduim pentru acuratețe, vă rugăm să rețineți că traducerile automate pot conține erori sau inexactități. Documentul original în limba sa nativă trebuie considerat sursa autorizată. Pentru informații critice, se recomandă traducerea profesională realizată de un om. Nu ne asumăm responsabilitatea pentru eventualele neînțelegeri sau interpretări greșite care decurg din utilizarea acestei traduceri.