Κοινοποίηση μέσω

Πράκτορες δοκιμής που χρησιμοποιούν το Microsoft Agent 365 SDK

Σημαντικό

Πρέπει να είστε μέρος του προγράμματος προεπισκόπησης Σύνορα για να αποκτήσετε πρώιμη πρόσβαση στον Παράγοντα Microsoft 365. Η Frontier σάς συνδέει απευθείας με τις τελευταίες καινοτομίες τεχνητής νοημοσύνης της Microsoft. Οι προεπισκοπήσεις για τα σύνορα υπόκεινται στους υφιστάμενους όρους προεπισκόπησης των συμβάσεων πελατών σας. Καθώς αυτές οι δυνατότητες είναι ακόμα σε εξέλιξη, η διαθεσιμότητά τους και οι δυνατότητές τους ενδέχεται να αλλάξουν με την πάροδο του χρόνου.

Δοκιμάστε τον πράκτορά σας τοπικά χρησιμοποιώντας το Agents Playground πριν από την ανάπτυξη. Αυτός ο οδηγός καλύπτει τη ρύθμιση του περιβάλλοντος ανάπτυξης, τη ρύθμιση παραμέτρων ελέγχου ταυτότητας και την επικύρωση της λειτουργικότητας του παράγοντα σας με το εργαλείο δοκιμών Agents Playground.

Όταν ο πράκτοράς σας εργάζεται τοπικά, μπορείτε να τον αναπτύξετε και να τον δημοσιεύσετε για δοκιμή σε εφαρμογές του Microsoft 365, όπως το Teams.

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

Προτού αρχίσετε, βεβαιωθείτε ότι πληρούνται οι εξής προϋποθέσεις:

Συνήθεις προϋποθέσεις

Προαπαιτούμενα για συγκεκριμένη γλώσσα

Ρύθμιση παραμέτρων περιβάλλοντος δοκιμής παράγοντα

Αυτή η ενότητα καλύπτει τον ορισμό μεταβλητών περιβάλλοντος, τον έλεγχο ταυτότητας του περιβάλλοντος ανάπτυξης και την προετοιμασία του παράγοντα agent 365 για δοκιμή.

Η ρύθμιση του περιβάλλοντος δοκιμής του φορέα σας ακολουθεί μια διαδοχική ροή εργασιών:

  1. Ρύθμιση παραμέτρων του περιβάλλοντός σας - Δημιουργήστε ή ενημερώστε το αρχείο ρύθμισης παραμέτρων περιβάλλοντος

  2. Ρύθμιση παραμέτρων LLM - Λήψη κλειδιών API και ρύθμιση παραμέτρων των ρυθμίσεων OpenAI ή Azure OpenAI

  3. Ρύθμιση παραμέτρων ελέγχου ταυτότητας - Ρύθμιση παράγοντα ελέγχου ταυτότητας

  4. Αναφορά μεταβλητών περιβάλλοντος - Ρύθμιση παραμέτρων απαιτούμενων μεταβλητών περιβάλλοντος:

    1. Μεταβλητές ελέγχου ταυτότητας
    2. Ρύθμιση παραμέτρων τελικού σημείου MCP
    3. Μεταβλητές παρατηρησιμότητας
    4. Ρύθμιση παραμέτρων διακομιστή εφαρμογών παράγοντα

Αφού ολοκληρώσετε αυτά τα βήματα, είστε έτοιμοι να αρχίσετε να δοκιμάζετε τον πράκτορά σας στο Agents Playground.

Βήμα 5: Ρύθμιση παραμέτρων του περιβάλλοντός σας

Ρυθμίστε το αρχείο ρύθμισης παραμέτρων:

cp .env.template .env

Σημείωμα

Ανατρέξτε στα δείγματα Microsoft Agent 365 SDK για να βρείτε πρότυπα ρύθμισης παραμέτρων που εμφανίζουν τα απαιτούμενα πεδία.

