Foundry Toolkit + Foundry Hosted Agents Workshop

Δημιουργήστε, δοκιμάστε και αναπτύξτε πράκτορες AI στην Υπηρεσία Πρακτόρων Microsoft Foundry ως Φιλοξενούμενοι Πράκτορες - εξ ολοκλήρου από το VS Code χρησιμοποιώντας την Επέκταση Microsoft Foundry και το Foundry Toolkit.

Οι Φιλοξενούμενοι Πράκτορες βρίσκονται αυτή τη στιγμή σε προεπισκόπηση. Οι υποστηριζόμενες περιοχές είναι περιορισμένες - δείτε την διαθεσιμότητα περιοχών.

Ο φάκελος agent/ μέσα σε κάθε εργαστήριο δημιουργείται αυτόματα από την επέκταση Foundry - στη συνέχεια προσαρμόζετε τον κώδικα, δοκιμάζετε τοπικά και αναπτύσσετε.

🌐 Υποστήριξη Πολλών Γλωσσών

Υποστηρίζεται μέσω GitHub Action (Αυτοματοποιημένο & Πάντα Ενημερωμένο)

Προτιμάτε να Κλωνοποιήσετε Τοπικά;

Αυτό το αποθετήριο περιλαμβάνει πάνω από 50 μεταφράσεις γλωσσών που αυξάνουν σημαντικά το μέγεθος λήψης. Για να κλωνοποιήσετε χωρίς τις μεταφράσεις, χρησιμοποιήστε το sparse checkout:

Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Lab
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Lab
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
Αυτό σας δίνει όλα όσα χρειάζεστε για να ολοκληρώσετε το μάθημα με πολύ πιο γρήγορο κατέβασμα.

Αρχιτεκτονική

flowchart TB
    subgraph Local["Τοπική Ανάπτυξη (VS Code)"]
        direction TB
        FE["Επέκταση Microsoft Foundry"]
        FoundryToolkit["Επέκταση Foundry Toolkit"]
        Scaffold["Κώδικας Πρακτόρου με Σκελετό
        (main.py · agent.yaml · Dockerfile)"]
        Inspector["Επιθεωρητής Πράκτορα
        (Τοπικός Έλεγχος)"]
        FE -- "Δημιουργία Νέου
        Φιλοξενούμενου Πράκτορα" --> Scaffold
        Scaffold -- "Αποσφαλμάτωση F5" --> Inspector
        FoundryToolkit -.- Inspector
    end

    subgraph Cloud["Microsoft Foundry"]
        direction TB
        ACR["Μητρώο Περιεκτών Azure"]
        AgentService["Υπηρεσία Πράκτορα Foundry
        (Χρόνος Εκτέλεσης Φιλοξενούμενου Πράκτορα)"]
        Model["Azure OpenAI
        (gpt-4.1 / gpt-4.1-mini)"]
        Playground["Πεδίο Δοκιμών Foundry
        & Πεδίο Δοκιμών VS Code"]
        ACR --> AgentService
        AgentService -- "/responses API" --> Model
        AgentService --> Playground
    end

    Scaffold -- "Ανάπτυξη
    (Docker build + push)" --> ACR
    Inspector -- "POST /responses
    (localhost:8088)" --> Scaffold
    Playground -- "Δοκιμή προτροπών" --> AgentService

    style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
    style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px

Ροή: Η επέκταση Foundry δημιουργεί τη δομή του πράκτορα → προσαρμόζετε τον κώδικα & τις οδηγίες → δοκιμάζετε τοπικά με το Agent Inspector → αναπτύσσετε στο Foundry (εικόνα Docker προωθείται στο ACR) → επαληθεύετε στο Playground.

Τι θα δημιουργήσετε

Εργαστήριο	Περιγραφή	Κατάσταση
Εργαστήριο 01 - Μονός Πράκτορας	Δημιουργία του "Εξήγησε το σαν να ήμουν Επιχειρηματίας" Πράκτορα, δοκιμή τοπικά και ανάπτυξη στο Foundry	✅ Διαθέσιμο
Εργαστήριο 02 - Ροή Πολλαπλών Πρακτόρων	Δημιουργία του "Αξιολογητής Βιογραφικού → Κατάλληλης Θέσης" - 4 πράκτορες συνεργάζονται για να βαθμολογήσουν την καταλληλότητα βιογραφικού και να δημιουργήσουν χάρτη μάθησης	✅ Διαθέσιμο

Γνωρίστε τον Πράκτορα Επιχειρηματία

Σε αυτό το εργαστήριο θα δημιουργήσετε τον "Εξήγησε το σαν να ήμουν Επιχειρηματίας" Πράκτορα - έναν πράκτορα AI που παίρνει δύσκολη τεχνική ορολογία και τη μεταφράζει σε ήρεμες, έτοιμες για το διοικητικό συμβούλιο, περιλήψεις. Γιατί, ειλικρινά, κανείς στον C-suite δεν θέλει να ακούει για "εξαντλημένη δεξαμενή νημάτων που προκλήθηκε από σύγχρονες κλήσεις που εισήχθησαν στην έκδοση v3.2."

Έφτιαξα αυτόν τον πράκτορα μετά από πολλά περιστατικά όπου το τέλεια συντεταγμένο μεταθανάτιο μου έπαιρνε την απάντηση: "Λοιπόν... η ιστοσελίδα είναι κάτω ή όχι;"

Πώς λειτουργεί

Του δίνετε μια τεχνική ενημέρωση. Σας επιστρέφει μια επιχειρηματική περίληψη - τρία σημεία, χωρίς ορολογίες, χωρίς ιχνηλάτηση στοίβας, χωρίς υπαρξιακό άγχος. Μόνο τι συνέβη, επιχειρηματική επίδραση και επόμενο βήμα.

Δείτε το σε δράση

Εσείς λέτε:

"Η καθυστέρηση του API αυξήθηκε λόγω εξάντλησης της δεξαμενής νημάτων που προκλήθηκε από σύγχρονες κλήσεις που εισήχθησαν στην έκδοση v3.2."

Ο πράκτορας απαντά:

Επιχειρηματική Περίληψη:

Τι συνέβη: Μετά την τελευταία ενημέρωση, το σύστημα επιβράδυνε.

Επιχειρηματική επίπτωση: Ορισμένοι χρήστες αντιμετώπισαν καθυστερήσεις κατά τη χρήση της υπηρεσίας.

Επόμενο βήμα: Η αλλαγή επαναφέρθηκε και ετοιμάζεται διόρθωση πριν την επανανάπτυξη.

Γιατί αυτός ο πράκτορας;

Είναι ένας απλός, μοναδικού σκοπού πράκτορας - τέλειος για να μάθετε τη διαδικασία των φιλοξενούμενων πρακτόρων από την αρχή μέχρι το τέλος χωρίς να μπλέκεστε σε περίπλοκες αλυσίδες εργαλείων. Και ειλικρινά; Κάθε ομάδα μηχανικών θα μπορούσε να χρησιμοποιήσει έναν τέτοιο.

Δομή εργαστηρίου

📂 Foundry_Toolkit_for_VSCode_Lab/
├── 📄 README.md                      ← You are here
├── 📂 ExecutiveAgent/                ← Standalone hosted agent project
│   ├── agent.yaml
│   ├── Dockerfile
│   ├── main.py
│   └── requirements.txt
└── 📂 workshop/
    ├── 📂 lab01-single-agent/        ← Full lab: docs + agent code
    │   ├── README.md                 ← Hands-on lab instructions
    │   ├── 📂 docs/                  ← Step-by-step tutorial modules
    │   │   ├── 00-prerequisites.md
    │   │   ├── 01-install-foundry-toolkit.md
    │   │   ├── 02-create-foundry-project.md
    │   │   ├── 03-create-hosted-agent.md
    │   │   ├── 04-configure-and-code.md
    │   │   ├── 05-test-locally.md
    │   │   ├── 06-deploy-to-foundry.md
    │   │   ├── 07-verify-in-playground.md
    │   │   └── 08-troubleshooting.md
    │   └── 📂 agent/                 ← Reference solution (auto-scaffolded by Foundry extension)
    │       ├── agent.yaml
    │       ├── Dockerfile
    │       ├── main.py
    │       └── requirements.txt
    └── 📂 lab02-multi-agent/         ← Resume → Job Fit Evaluator
        ├── README.md                 ← Hands-on lab instructions (end-to-end)
        ├── 📂 docs/                  ← Step-by-step tutorial modules
        │   ├── 00-prerequisites.md
        │   ├── 01-understand-multi-agent.md
        │   ├── 02-scaffold-multi-agent.md
        │   ├── 03-configure-agents.md
        │   ├── 04-orchestration-patterns.md
        │   ├── 05-test-locally.md
        │   ├── 06-deploy-to-foundry.md
        │   ├── 07-verify-in-playground.md
        │   └── 08-troubleshooting.md
        └── 📂 PersonalCareerCopilot/ ← Reference solution (multi-agent workflow)
            ├── agent.yaml
            ├── Dockerfile
            ├── main.py
            └── requirements.txt

Σημείωση: Ο φάκελος agent/ μέσα σε κάθε εργαστήριο είναι αυτό που δημιουργεί η επέκταση Microsoft Foundry όταν εκτελείτε Microsoft Foundry: Create a New Hosted Agent από το Command Palette. Τα αρχεία προσαρμόζονται στη συνέχεια με τις οδηγίες, τα εργαλεία και τις ρυθμίσεις του πράκτορά σας. Το Εργαστήριο 01 σας καθοδηγεί να το δημιουργήσετε από την αρχή.

Ξεκινώντας

1. Κλωνοποιήστε το αποθετήριο

git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Lab

2. Ρυθμίστε ένα εικονικό περιβάλλον Python

python -m venv venv

Ενεργοποιήστε το:

Windows (PowerShell):
```
.\venv\Scripts\Activate.ps1
```
macOS / Linux:
```
source venv/bin/activate
```

3. Εγκαταστήστε τις εξαρτήσεις

pip install -r workshop/lab01-single-agent/agent/requirements.txt

4. Ρυθμίστε τις μεταβλητές περιβάλλοντος

Αντιγράψτε το παράδειγμα αρχείο .env μέσα στο φάκελο agent και συμπληρώστε τις τιμές σας:

cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.env

Επεξεργαστείτε το workshop/lab01-single-agent/agent/.env:

AZURE_AI_PROJECT_ENDPOINT=https://<your-account>.services.ai.azure.com/api/projects/<your-project>
MODEL_DEPLOYMENT_NAME=<your-model-deployment-name>

5. Ακολουθήστε τα εργαστήρια

Κάθε εργαστήριο είναι αυτόνομο με τα δικά του modules. Ξεκινήστε με το Εργαστήριο 01 για να μάθετε τα βασικά, έπειτα προχωρήστε στο Εργαστήριο 02 για ροές πολλών πρακτόρων.

Εργαστήριο 01 - Μονός Πράκτορας (πλήρεις οδηγίες)

#	Module	Link
1	Διαβάστε τις προαπαιτήσεις	00-prerequisites.md
2	Εγκαταστήστε το Foundry Toolkit & την επέκταση Foundry	01-install-foundry-toolkit.md
3	Δημιουργήστε ένα έργο Foundry	02-create-foundry-project.md
4	Δημιουργήστε έναν φιλοξενούμενο πράκτορα	03-create-hosted-agent.md
5	Ρυθμίστε τις οδηγίες & το περιβάλλον	04-configure-and-code.md
6	Δοκιμάστε το τοπικά	05-test-locally.md
7	Αναπτύξτε στο Foundry	06-deploy-to-foundry.md
8	Επαληθεύστε στο playground	07-verify-in-playground.md
9	Αντιμετώπιση προβλημάτων	08-troubleshooting.md

Εργαστήριο 02 - Ροή Πολλαπλών Πρακτόρων (πλήρεις οδηγίες)

#	Module	Link
1	Προαπαιτήσεις (Εργαστήριο 02)	00-prerequisites.md
2	Κατανόηση αρχιτεκτονικής πολλών πρακτόρων	01-understand-multi-agent.md
3	Δημιουργία της δομής του έργου πολλών πρακτόρων	02-scaffold-multi-agent.md
4	Ρύθμιση πρακτόρων & περιβάλλοντος	03-configure-agents.md
5	Πρότυπα ορχήστρωσης	04-orchestration-patterns.md
6	Δοκιμή τοπικά (πολλοί πράκτορες)	05-test-locally.md
7	Ανάπτυξη στο Foundry	06-deploy-to-foundry.md
8	Επαλήθευση στο playground	07-verify-in-playground.md
9	Επίλυση προβλημάτων (πολλαπλοί agents)	08-troubleshooting.md

Υπεύθυνος συντήρησης

_{Shivam Goyal}

Απαιτούμενες άδειες (γρήγορη αναφορά)

Σενάριο	Απαιτούμενοι ρόλοι
Δημιουργία νέου έργου Foundry	Azure AI Owner στην πηγή του Foundry
Ανάπτυξη σε υπάρχον έργο (νέοι πόροι)	Azure AI Owner + Contributor στη συνδρομή
Ανάπτυξη σε πλήρως ρυθμισμένο έργο	Reader στο λογαριασμό + Azure AI User στο έργο

Σημαντικό: Οι ρόλοι Azure Owner και Contributor περιλαμβάνουν μόνο δικαιώματα διαχείρισης, όχι δικαιώματα ανάπτυξης (ενέργειες δεδομένων). Χρειάζεστε Azure AI User ή Azure AI Owner για να κατασκευάσετε και να αναπτύξετε agents.

Αναφορές

Γρήγορη εκκίνηση: Αναπτύξτε τον πρώτο σας φιλοξενούμενο agent (VS Code)
Τι είναι οι φιλοξενούμενοι agents;
Δημιουργία ροών εργασίας φιλοξενούμενων agents στο VS Code
Ανάπτυξη φιλοξενούμενου agent
RBAC για το Microsoft Foundry
Δείγμα Agent Ανασκόπησης Αρχιτεκτονικής - Ρεαλιστικός φιλοξενούμενος agent με εργαλεία MCP, διαγράμματα Excalidraw, και διπλή ανάπτυξη

Άδεια

MIT

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Foundry Toolkit + Foundry Hosted Agents Workshop

🌐 Υποστήριξη Πολλών Γλωσσών

Υποστηρίζεται μέσω GitHub Action (Αυτοματοποιημένο & Πάντα Ενημερωμένο)

Αρχιτεκτονική

Τι θα δημιουργήσετε

Γνωρίστε τον Πράκτορα Επιχειρηματία

Πώς λειτουργεί

Δείτε το σε δράση

Γιατί αυτός ο πράκτορας;

Δομή εργαστηρίου

Ξεκινώντας

1. Κλωνοποιήστε το αποθετήριο

2. Ρυθμίστε ένα εικονικό περιβάλλον Python

3. Εγκαταστήστε τις εξαρτήσεις

4. Ρυθμίστε τις μεταβλητές περιβάλλοντος

5. Ακολουθήστε τα εργαστήρια

Εργαστήριο 01 - Μονός Πράκτορας (πλήρεις οδηγίες)

Εργαστήριο 02 - Ροή Πολλαπλών Πρακτόρων (πλήρεις οδηγίες)

Υπεύθυνος συντήρησης

Απαιτούμενες άδειες (γρήγορη αναφορά)

Αναφορές

Άδεια

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

Foundry Toolkit + Foundry Hosted Agents Workshop

🌐 Υποστήριξη Πολλών Γλωσσών

Υποστηρίζεται μέσω GitHub Action (Αυτοματοποιημένο & Πάντα Ενημερωμένο)

Αρχιτεκτονική

Τι θα δημιουργήσετε

Γνωρίστε τον Πράκτορα Επιχειρηματία

Πώς λειτουργεί

Δείτε το σε δράση

Γιατί αυτός ο πράκτορας;

Δομή εργαστηρίου

Ξεκινώντας

1. Κλωνοποιήστε το αποθετήριο

2. Ρυθμίστε ένα εικονικό περιβάλλον Python

3. Εγκαταστήστε τις εξαρτήσεις

4. Ρυθμίστε τις μεταβλητές περιβάλλοντος

5. Ακολουθήστε τα εργαστήρια

Εργαστήριο 01 - Μονός Πράκτορας (πλήρεις οδηγίες)

Εργαστήριο 02 - Ροή Πολλαπλών Πρακτόρων (πλήρεις οδηγίες)

Υπεύθυνος συντήρησης

Απαιτούμενες άδειες (γρήγορη αναφορά)

Αναφορές

Άδεια