Nastavenie vývojového prostredia pre Azure AI Foundry

July 2, 2026 · View on GitHub

Tento sprievodca nastavuje modely Azure AI Foundry pre Java AI aplikácie v tomto kurze pomocou overovania bez kľúčov (Microsoft Entra ID) — nie je potrebné spravovať žiadne API kľúče. Ste nováčik v nástrojoch? Začnite so sprievodcom vývojovým prostredím.

Tento sprievodca nastavuje modely Azure AI Foundry pre Java AI aplikácie v tomto kurze. Máte dve možnosti:

  • Možnosť A — Provisionovanie pomocou azd + Bicep (odporúčané): jeden príkaz nasadí Foundry účet a modely ako kód. Žiadne klikanie v portáli.
  • Možnosť B — Vytvorte zdroje manuálne v portáli Azure AI Foundry.

Obe možnosti používajú overovanie bez kľúčov (Microsoft Entra ID) — nie je potrebné kopírovať alebo zverejňovať API kľúče.

Obsah

Čo sa vytvorí

Bicep šablóny v priečinku infra/ vytvoria:

  • Azure AI Foundry účet (Microsoft.CognitiveServices/accounts, typ AIServices) s projektom
  • Nasadenie chat — gpt-4o-mini
  • Nasadenie embedding — text-embedding-3-small (použité v neskorších kapitolách)
  • Priradenie role bez kľúča (Cognitive Services OpenAI User), aby ste sa mohli prihlasovať cez az login namiesto správy kľúčov

Požiadavky

Možnosť A: Provisionovanie pomocou azd + Bicep (odporúčané)

Zo zložky 02-SetupDevEnvironment:

cd 02-SetupDevEnvironment

# Prihlásiť sa (oba nástroje)
azd auth login
az login

# Poskytnite účet Foundry + nasadenie modelov
azd up

azd vás vyzve na zadanie názvu prostredia (napríklad genai-java) a regiónu. Vyberte región, kde sú dostupné gpt-4o-mini a text-embedding-3-small — napríklad eastus2 alebo swedencentral.

Po dokončení provisionovania azd:

  1. Nasadí všetko definované v infra/main.bicep.
  2. Spustí postprovision hook, ktorý zapíše examples/basic-chat-azure/.env s vašou koncovou adresou a názvami nasadení (žiadne tajné údaje).

Tip: Kedykoľvek spusťte znova azd up na aplikovanie zmien. Spustením azd down všetko zmažete a zastavíte generovanie nákladov.

Ak chcete vidieť vygenerované nastavenia:

azd env get-values

Teraz preskočte na Otestujte nastavenie.

Možnosť B: Vytvorte zdroje manuálne

Uprednostňujete portál? Vytvorte zdroje manuálne:

  1. Prejdite na Azure AI Foundry portál a prihláste sa.
  2. Vytvorte projekt (tým sa vytvorí aj zdroj AI Foundry). Pomenujte ho napríklad GenAIJava.
  3. Vo svojom projekte otvorte Models + endpoints → Deploy model → Deploy base model.
  4. Nasadte gpt-4o-mini (názov nasadenia gpt-4o-mini). Rovnaký postup pre text-embedding-3-small, ak chcete použiť príklady s embeddingom.
  5. Z Overview skopírujte endpoint (napríklad https://<resource>.openai.azure.com/).
  6. Pridajte si prístup bez kľúča: na zdroji otvorte Access control (IAM) → Add role assignment → priraďte Cognitive Services OpenAI User svojmu účtu.

Máte stále problémy? Pozrite si dokumentáciu Azure AI Foundry.

Nastavte svoje prostredie

Ak ste použili Možnosť A (azd up), váš súbor s nastaveniami je už vytvorený — nie je potrebné nič nastavovať. Preskočte na Otestujte nastavenie.

Ak ste použili Možnosť B (manuálne), vytvorte si súbor .env z príkladu sami:

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

Upravte .env so svojou koncovou adresou (bez kľúča — autentifikácia je bez kľúča):

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

Bezpečnostná poznámka: Nie je potrebné ukladať žiadny API kľúč. Autentifikujete sa cez Microsoft Entra ID pomocou az login (lokálne) alebo spravovanú identitu (v Azure). Súbor .env obsahuje iba ne-tajné nastavenia a je už zahrnutý v .gitignore.

Otestujte nastavenie

Uistite sa, že ste prihlásení, aby overovanie bez kľúča mohlo získať token, potom spustite príklad:

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

az login          # ak ešte nie ste prihlásený
mvn clean spring-boot:run

Mali by ste vidieť odpoveď z modelu gpt-4o-mini!

Používatelia VS Code: Stlačte F5 na spustenie. Aplikácia automaticky načíta váš .env.

Úplný príklad: Podrobnosti a riešenie problémov nájdete v Basic Chat s Azure AI Foundry príklade.

Čo je ďalej?

Nastavenie dokončené! Teraz máte:

  • Azure AI Foundry s nasadenými gpt-4o-mini a text-embedding-3-small
  • Overovanie bez kľúča (Microsoft Entra ID) — žiadne kľúče na správu
  • Lokálny .env so svojou koncovou adresou a názvami nasadení
  • Vývojové prostredie Java pripravené na použitie

Pokračujte na Kapitolu 3: Základné techniky generatívnej AI pre začiatok vývoja AI aplikácií!

Zdroje

Ďalšie zdroje

Vyhlásenie o zodpovednosti: Tento dokument bol preložený pomocou AI prekladateľskej služby Co-op Translator. Hoci sa snažíme o presnosť, vezmite prosím na vedomie, že automatické preklady môžu obsahovať chyby alebo nepresnosti. Pôvodný dokument v jeho natívnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre kritické informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za žiadne nedorozumenia alebo nesprávne interpretácie vyplývajúce z použitia tohto prekladu.