Βήμα 2: Ρύθμιση παραμέτρων LLM

Ρυθμίστε τις παραμέτρους OpenAI ή Azure OpenAI για τοπικές δοκιμές. Προσθέστε τα κλειδιά API και τα τελικά σημεία υπηρεσίας που έχουν ληφθεί από τις προϋποθέσεις στο αρχείο ρύθμισης παραμέτρων, μαζί με τυχόν παραμέτρους μοντέλου.

Προσθέστε το στο αρχείο σας .env :

# Replace with your actual OpenAI API key
OPENAI_API_KEY=

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_DEPLOYMENT=
AZURE_OPENAI_API_VERSION=

Μεταβλητές περιβάλλοντος Python LLM

Μεταβλητή Περιγραφή Απαραίτητο Παράδειγμα
OPENAI_API_KEY Κλειδί API για την υπηρεσία OpenAI Για OpenAI sk-proj-...
AZURE_OPENAI_API_KEY Κλειδί API για την υπηρεσία Azure OpenAI Για το Azure OpenAI a1b2c3d4e5f6...
AZURE_OPENAI_ENDPOINT Διεύθυνση URL τελικού σημείου υπηρεσίας Azure OpenAI Για το Azure OpenAI https://your-resource.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT Όνομα ανάπτυξης στο Azure OpenAI Για το Azure OpenAI gpt-4
AZURE_OPENAI_API_VERSION Έκδοση API για Azure OpenAI Για το Azure OpenAI 2024-02-15-preview

Βήμα 3: Ρύθμιση παραμέτρων τιμών ελέγχου ταυτότητας για έλεγχο ταυτότητας παράγοντα

Χρησιμοποιήστε την εντολή A365 CLI a365 config display για να ανακτήσετε τα διαπιστευτήρια σχεδιασμού του πράκτορα.

a365 config display -g

Αυτή η εντολή εμφανίζει τη ρύθμιση παραμέτρων του σχεδίου του παράγοντα. Ορίστε τις ακόλουθες τιμές:

Τιμή Περιγραφή
agentBlueprintId Το αναγνωριστικό προγράμματος-πελάτη του πράκτορά σας
agentBlueprintClientSecret Μυστικό πελάτη του πράκτορά σας
tenantId Το αναγνωριστικό μισθωτή Microsoft Entra ID.

Χρησιμοποιήστε αυτές τις τιμές για να ρυθμίσετε τον παράγοντα ελέγχου ταυτότητας στον πράκτορά σας:

Προσθέστε τις παρακάτω ρυθμίσεις στο αρχείο σας .env , αντικαθιστώντας τις τιμές κράτησης θέσης με τα πραγματικά διαπιστευτήριά σας:

USE_AGENTIC_AUTH=true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID=<agentBlueprintId>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET=<agentBlueprintClientSecret>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID=<your-tenant-id>
Μεταβλητή Περιγραφή Απαραίτητο Παράδειγμα
USE_AGENTIC_AUTH Ενεργοποίηση της λειτουργίας ελέγχου ταυτότητας παράγοντα Όχι true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID Αναγνωριστικό προγράμματος-πελάτη με σχέδιο πράκτορα από a365 config display -g Όχι 12345678-1234-1234-1234-123456789abc
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET Μυστικός πελάτης σχεδίων αντιπροσώπων από a365 config display -g Όχι abc~123...
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID Το αναγνωριστικό μισθωτή Microsoft Entra από το a365 config display -g Όχι adfa4542-3e1e-46f5-9c70-3df0b15b3f6c

Σημείωμα

Για το .NET, βεβαιωθείτε επίσης ότι USE_AGENTIC_AUTH=true έχει οριστεί σε (ανατρέξτε στο launchSettings.json Βήμα 4: Αναφορά μεταβλητών περιβάλλοντος)

Βήμα 2: Μεταβλητές περιβάλλοντος

