Ρύθμιση δομής προγράμματος παράγοντα

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

Σημείωμα

Η ρύθμιση ενός σχεδίου παράγοντα είναι απαραίτητη για την ενεργοποίηση των δυνατοτήτων Καταχώριση, Work IQ και Συμπαίκτης AI. Δείτε Ξεκινήστε με την ανάπτυξη του Agent 365 για να κατανοήσετε ποιες δυνατότητες εφαρμόζονται στον παράγοντά σας.

Για περισσότερες πληροφορίες σχετικά με το Agent 365 Identity, δείτε Agent 365 Identity.

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

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

  1. Agent 365 CLI - Δείτε Εγκατάσταση του Agent 365 CLI.

  2. Απαιτούμενα δικαιώματα:

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

    Φιλοδώρημα

    Οι παράγοντες (όχι οι συμπαίκτες AI) δεν χρειάζονται αρχείο διαμόρφωσης. Χρησιμοποιήστε a365 setup all --agent-name <name> και το CLI εντοπίζει αυτόματα τον μισθωτή και την εφαρμογή-πελάτη σας. Η ρύθμιση συμπαίκτη AI απαιτεί χειροκίνητη δημιουργία a365.config.json.

Δημιουργία σχεδίου παράγοντα

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

Εκτελέστε την εγκατάσταση

Εκτέλεση της εντολής εγκατάστασης:

a365 setup -h

Η εντολή έχει διάφορες επιλογές. Μπορείτε να ολοκληρώσετε ολόκληρη τη ρύθμιση με μία μόνο εντολή χρησιμοποιώντας a365 setup all ή να επιλέξετε πιο λεπτομερείς επιλογές.

Σημείωμα

Το a365 setup all έχει ως προεπιλογή τη λειτουργία παράγοντα blueprint. Για να δημιουργήσετε έναν παράγοντα συμπαίκτη AI, καταχωρίστε το --aiteammate. Για τους M365 παράγοντες (Teams, Copilot), καταχωρίστε επίσης --m365 ώστε να καταχωρηθεί αυτόματα το σημείο ανταλλαγής μηνυμάτων.

Ρύθμιση παράγοντα (προεπιλογή):

# With a config file
a365 setup all

# Config-free — no a365.config.json needed
a365 setup all --agent-name <your-agent-name>

Ρύθμιση παράγοντα M365 (Teams/Copilot):

# Registers the messaging endpoint via MCP Platform
a365 setup all --m365

Ρύθμιση συμπαίκτη AI:

a365 setup all --aiteammate

Ολόκληρη η διαδικασία εγκατάστασης εκτελεί αυτές τις λειτουργίες:

  1. Δημιουργεί υποδομή Azure (εάν δεν υπάρχει ήδη):

    • Ομάδα πόρων
    • App Service Plan με καθορισμένο SKU
    • Azure Web App με ενεργοποιημένη τη διαχειριζόμενη ταυτότητα

  2. Καταχωρίζει το σχέδιο παράγοντα:

    • Δημιουργεί το σχέδιο παράγοντα στον μισθωτή σας Microsoft Entra
    • Δημιουργεί καταχωρήσεις εφαρμογών Microsoft Entra
    • Διαμορφώνει την ταυτότητα παράγοντα με τα απαιτούμενα δικαιώματα
    • Θέτει managerApplications στο σχέδιο, το οποίο απαιτείται για τη διαχειρισιμότητα της πλατφόρμας

    Σημαντικό

    Τα σχέδια πρέπει να έχουν το managerApplications καθορισμένο για να γίνουν αποδεκτά από την πλατφόρμα. Το CLI το διαμορφώνει αυτόματα. Εάν έχετε ένα υπάρχον πρότυπο που δημιουργήθηκε πριν από την εισαγωγή αυτής της απαίτησης, διαγράψτε το και εκτελέστε ξανά το a365 setup all, ή διορθώστε το χειροκίνητα μέσω του Graph API.

  3. Ρύθμιση παραμέτρων δικαιωμάτων API:

    • Ρύθμιση πεδίων Microsoft Graph API
    • Ρυθμίζει τα δικαιώματα API του Bot μηνυμάτων
    • Εφαρμόζει κληρονομήσιμα δικαιώματα για στιγμιότυπα παραγόντων

  4. Ενημερώνει τα αρχεία διαμόρφωσης:

    • Αποθηκεύει τα αναγνωριστικά και τα τελικά σημεία που δημιουργούνται σε ένα νέο αρχείο στον κατάλογο εργασίας σας που ονομάζεται a365.generated.config.json
    • Καταγράφει τα στοιχεία της διαχειριζόμενης ταυτότητας και των πόρων

Σημείωμα

Η εγκατάσταση διαρκεί συνήθως 3-5 λεπτά και αποθηκεύει αυτόματα τη διαμόρφωση σε a365.generated.config.json. Εάν εκτελείτε ως καθολικός διαχειριστής, το CLI μπορεί να ανοίξει ένα παράθυρο του προγράμματος περιήγησης για συγκατάθεση διαχειριστή - ολοκληρώστε τη ροή συγκατάθεσης για να συνεχίσετε. Εάν εκτελείτε ως προγραμματιστής αναγνωριστικού παράγοντα, δεν εμφανίζεται κανένα παράθυρο του προγράμματος περιήγησης. Το CLI δημιουργεί διευθύνσεις URL συγκατάθεσης για να τις συμπληρώσει αργότερα ένας καθολικός διαχειριστής.

Ρύθμιση με χρήση του προγραμματιστή αναγνωριστικού παράγοντα

Αν εκτελείτε ως προγραμματιστής αναγνωριστικού παράγοντα (όχι ως καθολικός διαχειριστής), το a365 setup all ολοκληρώνει αυτόματα τα περισσότερα βήματα, αλλά οι χορηγήσεις δικαιωμάτων OAuth2 απαιτούν ξεχωριστό βήμα από καθολικό διαχειριστή.

Ποια βήματα ολοκληρώνονται αυτόματα:

  • Υποδομή Azure (ομάδα πόρων, App Service Plan, Web App)
  • Εγγραφή σχεδίου παράγοντα
  • Κληρονομήσιμα δικαιώματα για παρουσίες παραγόντων

Ποια βήματα απαιτούν τον ρόλο του καθολικού διαχειριστή:

  • Εκχωρήσεις δικαιωμάτων με ανάθεση OAuth2 (AllPrincipalsσυγκατάθεση) για Microsoft Graph, Agent 365 Tools, Messaging Bot API, Observability API και Power Platform API

Πώς να ολοκληρώσετε τη ρύθμιση με λογαριασμό χωρίς δικαιώματα διαχειριστή:

Βήμα Ποιος Ενέργεια
1 Προγραμματιστής Εκτελέστε το a365 setup all. Το CLI ολοκληρώνει όλα τα δυνατά βήματα και εκτυπώνει τα επόμενα βήματα, συμπεριλαμβανομένης μιας διεύθυνσης URL συναίνεσης για να την ανοίξει ένας καθολικός διαχειριστής.
2 Προγραμματιστής Κοινοποιήστε τη διεύθυνση URL συναίνεσης από την έξοδο του CLI με τον καθολικό διαχειριστή σας.
3 Καθολικός διαχειριστής Ανοίξτε τη διεύθυνση URL συναίνεσης σε ένα πρόγραμμα περιήγησης που έχει συνδεθεί ως καθολικός διαχειριστής και παραχωρήστε τα ζητούμενα δικαιώματα.

Εκτέλεση των εντολών:

# Developer runs:
a365 setup all
# Setup completes all steps it can. The CLI prints the next steps
# for a Global Administrator directly in the output, including a
# direct link or consent URL they can open to complete the grants.

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

Επαληθεύστε την εγκατάσταση

Όταν ολοκληρωθεί η ρύθμιση, εμφανίζεται μια σύνοψη με όλα τα ολοκληρωμένα βήματα. Επαλήθευση των δημιουργημένων πόρων:

  1. Επαληθεύστε τη διαμόρφωση που δημιουργήθηκε:

    Ανοίξτε το a365.generated.config.json στον κατάλογο εργασίας σας. Ή κάντε χρήση του PowerShell:

    Get-Content a365.generated.config.json | ConvertFrom-Json

    Το αναμενόμενο αποτέλεσμα περιλαμβάνει αυτές τις κρίσιμες τιμές:

    {
"managedIdentityPrincipalId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"agentBlueprintId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"agentBlueprintObjectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"agentBlueprintServicePrincipalObjectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"agentBlueprintClientSecret": "xxx~xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"agentBlueprintClientSecretProtected": true,
"botId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"botMsaAppId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"messagingEndpoint": "https://your-app.azurewebsites.net/api/messages",
"resourceConsents": [],
"completed": true,
"completedAt": "xxxx-xx-xxTxx:xx:xxZ",
"cliVersion": "x.x.xx"
}

    Βασικά πεδία για επαλήθευση:

    Πεδίο Σκοπός Τι να ελέγξετε
    managedIdentityPrincipalId Identity Authentication μέσω Azure Πρέπει να είναι έγκυρο GUID
    agentBlueprintId Το μοναδικό αναγνωριστικό του παράγοντά σας Χρησιμοποιείται στην Πύλη προγραμματιστών και στο κέντρο διαχείρισης
    agentBlueprintObjectId Το Microsoft Entra ID του Blueprint
    messagingEndpoint Δρομολόγηση μηνυμάτων Όπου το Teams/Outlook στέλνει μηνύματα στον παράγοντά σας
    agentBlueprintClientSecret Μυστικός κωδικός ελέγχου ταυτότητας Θα πρέπει να υπάρχει (η τιμή είναι αποκρυμμένη)
    resourceConsents Δικαιώματα API Θα πρέπει να περιέχει πόρους όπως το Microsoft Graph, τα Agent 365 Tools, το Messaging Bot API, το Observability API
    completed Κατάσταση εγκατάστασης Θα πρέπει να είναι true

    Σημείωμα

    Εάν εκτελέσατε τη ρύθμιση ως Διαχειριστής παράγοντας ID ή Developer παράγοντας ID, resourceConsents ενδέχεται να είναι κενό και completed ενδέχεται να είναι false έως ότου ένας καθολικός διαχειριστής ολοκληρώσει τις εκχωρήσεις δικαιωμάτων OAuth2 χρησιμοποιώντας τα επόμενα βήματα που εμφανίζονται από το CLI.

  2. Επαληθεύστε τους πόρους Azure στην πύλη Azure:

    Ή χρησιμοποιήστε την az resource list εντολή PowerShell.

    # List all resources in your resource group
az resource list --resource-group <your-resource-group> --output table

    Βεβαιωθείτε ότι έχουν δημιουργηθεί οι ακόλουθοι πόροι:

    • Ομάδα πόρων:

      • Μεταβείτε στις Ομάδες πόρων>. Επιλέξτε την ομάδα πόρων σας
      • Βεβαιωθείτε ότι περιέχει το πρόγραμμα υπηρεσιών εφαρμογής και την εφαρμογή Web

    • Πρόγραμμα υπηρεσιών εφαρμογής:

      • Μεταβείτε στις Υπηρεσίες εφαρμογών>Σχέδια υπηρεσίας εφαρμογών
      • Βρείτε το σχέδιό σας και βεβαιωθείτε ότι το επίπεδο τιμολόγησης αντιστοιχεί στο SKU διαμόρφωσής σας

    • Εφαρμογή Web:

      • Μεταβείτε στις App Services>Web Apps
      • Βρείτε το web app σας και μεταβείτε στις Ρυθμίσεις>Ταυτότητα>Ανατέθηκε από το σύστημα
      • Η επαλήθευση της κατάστασης είναι ενεργοποιημένη
      • Σημειώστε ότι το αναγνωριστικό αντικειμένου (principal) αντιστοιχεί στο managedIdentityPrincipalId

  3. Επαληθεύστε τις εφαρμογές Microsoft Entra στην πύλη Azure:

    Μεταβείτε στα Azure Active Directory>Καταχωρίσεις εφαρμογών>Όλες οι εφαρμογές:

    • Αναζητήστε το σχέδιο του παράγοντά σας από το agentBlueprintId

    • Ανοίξτε την εφαρμογή και επιλέξτε δικαιώματα API

    • Βεβαιωθείτε ότι τα δικαιώματα έχουν δοθεί και εμφανίζονται με πράσινο σημάδι ελέγχου:

      • Microsoft Graph (εκχωρημένα δικαιώματα και δικαιώματα εφαρμογής)
      • Δικαιώματα του Messaging Bot API

    • Όλα τα δικαιώματα εμφανίζουν "Εκχωρήθηκε για εσάς [Ο μισθωτής σας]"

  4. Επαληθεύστε ότι δημιουργήθηκε το αρχείο διαμόρφωσης:

    Θα πρέπει να διαθέτετε ένα αρχείο με όνομα a365.generated.config.json που περιέχει όλα τα δεδομένα ρύθμισης παραμέτρων.

    Χρησιμοποιήστε την εντολή PowerShell Test-Path για να επαληθεύσετε ότι υπάρχει.

    # Check file exists
