Ρύθμιση Περιβάλλοντος Ανάπτυξης για Γενετική Τεχνητή Νοημοσύνη με Java

Γρήγορη εκκίνηση: Παρέχετε τα μοντέλα AI σας στο Azure AI Foundry ως κώδικα με Bicep + azd σε λίγα λεπτά — δείτε τον Οδηγό Ρύθμισης Azure AI Foundry. Η πιστοποίηση είναι χωρίς κλειδί (Microsoft Entra ID), οπότε δεν χρειάζεται διαχείριση κλειδιών API.

Τι Θα Μάθετε

• Ρύθμιση περιβάλλοντος ανάπτυξης Java για εφαρμογές AI
• Επιλογή και διαμόρφωση του προτιμώμενου περιβάλλοντος ανάπτυξης (cloud-first με Codespaces, τοπικός dev container ή πλήρης τοπική ρύθμιση)
• Δοκιμή της ρύθμισής σας με σύνδεση σε μοντέλο Azure AI Foundry

Περιεχόμενα

• Τι Θα Μάθετε
• Εισαγωγή
• Βήμα 1: Ρύθμιση Περιβάλλοντος Ανάπτυξης
  • Επιλογή Α: GitHub Codespaces (Προτεινόμενο)
  • Επιλογή Β: Τοπικός Dev Container
  • Επιλογή Γ: Χρήση Υφιστάμενης Τοπικής Εγκατάστασης
• Βήμα 2: Παροχή Azure AI Foundry
• Βήμα 3: Δοκιμή της Ρύθμισής σας
• Επίλυση Προβλημάτων
• Περίληψη
• Επόμενα Βήματα

Εισαγωγή

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

Δεν απαιτείται τοπική ρύθμιση! Μπορείτε να χρησιμοποιήσετε GitHub Codespaces, που παρέχει πλήρες περιβάλλον ανάπτυξης στο πρόγραμμα περιήγησής σας, και να παράσχετε το Foundry από εκεί.

Χρησιμοποιούμε Azure AI Foundry για αυτό το μάθημα επειδή είναι:

• Παρεχόμενο ως κώδικας — ένα azd up αναπτύσσει τον λογαριασμό και τις αναπτύξεις μοντέλων
• Χωρίς κλειδί — αυθεντικοποίηση με το Azure sign-in σας ή μια διαχειριζόμενη ταυτότητα
• Έτοιμο για παραγωγή — ο ίδιος κώδικας τρέχει τοπικά και στο Azure
• Ευέλικτο — μπορείτε να αλλάξετε μοντέλα αλλάζοντας όνομα ανάπτυξης, όχι τον κώδικά σας

Σημείωση: Οι αναπτύξεις στο Azure AI Foundry τιμολογούνται ανά token (πληρωμή ανά χρήση). Δείτε τον οδηγό ρύθμισης Azure AI Foundry για λεπτομέρειες παροχής, περιοχής και κόστους.

Βήμα 1: Ρύθμιση Περιβάλλοντος Ανάπτυξης

Δημιουργήσαμε έναν προδιαμορφωμένο container ανάπτυξης για να ελαχιστοποιήσουμε τον χρόνο ρύθμισης και να εγγυηθούμε ότι έχετε όλα τα απαραίτητα εργαλεία για το μάθημα «Γενετική AI για Java». Επιλέξτε την προτιμώμενη προσέγγιση ανάπτυξης:

Επιλογές Ρύθμισης Περιβάλλοντος:

Επιλογή Α: GitHub Codespaces (Προτεινόμενο)

Ξεκινήστε να γράφετε κώδικα σε 2 λεπτά - δεν απαιτείται τοπική ρύθμιση!

1. Κάντε fork αυτό το αποθετήριο στο λογαριασμό σας στο GitHub

   Σημείωση: Αν θέλετε να επεξεργαστείτε την βασική ρύθμιση, δείτε την Διαμόρφωση Dev Container

