Freigeben über

Erstellen Ihres ersten benutzerdefinierten Copilot-Connectors mit dem Microsoft 365 Agents Toolkit

Microsoft 365 Copilot Connectors ermöglichen es Ihnen, Ihre Branchendaten in Microsoft Graph zu erfassen, um sie für Microsoft 365 Copilot verfügbar zu machen. Wenn Ihre Daten erfasst werden, kann Copilot die Daten ermitteln und sie verwenden, um auf Benutzeraufforderungen zu reagieren.

Das Microsoft 365 Agents Toolkit enthält eine Vorlage, die Sie zum Erstellen von Copilot-Connectors verwenden können. Die Copilot-Connectorvorlage ist so konzipiert, dass Sie Connectors mithilfe der Copilot-Connector-API in Microsoft Graph schnell erstellen können. Die Vorlage erstellt ein Gerüst für einen Connector, der Daten aus der GitHub-API in Microsoft Graph abruft. Nachdem Sie Ihren Connector erstellt haben, können Sie ihn lokal über die F5-Benutzeroberfläche ausführen oder über Azure Functions bereitstellen.

Dieser Artikel enthält eine exemplarische Vorgehensweise für die Schritte zum Erstellen Ihres ersten Copilot-Connectors mithilfe des Microsoft 365 Agents Toolkit in Visual Studio Code.

Voraussetzungen

Die folgenden Voraussetzungen sind erforderlich, um die Schritte in diesem Artikel auszuführen:

Erstellen Sie Ihren ersten benutzerdefinierten Connector

Führen Sie die folgenden Schritte aus, um Ihren ersten Connector zu erstellen.

  1. Wählen Sie auf der Randleiste in Visual Studio Code das Microsoft 365 Agents Toolkit > Create a New Agent/App aus.

    Menü

  2. Wählen Sie Copilot-Connector aus.

    Projektauswahl

  3. Geben Sie Github Issues als Connectornamen ein.

  4. Erstellen Sie eine mandantenweite eindeutige ID für den Connector. Ausführliche Informationen zu den Anforderungen für die Connector-ID finden Sie in der Id-Eigenschaft der externalConnection-Ressource.

  5. Wählen Sie Standardordner aus, um ihren Projektstammordner am Standardspeicherort zu speichern.

  6. Konfigurieren Sie das Repository, aus dem Sie Issues pullen möchten, indem Sie das CONNECTOR_REPOS -Feld in der .env.local Datei verwenden.

    env-local-file

  7. Drücken Sie F5 , um den Connector lokal auszuführen. Das Toolkit erstellt eine Microsoft Entra-App für Ihren Connector und startet den Bereitstellungsprozess.

  8. Folgen Sie dem Link im Terminal zum Microsoft Entra Admin Center, und wählen Sie Administratoreinwilligung erteilen aus.

    Hinweis

    Um diesen Schritt auszuführen, müssen Sie ein globaler Admin in Ihrem organization sein.

    Schaltfläche

  9. Die App erstellt die Verbindung, registriert das Schema und führt dann eine vollständige Durchforstung durch, um Elemente zu erfassen.

    Hinweis

    Die Registrierung des Schemas kann bis zu 10 Minuten dauern.

  10. Nachdem die vollständige Durchforstung abgeschlossen ist, Microsoft 365 Admin Center:

    • Wechseln Sie im linken Bereich zu Einstellungen>Suche &Intelligence-Datenquellen>.

    • Suchen Sie Ihre Verbindungs-ID.

    • Wählen Sie Connectorergebnisse einschließen aus.

      Schaltfläche

      Hinweis

      Um diesen Schritt auszuführen, müssen Sie ein Such-Admin sein. In diesem Schritt können Ergebnisse aus dem Connector von Microsoft 365 Copilot Chat verwendet werden. Wenn Sie diesen Connector nur als Wissensquelle für einen deklarativen Agent verwenden möchten, ist dieser Schritt nicht erforderlich.

  11. Um zu überprüfen, ob die Elemente indiziert wurden, wählen Sie den entsprechenden Connectornamen aus. Überprüfen Sie das Feld Elemente indiziert , um zu sehen, wie viele Probleme indiziert wurden.

    GitHub issues connector with 11 items indized displayed

  12. Öffnen Sie Microsoft 365 Copilot Chat, und testen Sie eine Beispielaufforderung wie "What are the two latest GitHub Issues?". Beachten Sie die Zitate für externe Elemente am unteren Rand der Seite. Diese Zitate sind die Daten aus Ihrem Copilot-Connector.

    M365 Copilot-Ausgabe mit GitHub-Problemen

Anpassen der Vorlage für Ihre Datenquelle

Um diese Vorlage für Ihre benutzerdefinierten Daten anzupassen, können Sie den Inhalt der folgenden Ordner aktualisieren:

  • src/custom: Enthält benutzerdefinierten Code zum Sammeln und Transformieren von Daten, die in Microsoft Graph erfasst werden sollen. Obwohl im Beispiel die GitHub-Problem-API verwendet wird, können Sie sie durch jede andere API ersetzen.

  • src/references: Enthält die Schemadefinition des Connectors. Passen Sie sie an die Daten und Metadaten an, die Sie erfassen möchten.

  • src/models: Enthält die Modelldefinition für eine interne Darstellung der Daten und konfiguration. Beide Modelle können an Ihre Anforderungen angepasst werden.

Zusätzlich zu diesen Ordnern können Sie je nach Szenario weitere Teile des Codes anpassen. Sie können den Code ab der [Customization point] Zeichenfolge nach Kommentaren durchsuchen. Diese Kommentare geben Bereiche für potenzielle Anpassungen an.

Verwandte Inhalte

  • Last updated on