Kehitysympäristön perustaminen Generative AI:ta varten Java-kielellä

July 2, 2026 · View on GitHub

Pika-aloitus: Ota AI-mallit käyttöön Azure AI Foundryssa koodina Bicepillä + azd:llä muutamassa minuutissa — katso Azure AI Foundry -aloitusopas. Todennus on avaimetonta (Microsoft Entra ID), joten hallittavaa API-avainta ei ole.

Mitä Opit

Java-kehitysympäristön pystyttäminen AI-sovelluksia varten
Kehitysympäristön valinta ja konfigurointi (pilvipohjainen Codespaces, paikallinen dev container tai täydellinen paikallinen asennus)
Asetuksen testaaminen yhdistämällä Azure AI Foundry -malliin

Tässä luvussa ohjaamme sinua läpi kehitysympäristön perustamisen. Käytämme koko kurssin ajan Azure AI Foundrya malleihin. Otat mallit käyttöön koodina Bicepillä ja Azure Developer CLI:llä (azd), ja yhdistät avaimettomalla todennuksella (Microsoft Entra ID) — ei kopioitavia tai vuotavia API-avaimia.

Paikallista asennusta ei tarvita! Voit käyttää GitHub Codespacesia, joka tarjoaa täyden kehitysympäristön suoraan selaimessasi ja ottaa Foundryn käyttöön sieltä.

Käytämme tätä kurssia varten Azure AI Foundrya, koska se on:

Koodina käyttöön otettava — yksi azd up ottaa käyttöön tilin ja mallin käyttöönotot
Avaimeton — kirjaudu Azure-tunnuksellasi tai hallitulla identiteetillä
Tuotantovalmiina — sama koodi toimii paikallisesti ja Azuressa
Joustava — vaihda mallia muuttamalla käyttöönoton nimeä, ei koodia

Huomautus: Azure AI Foundryn käyttöönotosta veloitetaan token-pohjaisesti (pay-as-you-go). Katso Azure AI Foundryn käyttöönotto-opas käyttöönottovaiheet, aluevalinnat ja kustannustiedot.

Vaihe 1: Kehitysympäristön Pystyttäminen

Olemme luoneet valmiiksi konfiguroidun kehityskontin, joka minimoi asetusaikaa ja varmistaa, että sinulla on kaikki tarvittavat työkalut tälle Generative AI for Java -kurssille. Valitse haluamasi kehitystapa:

Ympäristön pystytysvaihtoehdot:

Vaihtoehto A: GitHub Codespaces (Suositeltu)

Aloita koodaus 2 minuutissa – ei paikallista asennusta!

Forkkaa tämä repositorio GitHub-tilillesi

Huom: Jos haluat muokata perusasetuksia, tutustu Dev Container Configuration -tiedostoon
Klikkaa Code → Codespaces -välilehti → Klikkaa ... → New with options...
Käytä oletusasetuksia – tämä valitsee Dev container configuration: Generative AI Java Development Environment -mukautettu devcontainer tälle kurssille
Klikkaa Create codespace
Odota noin 2 minuuttia, että ympäristö on valmis
Jatka Vaiheeseen 2: Azure AI Foundryn Käyttöönotto

Kuvakaappaus: Create codespace -valinnat

Codespacesin hyödyt:

Ei paikallista asennusta

Toimii millä tahansa laitteella, jossa on selain

Esikonfiguroitu kaikilla työkaluilla ja riippuvuuksilla

Ilmaiset 60 tuntia per kuukausi henkilökohtaisille tileille

Yhtenäinen ympäristö kaikille oppijoille

Vaihtoehto B: Paikallinen Dev Container

Kehittäjille, jotka haluavat työskennellä paikallisesti Dockerilla

Forkkaa ja kloonaa tämä repositorio paikalliselle koneellesi

Huom: Jos haluat muokata perusasetuksia, tutustu Dev Container Configuration -tiedostoon
Asenna Docker Desktop ja VS Code
Asenna Dev Containers -laajennus VS Codeen
Avaa repositoriokansio VS Codessa
Kun kehote ilmestyy, valitse Reopen in Container (tai käytä Ctrl+Shift+P → "Dev Containers: Reopen in Container")
Odota, että kontti rakentuu ja käynnistyy
Jatka Vaiheeseen 2: Azure AI Foundryn Käyttöönotto

Kuvakaappaus: Dev container -rakennus valmis

Vaihtoehto C: Käytä Olemassa Olevaa Paikallista Asennustasi

Kehittäjille, joilla on jo Java-ympäristö

Esivaatimukset:

Java 21+
Maven 3.9+
VS Code tai haluamasi IDE

Vaiheet:

Kloonaa tämä repositorio paikalliselle koneellesi
Avaa projekti IDE:ssäsi
Jatka Vaiheeseen 2: Azure AI Foundryn Käyttöönotto