Ολοκληρώστε τη ρύθμιση του περιβάλλοντός σας ρυθμίζοντας τις παρακάτω απαιτούμενες μεταβλητές περιβάλλοντος:

Μεταβλητές ελέγχου ταυτότητας

Ρυθμίστε τις παραμέτρους του χειρισμού ελέγχου ταυτότητας που απαιτούνται για να λειτουργήσει σωστά ο έλεγχος ταυτότητας παράγοντα.

Προσθέστε το στο αρχείο σας .env :

# Agentic Authentication Settings
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE=AgenticUserAuthorization
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES=https://graph.microsoft.com/.default
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME=service_connection

# Connection Mapping
CONNECTIONSMAP_0_SERVICEURL=*
CONNECTIONSMAP_0_CONNECTION=SERVICE_CONNECTION
Μεταβλητή Περιγραφή Απαραίτητο
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE Τύπος χειρισμού ελέγχου ταυτότητας Όχι
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES Εμβέλειες ελέγχου ταυτότητας για το Microsoft Graph Όχι
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME Εναλλακτικό όνομα σύνδεσης σχεδίου Όχι
CONNECTIONSMAP_0_SERVICEURL Μοτίβο διεύθυνσης URL υπηρεσίας για αντιστοίχιση σύνδεσης Όχι
CONNECTIONSMAP_0_CONNECTION Όνομα σύνδεσης για αντιστοίχιση Όχι

Ρύθμιση παραμέτρων τελικού σημείου MCP

Η ρύθμιση παραμέτρων τελικού σημείου MCP (Πρωτόκολλο περιβάλλοντος μοντέλου) απαιτείται για να καθοριστεί σε ποιο τελικό σημείο πλατφόρμας παράγοντα 365 πρέπει να συνδεθεί ο πράκτοράς σας. Όταν δημιουργείτε τη διακήρυξη εργαλείων που ορίζει τους διακομιστές εργαλείων για τον πράκτορά σας, πρέπει να καθορίσετε το τελικό σημείο πλατφόρμας MCP. Αυτό το τελικό σημείο προσδιορίζει σε ποιο περιβάλλον (πριν από την παραγωγή, δοκιμή ή παραγωγή) συνδέονται οι διακομιστές εργαλείων MCP για τις δυνατότητες ενοποίησης του Microsoft 365.

Προσθέστε το στο αρχείο σας .env :

# MCP Server Configuration
MCP_PLATFORM_ENDPOINT=<MCP endpoint>
Μεταβλητή Περιγραφή Απαραίτητο Προεπιλεγμένος Παράδειγμα
MCP_PLATFORM_ENDPOINT Διεύθυνση URL τελικού σημείου πλατφόρμας MCP (πριν από την αναπαραγωγή, δοκιμή ή προώθηση) Όχι Ημερομηνία λήξης παραγωγής

Σημαντικό: Εάν MCP_PLATFORM_ENDPOINT δεν καθορίζεται, ορίζεται από προεπιλογή στο τελικό σημείο παραγωγής.

Μεταβλητές παρατηρησιμότητας

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

Σημείωμα

Η ρύθμιση παραμέτρων παρατηρησιμότητας είναι ίδια σε όλες τις γλώσσες.

Μεταβλητή Περιγραφή Προεπιλεγμένος Παράδειγμα
ENABLE_A365_OBSERVABILITY Ενεργοποίηση/απενεργοποίηση της παρατηρησιμότητας false true
ENABLE_A365_OBSERVABILITY_EXPORTER Εξαγωγή ανιχνεύσεων στην υπηρεσία παρατηρησιμότητας false true
OBSERVABILITY_SERVICE_NAME Όνομα υπηρεσίας για ανίχνευση Όνομα παράγοντα my-agent-service
OBSERVABILITY_SERVICE_NAMESPACE Χώρος ονομάτων υπηρεσίας agent365-samples my-company-agents

Ρύθμιση παραμέτρων διακομιστή εφαρμογών παράγοντα

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

Προσθέστε το στο αρχείο σας .env :

