Γρήγορη εκκίνηση: Ρύθμιση και εκτέλεση του παράγοντα δείγματος πλαισίου του Python Agent

Σε αυτή τη Γρήγορη εκκίνηση, δείτε μια αναλυτική παρουσίαση της ρύθμισης ενός παράγοντα-πλαισίου παράγοντα Python που λειτουργεί, χρησιμοποιώντας τον Παράγοντα 365 για εργαλεία, ειδοποιήσεις, παρατηρησιμότητα και δοκιμή του παράγοντα χρησιμοποιώντας το Agents Playground και το Teams.

Προαπαιτούμενα στοιχεία

Εάν σκοπεύετε να χρησιμοποιήσετε το Visual Studio Code, πρέπει να έχετε εγκατεστημένο το .NET. (Συνιστάται.NET 8.0.)
Εγκατάσταση του Python 3.11+
Έχει εγκατασταθεί η διαχείριση πακέτων UV. Εγκαταστήστε το σε ένα τερματικό χρησιμοποιώντας το pip install uv.
Εξαρτήσεις κιτ εργαλείων Microsoft Agents / Agent Framework

Το δείγμα που χρησιμοποιείται στην αναλυτική παρουσίαση βασίζεται στις βιβλιοθήκες του πλαισίου παραγόντων που παρέχονται μέσω του Κιτ εργαλείων microsoft 365 Agents ή ATK. Θα τα εγκαταστήσετε αυτόματα όταν χρησιμοποιείτε την επέκταση Κιτ εργαλείων Agents στο VS Code για να δημιουργήσετε ένα σκελετό στο δείγμα ή μπορείτε να εγκαταστήσετε το πακέτο με μη αυτόματο τρόπο, χρησιμοποιώντας αυτή την εντολή:
```
uv pip install -e . --find-links ../dist --pre
```
Πρόσβαση στο GitHub
Ένα υπάρχον έργο παράγοντα AI. Αυτός ο οδηγός γρήγορης εκκίνησης χρησιμοποιεί ένα δείγμα παράγοντα Agent 365 από το κιτ εργαλείων παράγοντα Microsoft 365 γνωστό επίσης ως ATK στον κώδικα VS.
A365 CLI
Έλεγχος ταυτότητας παράγοντα

Ρυθμίστε το πλαίσιο agent + δείγμα Python από το Κιτ εργαλείων microsoft 365 Agents

Για να προετοιμάσετε τα πάντα, εγκαταστήστε το Κιτ εργαλείων Microsoft 365 Agents σε κώδικα VS, ανοίξτε το δείγμα συλλογής και δημιουργήστε ένα σκελετό στο δείγμα Agent Framework + Python τοπικά, ώστε να μπορείτε να το ρυθμίσετε και να το εκτελέσετε αργότερα. Τα παρακάτω στιγμιότυπα οθόνης εμφανίζουν αυτό που πρέπει να περιμένετε να δείτε καθώς προχωράτε.

Ανοίξτε το Visual Studio Code και, στη συνέχεια, ανοίξτε τον πίνακα Επεκτάσεις Ctrl+Shift+X.
Στη γραμμή αναζήτησης, πληκτρολογήστε "Agents Toolkit".
Θα πρέπει να δείτε το αποτέλεσμα που εμφανίζεται στο στιγμιότυπο οθόνης εδώ:
Επιλέξτε Κιτ εργαλείων Microsoft 365 Agents.
Επιλέξτε Εγκατάσταση.

Ο κώδικας VS εμφανίζει την προβολή λεπτομερειών επέκτασης παρόμοια με:
Μόλις εγκατασταθεί, το εικονίδιο κιτ εργαλείων M365 Agents εμφανίζεται στην αριστερή γραμμή περιήγησης.
Επιλέξτε το για να ανοίξετε την εμπειρία υποδοχής.

Τώρα θα πρέπει να δείτε επιλογές όπως Δημιουργία δηλωτικού παράγοντα, Δημιουργία νέου παράγοντα/εφαρμογής και Προβολή δειγμάτων, όπως φαίνεται εδώ:
Επιλέξτε Προβολή δειγμάτων.
Στη λίστα δειγμάτων, κάντε κύλιση για να βρείτε το δείγμα παράγοντα Agent Framework + Python .
Επιλέξτε την.

