Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Möglicherweise verfügen Sie über Agents in Ihrem organization, die Sie mit C#, JavaScript oder Python erstellt haben und die in Azure oder einer anderen Hostinginfrastruktur gehostet werden. Bei diesen Agents handelt es sich um spezielle Umgebungen, die sich möglicherweise auf einen bestimmten Bereich konzentrieren und KI-Dienste nutzen und bereits in Web- oder benutzerdefinierte Apps integriert sind. Sie können das Microsoft 365 Agents Toolkit verwenden, um Ihren Agent in Microsoft 365 Copilot Chat anzuzeigen. Auf diese Weise können Benutzer die einheitliche Microsoft 365 Copilot-Benutzeroberfläche verwenden, um mit Agents zu arbeiten, die im gesamten Unternehmen erstellt wurden, sodass Ihre Agents für Benutzer besser auffindbar und zugänglicher sind.
Verwenden des Microsoft 365 Agents SDK
Um Ihren Agent in Microsoft 365 Copilot einzubinden, verwenden Sie das Microsoft 365 Agents Toolkit, um den Agent in die Microsoft 365 Agents SDK zu integrieren. Das Agents SDK unterstützt C#, JavaScript und Python. Wenn Ihr Agent in einer dieser Sprachen geschrieben ist, müssen Sie ihn nicht wesentlich ändern. Sie können einfach den Agents SDK-Code zu Ihrem Agent hinzufügen und die integrierten Kanaladapter verwenden, um Ihren Agent in Microsoft 365 Copilot bereitzustellen.
Die integrierten Kanaladapter im Microsoft 365 Agents SDK unterstützen eine Reihe von Kanälen, einschließlich Microsoft 365 Copilot. Indem Sie Ihren vorhandenen Agent mit dem Agents SDK umschließen, können Sie die Integration in die Azure-Bot Service durchführen, die sich zwischen einer Benutzeroberfläche oder einem Kanal (z. B. Microsoft 365 Copilot) und Ihrem Code befindet. Der Azure-Bot Service übersetzt, was dieser Kanal sendet, und transformiert es in allgemeine Aktivitäten, um dem zu entsprechen, was Ihr Code versteht– in diesem Fall der Agents SDK-Wrapper, der eingehende Nachrichten von Azure Bot Service akzeptiert.
Ändern der Komponenten Ihres Agents
Um Ihren Agent in Copilot zu integrieren, müssen Sie einige Komponenten Ihres Agents ändern, wie in diesem Abschnitt beschrieben.
Es wird empfohlen, mit dem Microsoft 365 Agents Toolkit zu beginnen und das Echo/Empty Agent-Beispiel zu verwenden (derzeit in C# in Visual Studio und JavaScript in Visual Studio Code verfügbar). Um sich mit der Sdk-Struktur für Agents vertraut zu machen, führen Sie die Schritte zum Testen und Bereitstellen Ihres Agents mithilfe des Agents Toolkits und des SDK durch. Diese Tools vereinfachen die beschriebenen Aufgaben.
Erstellen Ihrer App-Registrierung und des Azure Bot Service-Datensatzes für die Kanalkommunikation: Die Microsoft 365 Agents SDK verwendet Azure Bot Service, um die Kommunikation zwischen Kanälen und Ihrem Code zu verarbeiten und Komponenten zu verwalten, die sich auf diese Kanäle beziehen. Sie müssen eine Azure Bot Service-Ressource mit einer App-Registrierung erstellen, auf die Sie in Ihrem Agent manuell verweisen.
Konfigurieren Ihrer Agent-Ereignislistener: Ein Agent, der mit dem Microsoft 365 Agents SDK erstellt wurde, ist so strukturiert, dass er auf Ereignisse aus dem Kanal lauscht ( in diesem Fall Microsoft 365 Copilot). Verwenden Sie zunächst OnActivity.
Aktualisieren Sie die Struktur Ihres Agents, damit er die von Microsoft 365 Copilot an den Azure-Bot Service gesendete Aktivität verarbeiten kann. Fügen Sie dazu den vorhandenen Agent der Struktur eines Agents hinzu, der mit Microsoft 365 Agents SDK erstellt wurde. Sie müssen nicht speziell auf viele Aktivitäten hinweisen. Ein Agent kann mithilfe der OnActivity-Methode auf jede Nachricht vom Client lauschen. Der vorhandene Agent kann dann der -Methode hinzugefügt oder in der Methode referenziert werden, die von dem Ereignis ausgelöst wird, auf das lauscht, und daher jedes Mal ausgeführt wird, wenn eine Aktivität gesendet wird. Eine Aktivität kann eine Nachricht oder eine andere Art von Aktion innerhalb des Kanals sein.
Erstellen Sie manuell eine Manifestdatei, oder generieren Sie eine Manifestdatei mithilfe des Agents Toolkits. Microsoft 365 Copilot erfordert ein .zip Paket, das eine Manifestdatei enthält. Die Manifestdatei enthält eine Reihe von Anweisungen, um Microsoft 365 Copilot mitzuteilen, wo Nach Ihrem Agent gesucht werden soll, und andere Informationen. Microsoft 365 Copilot erfordert, dass ein Agent gehostet wird und ein Endpunkt, der über eine App-Registrierung (ID) verknüpft ist und auf den in einer Manifestdatei verwiesen wird. Wenn Ihr Agent in Teams ausgeführt wird, können Sie die vorhandene Manifestdatei ändern, um das neueste Schema für Microsoft 365 Copilot zu unterstützen.
Agents, die mit Microsoft 365 Copilot verbunden sind, können optional die Berechtigung des Benutzers anfordern, in ihrem Namen zu handeln. Wenn Sie diese Funktion verwenden möchten, konfigurieren Sie sie während des Agent-Setupvorgangs in Azure Bot Service. Tools für den Einstieg
Der Aufwand, der erforderlich ist, um Ihren Agent in Copilot zu integrieren, variiert je nach Agentkomplexität und ob Sie Tokenverwaltung hinzufügen müssen, damit Ihr Agent die Identität des Benutzers verwenden kann, um seine Kenntnisse zu erweitern.
Verwenden Sie zunächst das Microsoft 365 Agents Toolkit und das Echo-Agent-Beispiel, um Ihren Agent zu erstellen und die Dokumentation für Visual Studio oder Visual Studio Code zu testen und bereitzustellen. Dies hilft Ihnen, sich mit der Zusammenarbeit von Agents Toolkit, Agents SDK und Microsoft 365 Copilot vertraut zu machen.