Registrieren eines Agents auf der Teams-Plattform

Das Erstellen und Hosten einer Agent-Laufzeit reicht nicht aus, um Benutzern einen Teams-Agent zur Verfügung zu stellen. Außerdem müssen Sie Ihren Agent zu Beginn des Entwicklungsprozesses registrieren , indem Sie für ihn eine Konfiguration für drei Dienste erstellen:

  • Microsoft Entra ID: Eine Entra ID-App-Registrierung ist die eindeutige Identität des Agenten innerhalb des Microsoft 365-Ökosystems, die für die Dienstauthentifizierung und den eingewilligten Zugriff auf Benutzerdaten verwendet wird.
  • Agent Communication Service (ACS): Durch die Registrierung des Agents bei ACS kann er am Teams-Chat teilnehmen und Echtzeitinformationen über Benutzeraktivitäten in Teams erhalten.
  • Teams-Plattform: Ein im Teams-Entwicklerportal registriertes App-Manifest richtet einen Agent als verteilbare, installierbare Teams-App ein.

Indem Sie einen Agent zu Beginn der Entwicklung registrieren, können Sie ihn in Teams verwenden, während er Gestalt annimmt, sein Verhalten überprüfen und genau so erleben, wie es Benutzer tun werden.

In diesem Artikel werden die Dienstregistrierungen erläutert, die erforderlich sind, damit ein Teams-Agent mit Teams interagieren kann. Ein tiefgreifendes Verständnis dieser Konzepte ist nicht erforderlich, um mit der Entwicklung von Teams-Agents zu beginnen: Sie können den Schnellstart verwenden, um schnell einen neuen Agent zu erstellen und zu registrieren, und bei Bedarf auf diesen Leitfaden verweisen, um ein umfassenderes Verständnis zu erlangen.

Entra ID-App-Registrierung: Identität und Authentifizierung

Microsoft Entra ID ist der Identitäts- und Zugriffsverwaltungsdienst, der von Teams und Microsoft 365 verwendet wird. Eine App-Registrierung in einem Entra-Mandanten im Besitz Ihrer organization ist die global eindeutige Identität Ihres Agents für die gesamte Lebensdauer und ermöglicht mehrere Agent-Funktionen:

  • Authentifizierung bei ACS: Die ACS-Registrierung eines Agents ist eindeutig einer App-Registrierung zugeordnet, die mit den Laufzeit-App-Anmeldeinformationen des Agents konfiguriert wird.
  • Authentifizierung bei Organisationsressourcen: Viele Agents greifen direkt auf Organisationsdaten und -dienste wie Microsoft Graph zu, um Funktionen für die Zusammenarbeit zu unterstützen.
  • Vorgänge im Auftrag von mit einmaligem Anmelden (Single Sign-On, SSO) und OAuth: Benutzer können den Zugriff an Agents delegieren und ihnen die Zustimmung erteilen, in ihrem Namen auf Daten und Dienste zuzugreifen.
  • Einholen der Zustimmung zu privilegierten Operationen in Teams: Bestimmte Agentaktionen in Teams erfordern die Zustimmung von Administratoren und Benutzern.

Jeder Agent verfügt über eine primäre Entra ID-App-Registrierung, die mit seiner ACS-Registrierung verknüpft ist und zur eindeutigen Identifizierung verwendet wird. In einigen Fällen verwenden Agent-Implementierungen möglicherweise mehrere App-Registrierungen, um Identitätsszenarien in verschiedenen Kontexten zu unterstützen.

Weitere Informationen zu Registrierungen von Entra ID-Apps finden Sie unter Anwendungs- und Dienstprinzipalobjekte in Microsoft Entra ID.

Agent-Kommunikationsdienst (ACS)-Registrierung: Die Schnittstelle eines Agents zu Teams

Die Konnektivität eines Agents zu ACS macht ihn zu einem Teams-Agent : ACS dient der API, die die Laufzeit eines Agents für die Interaktion mit Teams-Funktionen verwendet, insbesondere mit Chat. Bevor Ihr Agent auf Microsoft Teams zugreifen kann, müssen Sie ihn beim Dienst registrieren.

Die ACS-Registrierung jedes Agenten und die primäre Registrierung der Entra ID-App sind eindeutig und dauerhaft verknüpft. Für die Authentifizierung bei ACS verwendet die Runtime des Agents Anmeldeinformationen, die in der App-Registrierung konfiguriert sind, z. B. einen geheimen Clientschlüssel oder eine verwaltete Azure-Identität.

Eine ACS-Registrierung enthält auch eine kleine Menge an Agent-Konfiguration, vor allem die Laufzeitendpunkt-URL des Agents. Immer wenn Aktivitäten in Teams auftreten, die für den Agent sichtbar sind, sendet ACS in jedem Mandanten, in dem es installiert ist, Anforderungen an diesen Endpunkt, die von der Laufzeitumgebung des Agents mithilfe eines Ereignisbehandlungsmusters verarbeitet werden.

ACS unterstützt zwei verschiedene Arten der Registrierung: von Teams und von Azure verwaltet. Weitere Informationen finden Sie unter Auswählen eines Registrierungstyps für den Agent-Kommunikationsdienst für einen Agent.

App-Manifest: Definieren und Verteilen

Das App-Manifest eines Agents ist eine JSON-Konfigurationsdatei, die alles enthält, was die Teams-Plattform benötigt, um sie zu verteilen und in Teams-Clients zu installieren. Sie umfasst zum Beispiel:

  • Name und Beschreibung des Agenten
  • Informationen zum Entwickler des Agents
  • Bot-ID des Agents (die eindeutige ID, die von der ACS-Registrierung und der App-Registrierung der Entra-ID gemeinsam verwendet wird)
  • Für bestimmte Agent-Features erforderliche Konfiguration auf Plattformebene
  • Eine Liste der RSC-Berechtigungen , die der Agent benötigt, um zu funktionieren

Durch die Registrierung des App-Manifests eines Agenten im Teams-Entwicklerportal wird es als installierbare Teams-App eingerichtet, die im Teams Store oder im App-Katalog Ihrer Organization verteilt werden kann. Bestimmte Agent-Features erfordern eine Konfiguration im App-Manifest. Wenn Sie diese Features während der Entwicklung hinzufügen, können Sie die Weboberfläche des Teams-Entwicklerportals verwenden, um das App-Manifest zu aktualisieren.

App-Manifeste entsprechen dem App-Manifestschema, das sich weiterentwickelt, wenn Microsoft neue Features der Teams-Plattform veröffentlicht.

Registrieren eines Agents bei Teams Entwickler-CLI

teams app create einen Agent vollständig registriert. Es schafft:

  1. Eine Entra ID-App-Registrierung in Ihrem Mandanten, konfiguriert mit einem geheimen Clientschlüssel
  2. Eine von Teams verwaltete ACS-Registrierung, die mit der Registrierung der Entra ID-App verknüpft ist
  3. Ein im Teams-Entwicklerportal registriertes Starter-App-Manifest, das für die Verwendung der von Teams verwalteten ACS-Registrierung konfiguriert ist
  4. Eine Konfigurationsdatei für die lokale Agent-Laufzeit (eine .env Datei für eine TypeScript- oder Python-Runtime oder eine appsettings.json Datei für .NET), die Ihr Agent für die Authentifizierung bei ACS mithilfe des geheimen Clientschlüssels verwendet

Nächste Schritte

Siehe auch

  • Zuletzt aktualisiert um