Agent-Blueprint-Einrichtung

Der Agent-Blueprint definiert die Identitäts-, Berechtigungs- und Infrastrukturanforderungen Ihres Agents. Erstellen Sie jede Agenteninstanz aus diesem Agenten-Blueprint.

Anmerkung

Das Einrichten einer Agenten-Blueprint ist erforderlich, um die Register-, Work IQ- und KI-Teamkollegen-Funktionen zu aktivieren. Siehe Erste Schritte mit Agent 365 Entwicklung, um zu verstehen, welche Funktionen für Ihren Agenten gelten.

Weitere Informationen zur Identität von Agent 365 finden Sie unter Agent 365 Identität.

Voraussetzungen

Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind, bevor Sie beginnen:

  1. Agent 365 CLI – Siehe Agent 365 CLI-Installation.

  2. Erforderliche Berechtigungen:

    • Gültiger Mandantenbenutzer mit einer der folgenden Rollen:
      • Globaler Administrator
      • Agent-ID-Entwickler
    • Zugreifen auf ein Azure-Abonnement mit Berechtigungen zum Erstellen von Ressourcen

    Trinkgeld

    Agenten (nicht KI-Teammitglieder) benötigen keine Konfigurationsdatei. Verwenden Sie a365 setup all --agent-name <name>, und die CLI ermittelt automatisch Ihre Mandant- und Client-App. Die Einrichtung eines KI-Teammitglieds erfordert ein manuell erstelltes a365.config.json.

Erstellen des Agent-Blueprints

Verwenden Sie den a365 setup Befehl zum erstellen von Azure-Ressourcen und zur Registrierung Ihres Agent-Blueprint. Der Blueprint definiert die Identitäts-, Berechtigungs- und Infrastrukturanforderungen des Agents. Dieser Schritt richtet die Grundlage für die Bereitstellung und Ausführung Ihres Agents in Azure ein.

Ausführen von Setup

Führen Sie den Einrichtungsbefehl aus:

a365 setup -h

Der Befehl hat verschiedene Optionen. Sie können das gesamte Setup mit einem einzigen Befehl abschließen, indem Sie a365 setup all verwenden, oder Sie wählen detailliertere Optionen.

Anmerkung

a365 setup all ist standardmäßig im Blueprint-Agent-Modus. Um stattdessen einen KI-Teamkollegen einzurichten, übergeben Sie --aiteammate. Für M365-Agenten (Teams, Copilot) geben Sie zusätzlich --m365 an, um den Messaging-Endpunkt automatisch zu registrieren.

Agenten-Einrichtung (Standard):

# With a config file
a365 setup all

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

M365-Agenten-Einrichtung (Teams/Copilot):

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

KI-Teamkamerad-Einrichtung:

a365 setup all --aiteammate

Der gesamte Einrichtungsprozess führt die folgenden Vorgänge aus:

  1. Erstellt die Azure-Infrastruktur (sofern noch nicht vorhanden):

    • Ressourcengruppe
    • App Service-Plan mit angegebener SKU
    • Azure Web App mit aktivierter verwalteter Identität

  2. Registriert den Agent-Blueprint:

    • Erstellt den Agent-Blueprint in Ihrem Microsoft Entra-Mandanten
    • Erstellt Microsoft Entra-Anwendungsregistrierungen
    • Konfiguriert die Agent-Identität mit den erforderlichen Berechtigungen
    • Setzt managerApplications in der Blaupause, was für die Verwaltbarkeit der Plattform erforderlich ist

    Wichtig

    Blaupausen müssen die Einstellung managerApplications aufweisen, damit sie von der Plattform akzeptiert werden. Die CLI setzt dies automatisch. Wenn Sie einen Blueprint haben, der vor Einführung dieser Anforderung erstellt wurde, löschen Sie ihn und führen Sie a365 setup all erneut aus, oder passen Sie ihn manuell über die Graph-API an.

  3. Konfiguriert API-Berechtigungen:

    • Richtet Microsoft Graph-API-Bereiche ein
    • Konfiguriert Messaging-Bot-API-Berechtigungen
    • Wendet vererbbare Berechtigungen für Agent-Instanzen an

  4. Aktualisiert die Konfigurationsdateien:

    • Speichert generierte IDs und Endpunkte in einer neuen Datei in deinem Arbeitsverzeichnis namens a365.generated.config.json
    • Erfasst verwaltete Identitäts- und Ressourceninformationen

Anmerkung

Die Einrichtung dauert in der Regel 3 bis 5 Minuten und speichert die Konfiguration automatisch in a365.generated.config.json. Wenn Sie als Globaler Administrator ausführen, öffnet die CLI möglicherweise ein Browserfenster für die Administrator-Einwilligung – schließen Sie den Zustimmungsprozess ab, um fortzufahren. Wenn Sie als Agent-ID-Entwickler ausführen, erscheint kein Browserfenster; die CLI generiert Einwilligungs-URLs, die ein globaler Administrator später ausfüllen kann.

Einrichtung mithilfe der Agent-ID-Entwicklungsfachkraft

Wenn Sie als Agent-ID-Entwicklungsfachkraft (nicht globaler Admin) arbeiten, führt a365 setup all die meisten Schritte automatisch aus, aber die Erteilung von OAuth2-Berechtigungen erfordert einen separaten Schritt als globaler Admin.

Welche Schritte werden automatisch durchgeführt:

  • Azure-Infrastruktur (Ressourcengruppe, App Service Plan, Web App)
  • Agent-Blaupausen-Registrierung
  • Vererbbare Berechtigungen für Agent-Instanzen

Welche Schritte erfordern einen globalen Administrator:

  • OAuth2-Berechtigungsgewährungen für delegierte Berechtigungen (AllPrincipals Einwilligung) für Microsoft Graph, Agent 365 Tools, Messaging Bot API, Observability API und Power Platform API

Wie Sie die Einrichtung mit einem Nicht-Admin-Konto durchführen:

Schritt Wer Aktion
1 Entwickler Führen Sie a365 setup all aus. Die CLI führt alle möglichen Schritte aus und druckt die nächsten Schritte aus, einschließlich einer Einwilligungs-URL, die ein globaler Administrator öffnen kann.
2 Entwickler Teilen Sie die Zustimmungs-URL aus der CLI-Ausgabe mit Ihrem globalen Administrator.
3 Global administrierende Person Öffnen Sie die Einwilligungs-URL in einem Browser, der als globaler Administrator angemeldet ist, und erteilen Sie die angeforderten Berechtigungen.

Den Befehl ausführen:

# 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.

Geben Sie die nächsten Schritte, die von der CLI ausgedruckt werden, an Ihren globalen Admin weiter. Sie können den bereitgestellten Link oder die Consent-URL öffnen, um die OAuth2-Berechtigungen abzuschließen.

Überprüfen der Einrichtung

Wenn die Einrichtung abgeschlossen ist, sehen Sie eine Zusammenfassung, die alle abgeschlossenen Schritte zeigt. Überprüfen Sie die erstellten Ressourcen:

  1. Generierte Konfiguration überprüfen:

    Öffnen Sie a365.generated.config.json in Ihrem Arbeitsverzeichnis. Oder verwenden Sie PowerShell:

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

    Die erwartete Ausgabe enthält diese kritischen Werte:

    {
"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"
}

    Schlüsselfelder zur Überprüfung:

    Feld Verwendungszweck Was zu prüfen ist
    managedIdentityPrincipalId Azure verwaltete Identity Authentication Sollte eine gültige GUID sein
    agentBlueprintId Die eindeutige ID Ihres Agenten Wird im Entwicklerportal und im Admin Center verwendet
    agentBlueprintObjectId Microsoft Entra ID des Blueprints
    messagingEndpoint Nachrichtenweiterleitung Wo Teams/Outlook Nachrichten an Ihren Agenten sendet
    agentBlueprintClientSecret Authentifizierungs-Geheimnis Sollte vorhanden sein (Wert ist maskiert)
    resourceConsents API-Berechtigungen Sollte Ressourcen wie Microsoft Graph, Agent 365 Tools, Messaging Bot API und Observability API enthalten
    completed Einrichtungsstatus Sollte true sein

    Anmerkung

    Wenn Sie die Einrichtung als Agent ID Administrator oder Agent ID Entwickler ausgeführt haben, könnte resourceConsents leer sein und completed könnte false sein, bis ein globaler Administrator die OAuth2-Berechtigung mit den nächsten Schritten, die von der CLI gedruckt werden, gewährt.

  2. Azure-Ressourcen im Azure-Portal überprüfen:

    Oder az resource list PowerShell Befehl verwenden.

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

    Stellen Sie sicher, dass die folgenden Ressourcen erstellt werden:

    • Ressourcengruppen:

      • Gehen Sie zu Ressourcengruppen> Wählen Sie Ihre Ressourcengruppe.
      • Überprüfen Sie, ob sie Ihren App Service-Plan und die Web-App enthält

    • App Service-Plan:

      • Gehen Sie zu App Services>App Service-Pläne
      • Suchen Sie Ihren Plan, und überprüfen Sie, ob der Tarif Ihrer Konfigurations-SKU entspricht

    • Web-App:

      • Gehen Sie zu App Services>Web-Apps
      • Suchen Sie Ihre Web-App, und wechseln Sie dann zu Einstellungen>Identität>System zugewiesen
      • Überprüfen Sie, ob der Status Ein ist
      • Beachten Sie, ob die Objekt-ID (Prinzipal-ID) mit managedIdentityPrincipalId übereinstimmt

  3. Überprüfen Sie Microsoft Entra-Anwendungen im Azure-Portal:

    Gehen Sie zu Azure Active Directory>App-Registrierungen>Alle Anwendungen:

    • Suchen Sie nach Ihrem Agent-Blueprint nach der agentBlueprintId

    • Öffnen Sie die Anwendung, und wählen Sie API-Berechtigungen aus

    • Überprüfen Sie, ob Berechtigungen mit grünen Häkchen erteilt wurden:

      • Microsoft Graph (delegierte Berechtigungen und Anwendungsberechtigungen)
      • Messaging-Bot-API-Berechtigungen

    • Alle Berechtigungen sollten Erteilt für [Ihr Mandant] anzeigen.

  4. Überprüfen Sie die erstellte Konfigurationsdatei:

    Sie sollten eine Datei mit dem Namen a365.generated.config.json haben, die alle Konfigurationsdaten enthält.

    Verwenden Sie den PowerShell-Befehl Testpfad, um zu prüfen, ob die Datei existiert.

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

    Wichtig

    Speichern Sie a365.config.json und a365.generated.config.json Dateien. Diese Werte benötigen Sie für die Bereitstellung und Fehlersuche.

  5. Überprüfen Sie, ob die Web-App die verwaltete Identität aktiviert hat:

    Verwenden Sie den az webapp identity show Befehl, um zu überprüfen, ob die verwaltete Identität aktiviert ist.

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

    Erwartet:

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

  6. Überprüfen Sie, ob der Agent-Blueprint bei Microsoft Entra registriert ist:

    Unter Microsoft Entra Admin Centre suchen Sie nach Ihrem agentBlueprintId oder suchen Sie nach Namen.

    Verifizieren Sie Folgendes:

    ✅ App-Registrierung und Unternehmensanwendung werden angezeigt
    ✅ Im App-Registrierungsblueprint werden in der Registerkarte API-Berechtigungen alle Berechtigungen angezeigt.
    ✅ Status zeigt Gewährt für Ihren Mandanten

Weitere Informationen finden Sie unter:

Berechtigungen für Agents

Bevor Apps und Agenten Microsoft 365-Daten (Benutzer, E-Mails, Dateien, Teams, Agenten usw.) lesen oder schreiben können, müssen Sie ihnen ausdrücklich Microsoft Graph-Berechtigungen erteilen. Microsoft Graph-Berechtigungen bilden das Autorisierungsmodell, das steuert, auf welche Daten und Aktionen eine App oder ein Dienst über die Microsoft Graph-APIs in Microsoft 365 und Microsoft Entra ID zugreifen kann.

Weitere Informationen: Übersicht über Microsoft Graph-Berechtigungen

Um Graph-Berechtigungen für Instanzen von Agent 365 zu verwenden, muss der Entwickler diese im Agentenblueprint deklarieren. Wenn ein Administrator den Blueprint im Microsoft 365 Admin Center aktiviert, prüft das Portal die Graph-Berechtigungen des Blueprints und fordert den Administrator auf, die Zustimmung zu erteilen.

Um zu verstehen und zu prüfen, wie Graph-Berechtigungen Ihren Agenten ermöglichen, können Sie:

Berechtigungen auf Ihre Blaupause anwenden

Verwenden Sie a365 setup permissions custom, um benutzerdefinierte API-Berechtigungen inline zu Ihrem Blueprint in Microsoft Entra anzuwenden.

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

Ausführliche Informationen zur Konfiguration und zum Entfernen benutzerdefinierter Berechtigungen finden Sie unter setup permissions custom.

Nächste Schritte,

Stellen Sie Ihren Agentencode in die Cloud bereit:

Azure

Amazon Web Services (AWS)

Google Cloud Platform (GCP)

Veröffentlichen im Microsoft Admin Center

Problembehandlung

Dieser Abschnitt beschreibt häufige Probleme beim Einrichten von Agenten-Blueprints.

Trinkgeld

Die Agent 365 Troubleshooting-Anleitung enthält übergeordnete Empfehlungen zur Fehlerbehebung, Best Practices und Links zu Inhalten zur Fehlerbehebung für jeden Abschnitt des Entwicklungszyklus von Agent 365.

Diese Probleme treten manchmal während der Registrierung auf:

Unzureichende Berechtigungen

Symptom:Unzureichende Berechtigungen bei der Ausführung des a365 setup-Befehls.

Sie benötigen eine der folgenden Rollen in Ihrem Microsoft Entra-Mandant:

  • Globaler Administrator
  • Agent-ID-Entwickler

Und Azure-Abonnementmitwirkender oder Besitzerzugriff.

Lösung: Überprüfen Sie, ob Sie die erforderlichen Berechtigungen in Microsoft Entra haben.

Anmerkung

Wenn Sie die Rolle Agent ID Administrator oder Agent ID Developer (nicht Global Administrator) besitzen, wird a365 setup all trotzdem erfolgreich abgeschlossen, überspringt aber die OAuth2-Berechtigungsgewährung. Nach Abschluss der Einrichtung druckt die CLI die nächsten Schritte für einen globalen Administrator aus, um die verbleibenden Erteilungen abzuschließen. Dieser Workflow ist in Organisationen üblich, in denen der Agentenentwickler und der Global Administrator verschiedene Personen sind.

Fehlende Azure CLI-Authentifizierung

Symptom: Die Einrichtung schlägt mit Authentifizierungsfehlern fehl.

Lösung: Stellen Sie sicher, dass Sie mit Azure verbunden sind, und überprüfen Sie Ihr Konto und Ihr Abonnement.

# Authenticate with Azure
az login

# Verify correct account and subscription
az account show

Die Ressource ist bereits vorhanden

Symptom: Die Einrichtung schlägt mit Resource already existsFehler für Ressourcengruppe, App Service-Plan oder Web-App fehl.

