Arenduskeskkonna seadistamine Azure AI Foundry jaoks

July 2, 2026 · View on GitHub

See juhend seab selle kursuse Java AI rakenduste jaoks üles Azure AI Foundry mudelid, kasutades võtmeta autentimist (Microsoft Entra ID) — pole vaja API võtmeid hallata. Oled tööriistadega uus? Alusta arenduskeskkonna juhendist.

See juhend seab selle kursuse Java AI rakenduste jaoks üles Azure AI Foundry mudelid. Sul on kaks võimalust:

  • Variant A — Provisioneeri azd + Bicep abil (soovitatav): üks käsklus viib läbi Foundry konto ja mudelite saidi loomise koodi abil. Ei mingit portaalis klõpsimist.
  • Variant B — Loo ressursid käsitsi Azure AI Foundry portaali kaudu.

Mõlemad teed kasutavad võtmeta autentimist (Microsoft Entra ID) — pole API võtmeid, mida kopeerida ega lekkida.

Sisukord

Mida luuakse

infra/ Bicep mallid loovad:

  • Azure AI Foundry konto (Microsoft.CognitiveServices/accounts, tüüp AIServices) koos projektiga
  • vestlus juurutuse — gpt-4o-mini
  • embedimise juurutuse — text-embedding-3-small (kasutatakse hilisemates peatükkides)
  • võtmeta rolli määramise (Cognitive Services OpenAI User), mis võimaldab sisselogimist az login kaudu võtmete haldamise asemel

Eeltingimused

Variant A: Provisioneeri azd + Bicep abil (Soovitatav)

Kaustast 02-SetupDevEnvironment:

cd 02-SetupDevEnvironment

# Logi sisse (mõlemad tööriistad)
azd auth login
az login

# Hangi Foundry konto ja mudelite juurutused
azd up

azd küsib keskkonna nime (näiteks genai-java) ja regiooni. Vali piirkond, kus on saadaval gpt-4o-mini ja text-embedding-3-small — näiteks eastus2 või swedencentral.

Kui provisioneerimine lõppeb, teeb azd:

  1. Juurutab kõik, mis on defineeritud infra/main.bicep failis.
  2. Käivitab postprovisioneerimise hook’i, mis kirjutab faili examples/basic-chat-azure/.env koos sinu lõpp-punkti ja juurutuste nimedega (ilma saladusteta).

Nipp: Käivita azd up uuesti iga kord muudatuste rakendamiseks. Kustuta kõik ja lõpeta kulutamine käsuga azd down.

Sätteid nägemiseks:

azd env get-values

Nüüd liigu edasi testi oma seadistust.

Variant B: Loo ressursid käsitsi

Eelistad portaali? Loo ressursid käsitsi:

  1. Mine Azure AI Foundry portaali ja logi sisse.
  2. Loo projekt (see loob ka AI Foundry ressursi). Anna sellele nimi, näiteks GenAIJava.
  3. Projektis ava Models + endpoints → Deploy model → Deploy base model.
  4. Juuruta gpt-4o-mini (juurutuse nimi gpt-4o-mini). Korda protseduuri text-embedding-3-small jaoks, kui soovid embedimise näiteid.
  5. Ava Overview, kopeeri lõpp-punkt (näiteks https://<resource>.openai.azure.com/).
  6. Anna endale võtmeta ligipääs: ava ressursil Juurdepääsu juhtimine (IAM) → Lisa rolli määramine → lisa roll Cognitive Services OpenAI User oma kontole.

Probleemid jätkuvad? Vaata Azure AI Foundry dokumentatsiooni.

Seadista oma keskkond

Kui kasutasid varianti A (azd up), on sinu seaded juba olemas — pole midagi lisaks seadistada. Liigu edasi testi oma seadistust.

Kui kasutasid varianti B (käsitsi), loo näite .env fail ise:

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

Redigeeri .env faili oma lõpp-punktiga (ilma võtmeta — autentimine on võtmeta):

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

Turvalisuse märkus: API võtit pole vaja salvestada. Autentid Microsoft Entra ID abil kas az login kaudu (kohapeal) või hallatud identiteediga (Azure’is). .env fail sisaldab ainult mitte-saladuslikke sätteid ja on juba .gitignore failiga kaetud.

Testi oma seadistust

Veendu, et oled sisse logitud, et võtmeta autentimine saaks tokeni ja käivita näide:

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

az login          # kui te pole veel sisse logitud
mvn clean spring-boot:run

Peaksid nägema vastust mudelilt gpt-4o-mini!

VS Code kasutajatele: Vajuta F5, et käivitada. Rakendus laadib sinu .env automaatselt.

Täielik näide: Vaata Basic Chat with Azure AI Foundry näidet detailide ja veaotsingu jaoks.

Mis järgmiseks?

Seadistamine on lõpetatud! Sul on nüüd:

  • Azure AI Foundry koos gpt-4o-mini ja text-embedding-3-small mudelitega juurutatud
  • Võtmeta autentimine (Microsoft Entra ID) — pole võtmete haldamist
  • Kohalik .env sinu lõpp-punktide ja juurutuste nimedega
  • Java arenduskeskkond valmis kasutamiseks

Jätka peatüki 3 juurde: Core Generative AI Techniques, et alustada AI rakenduste loomist!

Ressursid

Lisamaterjalid

Lahtiütlus: See dokument on tõlgitud kasutades AI tõlketeenust Co-op Translator. Kuigi me püüdleme täpsuse poole, palun pange tähele, et automatiseeritud tõlgetes võib esineda vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlkega seotud eksimustest või valesti mõistmistest.