Kehitysympäristön määrittäminen Azure AI Foundrylle

July 2, 2026 · View on GitHub

Tämä opas määrittää Azure AI Foundry -mallit tämän kurssin Java AI -sovelluksille käyttäen avainvapaata todennusta (Microsoft Entra ID) — API-avaimia ei tarvitse hallita. Uusi työkaluihin? Aloita kehitysympäristöoppaasta.

Tämä opas määrittää Azure AI Foundry -mallit tämän kurssin Java AI -sovelluksille. Sinulla on kaksi vaihtoehtoa:

  • Vaihtoehto A — Provisionointi azd:llä + Bicepillä (suositeltu): yksi komento ottaa käyttöön Foundry-tilin ja mallit koodina. Ei portaalin napsuttelua.
  • Vaihtoehto B — Luo resurssit manuaalisesti Azure AI Foundry -portaalissa.

Molemmat reitit käyttävät avainvapaata todennusta (Microsoft Entra ID) — API-avaimia ei tarvitse kopioida tai vuotaa.

Sisällysluettelo

Mitä luodaan

Bicep-mallit hakemistossa infra/ provisioivat:

  • Azure AI Foundry -tilin (Microsoft.CognitiveServices/accounts, tyyppi AIServices) projektilla
  • Chatin käyttöönoton — gpt-4o-mini
  • Upotuksen käyttöönoton — text-embedding-3-small (käytetään myöhemmissä luvuissa)
  • Avainvapaan roolimäärityksen (Cognitive Services OpenAI User), jotta kirjaudut sisään az login -komennolla ilman avainten hallintaa

Ennakkoedellytykset

Vaihtoehto A: Provisionointi azd:llä + Bicepillä (suositeltu)

Kansiosta 02-SetupDevEnvironment:

cd 02-SetupDevEnvironment

# Kirjaudu sisään (molemmat työkalut)
azd auth login
az login

# Tarjoa Foundry-tili + mallien käyttöönotot
azd up

azd pyytää ympäristön nimeä (esimerkiksi genai-java) ja aluetta. Valitse alue, jolla gpt-4o-mini ja text-embedding-3-small ovat saatavilla — esimerkiksi eastus2 tai swedencentral.

Kun provisiointi on valmis, azd:

  1. Ota käyttöön kaikki, mikä on määritelty tiedostossa infra/main.bicep.
  2. Suorittaa jälkiprovisiointikoukun, joka kirjoittaa tiedoston examples/basic-chat-azure/.env päätepisteelläsi ja käyttöönoton nimillä (ei salaisuuksia).

Vinkki: Suorita azd up uudelleen milloin tahansa muutosten soveltamiseksi. Suorita azd down poistaaksesi kaiken ja lopettaaksesi kustannukset.

Näyttääksesi luodut asetukset:

azd env get-values

Siirry nyt kohtaan Testaa asennuksesi.

Vaihtoehto B: Luo resurssit manuaalisesti

Haluatko mieluummin portaalin? Luo resurssit käsin:

  1. Mene Azure AI Foundry -portaaliin ja kirjaudu sisään.
  2. Luo projekti (tämä myös luo AI Foundry -resurssin). Anna nimi, kuten GenAIJava.
  3. Avaa projektissasi Models + endpoints → Deploy model → Deploy base model.
  4. Ota käyttöön gpt-4o-mini (käyttöönoton nimi gpt-4o-mini). Toista text-embedding-3-small varten, jos haluat upotus-esimerkit.
  5. Kopioi endpoint (esim. https://<resource>.openai.azure.com/) kohdasta Overview.
  6. Myönnä itsellesi avainvapaa käyttöoikeus: resurssilla avaa Access control (IAM) → Add role assignment → määritä Cognitive Services OpenAI User tilillesi.

Onko ongelmia? Katso Azure AI Foundryn dokumentaatio.

Ympäristön konfigurointi

Jos käytit Vaihtoehtoa A (azd up), asetustiedosto on jo kirjoitettu — mitään konfiguroitavaa ei ole. Siirry kohtaan Testaa asennuksesi.

Jos käytit Vaihtoehtoa B (manuaalinen), luo esimerkin .env itse:

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

Muokkaa .env-tiedostoa päätepisteelläsi (ei avainta — todennus on avainvapaa):

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

Turvallisuushuomautus: API-avainta ei ole talletettavana. Todennat Microsoft Entra ID:llä az login -komennolla (paikallisesti) tai hallinnoidulla identiteetillä (Azuressa). .env-tiedosto sisältää vain ei-salaisia asetuksia ja on jo jätetty huomioimatta .gitignore-tiedostolla.

Testaa asennuksesi

Varmista, että olet kirjautunut sisään, jotta avainvapaa todennus saa tokenin, ja suorita esimerkki:

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

az login          # jos et ole jo kirjautunut sisään
mvn clean spring-boot:run

Näet vastauksen gpt-4o-mini-mallilta!

VS Code -käyttäjille: Paina F5 suorittaaksesi. Sovellus lataa .env-tiedoston automaattisesti.

Täydellinen esimerkki: Katso Basic Chat with Azure AI Foundry -esimerkki yksityiskohtiin ja vianmääritykseen.

Mitä seuraavaksi?

Asennus valmis! Sinulla on nyt:

  • Azure AI Foundry käyttöön otettuna gpt-4o-mini ja text-embedding-3-small-malleilla
  • Avainvapaa todennus (Microsoft Entra ID) — ei avaimia hallittavana
  • Paikallinen .env päätepisteellä ja käyttöönoton nimillä
  • Java-kehitysympäristö valmiina käytettäväksi

Jatka kohtaan Luku 3: Keskeiset generatiivisen tekoälyn tekniikat aloittaaksesi tekoälysovellusten rakentamisen!

Resurssit

Lisäresurssit

Vastuuvapauslauseke: Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, otathan huomioon, että automaattiset käännökset saattavat sisältää virheitä tai epätarkkuuksia. Alkuperäinen asiakirja sen alkuperäiskielellä on virallinen lähde. Tärkeissä asioissa suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai tulkinnoista.