2. Πατήστε Code → καρτέλα Codespaces → ... → New with options...
3. Χρησιμοποιήστε τις προεπιλογές – αυτό θα επιλέξει την Διαμόρφωση Dev container: Generative AI Java Development Environment προσαρμοσμένο devcontainer δημιουργημένο για αυτό το μάθημα
4. Πατήστε Create codespace
5. Περιμένετε ~2 λεπτά για να είναι έτοιμο το περιβάλλον
6. Προχωρήστε στο Βήμα 2: Παροχή Azure AI Foundry

Οφέλη των Codespaces:

• Δεν απαιτείται τοπική εγκατάσταση
• Λειτουργεί σε οποιαδήποτε συσκευή με πρόγραμμα περιήγησης
• Προεγκατεστημένα όλα τα εργαλεία και εξαρτήσεις
• Δωρεάν 60 ώρες ανά μήνα για προσωπικούς λογαριασμούς
• Ομοιογενές περιβάλλον για όλους τους εκπαιδευόμενους

Επιλογή Β: Τοπικός Dev Container

Για προγραμματιστές που προτιμούν τοπική ανάπτυξη με Docker

1. Κάντε fork και clone αυτό το αποθετήριο στη τοπική σας μηχανή

   Σημείωση: Αν θέλετε να επεξεργαστείτε την βασική ρύθμιση, δείτε την Διαμόρφωση Dev Container

2. Εγκαταστήστε το Docker Desktop και το VS Code
3. Εγκαταστήστε την επέκταση Dev Containers στο VS Code
4. Ανοίξτε τον φάκελο του αποθετηρίου στο VS Code
5. Όταν σας ζητηθεί, πατήστε Reopen in Container (ή χρησιμοποιήστε Ctrl+Shift+P → "Dev Containers: Reopen in Container")
6. Περιμένετε να ολοκληρωθεί η κατασκευή και εκκίνηση του container
7. Προχωρήστε στο Βήμα 2: Παροχή Azure AI Foundry

Επιλογή Γ: Χρήση Υφιστάμενης Τοπικής Εγκατάστασης

Για προγραμματιστές με υπάρχον περιβάλλον Java

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

• Java 21+
• Maven 3.9+
• VS Code ή το προτιμώμενο IDE σας

Βήματα:

1. Κλωνοποιήστε το αποθετήριο στη τοπική σας μηχανή
2. Ανοίξτε το έργο στο IDE σας
3. Προχωρήστε στο Βήμα 2: Παροχή Azure AI Foundry

Συμβουλή: Αν έχετε χαμηλής ισχύος μηχανή αλλά θέλετε VS Code τοπικά, χρησιμοποιήστε GitHub Codespaces! Μπορείτε να συνδέσετε τον τοπικό VS Code σας σε hosted Codespace στο cloud για τα καλύτερα και των δύο κόσμων.

Βήμα 2: Παροχή Azure AI Foundry

Αναπτύξτε τα μοντέλα AI του μαθήματος στο Azure AI Foundry ως κώδικα. Από τη ρίζα του αποθετηρίου:

cd 02-SetupDevEnvironment
azd auth login
az login
azd up

azd ζητά όνομα περιβάλλοντος και περιοχή, παρέχει λογαριασμό Azure AI Foundry με αναπτύξεις gpt-4o-mini και text-embedding-3-small, και γράφει το endpoint στο αρχείο .env του παραδείγματος — όλα με πιστοποίηση χωρίς κλειδί (χωρίς κλειδιά API).

Ολοκληρωμένος οδηγός: Δείτε τον Οδηγό Ρύθμισης Azure AI Foundry για προαπαιτούμενα, εναλλακτική χειροκίνητη (portal), οδηγίες περιοχής και σημειώσεις κόστους/καθαρισμού.

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

Μόλις τα μοντέλα Foundry σας παρασχεθούν, δοκιμάστε τη σύνδεση με το παράδειγμα εφαρμογής στο 02-SetupDevEnvironment/examples/basic-chat-azure.

1. Ανοίξτε το τερματικό στο περιβάλλον ανάπτυξής σας.

2. Πλοηγηθείτε στο παράδειγμα:

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

