Δοκιμή παραγόντων με χρήση διοχετεύσεων προγραμματιστών

Χρησιμοποιώντας Dev Tunnels, μπορείτε να δοκιμάσετε τον Agent 365 παράγοντα με εφαρμογές Microsoft 365 (όπως Teams, Outlook ή Word) ενώ ο παράγοντας εκτελείται τοπικά στον υπολογιστή ανάπτυξης σας. Αυτή η προσέγγιση γεφυρώνει την τοπική ανάπτυξη και τις δοκιμές σε πραγματικά περιβάλλοντα, ώστε να μπορείτε να επικυρώσετε τη συμπεριφορά του παράγοντα σε πραγματικά περιβάλλοντα Microsoft 365 πριν από την ανάπτυξή του στο cloud.

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

Πριν χρησιμοποιήσετε το Dev Tunnels, βεβαιωθείτε ότι έχετε εγκαταστήσει το εργαλείο γραμμής εντολών Dev Tunnels.

• Windows: winget install Microsoft.devtunnel
• macOS/Linux: Κατεβάστε από aka.ms/devtunnels/download

Ρύθμιση Dev Tunnel

Διαμορφώστε ένα Dev Tunnel για να εκθέσετε το τοπικό τελικό σημείο του παράγοντα στις υπηρεσίες του Microsoft 365.

Δημιουργία και έναρξη διοχέτευσης

1. Συνδεθείτε στο Dev Tunnel:

   devtunnel user login
   

2. Δημιουργήστε μια μόνιμη διοχέτευση:

   devtunnel create --allow-anonymous
   

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

3. Διαμορφώστε τη θύρα της διοχέτευσης:

   Ορίστε τη θύρα που χρησιμοποιεί ο διακομιστής παράγοντα σας (συνήθως 3978):

   devtunnel port create <tunnel-id> -p <port-number>
   

