Ρύθμιση του Περιβάλλοντος Ανάπτυξης για το Azure AI Foundry

July 2, 2026 · View on GitHub

Αυτός ο οδηγός ρυθμίζει τα μοντέλα Azure AI Foundry για τις εφαρμογές Java AI αυτού του μαθήματος, χρησιμοποιώντας αυθεντικοποίηση χωρίς κλειδί (Microsoft Entra ID) — χωρίς να χρειάζεται να διαχειρίζεστε κλειδιά API. Καινούργιος στα εργαλεία; Ξεκινήστε με τον οδηγό περιβάλλοντος ανάπτυξης.

Αυτός ο οδηγός ρυθμίζει τα μοντέλα Azure AI Foundry για τις εφαρμογές Java AI αυτού του μαθήματος. Έχετε δύο επιλογές:

  • Επιλογή Α — Παροχή με azd + Bicep (συνιστάται): μία εντολή αναπτύσσει τον λογαριασμό Foundry και τα μοντέλα ως κώδικα. Χωρίς κλικ στο portal.
  • Επιλογή Β — Δημιουργία πόρων χειροκίνητα στο portal του Azure AI Foundry.

Και οι δύο τρόποι χρησιμοποιούν αυθεντικοποίηση χωρίς κλειδί (Microsoft Entra ID) — δεν υπάρχουν κλειδιά API για αντιγραφή ή διαρροή.

Πίνακας Περιεχομένων

Τι Δημιουργείται

Τα πρότυπα Bicep στον φάκελο infra/ παρέχουν:

  • Λογαριασμό Azure AI Foundry (Microsoft.CognitiveServices/accounts, τύπος AIServices) με ένα έργο
  • Μια ανάπτυξη chat — gpt-4o-mini
  • Μια ανάπτυξη embedding — text-embedding-3-small (χρησιμοποιείται σε επόμενα κεφάλαια)
  • Μια ανάθεση ρόλου χωρίς κλειδί (Cognitive Services OpenAI User) ώστε να συνδεθείτε με az login αντί να διαχειρίζεστε κλειδιά

Προαπαιτούμενα

Επιλογή Α: Παροχή με azd + Bicep (Συνιστάται)

Από τον φάκελο 02-SetupDevEnvironment:

cd 02-SetupDevEnvironment

# Συνδεθείτε (και τα δύο εργαλεία)
azd auth login
az login

# Παρέχετε τον λογαριασμό Foundry + αναπτύξεις μοντέλων
azd up

Η εντολή azd ζητά ένα όνομα περιβάλλοντος (π.χ. genai-java) και μια περιοχή. Επιλέξτε μια περιοχή όπου είναι διαθέσιμα τα gpt-4o-mini και text-embedding-3-small — για παράδειγμα eastus2 ή swedencentral.

Όταν ολοκληρωθεί η παροχή, το azd:

  1. Αναπτύσσει όλα όσα ορίζονται στο infra/main.bicep.
  2. Εκτελεί ένα postprovision hook που γράφει το examples/basic-chat-azure/.env με το endpoint και τα ονόματα ανάπτυξης (χωρίς μυστικά).

Συμβουλή: Εκτελέστε ξανά azd up οποτεδήποτε για να εφαρμόσετε αλλαγές. Τρέξτε azd down για να διαγράψετε τα πάντα και να σταματήσετε να επιβαρύνεστε οικονομικά.

Για να δείτε τις ρυθμίσεις που δημιουργήθηκαν:

azd env get-values

Τώρα πηγαίνετε στο Δοκιμή της Ρύθμισής σας.

Επιλογή Β: Δημιουργία Πόρων Χειροκίνητα

