Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Miro Microsoft 365 Copilot permite a su organización indexar paneles de Miro. Después de configurar el conector, los usuarios pueden buscar estos paneles desde Miro en Microsoft 365 Copilot y cualquier cliente de Microsoft Search.
Este artículo está destinado a administradores de Microsoft 365 o a cualquier persona que configure, ejecute y supervise un conector Miro Copilot.
Capacidades
- Paneles de acceso en Copilot mediante la eficacia de la búsqueda semántica.
- Personalice la frecuencia de rastreo.
- Cree un agente mediante el origen de datos de la conexión desde Microsoft Copilot Studio.
Limitaciones
- Solo se indexa el contenido de notas adhesivas, formas, marcos, texto y documentos incrustados en un panel. No se incluye el contenido de otros tipos de objeto. Para obtener más información, consulte documentación de Miro para desarrolladores.
- No indexa comentarios ni respuestas.
Requisitos previos
1. Crear un equipo de desarrollador para su cuenta miro
Cree o use una cuenta de Miro existente para acceder a Miro y haga clic en el vínculo para crear un equipo para desarrolladores para su cuenta de Miro activa. Si su organización está en un plan Enterprise, vaya a Equipos de desarrolladores empresariales. Para obtener más información, consulte Creación de un equipo de desarrolladores.
2. Creación de la aplicación en Miro
Inicie sesión en Miro y cree una nueva aplicación en Sus aplicaciones.
3. Agregar permisos a la aplicación
Agregue el boards:read Read boards you have access to plan en la aplicación que creó en la configuración de la aplicación.
4. Agregar dirección URL de redireccionamiento a la aplicación
En la página de creación de la aplicación, agregue los vínculos siguientes al campo "Dirección URL de redireccionamiento para OAuth2.0".
Para M365 Enterprise, copie y pegue:
https://gcs.office.com/v1.0/admin/oauth/callbackPara M365 Government, copie y pegue:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
5. Instale la aplicación y registre las credenciales.
Haga clic en Instalar aplicación y obtenga el token de OAuth y registre y Client IDClient secret desde las credenciales de la aplicación.
Introducción
1. Configurar el nombre para mostrar
Se usa un nombre para mostrar para identificar cada cita en Copilot para ayudar a los usuarios a reconocer fácilmente el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza y se usa como filtro de origen de contenido. Se proporciona un valor predeterminado para este campo; puede personalizarlo con un nombre que los usuarios de su organización reconozcan.
2. Agregar identificador de empresa
El identificador de empresa (también denominado Id. de organización) es el identificador único de la cuenta miro de su organización. Para encontrarlo, abra el panel de Miro, haga clic en su perfil en la esquina superior derecha, seleccione Configuración y, a continuación, compruebe la dirección URL en la barra de direcciones, donde se mostrará el identificador de empresa.
Nota:
Solo puede asociar un identificador de empresa en la conexión. Si tiene varios identificadores de empresa en el área de trabajo de Miro, cree una conexión independiente.
3. Proporcione el tipo de autenticación.
Escriba el id. de cliente y el secreto de cliente que obtuvo de la aplicación Miro. Para obtener más información, consulte Introducción a OAuth 2.0 y Miro.
4. Lanzamiento a audiencia limitada
Implemente esta conexión en una base de usuarios limitada si desea validarla en Copilot y en otras superficies de búsqueda antes de expandir el lanzamiento a una audiencia más amplia. Para obtener más información, consulte Lanzamiento provisional para conectores copilot de Microsoft 365.
Para crear la conexión para Miro, elija Crear para publicar la conexión y los paneles de índice desde su cuenta de Miro.
Para otras opciones de configuración, como permisos de acceso, esquema y frecuencia de rastreo, los valores predeterminados se establecen en función de lo que funcione mejor con los datos de Miro.
| Usuarios | Descripción |
|---|---|
| Permisos de acceso | Solo las personas con acceso al contenido del origen de datos. |
| Asignar identidades | Identidades de origen de datos asignadas mediante identificadores de Microsoft Entra. |
| Contenido | Descripción |
|---|---|
| Administrar propiedades | Para comprobar las propiedades predeterminadas y su esquema. |
| Sincronizar | Descripción |
|---|---|
| Rastreo completo | Frecuencia: todos los días |
Configuración personalizada
En la configuración personalizada, puede editar cualquiera de los valores predeterminados para los usuarios, el contenido y la sincronización.
Usuarios
Permisos de acceso
El conector Miro Copilot admite permisos de búsqueda que son visibles para todos los usuarios o solo las personas con acceso a este origen de datos. Si elige Todos, los datos indexados aparecerán en los resultados de búsqueda de todos los usuarios. Si elige Solo las personas con acceso a este origen de datos, los datos indexados aparecerán en los resultados de la búsqueda para los usuarios que tengan acceso a él.
Asignación de identidades
El método predeterminado para asignar las identidades del origen de datos con Microsoft Entra id. consiste en comprobar que el identificador de correo electrónico de los usuarios de Miro es el mismo que el nombre principal de usuario (UPN) o el correo electrónico de los usuarios de Microsoft Entra. Si la asignación predeterminada no funciona para su organización, puede proporcionar una fórmula de asignación personalizada. Para obtener más información, consulte Asignación de identidades que no son de Azure AD.
Para identificar qué opción es la mejor para su organización:
- Elija la opción Microsoft Entra id. si el identificador de correo electrónico de los usuarios de Miro es el mismo que el UPN o el correo electrónico de los usuarios en Microsoft Entra ID.
- Elija la opción Id. no Microsoft Entra si el identificador de correo electrónico de los usuarios de Miro es diferente del UPN y el correo electrónico de los usuarios en Microsoft Entra ID.
Contenido
Administrar propiedades
Para agregar o quitar propiedades disponibles del origen de datos de Miro, asigne un esquema a la propiedad (defina si una propiedad se puede buscar, consultar, recuperar o refinar), cambie la etiqueta semántica y agregue un alias a la propiedad. Algunas propiedades se seleccionan de forma predeterminada.
| Source (propiedad) | Etiqueta | Descripción | Esquema |
|---|---|---|---|
| Cuerpo | ND | ND | Búsqueda |
| CreatedAt | Fecha y hora de creación | Fecha y hora en que se creó el elemento en el origen de datos | Consulta, Recuperar. |
| CreatedBy | Creada por | El usuario que creó el elemento | Consulta, Recuperación, Búsqueda. |
| Descripción | ND | ND | Consulta, Recuperar. |
| Id | ND | ND | Consulta, Recuperar. |
| ModifiedAt | Fecha de la última modificación | Fecha y hora en que se modificó por última vez el elemento en el origen de datos | Consulta, Recuperar. |
| ModifiedBy | Última modificación | El usuario que realizó la última modificación | Consulta, Recuperación, Búsqueda. |
| Nombre | El título | El título del elemento que desea que se muestre en Copilot y otras experiencias de búsqueda | Consulta, Recuperación, Búsqueda. |
| Equipo | ND | ND | Consulta, Recuperar. |
| ViewLink | url | La dirección URL objetivo del elemento en el origen de datos | Consulta, Recuperar. |
Vista previa de datos
Haga clic en vista previa de los resultados para comprobar los valores de ejemplo de las propiedades seleccionadas y el filtro de consulta.
Sincronizar
El intervalo de actualización determina la frecuencia con la que se sincronizan los datos entre el origen de datos y el índice del conector Miro Copilot. Solo se admiten intervalos de actualización de rastreo completos. Para obtener más información, vea Actualizar configuración.
Puede cambiar los valores predeterminados del intervalo de actualización.
Solución de problemas
A continuación se muestran errores comunes y cómo resolverlos.
- Faltan los ámbitos de permisos necesarios. Asegúrese de que los ámbitos necesarios están seleccionados en la aplicación Miro.
No tiene los ámbitos de permisos necesarios. Asegúrese de que seleccionó boards:read Read boards you have access to en el campo de permiso de la configuración de Aplicaciones.
- Error en el flujo de OAuth 2.0. Compruebe la información de credenciales y asegúrese de que la aplicación Miro está configurada con la configuración correcta.
Se trata de un error de autenticación común. Volver a la aplicación Miro y compruebe que OAuth2 en Configuración está configurado correctamente.
- Error en el flujo de OAuth 2.0. Confirme que el usuario de Miro asociado a este token de acceso de equipo tiene el rol de administrador del equipo y es un usuario activo.
Se trata de un error de autenticación común. Volver a la consola de la aplicación Miro y compruebe que el creador tiene un rol de administrador y que el estado de la cuenta está activo.
- Las credenciales de seguridad han expirado para esta sesión. Volver e inicie sesión de nuevo con la clave de aplicación y el secreto de la aplicación.
La información de credenciales ha expirado. Actualice la aplicación Miro y copie el identificador de cliente y el secreto de cliente más recientes de la pestaña configuración para autenticarse.
- Se detectaron credenciales no válidas. Compruebe la información de credenciales y compruebe los ámbitos de permisos de la aplicación Miro.
Se trata de un error de credencial común. Volver a la aplicación Miro y compruebe que los ámbitos de Permisos están configurados correctamente.
Pasos siguientes
Después de publicar la conexión, puede revisar el estado en la sección Conectores del Centro de administración. Para obtener más información, consulte Administración del conector.
Si tiene problemas o quiere proporcionar comentarios, consulte Soporte técnico de Microsoft Graph.