4. Ξεκινήστε τη διοχέτευση:

   devtunnel host <tunnel-id>
   

   Η εντολή εμφανίζει τη διεύθυνση URL της διοχέτευσής σας (για παράδειγμα, https://abc123xyz.devtunnels.ms:3978). Αντιγράψτε αυτήν τη διεύθυνση URL για το επόμενο βήμα.

Φιλοδώρημα

Χρησιμοποιήστε το devtunnel list για να δείτε όλες τις διοχετεύσεις σας και το devtunnel delete <tunnel-id> για να αφαιρέσετε διοχετεύσεις που δεν χρειάζεστε πλέον.

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

Εγγράψτε το URL του Dev Tunnel (για παράδειγμα, https://abc123xyz.devtunnels.ms:3978/api/messages) ως το τελικό σημείο ανταλλαγής μηνυμάτων παράγοντα, ώστε το Microsoft 365 να γνωρίζει πού να δρομολογεί τα μηνύματα. Μην ξεχάσετε το επίθημα /api/messages στο τελικό σημείο.

Ανατρέξτε στην ενότητα Ορισμός τελικού σημείου ανταλλαγής μηνυμάτων παράγοντα

Δοκιμάστε με το Microsoft 365

Με το Dev Tunnel ενεργό και το endpoint καταχωρημένο, δοκιμάστε τον παράγοντα σας σε εφαρμογές Microsoft 365.

Δοκιμή στο Microsoft Teams

1. Ξεκινήστε τον τοπικό σας παράγοντα ακολουθώντας τις οδηγίες στην ενότητα «Εγκατάσταση εξαρτημάτων και εκκίνηση του διακομιστή εφαρμογών παράγοντα».

2. Επαληθεύστε τη συνδεσιμότητα της διοχέτευσης:

   devtunnel list
   

   Ελέγξτε ότι η διοχέτευσή σας εμφανίζει ενεργές συνδέσεις φιλοξενίας. Η στήλη "Συνδέσεις φιλοξενίας" θα πρέπει να εμφανίζει έναν αριθμό μεγαλύτερο του 0.

3. Αλληλεπιδράστε με τον παράγοντά σας στο Teams:

   • Ανοίξτε το Microsoft Teams (web έκδοση ή desktop έκδοση)
   • Στη γραμμή αναζήτησης του Teams, αναζητήστε τον παράγοντας σας με όνομα ή email
   • Ξεκινήστε συνομιλία με τον παράγοντά σας
   • Στείλτε ένα μήνυμα και ελέγξτε την απάντηση
   • Ελέγξτε την τοπική κονσόλα σας για εισερχόμενες αιτήσεις και δραστηριότητα παράγοντα

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

Εάν ο παράγοντας σας έχει διαμορφωθεί για ειδοποιήσεις μέσω email:

1. Στείλτε ένα email στη διεύθυνση email του παράγοντα σας
2. Κοινοποιήστε τον παράγοντά σας σε ένα νήμα email
3. Παρακολουθήστε την τοπική κονσόλα σας για το webhook ειδοποίησης
4. Επαληθεύστε ότι ο παράγοντας σας διαχειρίζεται και απαντά στο email

Δοκιμάστε την ενοποίηση με το Word

Για παράγοντες που απαντούν σε σχόλια του Word:

1. Ανοίξτε ένα έγγραφο του Word στο οποίο ο παράγοντας σας έχει πρόσβαση.
2. Προσθέστε ένα σχόλιο με αναφορά στον παράγοντα σας.
3. Ελέγξτε την τοπική κονσόλα σας για την ειδοποίηση.
4. Επαληθεύστε ότι η απάντηση του παράγοντα εμφανίζεται στο Word.

Παρακολουθήστε τη δραστηριότητα της διοχέτευσης

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

devtunnel show <tunnel-id>

Αυτή η εντολή εμφανίζει:

• Ενεργές συνδέσεις και λεπτομέρειες συνεδρίας.
• Πληροφορίες αιτήματος και απάντησης.
• Στατιστικά όγκου κίνησης.
• Σφάλματα σύνδεσης και ειδοποιήσεις.

Μπορείτε επίσης να παρακολουθείτε τη δραστηριότητα της σήραγγας σε πραγματικό χρόνο μέσω της εξόδου της εντολής devtunnel host.

Διατήρηση συνδέσεων διοχέτευσης

Οι Dev Tunnels απαιτούν η διαδικασία devtunnel host να παραμένει σε λειτουργία. Αν η αδράνεια, τα προβλήματα δικτύου ή η αναστολή λειτουργίας του υπολογιστή σας προκαλέσουν διακοπή της σύνδεσης, πρέπει να επανεκκινήσετε τη διαδικασία της διοχέτευσης.

Έλεγχος κατάστασης διοχέτευσης

Ελέγξτε αν η διοχέτευσή σας είναι ενεργή:

devtunnel list

Η έξοδος εμφανίζει:

• Αναγνωριστικό διοχέτευσης: Το αναγνωριστικό της διοχέτευσής σας
• Συνδέσεις φιλοξενίας: Αριθμός ενεργών συνδέσεων (θα πρέπει να είναι μία ή περισσότερες όταν devtunnel host είναι σε λειτουργία)
• Θύρες: Διαμορφωμένες θύρες
• Λήξη: Χρόνος λήξης της διοχέτευσης

Εάν οι Συνδέσεις φιλοξενίας εμφανίζουν 0, η διοχέτευση υπάρχει αλλά δεν φιλοξενείται αυτήν τη στιγμή.

Επανεκκινήστε μια αποσυνδεδεμένη διοχέτευση

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

devtunnel host <tunnel-id>

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

Διατηρήστε τις διοχετεύσεις ενεργές κατά τη διάρκεια της ανάπτυξης

Για να διατηρήσετε σταθερές συνδέσεις:

• Κρατήστε το παράθυρο του τερματικού ανοιχτό - Μην κλείνετε το τερματικό που εκτελείdevtunnel host.
• Αποτρέψτε την αναστολή λειτουργίας του υπολογιστή - Ρυθμίστε το σύστημά σας ώστε να μην μπαίνει σε κατάσταση αναστολής λειτουργίας κατά τη διάρκεια των δοκιμών.
• Παρακολουθήστε για σφάλματα σύνδεσης - Παρακολουθήστε την devtunnel host έξοδο του τερματικού για μηνύματα αποσύνδεσης.
• Επανεκκινήστε μετά από αλλαγές δικτύου - Αν αλλάξετε δίκτυο ή επανασυνδεθείτε σε VPN, επανεκκινήστε τη διοχέτευση.

Φιλοδώρημα

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

Εκκαθάριση

Όταν ολοκληρώσετε τις δοκιμές με τα Dev Tunnels:

Σταματήστε τη διοχέτευση

Πατήστε Ctrl+C στο τερματικό όπου εκτελείται το devtunnel host για να σταματήσετε τη διοχέτευση.

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

Σημείωμα

Η διοχέτευση παραμένει διαθέσιμη για μελλοντική χρήση μέχρι να τη διαγράψετε ρητά χρησιμοποιώντας devtunnel delete <tunnel-id>.

Περιορισμοί

Λάβετε υπόψη αυτούς τους περιορισμούς κατά τη δοκιμή με Dev Tunnels:

• Μόνο ανάπτυξη: Χρησιμοποιήστε Dev Tunnels για ανάπτυξη και δοκιμή, όχι για παραγωγή.
• Απόδοση: Αναμένετε υψηλότερη καθυστέρηση σε σύγκριση με παράγοντες που φιλοξενούνται στο cloud λόγω της δρομολόγησης του δικτύου.
• Σταθερότητα σύνδεσης: Οι συνδέσεις διοχέτευσης ενδέχεται να διακόπτονται περιστασιακά και να απαιτούν χειροκίνητη επανεκκίνηση.
• Ζητήματα ασφαλείας: Η --allow-anonymous σημαία είναι βολική για δοκιμές, αλλά μην τη χρησιμοποιείτε με ευαίσθητα δεδομένα.
• Διαχείριση συνεδρίας: Μπορεί να χρειαστεί να επαναλάβετε τον έλεγχο ταυτότητας περιοδικά, ανάλογα με τη διάρκεια της συνεδρίας.

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

Μετά την επιτυχή δοκιμή του Dev Tunnel:

• Αναπτύξτε τον παράγοντα σας στο cloud: Αναπτύξτε στο Azure, Ορίστε το σημείο ανταλλαγής μηνυμάτων του παράγοντα στο AWS, ή Ορίστε το σημείο ανταλλαγής μηνυμάτων του παράγοντα στο GCP.
• Ρυθμίστε τα τελικά σημεία ανταλλαγής μηνυμάτων παράγοντα: τελικό σημείο ανταλλαγής μηνυμάτων παράγοντα.
• Ακολουθήστε τον πλήρη κύκλο ζωής ανάπτυξης: Κύκλος ζωής ανάπτυξης Agent 365.

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

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

Η σύνδεση του Dev Tunnel αποτυγχάνει

Συμπτώματα: Το Dev Tunnel δεν ξεκινά ή αποσυνδέεται αμέσως.

Λύσεις:

• Βεβαιωθείτε ότι είστε συνδεδεμένοι: devtunnel user login
• Ελέγξτε εάν μια άλλη διαδικασία χρησιμοποιεί την ίδια θύρα
• Βεβαιωθείτε ότι το τείχος προστασίας σας επιτρέπει συνδέσεις Dev Tunnel
• Διαγράψτε και δημιουργήστε ξανά τη διοχέτευση: devtunnel delete <tunnel-id> και στη συνέχεια δημιουργήστε μια νέα

Τα μηνύματα δεν φτάνουν στον τοπικό παράγοντα

Συμπτώματα: Το Microsoft 365 υποδεικνύει ότι το μήνυμα στάλθηκε, αλλά ο τοπικός σας παράγοντας δεν το λαμβάνει.

Λύσεις:

• Βεβαιωθείτε ότι ο παράγοντας σας εκτελείται τοπικά
• Επιβεβαιώστε ότι το Dev Tunnel είναι ενεργό: το devtunnel list θα πρέπει να εμφανίζει την ένδειξη "Συνδέθηκε"
• Ελέγξτε τη διαμόρφωση του τελικού σημείου στο a365.config.json και βεβαιωθείτε ότι το URL του Dev Tunnel έχει οριστεί ως το τελικό σημείο ανταλλαγής μηνυμάτων
• Ελέγξτε τα αρχεία καταγραφής του Dev Tunnel στο τερματικό όπου εκτελείται το devtunnel host για σφάλματα σύνδεσης
• Βεβαιωθείτε ότι η τοπική σας θύρα αντιστοιχεί στη θύρα του Dev Tunnel (και οι δύο θα πρέπει να είναι 3978 από προεπιλογή)

Σφάλματα ελέγχου ταυτότητας μέσω του Dev Tunnel

Συμπτώματα: Σφάλματα 401 ή 403 κατά τη δοκιμή μέσω του Dev Tunnel.

Λύσεις:

• Επαληθεύστε ότι έχει ρυθμιστεί ο έλεγχος ταυτότητας παράγοντα (ο έλεγχος ταυτότητας με διακριτικό φορέα δεν λειτουργεί με Dev Tunnels για ενοποίηση Microsoft 365).
• Ελέγξτε τα διαπιστευτήρια Blueprint παράγοντα στο a365.generated.config.json.
• Επιβεβαιώστε ότι ο παράγοντας σας έχει τα απαιτούμενα δικαιώματα για τις λειτουργίες που δοκιμάζετε.
• Βεβαιωθείτε ότι τα διακριτικά ελέγχου ταυτότητας δεν έχουν λήξει.

Η διεύθυνση URL του tunnel άλλαξε ή έληξε

Συμπτώματα: Μια προηγουμένως λειτουργική διεύθυνση tunnel URL δεν κατευθύνεται πλέον στον παράγοντα σας.

Λύσεις:

• Ελέγξτε την κατάσταση της διοχέτευσης χρησιμοποιώντας το devtunnel list.
• Επανεκκινήστε τη διοχέτευση χρησιμοποιώντας το devtunnel host <tunnel-id>.
• Ενημερώστε το σημείο ανταλλαγής μηνυμάτων αν αλλάξει η διεύθυνση URL χρησιμοποιώντας το a365 setup blueprint --endpoint-only.