Lösungen: Wählen Sie eine der folgenden Lösungen.

  • Vorhandene Ressourcen verwenden

    Wenn Ressourcen vorhanden sind und Sie sie verwenden möchten, vergewissern Sie sich, dass sie Ihrer Konfiguration entsprechen. Verwenden Sie den az resource list PowerShell-Befehl.

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

  • Konflikt-Ressourcen löschen

    Löschen Sie die Ressourcengruppe oder benennen Sie Ihre Ressourcen in a365.config.json um und führen Sie die Einrichtung erneut durch.

    Verwenden Sie den az group delete PowerShell-Befehl, um eine Ressourcengruppe zu löschen.

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

  • Verwenden Sie den Cleanup-Befehl, um neu zu starten

    Verwenden Sie den cleanup-Befehl, um alle Agent 365 Ressourcen zu entfernen, und anschließend den a365 setup all-Befehl, um die Einrichtung erneut auszuführen.

    Warnung

    Das Ausführen von a365 cleanup ist destruktiv.

    a365 cleanup
a365 setup all

Symptom: Sie haben während der Einrichtung die Browserfenster geöffnet, sie aber geschlossen, ohne die Zustimmung zu vollenden oder die Einrichtung abgeschlossen zu haben, aber die OAuth2-Berechtigungen sind noch ausstehend.

Lösung: Wählen Sie basierend auf Ihrer Rolle:

  • Globaler Administrator: Führt a365 setup all erneut aus. Die CLI fordert zur Zustimmung des Administrators auf. Führen Sie den Einwilligungsprozess im angezeigten Browserfenster zu Ende.

  • Agent ID Administrator oder Entwickler: Sie können OAuth2-Genehmigungen nicht direkt abschließen. Führen Sie a365 setup all aus. Die Einrichtungszusammenfassung druckt die nächsten Schritte für einen globalen Admin, einschließlich eines direkten Links oder einer Zustimmungs-URL, um die Erteilung abzuschließen. Teilen Sie diese Details mit Ihrem globalen Administrator.

Ungültige oder fehlende Relay-Konfiguration

Symptom: Die Einrichtung schlägt mit Konfiguration nicht gefunden oder Validierungsfehlern fehl.

Lösung:

  1. Überprüfen Sie, ob die a365.config.json Datei vorhanden ist.
  2. Falls sie fehlt oder ungültig ist, erstellen Sie sie manuell oder verwenden Sie a365 setup all --agent-name <name> (nur für Agenten).
# Verify a365.config.json exists
Test-Path a365.config.json

Einrichtung abgeschlossen, aber die Ressourcen wurden nicht erstellt

Symptom: Der Einrichtungs-Befehl wurde erfolgreich ausgeführt, aber die Azure-Ressourcen sind nicht vorhanden.

Lösung:

  1. Überprüfen Sie die erstellten Ressourcen, indem Sie die Datei a365.generated.config.json in Ihrem Arbeitsverzeichnis öffnen.
  2. Überprüfen Sie, ob Azure-Ressourcen vorhanden sind, indem Sie den az resource list-Befehl verwenden.
  3. Falls Ressourcen fehlen, überprüfen Sie die Ausgabe der Einrichtung auf Fehler und führen Sie die Einrichtung mit dem a365 setup all-Befehl erneut aus.
# 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

Agent Blueprint nicht in Microsoft Entra registriert

Symptom: Die Einrichtung ist abgeschlossen, aber Sie können den Agent-Blueprint im Microsoft Entra Admin Center nicht finden.

Lösung:

  1. Eine Blueprint-ID aus a365.generated.config.json abrufen.

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

  2. Suchen Sie im Microsoft Entra Admin Center:

    1. Gehen Sie zum Microsoft Entra Admin Center.
    2. Navigieren Sie zu App-Registrierung>Alle Anwendungen.
    3. Suche nach Ihrer agentBlueprintId.

  3. Falls nicht gefunden, führen Sie die Einrichtung mit dem a365 setup all-Befehl erneut durch.

    a365 setup all

API-Berechtigungen nicht erteilt

Symptom: Einrichtung abgeschlossen, aber die Berechtigungen werden in Microsoft Entra als „Nicht gewährt“ angezeigt.

Lösung:

  1. Öffnen sie Microsoft Entra Admin Center.

  2. Suchen Sie die Registrierung Ihrer Agent-Blaupausen-App.

  3. Gehen Sie zu API-Berechtigungen.

  4. Administratoreinwilligung erteilen:

    1. Wählen Sie Administratoreinwilligung gewähren für [Ihr Mandant] aus.
    2. Bestätigen Sie die Aktion.

  5. Stellen Sie sicher, dass alle Berechtigungen grüne Häkchen anzeigen.

Verwaltete Identität nicht aktiviert

Symptom: Eine Web-App existiert, aber die verwaltete Identität ist nicht aktiviert.

Lösung:

  1. Überprüfen Sie den Status der verwalteten Identität mit dem az webapp identity show Befehl.
  2. Falls nicht aktiviert, aktivieren Sie die verwaltete Identität manuell mit dem az webapp identity assign Befehl.
  3. Überprüfen Sie, ob die verwaltete Identität aktiviert ist, indem Sie den az webapp identity show-Befehl ausführen.
# 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>

Die Einrichtung dauert zu lange oder reagiert nicht mehr

Symptom: Der Einrichtungs-Befehl läuft länger als 10 Minuten, ohne abgeschlossen zu werden.

Lösung:

  1. Wenn Sie als globaler Admin angemeldet sind, überprüfen Sie, ob ein Browserfenster auf die Administratoreinwilligung wartet. Schließen Sie den Zustimmungsprozess ab, um die Einrichtung freizugeben.

  2. Wenn die Einrichtung wirklich nicht mehr reagiert, brechen Sie sie ab (Ctrl+C) und überprüfen Sie, was erstellt wurde.

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

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

  3. Bereinigung und Wiederholen.

    a365 cleanup
a365 setup all

Bereinigen eines konfigurationslosen Agents

Symptom: Sie haben einen Agenten mit a365 setup all --agent-name <name> bereitgestellt und möchten ihn nun entfernen, haben aber keine a365.config.json Datei.

Lösung: Verwenden Sie a365 cleanup --agent-name, um den Agenten ohne Konfigurationsdatei zu entfernen. Die CLI liest die Ressourcen-IDs aus der global generierten Konfigurationsdatei, die während des Bootstrap-Setups erstellt wurde.

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

Trinkgeld

Wenn der Befehl bei der Authentifizierung ins Stocken gerät, wechselt er automatisch zum Geräte-Code-Flow. Folgen Sie den angezeigten Anweisungen im Terminal, um die Anmeldung abzuschließen.

Wenn Sie die global generierte Konfigurationsdatei nicht mehr haben (zum Beispiel nach einer Neuinstallation der CLI), verwenden Sie a365 cleanup mit einem manuell erstellten minimalen a365.config.json oder entfernen Sie Ressourcen direkt über das Azure-Portal und das Microsoft Entra Admin Center.

Die erste Nachricht kann in Teams nicht gesendet werden

Symptom: Nach der Bereitstellung einer Agent-Instanz kann sie keine Begrüßungsnachricht an den Agentenmanager senden.

Lösung: Die [Chat.Create][perm-chatcreate]-Berechtigung ist erforderlich, um ein neues Chatobjekt zu erstellen. Wenn bereits ein Einzelchat existiert, gibt diese Operation den bestehenden Chat zurück und erstellt keinen neuen.

  • Um dies umzusetzen, konfigurieren Sie die vererbbaren Berechtigungen Ihres Blueprints so, dass sie den Chat.Create Umfang enthalten.
  • Konfigurieren Sie eine Teams-Chatnachricht, die gesendet wird, sobald eine Agenteninstanz provisioniert ist.
  • Erstellen Sie eine neue Agent-Instanz aus der Blaupause und testen Sie die erste Ausführungsnachricht.
  • Last updated on