Postavljanje razvojne okoline za Azure AI Foundry

July 2, 2026 · View on GitHub

Ovaj vodič postavlja Azure AI Foundry modele za Java AI aplikacije u ovom tečaju, koristeći autentifikaciju bez ključeva (Microsoft Entra ID) — nema API ključeva za upravljanje. Novi ste u alatima? Počnite s vodičem za razvojnu okolinu.

Ovaj vodič postavlja Azure AI Foundry modele za Java AI aplikacije u ovom tečaju. Imate dva načina:

  • Opcija A — Provision s azd + Bicep (preporučeno): jedna naredba implementira Foundry račun i modele kao kod. Nema klikanja po portalu.
  • Opcija B — Ručno kreirajte resurse u Azure AI Foundry portalu.

Oba načina koriste autentifikaciju bez ključeva (Microsoft Entra ID) — nema API ključeva za kopiranje ili curenje.

Sadržaj

Što se kreira

Bicep predlošci u infra/ kreiraju:

  • Azure AI Foundry račun (Microsoft.CognitiveServices/accounts, tip AIServices) s projektom
  • chat implementaciju — gpt-4o-mini
  • embedding implementaciju — text-embedding-3-small (koristi se u kasnijim poglavljima)
  • dodjelu uloge bez ključa (Cognitive Services OpenAI User) tako da se prijavljujete s az login umjesto da upravljate ključevima

Preduvjeti

Opcija A: Provision s azd + Bicep (Preporučeno)

Iz mape 02-SetupDevEnvironment:

cd 02-SetupDevEnvironment

# Prijavite se (oba alata)
azd auth login
az login

# Osigurajte Foundry račun + implementacije modela
azd up

azd traži ime okoline (na primjer genai-java) i regiju. Odaberite regiju u kojoj su dostupni gpt-4o-mini i text-embedding-3-small — na primjer eastus2 ili swedencentral.

Kad provisioning završi, azd:

  1. Implementira sve definirano u infra/main.bicep.
  2. Pokreće postprovision hook koji zapisuje examples/basic-chat-azure/.env s vašom krajnjom točkom i imenima implementacija (bez tajni).

Savjet: Pokrenite azd up bilo kada za primjenu promjena. Pokrenite azd down da izbrišete sve i prestanete stvarati troškove.

Da vidite generirane postavke:

azd env get-values

Sada preskočite na Testirajte svoju postavu.

Opcija B: Ručno kreiranje resursa

Više volite portal? Kreirajte resurse ručno:

  1. Idite na Azure AI Foundry portal i prijavite se.
  2. Kreirajte projekt (ovo također stvara AI Foundry resurs). Dajte mu ime poput GenAIJava.
  3. U vašem projektu otvorite Models + endpoints → Deploy model → Deploy base model.
  4. Implementirajte gpt-4o-mini (ime implementacije gpt-4o-mini). Ponovite za text-embedding-3-small ako želite primjere ugradnje.
  5. Iz Pregleda, kopirajte krajnju točku (na primjer https://<resource>.openai.azure.com/).
  6. Dodijelite sebi pristup bez ključa: na resursu otvorite Access control (IAM) → Add role assignment → dodijelite Cognitive Services OpenAI User svom računu.

I dalje imate problema? Pogledajte dokumentaciju Azure AI Foundry.

Konfigurirajte svoju okolinu

Ako ste koristili Opciju A (azd up), vaša datoteka postavki je već zapisana — nema što konfigurirati. Preskočite na Testirajte svoju postavu.

Ako ste koristili Opciju B (ručno), sami napravite .env datoteku primjera:

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

Uredite .env s vašom krajnjom točkom (bez ključa — autentifikacija je bez ključa):

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

Sigurnosna napomena: Nema API ključa za pohranu. Autentificirate se s Microsoft Entra ID putem az login (lokalno) ili putem managed identity (u Azureu). .env datoteka sadrži samo postavke koje nisu tajne i već je zaštićena s .gitignore.

Testirajte svoju postavu

Provjerite jeste li prijavljeni da bi autentifikacija bez ključa mogla dohvatiti token, zatim pokrenite primjer:

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

az login          # ako već niste prijavljeni
mvn clean spring-boot:run

Trebali biste vidjeti odgovor od modela gpt-4o-mini!

Koristite li VS Code? Pritisnite F5 za pokretanje. Aplikacija automatski učitava vašu .env.

Cijeli primjer: Pogledajte Osnovni Chat s Azure AI Foundry za detalje i rješavanje problema.

Što dalje?

Postavljanje završeno! Sada imate:

  • Azure AI Foundry s implementacijama gpt-4o-mini i text-embedding-3-small
  • Autentifikaciju bez ključeva (Microsoft Entra ID) — nema ključeva za upravljanje
  • Lokalnu .env datoteku s vašom krajnjom točkom i imenima implementacija
  • Java razvojnu okolinu spremnu za rad

Nastavite na Poglavlje 3: Temeljne tehnike generativnog AI da započnete s izradom AI aplikacija!

Resursi

Dodatni resursi

Napomena: Ovaj dokument je preveden korištenjem AI prevoditeljskog servisa Co-op Translator. Iako težimo točnosti, imajte na umu da automatski prijevodi mogu sadržavati greške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za važne informacije preporuča se profesionalni ljudski prijevod. Nismo odgovorni za bilo kakva nesporazumevanja ili pogrešne interpretacije koje proizlaze iz korištenja ovog prijevoda.