Θα δείτε δύο επιλογές: Δημιουργία (δημιουργία σκελετού τοπικά) ή Προβολή στο GitHub.
Επιλέξτε Δημιουργία.
Όταν σας ζητηθεί, επιλέξτε έναν φάκελο στον υπολογιστή σας όπου θα πρέπει να δημιουργηθεί το δείγμα. Για παράδειγμα: C:\A365-python-sample

Το κιτ εργαλείων σκελετού σκελετού δημιουργεί ένα δείγμα Agent framework + Python σε έναν υποφάκελο (όπως sample_agent) και, στη συνέχεια, το ανοίγει αυτόματα σε κώδικα VS.

Μόλις ολοκληρωθεί η δημιουργία σκελετού, έχετε τώρα ένα πλήρως λειτουργικό πλαίσιο εργασίας παράγοντα + παράγοντα Python στον υπολογιστή σας
Εγκατάσταση απαιτούμενων πακέτων Agent 365

Πριν από την εκτέλεση του δείγματος, ανοίξτε το package.json στο έργο σας και επιβεβαιώστε ότι παρατίθενται όλες οι απαιτούμενες εξαρτήσεις πλαισίου παράγοντα 365 και παράγοντα. Το δείγμα που δημιουργήθηκε από το Κιτ εργαλείων microsoft 365 Agents περιλαμβάνει ήδη αυτές τις καταχωρήσεις.

Αφού εξετάσετε την package.json, εγκαταστήστε τα πάντα εκτελώντας αυτήν την εντολή:
```
uv pip install -e
```
Αυτό τραβάει όλες τις βιβλιοθήκες του Παράγοντα 365 SDK, τις εξαρτήσεις πλαισίου παράγοντα, τα στοιχεία φιλοξενίας και οποιεσδήποτε άλλες εξαρτήσεις που ορίζονται στο δείγμα.
Μετά την εγκατάσταση, επαληθεύστε ότι το έργο δημιουργείται και εκτελείται, ξεκινώντας τον διακομιστή dev χρησιμοποιώντας αυτήν την εντολή:
```
uv run python start_with_generic_host.py
```

Προσθήκη εργαλείων Microsoft 365 (διακομιστές MCP)

Μπορείτε να εξερευνήσετε και να διαχειριστείτε διακομιστές MCP χρησιμοποιώντας τις εντολές ανάπτυξης a365 στη CLI.

Όταν εργάζεστε με διακομιστές MCP, μπορείτε να κάνετε τα εξής:

Ανακαλύψτε ποιοι διακομιστές MCP είναι διαθέσιμοι για χρήση
Προσθήκη ενός ή περισσότερων διακομιστών MCP στη ρύθμιση παραμέτρων του παράγοντα σας
Εξέταση των διακομιστών MCP που έχουν ρυθμιστεί αυτήν τη στιγμή
Κατάργηση διακομιστών MCP που δεν χρειάζεστε πλέον

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

{
   "mcpServers": [
      {
         "mcpServerName": "mcp_MailTools",
         "mcpServerUniqueName": "mcp_MailTools",
         "scope": "McpServers.Mail.All",
         "audience": "api://00001111-aaaa-2222-bbbb-3333cccc4444"
      }
   ]
}

Μάθετε πώς μπορείτε να προσθέσετε και να διαχειριστείτε εργαλεία

Συνδρομή και χειρισμός ειδοποιήσεων

Το δείγμα παράγοντα εγγράφεται σε όλες τις ειδοποιήσεις SDK του παράγοντα 365 και onAgentNotification("*") τις δρομολογεί σε έναν μόνο χειρισμό. Αυτός ο χειρισμός επιτρέπει στον παράγοντα να αντιδρά στο παρασκήνιο ή στα συμβάντα του συστήματος, όχι μόνο να κατευθύνει μηνύματα χρήστη.

Μάθετε πώς μπορείτε να ειδοποιήσετε τους υπαλλήλους

Ο παρακάτω κώδικας εμφανίζει τον τρόπο ρύθμισης των παραμέτρων της ειδοποίησης στο agent.py αρχείο.

if notification_type == NotificationTypes.EMAIL_NOTIFICATION: 
if not hasattr(notification_activity, "email") or not notification_activity.email: return "I could not find the email notification details."
email = notification_activity.email
email_body = getattr(email, "html_body", "") or getattr(email, "body", "")