3. Βεβαιωθείτε ότι έχετε συνδεθεί (η πιστοποίηση χωρίς κλειδί απαιτεί token):

   az login
   

   Αν κάνατε azd up, το αρχείο .env με το endpoint γράφτηκε ήδη για εσάς.

4. Εκτελέστε την εφαρμογή:

   mvn clean spring-boot:run
   

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

Κατανόηση του Κώδικα Παράδειγματος

Το παράδειγμα στο examples/basic-chat-azure είναι μια εφαρμογή Spring Boot που χρησιμοποιεί Spring AI για σύνδεση με Azure AI Foundry με πιστοποίηση χωρίς κλειδί.

Τι κάνει αυτός ο κώδικας:

• Συνδέεται στο Azure AI Foundry με το Azure sign-in σας (Microsoft Entra ID) — χωρίς κλειδί API
• Στέλνει ένα prompt στο μοντέλο gpt-4o-mini
• Λαμβάνει και εμφανίζει την απόκριση της ΤΝ
• Επαληθεύει ότι η ρύθμισή σας λειτουργεί σωστά

Βασική εξάρτηση (στο pom.xml):

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

Διαμόρφωση (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}

Περίληψη

Τέλεια! Πλέον έχετε όλα ρυθμισμένα:

• Παρέχετε μοντέλα Azure AI Foundry ως κώδικα με Bicep + azd
• Εκτελείτε το περιβάλλον ανάπτυξης Java σας (είτε Codespaces, dev containers, είτε τοπικά)
• Συνδέεστε στο Azure AI Foundry με πιστοποίηση χωρίς κλειδί (Microsoft Entra ID) — χωρίς κλειδιά API
• Δοκιμάσατε ότι όλα λειτουργούν με ένα απλό παράδειγμα που επικοινωνεί με το μοντέλο σας

Επόμενα Βήματα

Κεφάλαιο 3: Βασικές Τεχνικές Γενετικής AI

Επίλυση Προβλημάτων

Αν αντιμετωπίζετε θέματα, δείτε κοινά προβλήματα και λύσεις:

• Αποτυχία αυθεντικοποίησης (401/403);

  • Τρέξτε az login — η αυθεντικοποίηση είναι χωρίς κλειδί, οπότε πρέπει να είστε συνδεδεμένοι
  • Ελέγξτε ότι ο λογαριασμός σας έχει τον ρόλο Cognitive Services OpenAI User στον πόρο
  • Αν μόλις παρέχετε, περιμένετε ένα λεπτό για να διαδοθεί η ανάθεση ρόλου

• Δεν βρέθηκε το Maven;

  • Αν χρησιμοποιείτε dev containers/Codespaces, το Maven πρέπει να είναι προεγκατεστημένο
  • Για τοπική ρύθμιση, βεβαιωθείτε ότι έχετε Java 21+ και Maven 3.9+ εγκατεστημένα
  • Δοκιμάστε mvn --version για επιβεβαίωση εγκατάστασης

• Δεν βρέθηκε το azd ή αποτυγχάνει η παροχή;

  • Εγκαταστήστε το Azure Developer CLI και τρέξτε azd auth login
  • Επιλέξτε περιοχή όπου είναι διαθέσιμο το gpt-4o-mini (π.χ. eastus2)
  • Δείτε τον οδηγό ρύθμισης Azure AI Foundry για λεπτομέρειες

• Δεν ξεκινά ο dev container;

  • Βεβαιωθείτε ότι τρέχει το Docker Desktop (για τοπική ανάπτυξη)
  • Δοκιμάστε να ξαναχτίσετε το container: Ctrl+Shift+P → "Dev Containers: Rebuild Container"

• Σφάλματα μεταγλώττισης εφαρμογής;

  • Βεβαιωθείτε ότι είστε στον σωστό φάκελο: 02-SetupDevEnvironment/examples/basic-chat-azure
  • Δοκιμάστε καθαρισμό και επαναμεταγλώττιση: mvn clean compile

Χρειάζεστε βοήθεια?: Αν έχετε ακόμα προβλήματα, ανοίξτε ένα issue στο αποθετήριο και θα σας βοηθήσουμε.

---

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