Προτιμάτε το portal; Δημιουργήστε τους πόρους χειροκίνητα:

  1. Μεταβείτε στο portal Azure AI Foundry και συνδεθείτε.
  2. Δημιουργήστε ένα έργο (αυτό δημιουργεί επίσης έναν πόρο AI Foundry). Δώστε του ένα όνομα όπως GenAIJava.
  3. Στο έργο σας, ανοίξτε Models + endpoints → Deploy model → Deploy base model.
  4. Αναπτύξτε το gpt-4o-mini (όνομα ανάπτυξης gpt-4o-mini). Επαναλάβετε για το text-embedding-3-small αν θέλετε τα παραδείγματα embedding.
  5. Από την Επισκόπηση, αντιγράψτε το endpoint (π.χ. https://<resource>.openai.azure.com/).
  6. Δώστε στον εαυτό σας πρόσβαση χωρίς κλειδί: στον πόρο, ανοίξτε Έλεγχος πρόσβασης (IAM) → Προσθήκη ανάθεσης ρόλου → αναθέστε Cognitive Services OpenAI User στον λογαριασμό σας.

Ακόμη έχετε πρόβλημα; Δείτε την τεκμηρίωση Azure AI Foundry.

Ρύθμιση του Περιβάλλοντός σας

Αν χρησιμοποιήσατε την Επιλογή Α (azd up), το αρχείο ρυθμίσεών σας έχει ήδη γραφτεί — δεν χρειάζεται καμία περαιτέρω ρύθμιση. Παραλείψτε και πηγαίνετε στο Δοκιμή της Ρύθμισής σας.

Αν χρησιμοποιήσατε την Επιλογή Β (χειροκίνητα), δημιουργήστε μόνοι σας το αρχείο .env του παραδείγματος:

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

Επεξεργαστείτε το .env με το endpoint σας (χωρίς κλειδί — η αυθεντικοποίηση είναι χωρίς κλειδί):

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

Σημείωση ασφάλειας: Δεν υπάρχει κλειδί API να αποθηκεύσετε. Αυθεντικοποιείστε μέσω Microsoft Entra ID με az login (τοπικά) ή με managed identity (στο Azure). Το αρχείο .env περιέχει μόνο μη μυστικές ρυθμίσεις και καλύπτεται ήδη από .gitignore.

Δοκιμή της Ρύθμισής σας

Βεβαιωθείτε ότι είστε συνδεδεμένοι ώστε η αυθεντικοποίηση χωρίς κλειδί να λάβει ένα token, και στη συνέχεια τρέξτε το παράδειγμα:

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

az login          # αν δεν έχετε ήδη συνδεθεί
mvn clean spring-boot:run

Θα πρέπει να δείτε μια απόκριση από το μοντέλο gpt-4o-mini!

Χρήστες VS Code: Πατήστε F5 για εκτέλεση. Η εφαρμογή φορτώνει αυτόματα το .env σας.

Πλήρες παράδειγμα: Δείτε το Βασικό Chat με Azure AI Foundry για λεπτομέρειες και αντιμετώπιση προβλημάτων.

Τι Ακολουθεί;

Η ρύθμιση ολοκληρώθηκε! Τώρα διαθέτετε:

  • Το Azure AI Foundry με τα gpt-4o-mini και text-embedding-3-small αναπτυγμένα
  • Αυθεντικοποίηση χωρίς κλειδί (Microsoft Entra ID) — χωρίς κλειδιά για διαχείριση
  • Ένα τοπικό .env με το endpoint και τα ονόματα ανάπτυξης
  • Ένα περιβάλλον ανάπτυξης Java έτοιμο για χρήση

Συνεχίστε στο Κεφάλαιο 3: Βασικές Τεχνικές Γεννητικής Τεχνητής Νοημοσύνης για να ξεκινήσετε την κατασκευή εφαρμογών AI!

Πόροι

Πρόσθετοι Πόροι

Αποποίηση ευθυνών: Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία μετάφρασης με τεχνητή νοημοσύνη Co-op Translator. Ενώ επιδιώκουμε την ακρίβεια, παρακαλούμε να έχετε υπόψη ότι οι αυτοματοποιημένες μεταφράσεις ενδέχεται να περιέχουν λάθη ή ανακρίβειες. Το πρωτότυπο έγγραφο στη μητρική του γλώσσα πρέπει να θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες, συνιστάται επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε ευθύνη για τυχόν παρεξηγήσεις ή λανθασμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης.