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.
Der Miro Microsoft 365 Copilot ermöglicht es Ihrem organization, Indexboards von Miro zu indizieren. Nachdem Sie den Connector konfiguriert haben, können Benutzer nach diesen Boards von Miro in Microsoft 365 Copilot und einem beliebigen Microsoft Search-Client suchen.
Dieser Artikel richtet sich an Microsoft 365-Administratoren oder alle, die einen Miro Copilot-Connector konfigurieren, ausführen und überwachen.
Funktionen
- Zugreifen auf Boards in Copilot mithilfe der Leistungsfähigkeit der semantischen Suche.
- Passen Sie die Durchforstungshäufigkeit an.
- Erstellen Sie einen Agent mithilfe der Datenquelle der Verbindung aus Microsoft Copilot Studio.
Begrenzungen
- Nur der Inhalt in Kurznotizen, Formen, Rahmen, Text und eingebetteten Dokumenten auf einem Board wird indiziert. Inhalte in anderen Objekttypen sind nicht enthalten. Weitere Informationen finden Sie in der Miro-Dokumentation für Entwickler.
- Indiziert keine Kommentare oder Antworten.
Voraussetzungen
1. Erstellen eines Entwicklerteams für Ihr Miro-Konto
Erstellen oder verwenden Sie ein vorhandenes Miro-Konto, um auf Miro zuzugreifen, und klicken Sie auf den Link , um ein Entwicklerteam für Ihr aktives Miro-Konto zu erstellen. Wenn Sich Ihr organization in einem Enterprise-Plan befindet, wechseln Sie zu Enterprise Developer Teams. Weitere Informationen finden Sie unter Erstellen eines Entwicklerteams.
2. Erstellen Ihrer App in Miro
Melden Sie sich bei Miro an, und erstellen Sie unter Ihre Apps eine neue App.
3. Hinzufügen von Berechtigungen zu Ihrer App
Fügen Sie den boards:read Read boards you have access to Plan in der App hinzu, die Sie in der Konfiguration Ihrer App erstellt haben.
4. Hinzufügen der Umleitungs-URL zu Ihrer App
Fügen Sie auf der App-Erstellungsseite die folgenden Links zum Feld "Umleitungs-URL für OAuth2.0" hinzu.
Kopieren Sie für M365 Enterprise, und fügen Sie sie ein:
https://gcs.office.com/v1.0/admin/oauth/callbackKopieren Sie für M365 Government, und fügen Sie sie ein:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
5. Installieren Ihrer App und Aufzeichnen von Anmeldeinformationen
Klicken Sie auf App installieren, und rufen Sie das OAuth-Token ab , und notieren Sie sich und Client IDClient secret aus den Anmeldeinformationen der App.
Erste Schritte
1. Konfigurieren des Anzeigenamens
Ein Anzeigename wird verwendet, um jedes Zitat in Copilot zu identifizieren, damit Benutzer die zugeordnete Datei oder das zugehörige Element leicht erkennen können. Der Anzeigename steht auch für vertrauenswürdigen Inhalt und wird als Inhaltsquellenfilter verwendet. Für dieses Feld wird ein Standardwert angegeben. Sie können sie an einen Namen anpassen, den Benutzer in Ihrem organization erkennen.
2. Hinzufügen der Unternehmens-ID
Die Unternehmens-ID (auch organisations-ID genannt) ist der eindeutige Bezeichner für das Miro-Konto Ihres organization. Sie können es finden, indem Sie die Miro-Dashboard öffnen, in der oberen rechten Ecke auf Ihr Profil klicken, Einstellungen auswählen und dann die URL in der Adressleiste überprüfen, in der die Unternehmens-ID angezeigt wird.
Hinweis
Sie können nur eine Unternehmens-ID in der Verbindung zuordnen. Wenn In Ihrem Miro-Arbeitsbereich mehrere Unternehmens-IDs vorhanden sind, erstellen Sie eine separate Verbindung.
3. Geben Sie den Authentifizierungstyp an.
Geben Sie die Client-ID und den geheimen Clientschlüssel ein, die Sie von Ihrer Miro-App erhalten haben. Weitere Informationen finden Sie unter Erste Schritte mit OAuth 2.0 und Miro.
4. Rollout für eine begrenzte Zielgruppe
Stellen Sie diese Verbindung für eine eingeschränkte Benutzerbasis bereit, wenn Sie sie in Copilot und anderen Suchoberflächen überprüfen möchten, bevor Sie den Rollout auf eine breitere Zielgruppe erweitern. Weitere Informationen finden Sie unter Gestaffelter Rollout für Microsoft 365 Copilot-Connectors.
Um die Verbindung für Miro zu erstellen, wählen Sie Erstellen aus, um Ihre Verbindungs- und Indexboards aus Ihrem Miro-Konto zu veröffentlichen.
Für andere Einstellungen, z. B . Zugriffsberechtigungen, Schema und Durchforstungshäufigkeit, werden Standardwerte basierend auf den am besten geeigneten Miro-Daten festgelegt.
| Benutzer | Beschreibung |
|---|---|
| Zugriffsberechtigungen | Nur Personen mit Zugriff auf den Inhalt in der Datenquelle. |
| Zuordnen von Identitäten | Datenquellenidentitäten, die mithilfe von Microsoft Entra-IDs zugeordnet werden. |
| Inhalt | Beschreibung |
|---|---|
| Eigenschaften verwalten | So überprüfen Sie die Standardeigenschaften und deren Schema. |
| Synchronisieren | Beschreibung |
|---|---|
| Vollständige Durchforstung | Häufigkeit: Jeden Tag |
Benutzerdefinierte Einrichtung
Im benutzerdefinierten Setup können Sie jeden der Standardwerte für Benutzer, Inhalt und Synchronisierung bearbeiten.
Benutzer
Zugriffsberechtigungen
Der Miro Copilot-Connector unterstützt Suchberechtigungen, die für Alle oder Nur Personen mit Zugriff auf diese Datenquelle sichtbar sind. Wenn Sie Alle auswählen, werden indizierte Daten in den Suchergebnissen für alle Benutzer angezeigt. Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, werden in den Suchergebnissen für Benutzer, die Zugriff darauf haben, indizierte Daten angezeigt.
Zuordnen von Identitäten
Die Standardmethode zum Zuordnen Ihrer Datenquellenidentitäten zu Microsoft Entra ID besteht darin, zu überprüfen, ob die E-Mail-ID der Miro-Benutzer mit dem Benutzerprinzipalnamen (UPN) oder der E-Mail-Adresse der Benutzer in Microsoft Entra identisch ist. Wenn die Standardzuordnung für Ihre organization nicht funktioniert, können Sie eine benutzerdefinierte Zuordnungsformel bereitstellen. Weitere Informationen finden Sie unter Zuordnen Ihrer Nicht-Azure AD-Identitäten.
So ermitteln Sie, welche Option für Ihre organization am besten geeignet ist:
- Wählen Sie die Option Microsoft Entra ID aus, wenn die E-Mail-ID der Miro-Benutzer mit dem UPN oder der E-Mail-Adresse des Benutzers in Microsoft Entra ID identisch ist.
- Wählen Sie die Option Nicht Microsoft Entra ID aus, wenn sich die E-Mail-ID der Miro-Benutzer vom UPN und der E-Mail-Adresse der Benutzer in Microsoft Entra ID unterscheidet.
Inhalt
Eigenschaften verwalten
Um der Miro-Datenquelle verfügbare Eigenschaften hinzuzufügen oder daraus zu entfernen, weisen Sie der Eigenschaft ein Schema zu (definieren Sie, ob eine Eigenschaft durchsuchbar, abfragbar, abrufbar oder verfeinernd ist), ändern Sie die semantische Bezeichnung, und fügen Sie der Eigenschaft einen Alias hinzu. Einige Eigenschaften sind standardmäßig ausgewählt.
| Source-Eigenschaft | Label | Beschreibung | Schema |
|---|---|---|---|
| Body | – | – | Suche |
| CreatedAt | Erstellungsdatum und Uhrzeit | Datum und Uhrzeit der Erstellung des Elements in der Datenquelle | Abfrage, Abrufen. |
| CreatedBy | Erstellt von | Der Benutzer, der das Element erstellt hat | Abfrage, Abrufen, Suchen. |
| Beschreibung | – | – | Abfrage, Abrufen. |
| Id | – | – | Abfrage, Abrufen. |
| ModifiedAt | Datum der letzten Änderung Uhrzeit | Datum und Uhrzeit der letzten Änderung des Elements in der Datenquelle | Abfrage, Abrufen. |
| ModifiedBy | Zuletzt geändert von | Der Benutzer, der die letzte Änderung vorgenommen hat | Abfrage, Abrufen, Suchen. |
| Name | Titel | Der Titel des Elements, das in Copilot und anderen Suchfunktionen angezeigt werden soll | Abfrage, Abrufen, Suchen. |
| Team | – | – | Abfrage, Abrufen. |
| ViewLink | url | Die Ziel-URL des Elements in der Datenquelle | Abfrage, Abrufen. |
Datenvorschau
Klicken Sie auf Vorschauergebnisse , um die Beispielwerte der ausgewählten Eigenschaften und des Abfragefilters zu überprüfen.
Synchronisieren
Das Aktualisierungsintervall bestimmt, wie oft Ihre Daten zwischen der Datenquelle und dem Miro Copilot-Connectorindex synchronisiert werden. Nur vollständige Durchforstungsaktualisierungsintervalle werden unterstützt. Weitere Informationen finden Sie unter Aktualisierungseinstellungen.
Sie können die Standardwerte des Aktualisierungsintervalls ändern.
Problembehandlung
Im Folgenden finden Sie häufige Fehler und deren Behebung.
- Erforderliche Berechtigungsbereiche fehlen. Stellen Sie sicher, dass die erforderlichen Bereiche in der Miro-App ausgewählt sind.
Sie verfügen nicht über die erforderlichen Berechtigungsbereiche. Stellen Sie sicher, dass Sie im Berechtigungsfeld Ihrer App-Konfiguration ausgewählt boards:read Read boards you have access to haben.
- Fehler beim OAuth 2.0-Flow. Überprüfen Sie die Anmeldeinformationen, und stellen Sie sicher, dass die Miro-App mit den richtigen Einstellungen konfiguriert ist.
Dies ist ein häufiger Authentifizierungsfehler. Zurück zur Miro-App und überprüfen Sie, ob OAuth2 unter Einstellungen ordnungsgemäß konfiguriert ist.
- Fehler beim OAuth 2.0-Flow. Vergewissern Sie sich, dass der Diesem Teamzugriffstoken zugeordnete Miro-Benutzer die Teamadministratorrolle besitzt und ein aktiver Benutzer ist.
Dies ist ein häufiger Authentifizierungsfehler. Zurück zur Miro-App-Konsole und vergewissern Sie sich, dass der Ersteller über eine Administratorrolle verfügt und das Konto status aktiv ist.
- Ihre Sicherheitsanmeldeinformationen sind für diese Sitzung abgelaufen. Zurück und melden Sie sich erneut mit Ihrem App-Schlüssel und Ihrem App-Geheimnis an.
Ihre Anmeldeinformationen sind abgelaufen. Aktualisieren Sie die Miro-App, und kopieren Sie die neueste Client-ID und den geheimen Clientschlüssel von der Registerkarte "Einstellungen", um sich zu authentifizieren.
- Ungültige Anmeldeinformationen wurden erkannt. Überprüfen Sie die Anmeldeinformationen und die Berechtigungsbereiche der Miro-App.
Dies ist ein häufiger Anmeldeinformationsfehler. Zurück zur Miro-App und überprüfen Sie, ob die Bereiche unter Berechtigungen ordnungsgemäß konfiguriert sind.
Nächste Schritte
Nachdem Sie Ihre Verbindung veröffentlicht haben, können Sie die status im Abschnitt Connectors des Admin Centers überprüfen. Weitere Informationen finden Sie unter Verwalten Ihres Connectors.
Wenn Sie Probleme haben oder Feedback geben möchten, finden Sie weitere Informationen unter Microsoft Graph-Support.