# Server Configuration
PORT=3978
Μεταβλητή Περιγραφή Απαραίτητο Προεπιλεγμένος Παράδειγμα
PORT Αριθμός θύρας όπου εκτελείται ο διακομιστής αντιπροσώπων Όχι 3978 3978

Εγκατάσταση εξαρτήσεων και εκκίνηση του διακομιστή εφαρμογών παράγοντα

Αφού ρυθμιστούν οι παράμετροι του περιβάλλοντός σας, πρέπει να εγκαταστήσετε τις απαιτούμενες εξαρτήσεις και να εκκινήσετε τον διακομιστή εφαρμογών του παράγοντα σας τοπικά για δοκιμή.

Εγκατάσταση των εξαρτήσεων.

uv pip install -e .

Αυτή η εντολή διαβάζει τις εξαρτήσεις πακέτων που έχουν οριστεί στο pyproject.toml και τις εγκαθιστά από το PyPI. Όταν δημιουργείτε μια εφαρμογή παράγοντα από την αρχή, πρέπει να δημιουργήσετε ένα pyproject.toml αρχείο για να ορίσετε τις εξαρτήσεις σας. Τα δείγματα παραγόντων από το αποθετήριο δειγμάτων έχουν ήδη καθορίσει αυτά τα πακέτα. Μπορείτε να τις προσθέσετε ή ενημερώσετε ανάλογα με τις ανάγκες.

Εκκίνηση του διακομιστή εφαρμογών παράγοντα

python <main.py>

Αντικαταστήστε <main.py> το με το όνομα του κύριου αρχείου Σας Python που περιέχει το σημείο εισόδου για την εφαρμογή του παράγοντα (για παράδειγμα, start_with_generic_host.py, app.pyή main.py).

Ή με υπεριώδη ακτινοβολία:

uv run python <main.py>

Ο διακομιστής αντιπροσώπων σας θα πρέπει τώρα να εκτελείται και να είναι έτοιμος για να λάβει αιτήσεις από το Agents Playground ή εφαρμογές του Microsoft 365.

Πράκτορας δοκιμής στην παιδική χαρά αντιπροσώπων

Το Agents Playground είναι ένα τοπικό εργαλείο δοκιμών που προσομοιώνει το περιβάλλον του Microsoft 365 χωρίς να απαιτείται πλήρης ρύθμιση μισθωτή. Είναι ο ταχύτερος τρόπος για να επικυρώσετε τις κλήσεις λογικής και εργαλείου του παράγοντα σας. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δοκιμή με το Agents Playground.

Ανοίξτε ένα νέο τερματικό (PowerShell στα Windows) και ξεκινήστε το Agents Playground:

agentsplayground

Αυτό ανοίγει ένα πρόγραμμα περιήγησης web με το περιβάλλον εργασίας Agents Playground. Το εργαλείο εμφανίζει ένα περιβάλλον εργασίας συνομιλίας όπου μπορείτε να στείλετε μηνύματα στον πράκτορά σας.

Βασική δοκιμή

Ξεκινήστε επαληθεύοντας ότι ο πράκτοράς σας έχει ρυθμιστεί σωστά. Στείλτε ένα μήνυμα στον πράκτορα:

What can you do?

Ο παράγοντας θα πρέπει να απαντήσει με τις οδηγίες που έχει ρυθμιστεί με, με βάση την προτροπή και τις δυνατότητες του συστήματος του παράγοντα σας. Αυτό επιβεβαιώνει ότι:

  • Ο ατζέντης σας λειτουργεί σωστά
  • Ο παράγοντας μπορεί να επεξεργάζεται μηνύματα και να απαντά
  • Επικοινωνία μεταξύ Agent Playground και ο πράκτοράς σας εργάζεται

Κλήσεις εργαλείου δοκιμής

