Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Miro Microsoft 365 Copilot permite à sua organização indexar quadros do Miro. Depois de configurar o conector, os utilizadores podem procurar estes quadros no Miro no Microsoft 365 Copilot e em qualquer cliente microsoft Search.
Este artigo destina-se a administradores do Microsoft 365 ou a qualquer pessoa que configure, execute e monitorize um conector Miro Copilot.
Recursos
- Aceda a quadros no Copilot com o poder da pesquisa semântica.
- Personalize a frequência de pesquisa.
- Crie um agente com a origem de dados da ligação do Microsoft Copilot Studio.
Limitações
- Apenas o conteúdo dentro de notas autocolantes, formas, molduras, texto e documentos incorporados num quadro é indexado. O conteúdo noutros tipos de objetos não está incluído. Para obter mais informações, veja Documentos do Miro para programadores.
- Não indexa comentários ou respostas.
Pré-requisitos
1. Criar uma equipa de Programadores para a sua conta Miro
Crie ou utilize uma conta Miro existente para aceder ao Miro e clique na ligação para criar uma Equipa de programador para a sua conta Miro ativa. Se a sua organização estiver num plano Enterprise, aceda a Equipas de Programadores Empresariais. Para obter mais informações, veja Criar uma equipa de Programadores.
2. Criar a sua aplicação no Miro
Inicie sessão no Miro e crie uma nova aplicação em As suas aplicações.
3. Adicionar permissões à sua aplicação
Adicionar o boards:read Read boards you have access to plano na aplicação que criou na configuração da sua aplicação
4. Adicionar URL de redirecionamento à sua aplicação
Na página de criação da aplicação, adicione as seguintes ligações ao campo "URL de Redirecionamento para OAuth2.0".
Para O M365 Enterprise, copie e cole:
https://gcs.office.com/v1.0/admin/oauth/callbackPara o M365 Administração Pública, copie e cole:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
5. Instalar a sua aplicação e registar credenciais
Clique em Instalar aplicação e obtenha o token OAuth e registe e a Client IDClient secret partir das credenciais da aplicação.
Introdução
1. Configurar o nome a apresentar
Um nome a apresentar é utilizado para identificar cada citação em Copilot para ajudar os utilizadores a reconhecer facilmente o ficheiro ou item associado. O nome a apresentar também significa conteúdo fidedigno e é utilizado como um filtro de origem de conteúdo. É fornecido um valor predefinido para este campo; pode personalizá-lo para um nome que os utilizadores na sua organização reconheçam.
2. Adicionar ID da Empresa
O ID da Empresa (também denominado ID da Organização) é o identificador exclusivo da conta Miro da sua organização. Pode encontrá-lo ao abrir a dashboard do Miro, clicar no seu perfil no canto superior direito, selecionar Definições e, em seguida, verificar o URL na barra de endereço, onde será apresentado o ID da Empresa.
Observação
Só pode associar um ID da Empresa na ligação. Se tiver vários IDs da Empresa na área de trabalho do Miro, crie uma ligação separada.
3. Indique o Tipo de autenticação
Introduza o ID de Cliente e o Segredo do cliente que obteve a partir da sua aplicação Miro. Para obter mais informações, consulte Introdução ao OAuth 2.0 e ao Miro.
4. Implementar para público-alvo limitado
Implemente esta ligação numa base de utilizadores limitada se pretender validá-la no Copilot e noutras superfícies de Pesquisa antes de expandir a implementação para uma audiência mais ampla. Para obter mais informações, consulte Implementação faseada para conectores Do Microsoft 365 Copilot.
Para criar a ligação para o Miro, selecione Criar para publicar os quadros de ligação e de índice a partir da sua conta Miro.
Para outras definições, como permissões de Acesso, Esquema e Frequência de pesquisa, os valores predefinidos são definidos com base no que funciona melhor com os dados do Miro.
| Usuários | Descrição |
|---|---|
| Permissões de acesso | Apenas pessoas com acesso ao conteúdo na origem de dados. |
| Identidades do mapa | Identidades de origem de dados mapeadas com Microsoft Entra IDs. |
| Conteúdo | Descrição |
|---|---|
| Gerir propriedades | Para marcar as propriedades predefinidas e o respetivo esquema. |
| Sincronização | Descrição |
|---|---|
| Pesquisa completa | Frequência: todos os dias |
Configuração personalizada
Na configuração personalizada, pode editar qualquer um dos valores predefinidos para utilizadores, conteúdos e sincronização.
Usuários
Permissões de acesso
O conector Miro Copilot suporta permissões de pesquisa visíveis para Todos ou Apenas pessoas com acesso a esta origem de dados. Se escolher Todos, os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores. Se escolher Apenas pessoas com acesso a esta origem de dados, os dados indexados são apresentados nos resultados da pesquisa para os utilizadores que têm acesso à mesma.
Identidades de mapeamento
O método predefinido para mapear as identidades da origem de dados com Microsoft Entra ID é verificar se o ID de e-mail dos utilizadores do Miro é o mesmo que o nome principal de utilizador (UPN) ou o e-mail dos utilizadores no Microsoft Entra. Se o mapeamento predefinido não funcionar para a sua organização, pode fornecer uma fórmula de mapeamento personalizada. Para obter mais informações, consulte Mapear identidades não Azure AD.
Para identificar qual é a melhor opção para a sua organização:
- Escolha a opção Microsoft Entra ID se o ID de e-mail dos utilizadores do Miro for o mesmo que o UPN ou o e-mail dos utilizadores no Microsoft Entra ID.
- Escolha a opção ID não Microsoft Entra se o ID de e-mail dos utilizadores do Miro for diferente do UPN e do e-mail dos utilizadores no Microsoft Entra ID.
Conteúdo
Gerir propriedades
Para adicionar ou remover propriedades disponíveis da sua origem de dados Miro, atribua um esquema à propriedade (defina se uma propriedade é pesquisável, pesquisável, recuperável ou refinável), altere a etiqueta semântica e adicione um alias à propriedade. Algumas propriedades estão selecionadas por predefinição.
| Propriedade Source | Rótulo | Descrição | Esquema |
|---|---|---|---|
| Corpo | NA | NA | Pesquisar |
| CreatedAt | Data e hora de criação | Data e hora em que o item foi criado na origem de dados | Consulta, Obter. |
| CreatedBy | Criado por | O utilizador que criou o item | Consultar, Obter, Procurar. |
| Descrição | NA | NA | Consulta, Obter. |
| Id | NA | NA | Consulta, Obter. |
| ModifiedAt | Hora da última modificação | Data e hora em que o item foi modificado pela última vez na origem de dados | Consulta, Obter. |
| ModifiedBy | Última modificação por | O utilizador que efetuou a última modificação | Consultar, Obter, Procurar. |
| Nome | Título | O título do item que pretende que seja apresentado em Copilot e outras experiências de pesquisa | Consultar, Obter, Procurar. |
| Equipe | NA | NA | Consulta, Obter. |
| ViewLink | url | A URL de destino do item na fonte de dados | Consulta, Obter. |
Pré-visualizar dados
Clique nos resultados da pré-visualização para verificar os valores de exemplo das propriedades selecionadas e do filtro de consulta.
Sincronização
O intervalo de atualização determina a frequência com que os dados são sincronizados entre a origem de dados e o índice do conector Miro Copilot. Apenas são suportados intervalos de atualização de pesquisa completos. Para obter mais informações, veja Definições de atualização.
Pode alterar os valores predefinidos do intervalo de atualização.
Solução de problemas
Seguem-se erros comuns e como resolve-los.
- Faltam os âmbitos de permissão necessários. Certifique-se de que os âmbitos necessários estão selecionados na Aplicação Miro.
Não tem os âmbitos de permissão necessários. Certifique-se de que selecionou boards:read Read boards you have access to no campo de permissão da configuração aplicações.
- O fluxo OAuth 2.0 falhou. Verifique as informações das credenciais e certifique-se de que a Aplicação Miro está configurada com as definições corretas.
Este é um erro de autenticação comum. Voltar à aplicação Miro e verifique se o OAuth2 nas Definições está configurado corretamente.
- O fluxo OAuth 2.0 falhou. Confirme que o utilizador Miro associado a este token de acesso de equipa tem a função de administrador de equipa e é um utilizador ativo.
Este é um erro de autenticação comum. Voltar à consola da aplicação Miro e verifique se o criador tem uma função de administrador e se a conta status está ativa.
- As credenciais de segurança expiraram para esta sessão. Voltar e inicie sessão novamente com a chave da aplicação e o Segredo da aplicação.
As suas informações de credenciais expiraram. Atualize a aplicação Miro e copie o ID de Cliente e o Segredo do cliente mais recentes no separador definições para autenticar.
- Foram detetadas Credenciais Inválidas. Verifique as informações das credenciais e marcar os âmbitos de permissão da Aplicação Miro.
Este é um erro de credencial comum. Voltar à Aplicação Miro e verifique se os âmbitos em Permissões estão configurados corretamente.
Próximas etapas
Depois de publicar a ligação, pode rever a status na secção Conectores do centro de administração. Para obter mais informações, consulte Gerir o conector.
Se tiver problemas ou quiser fornecer comentários, consulte Suporte do Microsoft Graph.