message = (
    "You have received the following email. "
    "Please follow any instructions in it. "
    f"{email_body}"
)

result = await self.agent.run(message)
return self._extract_result(result) or "Email notification processed."

Δυνατότητα προσαρμογής

Αυτό το τμήμα κώδικα εμφανίζει τις ελάχιστες αλλαγές που απαιτούνται για την ενεργοποίηση της παρατηρησιμότητας στο δείγμα. Προετοιμάζει το SDK παρατηρησιμότητας του Παράγοντα 365 και ενσωματώνει κάθε παράγοντα που αναφέρεται σε έναν InferenceScope , ώστε τα δεδομένα εισόδου, εξόδου και μετα-δεδομένων να μπορούν να καταγραφούν αυτόματα.

Ο παρακάτω κώδικας εμφανίζει ένα βελτιωμένο παράδειγμα παρατηρήσεων στο agent.py αρχείο.

def _enable_agentframework_instrumentation(self): 
"""Enable Agent Framework instrumentation.""" 
try: 
AgentFrameworkInstrumentor().instrument() 
logger.info("✅ Instrumentation enabled")
 except Exception as e: 
logger.warning(f"⚠️ Instrumentation failed: {e}")

Αυτός ο κώδικας είναι η ρύθμιση πλήρους τήρησης που απαιτείται για το δείγμα πλαισίου Python + Παράγοντας. Μάθετε περισσότερα σχετικά με την παρατηρησιμότητα

Δοκιμή του παράγοντά σας

Ορίστε τις απαιτούμενες μεταβλητές περιβάλλοντος, επιλέξτε μια λειτουργία ελέγχου ταυτότητας και ξεκινήστε τον παράγοντα τοπικά. Μπορείτε να δοκιμάσετε όλα τα στοιχεία από άκρο σε άκρο με το Agents Playground χωρίς να χρειάζεστε μισθωτή Microsoft 365, εκτός εάν θέλετε να δημοσιεύσετε τον παράγοντα και να τον χρησιμοποιήσετε σε εφαρμογές όπως το Teams ή το Outlook.

Επισκόπηση βημάτων δοκιμών

Προσθέστε τα κλειδιά API και τις ρυθμίσεις μοντέλου σε ένα .env αρχείο, ώστε το δείγμα να μπορεί να μιλήσει σε μια LLM.
Επιλέξτε τη λειτουργία ελέγχου ταυτότητας. Για τοπική ανάπτυξη, το δείγμα υποστηρίζει έλεγχο ταυτότητας agentic χρησιμοποιώντας τιμές που δημιουργήθηκαν από τον παράγοντα Blueprint.
Ξεκινήστε τον παράγοντα τοπικά, το οποίο το εκθέτει σε εργαλεία όπως το Agents Playground.
Χρησιμοποιήστε το Agents Playground για να δοκιμάσετε μηνύματα, εργαλεία και ειδοποιήσεις χωρίς να ρυθμίσετε έναν μισθωτή ή να αναπτύξετε τίποτα.
Όταν είστε έτοιμοι για συμπεριφορά από τον πραγματικό κόσμο, δημοσιεύστε έναν μισθωτή Microsoft 365 και δοκιμάστε τον παράγοντα μέσα στο Teams, το Outlook ή σε άλλες επιφάνειες του Microsoft 365.

Μάθετε περισσότερα σχετικά με τις δοκιμές

Δημοσίευση του παράγοντά σας

Όταν ο πράκτοράς σας είναι έτοιμος για πραγματικές εμπειρίες του Microsoft 365, όπως συνομιλίες του Teams, μηνύματα του Outlook, Word @mentions, θα τις δημοσιεύσετε σε έναν μισθωτή Microsoft 365. Η εντολή CLI publish agent 365 χειρίζεται τη συσκευασία: ενημερώνει τη διακήρυξη, ομαδοποιεί τα πάντα και αποστέλλει τον πράκτορα στο Κέντρο διαχείρισης της Microsoft.

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

Μπορείτε να δείτε δημοσιευμένους υπαλλήλους εδώ: https://admin.cloud.microsoft/#/agents/all

Μάθετε περισσότερα σχετικά με την πλήρη ροή εργασιών και τις οδηγίες βήμα προς βήμα

Ανάδραση

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2025-12-02