Erstellen eines Microsoft Copilot Agents für Haiilo (MCP)

Diese Funktion ist verfügbar mit:

Du weißt nicht, welches Modul du verwendest? Lies mehr hier.

  • Haiilo MCP

Du kannst einen Microsoft Copilot Declarative Agent erstellen und veröffentlichen, der in deine Haiilo-Plattform integriert ist, sodass die Nutzer deiner Organisation direkt über Microsoft Copilot mit den Haiilo-Funktionen interagieren können.

Bevor du beginnst: Im Artikel Verstehen der Haiilo MCP-Integration erfährst du, wie die Integration funktioniert, welche Funktionen verfügbar sind und welche Informationen KI-Assistenten über Haiilo abrufen oder aktualisieren können.

Voraussetzungen

Schritt 1: Erstelle einen API-Client in Haiilo

  1. Gehe in Haiilo zu Administration > API-Clients.
  2. Wähle Erstellen.
  3. Gib eine passende Client-ID ein, z. B. „Haiilo-MCP“.
  4. Unter Grant Types aktiviere Authorization Code.
  5. Füge die folgende Redirect-URL hinzu: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
  6. Wähle Erstellen.

Lass diese Seite geöffnet; du wirst sie im nächsten Schritt noch brauchen.

Schritt 2: Registriere einen OAuth-Client bei Microsoft

  1. Gehe zum Microsoft Developer Portal.
  2. Melde dich mit deinem Microsoft 365 Konto an.
  3. Im Developer Portal geh zu Tools > OAuth-Client-Registrierung.
  4. Wähle Neue OAuth-Client-Registrierung oder Client registrieren.
  5. Fülle die folgenden Details mit den Werten von Haiilo aus:
    • Basis-URL https://<<deine_haiilo_domain>>/api/mcp. Beispiel: https://example.haiilo.app/api/mcp.
    • Client-ID: Die Client-ID, die du im vorherigen Schritt definiert hast.
    • Client Secret: Das Client Secret aus dem Haiilo-Anmelde-Duo.
    • Autorisierungs-Endpunkt: Kopiere und füge es aus Haiilo unter Administration > Integrationen > MCP ein. Sollte dieses Format haben: https://<<deine_haiilo_domain>>/web/idp/realms/tenant-<<unique_id>>/protocol/openid-connect/auth
    • Token-Endpunkt: Kopiere und füge es aus Haiilo unter Administration > Integrationen > MCP ein. Sollte dieses Format haben: https://<<deine_haiilo_domain>>/web/idp/realms/tenant-<<unique_id>>/protocol/openid-connect/token
    • Refresh-Endpunkt: Gleich wie Token-Endpunkt.
  6. Lass vorerst die Einstellung Nutzung durch Teams-App einschränken auf Beliebige Teams-App. Das änderst du später.
  7. Klicke auf Speichern.
  8. Kopiere die OAuth-Client-Registrierungs-ID, die du in Schritt 3 verwenden wirst.

Behalte diese Seite offen; du wirst in Schritt 6.2 zurückkehren.

Schritt 3: Konfiguriere den Agenten in Haiilo

  1. Gehe in Haiilo zu Administration > Integrationen > Haiilo MCP.
  2. Schalte die MCP-Einstellungen ein.

  3. Fülle die folgenden Felder aus:

    Feld Beschreibung
    App-Name Der Anzeigename für deinen Agenten in Microsoft Copilot
    OAuth-Client-Registrierungs-ID Die OAuth-Client-ID, die du in Schritt 2 erstellt hast
  4. Wähle Manifest herunterladen. Eine ZIP-Datei wird heruntergeladen, die das Manifest, die Agentenkonfiguration, Tool-Definitionen und App-Symbole enthält.

Schritt 4: Hochladen ins Microsoft Admin Center

  1. Gehe zum Microsoft 365 Cloud Admin Center.
  2. Melde dich mit deinem Microsoft 365 Tenant-Admin-Konto an.
  3. Gehe zu Agenten > Alle Agenten
  4. Wähle am rechten Seitenende ellipsis icon.png > Agent hinzufügen.
  5. Lade die ZIP-Datei hoch, die du im vorherigen Schritt heruntergeladen hast.
  6. Überprüfe nach dem Hochladen die App-Details.
  7. Konfiguriere unter Einstellungen, wer die App installieren kann, und wähle die passende Richtlinienvorlage aus.
  8. Überprüfe die App-Berechtigungen. Für diese Integration sind normalerweise keine zusätzlichen Berechtigungen erforderlich.
  9. Wähle Veröffentlichen oder Bereitstellen.

Schritt 5: Teste den Agenten

5.1 Installieren und Testen

  1. Stelle im Microsoft Admin Center sicher, dass die App deinem Benutzerkonto zugewiesen ist.
  2. Öffne Microsoft Teams oder Microsoft Copilot.
  3. Suche deinen Agenten nach Namen.
  4. Wähle Hinzufügen oder Diesen Agenten verwenden.
  5. Versuche, eine MCP-Tool-Aktion auszuführen, um die Authentifizierung zu überprüfen.

5.2 Veröffentlichung für deine Organisation

Nachdem der Test abgeschlossen ist:

  1. Kehre zum Microsoft Admin Center zurück.
  2. Aktualisiere die Bereitstellungseinstellungen, um die vorgesehenen Benutzergruppen oder die gesamte Organisation einzubeziehen.
  3. Der Agent wird automatisch für die ausgewählten Benutzer installiert.

Schritt 6: Aktualisiere die OAuth-Client-Registrierung

6.1 Hol dir die App-ID aus Teams

  1. Gehe zum Microsoft Teams Admin Center und melde dich mit deinem Konto an.
  2. Gehe zu Teams-Apps > Apps verwalten.
  3. Suche nach dem Namen des Agents und öffne ihn.
  4. Kopiere die App-ID.

6.2 Aktualisiere den OAuth-Client

  1. Kehre zum Microsoft Developer Portal zurück und melde dich mit deinem Konto an.
  2. Gehe zu Tools > OAuth-Client-Registrierung.
  3. Öffne deinen neu registrierten OAuth-Client.
  4. Wähle unter Nutzung durch Teams-App einschränken die Option Bestehende Teams-App.
  5. Füge die Teams-App-ID ein und speichere sie.

War dieser Beitrag hilfreich?

0 von 0 fanden dies hilfreich