Test-Path a365.generated.config.json
# Should return: True

    Σημαντικό

    Αποθηκεύστε και τα δύο αρχεία: a365.config.json και a365.generated.config.json. Χρειάζεστε αυτές τις τιμές για την ανάπτυξη και την αντιμετώπιση προβλημάτων.

  5. Επαληθεύστε ότι η εφαρμογή Web έχει ενεργοποιημένη τη διαχειριζόμενη ταυτότητα:

    Χρησιμοποιήστε την εντολή az webapp identity show για να ελέγξετε αν είναι ενεργοποιημένη η διαχειριζόμενη ταυτότητα.

    az webapp identity show --name <your-web-app> --resource-group <your-resource-group>

    Αναμενόμενο:

    {
"principalId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "SystemAssigned"
}

  6. Επαληθεύστε το σχέδιο παράγοντα που έχει καταχωρηθεί στο Microsoft Entra:

    Στο κέντρο διαχείρισης Microsoft Entra, αναζητήστε το δικό σας agentBlueprintId ή αναζητήστε με βάση το όνομα.

    Βεβαιωθείτε ότι:

    ✅ Εμφανίζονται η εγγραφή εφαρμογής και η εταιρική εφαρμογή
    ✅ Στο πρότυπο εγγραφής εφαρμογής, η καρτέλα Δικαιώματα API εμφανίζει όλα τα δικαιώματα
    ✅ Η κατάσταση εμφανίζει «Παραχωρήθηκε για τον μισθωτή σας»

Για περισσότερη βοήθεια, βλ.:

Δικαιώματα παράγοντα

Πριν οι εφαρμογές και οι παράγοντες μπορέσουν να διαβάσουν ή να γράψουν δεδομένα του Microsoft 365 (χρήστες, αλληλογραφία, αρχεία, Teams, παράγοντες κ.λπ.), πρέπει να τους εκχωρήσετε ρητά δικαιώματα Microsoft Graph. Τα δικαιώματα Microsoft Graph είναι το μοντέλο ελέγχου ταυτότητας που ελέγχει τα δεδομένα και τις ενέργειες στις οποίες μπορεί να έχει πρόσβαση μια εφαρμογή ή υπηρεσία μέσω των API του Microsoft Graph στο Microsoft 365 και το Microsoft Entra ID.

Μάθετε περισσότερα: Επισκόπηση των δικαιωμάτων του Microsoft Graph

Για να χρησιμοποιήσετε τα δικαιώματα Graph για παρουσίες παράγοντα Agent 365, ο προγραμματιστής πρέπει να τα δηλώσει στο σχέδιο παράγοντα. Όταν ένας διαχειριστής ενεργοποιεί το blueprint στο Κέντρο διαχείρισης Microsoft 365, η πύλη ελέγχει τα δικαιώματα Graph του blueprint και ζητά από τον διαχειριστή να συναινέσει σε αυτά.

Για να κατανοήσετε και να επιβεβαιώσετε πώς τα δικαιώματα Graph ενεργοποιούν τον παράγοντα σας, μπορείτε να:

  • Δείτε όλα τα δικαιώματα Graph που είναι διαθέσιμα.
  • Επισκεφτείτε το Graph Explorer για να δοκιμάσετε ερωτήματα, να επιθεωρήσετε απαντήσεις και να κατανοήσετε τα δικαιώματα
  • Χρησιμοποιήστε το Microsoft 365 Agents Playground για να δοκιμάσετε τον παράγοντα σας τοπικά πριν από την ανάπτυξη.

Εφαρμόστε δικαιώματα στο πρότυπο (blueprint) σας

