Generatyvinio DI kūrimo aplinkos nustatymas Java kalbai

July 2, 2026 · View on GitHub

Greitas pradėjimas: Pateikite savo DI modelius Azure AI Foundry kaip kodą naudodami Bicep + azd per kelias minutes – žr. Azure AI Foundry diegimo vadovą. Autentifikacija yra be raktų (Microsoft Entra ID), todėl API raktų valdymas nereikalingas.

Ko išmoksite

  • Sukursite Java kūrimo aplinką DI programoms
  • Pasirinksite ir sukonfigūruosite pageidaujamą kūrimo aplinką (pirmiausia debesyje su Codespaces, vietinį kūrimo konteinerį arba pilną vietinę sąranką)
  • Patikrinsite savo aplinką prisijungdami prie Azure AI Foundry modelio

Turinys

Įvadas

Šis skyrius parodys, kaip sukurti kūrimo aplinką. Šiame kurse naudosime Azure AI Foundry modeliams. Jūs pateikiate modelius kaip kodą su Bicep ir Azure Developer CLI (azd), tada jungiatės su be raktų autentifikacija (Microsoft Entra ID) – nereikia kopijuoti ar saugoti API raktų.

Vietinė sąranka nereikalinga! Galite naudoti GitHub Codespaces, kuris suteikia pilną kūrimo aplinką naršyklėje ir leidžia iš ten pateikti Foundry.

Šiam kursui naudojame Azure AI Foundry, nes jis:

  • Diegiamas kaip kodas — vienu azd up įdiegiate paskyrą ir modelių diegimus
  • Be raktų — autentifikuojatės su Azure prisijungimu arba valdomu identitetu
  • Paruoštas gamybai — tas pats kodas veikia vietoje ir Azure
  • Lankstus — pakeiskite modelius keičiant diegimo pavadinimą, o ne kodą

Pastaba: Azure AI Foundry diegimai apmokestinami už tokenus (mokate pagal naudojimą). Žr. Azure AI Foundry diegimo vadovą dėl sąrankos, regiono ir kainų.

Sukūrėme iš anksto sukonfigūruotą kūrimo konteinerį, kad sumažintume sąrankos laiką ir užtikrintume, jog turite visus reikalingus įrankius šiame Generatyvinio DI Java kursui. Pasirinkite norimą kūrimo metodą:

Aplinkos nustatymo pasirinkimai:

Pasirinkimas A: GitHub Codespaces (rekomenduojama)

Pradėkite koduoti per 2 minutes – vietinė sąranka nereikalinga!

  1. Atšakokite (fork) šį saugyklą į savo GitHub paskyrą

    Pastaba: Jei norite redaguoti bazinę konfigūraciją, peržiūrėkite Dev konteinerio konfigūraciją

  2. Spustelėkite Code → skirtuką Codespaces → ... → New with options...
  3. Naudokite numatytuosius nustatymus – pasirinktas bus Dev konteinerio konfigūracija: Generatyvinio DI Java kūrimo aplinka, sukurta specialiai šiam kursui
  4. Spustelėkite Create codespace
  5. Palaukite apie 2 minutes, kol aplinka bus paruošta
  6. Tęskite prie 2 žingsnio: Pateikite Azure AI Foundry
Ekrano kopija: Codespaces poskiltis Ekrano kopija: Naujas su parinktimis Ekrano kopija: Kurti codespace parinktis

Codespaces privalumai:

  • Vietinė diegimas nereikalingas
  • Veikia bet kuriame įrenginyje su naršykle
  • Iš anksto sukonfigūruota su visais įrankiais ir priklausomybėmis
  • Asmeninėms paskyroms 60 nemokamų valandų per mėnesį
  • Nuosekli aplinka visiems besimokantiesiems

Pasirinkimas B: Vietinis kūrimo konteineris

Skirta kūrėjams, kurie nori vietinės plėtros su Docker

  1. Atšakokite ir klonuokite šią saugyklą į savo vietinį kompiuterį

    Pastaba: Jei norite redaguoti bazinę konfigūraciją, peržiūrėkite Dev konteinerio konfigūraciją

  2. Įdiekite Docker Desktop ir VS Code
  3. Įdiekite Dev Containers plėtinį VS Code
  4. Atidarykite saugyklos aplanką VS Code
  5. Kai bus paraginta, spustelėkite Reopen in Container (arba naudokite Ctrl+Shift+P → "Dev Containers: Reopen in Container")
  6. Palaukite, kol konteineris bus sukurtas ir paleistas
  7. Tęskite prie 2 žingsnio: Pateikite Azure AI Foundry
Ekrano kopija: Dev konteinerio sąranka Ekrano kopija: Dev konteinerio kūrimas baigtas

Pasirinkimas C: Naudokite esamą vietinę diegimą

Skirta kūrėjams su esama Java aplinka

Reikalavimai:

Veiksmai:

  1. Klonuokite šią saugyklą į savo vietinį kompiuterį
  2. Atidarykite projektą savo IDE
  3. Tęskite prie 2 žingsnio: Pateikite Azure AI Foundry

Profesionalus patarimas: Jei turite silpną kompiuterį, bet norite naudoti VS Code vietoje, naudokite GitHub Codespaces! Galite prijungti savo vietinį VS Code prie debesyje išlaikomo Codespace ir turėti geriausią iš abiejų pasaulių.

Ekrano kopija: sukurtas vietinis dev konteinerio egzempliorius

2 žingsnis: Pateikite Azure AI Foundry

Diegkite kurso DI modelius į Azure AI Foundry kaip kodą. Iš saugyklos šakninio aplanko:

cd 02-SetupDevEnvironment
azd auth login
az login
azd up

azd paprašys aplinkos pavadinimo ir regiono, pateiks Azure AI Foundry paskyrą su gpt-4o-mini ir text-embedding-3-small diegimais bei įrašys galinius taškus į pavyzdžio .env — visa tai su be raktų autentifikacija (be API raktų).

Pilnas vedlys: Žr. Azure AI Foundry diegimo vadovą dėl išankstinių sąlygų, rankinio (portalo) alternatyvos, regionų ir kainų/valymo pastabų.

Kai Foundry modeliai bus įdiegti, patikrinkite ryšį su pavyzdine programa kataloge 02-SetupDevEnvironment/examples/basic-chat-azure.

  1. Atidarykite terminalą savo kūrimo aplinkoje.

  2. Eikite į pavyzdį:

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

  3. Įsitikinkite, kad esate prisijungę (be raktų autentifikacijai reikalingas žetonas):

    az login

    Jei paleidote azd up, .env failas su jūsų galiniu tašku jau buvo sukurtas.

  4. Paleiskite programą:

    mvn clean spring-boot:run

Turėtumėte pamatyti atsakymą iš gpt-4o-mini modelio.

Pavyzdinio kodo supratimas

Pavyzdys examples/basic-chat-azure yra Spring Boot programa, kuri naudoja Spring AI prisijungimui prie Azure AI Foundry su be raktų autentifikacija.

Ką daro šis kodas:

  • Jungiasi prie Azure AI Foundry su jūsų Azure prisijungimu (Microsoft Entra ID) – be API rakto
  • Siunčia užklausą gpt-4o-mini modeliui
  • Gautą atsakymą atvaizduoja
  • Tikrina, ar jūsų sąranka veikia tinkamai

Pagrindinė priklausomybė (faile pom.xml):

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

Konfigūracija (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}

Santrauka

Puiku! Dabar turite viską sukonfigūruotą:

  • Pateikėte Azure AI Foundry modelius kaip kodą su Bicep + azd
  • Paleidote Java kūrimo aplinką (Codespaces, kūrimo konteinerius ar vietinę)
  • Prisijungėte prie Azure AI Foundry su be raktų autentifikacija (Microsoft Entra ID) – be API raktų
  • Išbandėte veikimą su paprastu pavyzdžiu, kuris bendrauja su jūsų modeliu

Tolimesni veiksmai

3 skyrius: Pagrindinės generatyvinio DI technikos

Klaidų šalinimas

Turite problemų? Štai dažniausios problemos ir jų sprendimai:

  • Autentifikacija nepavyksta (401/403)?

    • Vykdykite az login – autentifikacija be raktų, todėl turite būti prisijungę
    • Patikrinkite, ar jūsų paskyra turi Cognitive Services OpenAI User rolę resurse
    • Jei ką tik pateikėte paslaugą, palaukite minutę, kol rolės priskyrimas įsigalios

  • Maven nerandamas?

    • Jei naudojate kūrimo konteinerius ar Codespaces, Maven turėtų būti iš anksto įdiegtas
    • Vietinėje sąrangoje įsitikinkite, kad įdiegta Java 21+ ir Maven 3.9+
    • Patikrinkite mvn --version

  • azd nerandamas arba diegimas nepavyksta?

  • Kūrimo konteineris nesikuria?

    • Įsitikinkite, kad Docker Desktop veikia (vietinei plėtrai)
    • Bandykite perkurti konteinerį: Ctrl+Shift+P → "Dev Containers: Rebuild Container"

  • Programos kompiliavimo klaidos?

    • Įsitikinkite, kad esate teisingame kataloge: 02-SetupDevEnvironment/examples/basic-chat-azure
    • Bandykite išvalyti ir iš naujo kompiliuoti: mvn clean compile

Reikia pagalbos?: Jei problemos nepavyksta išspręsti, atidarykite problemą repozitorijoje, mes jums padėsime.

Atsakomybės apribojimas: Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą Co-op Translator. Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba laikomas autoritetingu šaltiniu. Svarbiai informacijai rekomenduojama naudoti profesionalų žmogiškąjį vertimą. Mes neatsakome už jokius nesusipratimus ar neteisingą interpretaciją, kilusią naudojantis šiuo vertimu.