Μετά τη ρύθμιση των παραμέτρων των διακομιστών εργαλείων MCP στο (ανατρέξτε στην toolingManifest.json ενότητα Εργαλεία για οδηγίες ρύθμισης), δοκιμάστε κλήσεις εργαλείων με παραδείγματα όπως αυτά:

Πρώτα, επαληθεύστε ποια εργαλεία είναι διαθέσιμα:

List all tools I have access to

Στη συνέχεια, δοκιμάστε συγκεκριμένες κλήσεις εργαλείων:

Εργαλεία αλληλογραφίας

Send email to your-email@example.com with subject "Test" and message "Hello from my agent"

Αναμενόμενη απάντηση: Ο παράγοντας στέλνει ένα μήνυμα ηλεκτρονικού ταχυδρομείου χρησιμοποιώντας τον διακομιστή Mail MCP και επιβεβαιώνει την αποστολή του μηνύματος.

Εργαλεία ημερολογίου

List my calendar events for today

Αναμενόμενη απόκριση: Ο παράγοντας θα ανακτήσει και θα εμφανίσει τα συμβάντα ημερολογίου σας για την τρέχουσα ημέρα.

Εργαλεία του SharePoint

List all SharePoint sites I have access to

Αναμενόμενη απόκριση: Ο παράγοντας υποβάλλει ερώτημα στο SharePoint και επιστρέφει μια λίστα με τις τοποθεσίες στις οποίες έχετε πρόσβαση.

Μπορείτε να προβάλετε το εργαλείο στις εξής κλήσεις:

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

Δοκιμή με δραστηριότητες ειδοποίησης

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

Πριν από τη δοκιμή των δραστηριοτήτων ειδοποίησης, βεβαιωθείτε ότι έχετε:

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

Για να στείλετε προσαρμοσμένες δραστηριότητες:

  1. Ξεκινήστε τον ατζέντη σας και το Agents Playground
  2. Στο Agents Playground, μεταβείτε στο Mock an Activity>Custom activity
  3. Αντιγράψτε το conversationId από τη δραστηριότητα (το αναγνωριστικό συνομιλίας αλλάζει κάθε φορά που γίνεται επανεκκίνηση του Agents Playground)
  4. Επικολλήστε το JSON προσαρμοσμένης δραστηριότητάς σας και ενημερώστε το personal-chat-id πεδίο με το αναγνωριστικό συνομιλίας που αντιγράψατε. Ανατρέξτε στο παράδειγμα ειδοποίησης ηλεκτρονικού ταχυδρομείου
  5. Επιλέξτε Προσθήκη δραστηριότητας.
  6. Προβολή του αποτελέσματος τόσο στη συνομιλία όσο και στον πίνακα καταγραφής

Ειδοποίηση με μήνυμα ηλεκτρονικού ταχυδρομείου

Αυτό προσομοιώνει ένα μήνυμα ηλεκτρονικού ταχυδρομείου που αποστέλλεται στον παράγοντα. Αντικαταστήστε τις τιμές συμβόλων κράτησης θέσης με τις πραγματικές λεπτομέρειες του παράγοντα:

{
  "type": "message",
  "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "timestamp": "2025-09-24T17:40:19+00:00",
  "serviceUrl": "http://localhost:56150/_connector",
  "channelId": "agents",
  "name": "emailNotification",
  "from": {
    "id": "manager@contoso.com",
    "name": "Agent Manager",
    "role": "user"
  },
  "recipient": {
    "id": "agent@contoso.com",
    "name": "Agent",
    "agenticUserId": "<your-agentic-user-id>",
    "agenticAppId": "<your-agent-app-id>",
    "tenantId": "<your-tenant-id>"
  },
  "conversation": {
    "conversationType": "personal",
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "id": "personal-chat-id"
  },
  "membersAdded": [],
  "membersRemoved": [],
  "reactionsAdded": [],
  "reactionsRemoved": [],
  "locale": "en-US",
  "attachments": [],
  "entities": [
    {
      "id": "email",
      "type": "productInfo"
    },
    {
      "type": "clientInfo",
      "locale": "en-US",
      "timezone": null
    },
    {
      "type": "emailNotification",
      "id": "bbbbbbbb-1111-2222-3333-cccccccccccc",
      "conversationId": "personal-chat-id",
      "htmlBody": "<body dir=\"ltr\">\n<div class=\"elementToProof\" style=\"font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);\">\nYour email message content here</div>\n\n\n</body>"
    }
  ],
  "channelData": {
    "tenant": {
      "id": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
    }
  },
  "listenFor": [],
  "textHighlights": []
}

