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 conector guru Microsoft 365 Copilot integra conteúdos do Guru no Microsoft 365, permitindo que a Copilot, a Copilot Search e a Microsoft Search procurem cartões Guru relevantes diretamente em aplicações como o Teams, Outlook e SharePoint. Este artigo descreve os passos para implementar e personalizar o conector Guru.
Pré-requisitos
Antes de implementar o conector Guru, certifique-se de que cumpre os seguintes pré-requisitos:
- Tem de ser o administrador de pesquisa do inquilino do Microsoft 365 da sua organização.
- Conta de Administração do Guru Instance: para ligar à sua instância do Guru e permitir que o conector guru Microsoft 365 Copilot atualize os cartões Guru regularmente, precisa de uma conta de utilizador administrador da instância do Guru com permissão para criar um token de utilizador. Encontre mais detalhes aqui.
Implementar o conector
Para adicionar o conector Guru à sua organização:
- Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectoresCopilot>.
- Aceda ao separador Conectores e, no painel esquerdo, selecione Galeria.
- Na lista de conectores disponíveis, selecione Guru.
Definir nome a apresentar
O nome a apresentar é utilizado para identificar referências em respostas copilot para ajudar os utilizadores a reconhecer 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. Pode aceitar o nome a apresentar do Guru predefinido ou personalizar o valor para utilizar um nome a apresentar que os utilizadores na sua organização reconheçam.
Para obter mais informações sobre os nomes a apresentar e descrições do conector, veja Melhorar a deteção copilot de conteúdo do conector.
Definir URL da instância
Indique o URL da instância do Guru. A estrutura típica é https://app.getguru.com/ seguida pelo identificador de instância da sua organização.
Escolher tipo de autenticação
O conector Guru suporta a Autenticação Básica através de um token de utilizador. Recomendamos que utilize uma conta de administrador do Guru para gerar o token de utilizador. Para obter mais informações, veja a documentação da API Guru.
Implementar
Para implementar para uma audiência limitada, selecione o botão de alternar junto a Implementação para audiência limitada e especifique os utilizadores e grupos para os quais pretende implementar o conector. Para obter mais informações, veja Implementação faseada para conectores Copilot.
Selecione Criar para implementar a ligação. O conector Guru Copilot começa imediatamente a indexar conteúdo.
A tabela seguinte lista os valores predefinidos que estão definidos.
| Categoria | Valor padrão |
|---|---|
| Usuários | Apenas pessoas com acesso a esta origem de dados. |
| Usuários | Identidades de origem de dados mapeadas com Microsoft Entra IDs. |
| Conteúdo | Todos os cartões, exceto os cartões em espaço pessoal. |
| Conteúdo | Para marcar propriedades predefinidas e o respetivo esquema, veja Gerir propriedades. |
| Sincronização | Pesquisa incremental: a cada 15 minutos. |
| Sincronização | Pesquisa completa: todos os dias. |
Para personalizar estes valores, selecione Configuração personalizada. Para obter mais informações, veja Personalizar definições.
Depois de criar a ligação, pode rever a status na secção Conectores do Centro de administração do Microsoft 365.
Personalizar definições (opcional)
Pode personalizar os valores predefinidos para as definições do conector Guru. Para personalizar as definições, na página do conector no centro de administração, selecione Configuração personalizada.
Personalizar as definições do utilizador
Permissões de acesso
O conector Guru suporta duas opções para permissões de acesso:
- Todos: os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores.
- Apenas as pessoas com acesso a esta origem de dados (predefinição): apenas os utilizadores com acesso no Guru podem ver o conteúdo.
Se escolher Apenas pessoas com acesso a esta origem de dados, terá de escolher se a sua instância do Guru tem Microsoft Entra ID utilizadores aprovisionados ou utilizadores que não sejam da Entra ID:
- Escolha a opção Microsoft Entra ID se o ID de e-mail dos utilizadores do Guru for o mesmo que o nome principal de utilizador (UPN) dos utilizadores no Microsoft Entra ID.
- Escolha a opção de ID não Entra se o ID de e-mail dos utilizadores do Guru for diferente do UPN dos utilizadores no Entra ID.
Se escolher Microsoft Entra ID como a origem de identidade, o conector mapeia os IDs de e-mail do utilizador do Guru para a propriedade UPN no Microsoft Entra ID. Se escolher o ID não Entra como a origem de identidade, forneça uma expressão regular para mapear o ID de e-mail para o UPN. Para obter mais informações, consulte Mapear as suas identidades não-Entra ID.
Observação
Atualizações para utilizadores ou grupos que regem as permissões de acesso são sincronizados apenas em pesquisas completas. Atualmente, as pesquisas incrementais não suportam o processamento de atualizações para permissões.
Personalizar definições de conteúdo
Pode personalizar os dados incluídos e excluídos e personalizar as propriedades do conector predefinido.
Filtros de ingestão de conteúdos
Pode escolher os dados que pretende indexar. Utilize a Linguagem de Consulta Guru (GQL) para filtrar os seus dados antes de serem indexados, permitindo-lhe controlar que dados são pesquisáveis. Por exemplo, pode utilizar o filtro GQL para indexar conteúdo modificado após um determinado período de tempo com lastModified > 2016-01-01T00:00:00.000-00:00.
Para obter mais informações, veja Linguagem de Consulta Guru.
Utilize o botão de resultados de pré-visualização para verificar os valores de exemplo das propriedades e filtros selecionados.
Gerir propriedades
Pode marcar as propriedades disponíveis da sua instância do Guru. Atribua um esquema à propriedade (defina se uma propriedade é pesquisável, consultada, recuperável ou refinável), altere a etiqueta semântica e adicione um alias à propriedade . A tabela seguinte lista as propriedades que o conector indexa por predefinição.
| Propriedade predefinida | Etiqueta Semântica | Descrição | Esquema |
|---|---|---|---|
| Título | title | Título do card | Consulta, Procurar, Obter |
| Link | URL | URL do item | Obter |
| CreatedTime | createdDateTime | Data/Hora em que o card foi criado | Consultar, Obter |
| ModifiedTime | lastModifiedDateTime | Data/Hora em que a card foi atualizada pela última vez | Consultar, Obter, Refinar |
| Proprietário | createdBy | Proprietário do card | Consulta, Procurar, Obter |
| LastModifiedBy | lastModifiedBy | Nome da pessoa que modificou a card pela última vez | Consulta, Procurar, Obter |
| Coleção | containerName | Nome da coleção à card pertence | Consulta, Procurar, Obter |
| CollectionUrl | containerUrl | URL da coleção à card pertence | Obter |
| Conteúdo | conteúdo | Conteúdo HTML composto da página | Consulta, Pesquisa |
Personalizar intervalos de sincronização
O intervalo de atualização determina a frequência com que os seus dados são sincronizados entre a origem de dados e o índice do conector Guru. Os conectores copilot utilizam dois tipos de intervalos de atualização:
- Pesquisa completa: a predefinição é todos os dias.
- Pesquisa incremental: a predefinição é de 15 em 15 minutos.
Pode alterar os valores predefinidos dos intervalos de atualização. Para obter mais informações, veja Diretrizes para definições de sincronização.