Χρησιμοποιήστε το a365 setup permissions custom για να εφαρμόσετε απευθείας προσαρμοσμένες άδειες API στο πρότυπό σας στο Microsoft Entra.

a365 setup permissions custom `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Mail.Read,Mail.Send,Chat.Read,Chat.ReadWrite,Chat.Create,User.Read

Για πλήρεις λεπτομέρειες σχετικά με τη διαμόρφωση και την κατάργηση προσαρμοσμένων δικαιωμάτων, ανατρέξτε στο θέμα setup permissions custom.

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

Αναπτύξτε τον κώδικα παράγοντα σας στο cloud:

Azure

Υπηρεσίες Web της Amazon (AWS)

Πλατφόρμα Google Cloud (GCP)

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

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

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

Φιλοδώρημα

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

Αυτά τα προβλήματα παρουσιάζονται μερικές φορές κατά την εγγραφή:

Σφάλμα ανεπαρκών δικαιωμάτων

Σύμπτωμα: Σφάλμα ανεπαρκών δικαιωμάτων κατά την a365 setup εκτέλεση εντολής.

Χρειάζεστε έναν από τους παρακάτω ρόλους στον μισθωτή Microsoft Entra:

  • Καθολικός διαχειριστής
  • Προγραμματιστής αναγνωριστικού παράγοντα

Και πρόσβαση ως συνεισφέρων ή κάτοχος συνδρομής Azure.

Λύση: Βεβαιωθείτε ότι έχετε τα απαιτούμενα δικαιώματα στο Microsoft Entra.

Σημείωμα

Εάν έχετε ρόλο διαχειριστή αναγνωριστικού παράγοντα ή προγραμματιστή αναγνωριστικού παράγοντα (όχι καθολικός διαχειριστής), a365 setup all εξακολουθεί να είναι επιτυχής αλλά παραλείπει τις εκχωρήσεις δικαιωμάτων OAuth2. Μετά την ολοκλήρωση της ρύθμισης, το CLI εμφανίζει τα επόμενα βήματα που πρέπει να ακολουθήσει ο Καθολικός Διαχειριστής για να ολοκληρώσει τις υπόλοιπες παραχωρήσεις δικαιωμάτων. Αυτή η ροή εργασίας αναμένεται για οργανισμούς όπου ο προγραμματιστής του παράγοντα και ο καθολικός διαχειριστής είναι διαφορετικά άτομα.

Λείπει ο έλεγχος ταυτότητας Azure CLI

Σύμπτωμα: Η εγκατάσταση αποτυγχάνει με σφάλματα ταυτοποίησης.

Λύση: Βεβαιωθείτε ότι είστε συνδεδεμένοι στο Azure και επαληθεύστε τον λογαριασμό και τη συνδρομή σας.

# Authenticate with Azure
az login

# Verify correct account and subscription
az account show

Ο πόρος υπάρχει ήδη

Σύμπτωμα: Η εγκατάσταση αποτυγχάνει με Resource already exists σφάλμα για την ομάδα πόρων, το πρόγραμμα υπηρεσίας εφαρμογών ή την εφαρμογή Web.

Λύσεις: Επιλέξτε μία από τις ακόλουθες λύσεις.

  • Χρήση πόρων που υπάρχουν ήδη

    Εάν υπάρχουν πόροι και θέλετε να τους χρησιμοποιήσετε, βεβαιωθείτε ότι ταιριάζουν με τη ρύθμιση παραμέτρων σας. Χρησιμοποιήστε την az resource list εντολή PowerShell.

    az resource list --resource-group <your-resource-group>

  • Διαγραφή συγκρουόμενων πόρων

    Διαγράψτε την ομάδα πόρων ή μετονομάστε τους πόρους σας μέσα στην a365.config.json και εκτελέστε ξανά τη ρύθμιση.

    Χρησιμοποιήστε την εντολή PowerShell az group delete για να διαγράψετε μια ομάδα πόρων.

    # WARNING: This command deletes all resources in it
az group delete --name <your-resource-group>

  • Χρησιμοποιήστε την εντολή εκκαθάρισης για να ξεκινήσετε από την αρχή

    Χρησιμοποιήστε την cleanup εντολή για να καταργήσετε όλους τους πόρους του Agent 365 και, στη συνέχεια, χρησιμοποιήστε την a365 setup all εντολή για να εκτελέσετε ξανά την εγκατάσταση.

    Προειδοποίηση

    Η εκτέλεση του a365 cleanup είναι καταστροφική.

    a365 cleanup
a365 setup all

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

Λύση: Επιλέξτε με βάση τον ρόλο σας:

  • Καθολικός διαχειριστής: Εκτελέστε a365 setup all ξανά. Το CLI ζητά διαχειριστική συναίνεση. Ολοκληρώστε τη ροή συναίνεσης στο παράθυρο του προγράμματος περιήγησης που εμφανίζεται.

  • Διαχειριστής ή προγραμματιστής αναγνωριστικού παράγοντα: Δεν μπορείτε να ολοκληρώσετε απευθείας τις παραχωρήσεις δικαιωμάτων OAuth2. Εκτέλεση a365 setup all — η σύνοψη ρύθμισης εκτυπώνει τα επόμενα βήματα για έναν καθολικό διαχειριστή, συμπεριλαμβανομένης μιας άμεσης σύνδεσης ή μιας διεύθυνσης URL συγκατάθεσης για την ολοκλήρωση των εκχωρήσεων. Μοιραστείτε αυτές τις λεπτομέρειες με τον καθολικό διαχειριστή σας.

Δεν υπάρχουν αρχεία ρύθμισης παραμέτρων ή είναι μη έγκυρα

Σύμπτωμα: Η εγκατάσταση αποτυγχάνει με το σφάλμα "Δεν βρέθηκε η ρύθμιση παραμέτρων" ή με σφάλματα επικύρωσης.

Λύση:

  1. Βεβαιωθείτε ότι το a365.config.json αρχείο υπάρχει.
  2. Εάν λείπει ή δεν είναι έγκυρο, δημιουργήστε το χειροκίνητα ή χρησιμοποιήστε a365 setup all --agent-name <name> (μόνο για παράγοντες).
# Verify a365.config.json exists
Test-Path a365.config.json

Η εγκατάσταση ολοκληρώνεται, αλλά οι πόροι δεν δημιουργούνται

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

Λύση:

  1. Ελέγξτε τους πόρους που δημιουργήθηκαν ανοίγοντας το αρχείο a365.generated.config.json στον φάκελο εργασίας σας.
  2. Επαληθεύστε την ύπαρξη πόρων Azure χρησιμοποιώντας την az resource list εντολή.
  3. Εάν λείπουν πόροι, ελέγξτε για σφάλματα στην έξοδο εγκατάστασης και εκτελέστε ξανά την εγκατάσταση με την εντολή a365 setup all.
# Check created resources
Get-Content a365.generated.config.json | ConvertFrom-Json

# Verify Azure resources exist
az resource list --resource-group <your-resource-group> --output table

# If resources missing, check for errors in setup output and re-run
a365 setup all

Το πρότυπο παράγοντα δεν έχει καταχωρηθεί στο Microsoft Entra

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

Λύση:

  1. Απόκτηση αναγνωριστικού blueprint από το a365.generated.config.json.

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. Κάντε αναζήτηση στο Κέντρο διαχείρισης του Microsoft Entra:

    1. Μεταβείτε στο Κέντρο διαχείρισης Microsoft Entra.
    2. Μεταβείτε στις Καταχωρήσεις εφαρμογών>Όλες οι εφαρμογές.
    3. Αναζητήστε το agentBlueprintId σας.

  3. Εάν δεν βρεθεί, εκτελέστε ξανά τη διαδικασία εγκατάστασης χρησιμοποιώντας την εντολή a365 setup all.

    a365 setup all

Δεν έχουν εκχωρηθεί δικαιώματα API

Σύμπτωμα: Η εγκατάσταση ολοκληρώνεται, αλλά τα δικαιώματα εμφανίζονται ως «Δεν έχουν εκχωρηθεί» στο Microsoft Entra.

Λύση:

  1. Ανοίξτε το Κέντρο διαχείρισης Microsoft Entra.

  2. Βρείτε την εγγραφή της εφαρμογής blueprint του παράγοντά σας.

  3. Μεταβείτε σε δικαιώματα API.

  4. Εκχώρηση συγκατάθεσης διαχειριστή:

    1. Επιλέξτε Εκχώρηση συναίνεσης διαχειριστή για το [ο μισθωτής σας].
    2. Επιβεβαιώστε την ενέργεια.

  5. Επιβεβαιώστε ότι όλες οι άδειες εμφανίζουν πράσινα σημάδια ελέγχου.

Η διαχειριζόμενη ταυτότητα δεν ενεργοποιήθηκε

Σύμπτωμα: Η Εφαρμογή Web υπάρχει, αλλά η διαχειριζόμενη ταυτότητα δεν είναι ενεργοποιημένη.

Λύση:

  1. Ελέγξτε την κατάσταση της διαχειριζόμενης ταυτότητας χρησιμοποιώντας την εντολή az webapp identity show.
  2. Αν δεν είναι ενεργοποιημένη, ενεργοποιήστε τη χειροκίνητα χρησιμοποιώντας την az webapp identity assign εντολή.
  3. Βεβαιωθείτε ότι είναι ενεργοποιημένη χρησιμοποιώντας την εντολή az webapp identity show.
# Check managed identity status
az webapp identity show --name <your-web-app> --resource-group <your-resource-group>

# If not enabled, enable it manually
az webapp identity assign --name <your-web-app> --resource-group <your-resource-group>

# Verify it's enabled
az webapp identity show --name <your-web-app> --resource-group <your-resource-group>

Η διαδικασία εγκατάστασης διαρκεί πολύ ή σταματά να ανταποκρίνεται

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

Λύση:

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

  2. Εάν η εγκατάσταση σταματήσει πραγματικά να ανταποκρίνεται, ακυρώστε την (Ctrl+C) και ελέγξτε τι δημιουργήθηκε.

    # Check generated config
Get-Content a365.generated.config.json | ConvertFrom-Json

# Check Azure resources
az resource list --resource-group <your-resource-group>

  3. Εκκαθαρίστε και δοκιμάστε ξανά.

    a365 cleanup
a365 setup all

Εκκαθάριση ενός παράγοντα χωρίς διαμόρφωση

Σύμπτωμα: Παρείχατε έναν παράγοντα και a365 setup all --agent-name <name> τώρα θέλετε να τον καταργήσετε, αλλά δεν έχετε αρχείο a365.config.json.

Λύση: Χρησιμοποιήστε το a365 cleanup --agent-name για να καταργήσετε τον παράγοντα χωρίς αρχείο ρύθμισης παραμέτρων. Το CLI διαβάζει αναγνωριστικά πόρων από το παγκόσμιο αρχείο ρύθμισης παραμέτρων που δημιουργήθηκε κατά τη διαδικασία bootstrap.

a365 cleanup --agent-name <your-agent-name>

Φιλοδώρημα

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

Εάν δεν έχετε πλέον το καθολικό αρχείο ρυθμίσεων (για παράδειγμα, μετά την επανεγκατάσταση του CLI), χρησιμοποιήστε a365 cleanup με ένα ελάχιστο a365.config.json που δημιουργήθηκε χειροκίνητα ή καταργήστε πόρους απευθείας μέσω της πύλης Azure και του κέντρου διαχείρισης Microsoft Entra.

Δεν είναι δυνατή η αποστολή του πρώτου μηνύματος στο Teams

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

Λύση: Η άδεια [Chat.Create][perm-chatcreate] απαιτείται για τη δημιουργία νέου αντικειμένου συνομιλίας. Εάν υπάρχει ήδη συνομιλία ένας προς έναν, η ενέργεια επιστρέφει την υπάρχουσα συνομιλία και δεν δημιουργεί νέα.

  • Για να το εφαρμόσετε, διαμορφώστε τις άδειες του blueprint που μεταβιβάζονται ώστε να περιλαμβάνουν το πεδίο Chat.Create.
  • Διαμορφώστε ένα μήνυμα συνομιλίας Teams ώστε να αποσταλεί μόλις δημιουργηθεί μια παρουσία παράγοντα.
  • Δημιουργήστε μια νέα παρουσία παράγοντα από το blueprint και δοκιμάστε το μήνυμα πρώτης εκτέλεσης.
  • Last updated on