Προβολή αρχείων καταγραφής παρατηρησιμότητας

Για να προβάλετε τα αρχεία καταγραφής παρατηρησιμότητας κατά τη διάρκεια της τοπικής ανάπτυξης, ρυθμίστε τον πράκτορά σας με κώδικα παρατηρησιμότητας (ανατρέξτε στην ενότητα Παρατηρησιμότητα για παραδείγματα κώδικα) και ρυθμίστε τις παραμέτρους των μεταβλητών περιβάλλοντος όπως περιγράφεται στις Μεταβλητές δυνατότητας παρατήρησης. Όταν ρυθμιστούν οι παράμετροι, τα ίχνη σε πραγματικό χρόνο εμφανίζονται στην κονσόλα και εμφανίζουν τα εξής:

  • Ανιχνεύσεις κλήσης παράγοντα
  • Λεπτομέρειες εκτέλεσης εργαλείου
  • Κλήσεις συμπερασμών LLM
  • Μηνύματα εισόδου και εξόδου
  • Χρήση διακριτικού
  • Χρόνος απόκρισης
  • Πληροφορίες σφάλματος

Αυτά τα αρχεία καταγραφής σάς βοηθούν να εντοπίσετε σφάλματα, να κατανοήσετε τη συμπεριφορά του παράγοντα και να βελτιστοποιήσετε τις επιδόσεις.

Αντιμετώπιση προβλημάτων

Αυτή η ενότητα παρέχει λύσεις για συνήθη προβλήματα που ενδέχεται να αντιμετωπίσετε κατά τη δοκιμή του παράγοντα σας τοπικά.

Προβλήματα σύνδεσης και περιβάλλοντος

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

Ζητήματα σύνδεσης Agents Playground

Σύμπτωμα: Agents Playground δεν μπορεί να συνδεθεί με τον πράκτορά σας

Λύσεις:

  • Επαλήθευση ότι ο διακομιστής αντιπροσώπων σας εκτελείται
  • Ελέγξτε ότι οι αριθμοί των θυρών ταιριάζουν μεταξύ του πράκτορά σας και του Agents Playground
  • Βεβαιωθείτε ότι δεν υπάρχουν κανόνες τείχους προστασίας που αποκλείουν τις τοπικές συνδέσεις
  • Δοκιμάστε να επανεκκινήσετε τόσο τον πράκτορα όσο και το Agents Playground

Ξεπερασμένη έκδοση Agent Playground

Σύμπτωμα: Μη αναμενόμενα σφάλματα ή δυνατότητες που λείπουν στο Agents Playground

Λύση: Κατάργηση εγκατάστασης και επανεγκατάσταση του Agents Playground:

winget uninstall agentsplayground
winget install agentsplayground

Διενέξεις θυρών

Σύμπτωμα: Σφάλμα που υποδεικνύει ότι η θύρα χρησιμοποιείται ήδη

Λύση:

  • Διακοπή τυχόν άλλων παρουσιών του πράκτορά σας
  • Αλλαγή της θύρας στη ρύθμιση παραμέτρων σας
  • Θα πρέπει να χρησιμοποιείται η διαδικασία μέσω της θύρας:
# Windows PowerShell
Get-Process -Id (Get-NetTCPConnection -LocalPort <port>).OwningProcess | Stop-Process

Δεν είναι δυνατή η προσθήκη του DeveloperMCPServer