Vinkki: Jos sinulla on heikkotehoinen kone mutta haluat käyttää VS Codea paikallisesti, käytä GitHub Codespacesia! Voit yhdistää paikallisen VS Coden pilvipohjaiseen Codespaceen parhaan kokemuksen saamiseksi.

Kuvakaappaus: luotu paikallinen devcontainer-instanssi

Vaihe 2: Azure AI Foundryn Käyttöönotto

Ota kurssin AI-mallit käyttöön Azure AI Foundryyn koodina. Repositorion juurihakemistosta:

cd 02-SetupDevEnvironment
azd auth login
az login
azd up

azd kysyy ympäristön nimen ja alueen, ottaa käyttöön Azure AI Foundry -tilin gpt-4o-mini ja text-embedding-3-small -käyttöönottoineen sekä kirjoittaa päätepisteen esimerkin .env-tiedostoon — kaikki avaimettomalla todennuksella (ei API-avaimia).

Täysi läpikäynti: Katso Azure AI Foundry -aloitusopas esivaatimuksista, manuaalisesta (portaali) vaihtoehdosta, alueohjeista sekä kustannus- ja siivousohjeista.

Vaihe 3: Testaa Asetuksesi

Kun Foundry-mallit ovat valmiina, testaa yhteys esimerkkisovelluksella hakemistossa 02-SetupDevEnvironment/examples/basic-chat-azure.

Avaa terminaali kehitysympäristössäsi.

Siirry esimerkkikansioon:

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

Varmista, että olet kirjautunut sisään (avaimeton todennus tarvitsee tokenin):
```
az login
```
Jos olet suorittanut azd up, .env-tiedosto päätepisteellä on jo luotu.
Käynnistä sovellus:
```
mvn clean spring-boot:run
```

Sinun pitäisi nähdä vastaus gpt-4o-mini -mallilta.

Esimerkkikoodin Ymmärtäminen

examples/basic-chat-azure -kansiossa oleva esimerkki on Spring Boot -sovellus, joka käyttää Spring AI:ta yhdistääkseen Azure AI Foundryyn avaimettomalla todennuksella.

Mitä tämä koodi tekee:

Yhdistää Azure AI Foundryyn Azure-kirjautumistunnuksellasi (Microsoft Entra ID) — ilman API-avainta
Lähettää kehotteen gpt-4o-mini -mallille
Vastaanottaa ja näyttää AI:n vastauksen
Varmistaa että asetuksesi toimivat oikein

Avainriippuvuus (pom.xml):

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-model-azure-openai</artifactId>
</dependency>

Konfiguraatio (application.yml):

spring:
  ai:
    azure:
      openai:
        # Endpoint only - no api-key. Spring AI uses DefaultAzureCredential (keyless).
        endpoint: ${AZURE_OPENAI_ENDPOINT}
        chat:
          options:
            deployment-name: ${AZURE_OPENAI_DEPLOYMENT:gpt-4o-mini}

Yhteenveto

Hienoa! Nyt sinulla on kaikki valmiina:

Otit Azure AI Foundryn mallit käyttöön koodina Bicepillä + azd:llä
Java-kehitysympäristösi toimii (oli se sitten Codespaces, devcontainer tai paikallinen)
Yhdistit Azure AI Foundryyn avaimettomalla todennuksella (Microsoft Entra ID) — ilman API-avaimia
Testasit kaiken toimivan yksinkertaisella esimerkillä, joka kommunikoi mallisi kanssa

Seuraavat Askeleet

Luku 3: Keskeiset Generative AI -tekniikat

Vianetsintä

Ongelmia? Tässä yleisimmät ongelmat ja ratkaisut:

Todennus epäonnistuu (401/403)?
- Suorita az login — todennus on avaimetonta, joten kirjaudu sisään
- Varmista, että tililläsi on Cognitive Services OpenAI User -rooli resurssissa
- Jos otit juuri käyttöön, odota hetki, että roolijako leviää
Maven ei löydy?
- Dev containereissa/Codespacessa Mavenin pitäisi olla esiasennettu
- Paikallisessa asennuksessa varmista, että Java 21+ ja Maven 3.9+ on asennettu
- Tarkista komennolla mvn --version
azd ei löydy tai käyttöönotto epäonnistuu?
- Asenna Azure Developer CLI ja suorita azd auth login
- Valitse alue, jolla gpt-4o-mini on saatavilla (esim. eastus2)
- Katso Azure AI Foundry -aloitusopas lisätiedoista
Dev container ei käynnisty?
- Varmista, että Docker Desktop on käynnissä (paikallista kehitystä varten)
- Yritä rakentaa kontti uudelleen: Ctrl+Shift+P → "Dev Containers: Rebuild Container"
Sovelluksen käännösvirheitä?
- Varmista, että olet oikeassa hakemistossa: 02-SetupDevEnvironment/examples/basic-chat-azure
- Yritä puhdistaa ja kääntää uudelleen: mvn clean compile

Tarvitsetko apua?: Jos ongelmat jatkuvat, avaa issue repositoriossa, niin autamme sinua.

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.