Οδηγός αντιμετώπισης προβλημάτων του Agent 365

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

Βήματα αντιμετώπισης προβλημάτων

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

Στάδιο Περιεχόμενο αντιμετώπισης προβλημάτων
Δημιουργία και εκτέλεση παράγοντα Agent 365 CLI
Εγγραφή προσαρμοσμένης εφαρμογής προγράμματος-πελάτη για το Agent 365 CLI
Προσομοιωμένος διακομιστής εργαλείων
Παρατηρησιμότητα παράγοντα
Δοκιμή παραγόντων
Δοκιμή παραγόντων με χρήση διοχετεύσεων προγραμματιστών
Προσθήκη και διαχείριση εργαλείων
Ρύθμιση δομής προγράμματος παράγοντα Ρύθμιση δομής προγράμματος παράγοντα
Ανάπτυξη Ανάπτυξη παράγοντα στο Azure
Ανάπτυξη παράγοντα στις Υπηρεσίες Web της Amazon (AWS)
Ανάπτυξη παράγοντα στην Πλατφόρμα Google Cloud (GCP)
Δημοσίευση παράγοντα στο Κέντρο διαχείρισης Microsoft 365 Δημοσίευση παράγοντα στο κέντρο διαχείρισης της Microsoft
Δημιουργία παρουσιών παράγοντα Δημιουργία παρουσιών παράγοντα

Αναφορά διαγνωστικών εντολών

Πριν εστιάσετε σε συγκεκριμένα προβλήματα, χρησιμοποιήστε αυτές τις εντολές για να ελέγξετε την τρέχουσα κατάσταση της ρύθμισης του Agent 365:

Ελέγξτε το CLI και τη διαμόρφωση

Χρησιμοποιήστε αυτές τις εντολές για να επικυρώσετε το CLI και τη διαμόρφωσή σας.

# Verify CLI is installed and check version
a365 --version

# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

Επαλήθευση πόρων Azure

Χρησιμοποιήστε αυτές τις εντολές για να επιθεωρήσετε τους πόρους Azure και την κατάσταση της εφαρμογής.

# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>

# Authenticate with Azure
az login

# List resources in your resource group
az resource list --resource-group $resource-group --output table

# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state

# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group

Επαλήθευση δομής προγράμματος παράγοντα

Επιβεβαιώστε ότι το σχέδιο του παράγοντά σας υπάρχει και έχει ρυθμιστεί σωστά.

# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

Επαλήθευση δομής προγράμματος στο Microsoft Entra

  1. Μεταβείτε σε https://entra.microsoft.com>Καταχωρήσεις εφαρμογών>Όλες οι εφαρμογές.
  2. Αναζητήστε το agentBlueprintId σας.

Βέλτιστες πρακτικές πρόληψης

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

Προτού ξεκινήσετε

Λίστα ελέγχου προαπαιτούμενων:

✅ Εγκατεστημένο .NET 8.0 SDK
✅ Εγκατεστημένο και αυθεντικοποιημένο Azure CLI
✅Απαιτούμενα δικαιώματα Entra που έχουν εκχωρηθεί
✅ Δημιουργήθηκε και διαμορφώθηκε προσαρμοσμένη εφαρμογή πελάτη
✅ Ενεργοποιημένος μισθωτής για το Microsoft Agent 365 Frontier

Εντολές επικύρωσης:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Στη διάρκεια ανάπτυξης

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

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

Διατηρήστε το CLI ενημερωμένο:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Σταδιακή δοκιμή:

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

Πριν από την ανάπτυξη

Λίστα ελέγχου πριν από τη διάθεση:

✅ Ο παράγοντας λειτουργεί τοπικά με το Agents Playground.
✅ Όλες οι μεταβλητές περιβάλλοντος τεκμηριωμένες.
✅ Τα αρχεία διαμόρφωσης έχουν καταχωρηθεί στον έλεγχο πηγαίου κώδικα.
✅ Οι διακομιστές MCP έχουν διαμορφωθεί και δοκιμαστεί
✅ Παρατηρησιμότητα ενεργοποιημένη και επαληθευμένη.

Λήψη πρόσθετης βοήθειας

Για να εξετάσετε δείγματα κώδικα, να αναφέρετε προβλήματα ή να αναζητήσετε υπάρχοντα προβλήματα, χρησιμοποιήστε αυτά τα αποθετήρια κώδικα:

  • Last updated on