Σύμπτωμα: Σφάλμα κατά την προσπάθεια προσθήκης του DeveloperMCPServer στο VS Code

Λύση: Κλείστε και ανοίξτε ξανά το Visual Studio Code και, στη συνέχεια, δοκιμάστε να προσθέσετε ξανά τον διακομιστή.

Ζητήματα ελέγχου ταυτότητας

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

Το διακριτικό φορέα έληξε

Σύμπτωμα: Σφάλματα ελέγχου ταυτότητας ή 401 μη εξουσιοδοτημένες αποκρίσεις

Λύση: Τα διακριτικά φορέα λήγουν μετά από περίπου 1 ώρα. Αποκτήστε ένα νέο διακριτικό και ενημερώστε τη ρύθμιση παραμέτρων σας.

Σφάλματα ελέγχου ταυτότητας παράγοντα στην Python

Σύμπτωμα: Σφάλμα απόκτησης διακριτικού παρουσίας παράγοντα

Λύση: Επαληθεύστε τη ALT_BLUEPRINT_NAME ρύθμιση στο :.env

# Change from:
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=ServiceConnection

# To:
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=SERVICE_CONNECTION

Ζητήματα εργαλείων και ειδοποιήσεων

Αυτά τα ζητήματα αφορούν προβλήματα με κλήσεις εργαλείων, αλληλεπιδράσεις διακομιστή MCP και παράδοση ειδοποιήσεων.

Δεν λάβατε μήνυμα ηλεκτρονικού ταχυδρομείου

Σύμπτωμα: Ο παράγοντας υποδεικνύει ότι στάλθηκε μήνυμα ηλεκτρονικού ταχυδρομείου, αλλά δεν το λαμβάνετε

Λύσεις:

  • Ελέγξτε τον φάκελο Ανεπιθύμητα/Ανεπιθύμητα μηνύματα
  • Η παράδοση μέσω ηλεκτρονικού ταχυδρομείου μπορεί να καθυστερήσει κατά μερικά λεπτά - αναμονή έως 5 λεπτά
  • Επαλήθευση ότι η διεύθυνση ηλεκτρονικού ταχυδρομείου παραλήπτη είναι σωστή
  • Αρχεία καταγραφής παράγοντα ελέγχου για τυχόν σφάλματα κατά την αποστολή μηνύματος ηλεκτρονικού ταχυδρομείου

Οι απαντήσεις σχολίων του Word δεν λειτουργούν

Γνωστό πρόβλημα: Η υπηρεσία ειδοποιήσεων αυτήν τη στιγμή δεν μπορεί να απαντήσει απευθείας στα σχόλια του Word. Αυτή η λειτουργικότητα αναπτύσσεται.

Λήψη βοήθειας

Εάν αντιμετωπίσετε προβλήματα που δεν καλύπτονται σε αυτή την ενότητα αντιμετώπισης προβλημάτων, εξερευνήστε αυτούς τους πόρους:

Αποθετήρια δεδομένων SDK Microsoft Agent 365

Περισσότερη υποστήριξη

  • Εξέταση δείγματος κώδικα και τεκμηρίωσης στα αποθετήρια δεδομένων SDK του Microsoft Agent 365
  • Υποβολή ζητημάτων μέσω ζητημάτων GitHub στο σχετικό αποθετήριο δεδομένων

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

Τώρα που έχετε δοκιμάσει επιτυχώς τον πράκτορά σας τοπικά, είστε έτοιμοι να τον αναπτύξετε στο Azure και να τον δημοσιεύσετε στο Microsoft 365:

  • Ανάπτυξη και δημοσίευση παραγόντων: Μάθετε πώς μπορείτε να αναπτύξετε τον πράκτορά σας στην εφαρμογή Web Azure και να τον δημοσιεύσετε στο Κέντρο διαχείρισης της Microsoft, καθιστώντας το διαθέσιμο στον οργανισμό σας για εντοπισμό και πρόσληψη στο Microsoft 365.
  • Last updated on