Conector de Microsoft 365 Copilot DataStax

O conector de Microsoft 365 Copilot DataStax permite que a sua organização indexe registos nas suas coleções do DataStax Astra DB. Depois de configurar o conector e o conteúdo do índice a partir das bases de dados DataStax, os utilizadores podem procurar esses itens no Microsoft 365 Copilot.

Este artigo destina-se a administradores do Microsoft 365 ou a qualquer pessoa que configure, execute e monitorize o conector DataStax Copilot.

Recursos

• Indexar registos em coleções do DataStax Astra DB.
• Permita que os seus utilizadores peçam conselhos com base no conhecimento do DataStax no Copilot. Por exemplo, configurou o conector para aceder à coleção de críticas de filmes no DataStax:
  • Recomende um filme baseado em textos de revisão e nos seus interesses.
  • Resuma o texto de revisão no filme Paa.
  • Identifique o filme que gera discussões acaloradas.

Limitações

• Não indexa BD Não Vetor.
• Não indexa o Langflow.
• Não suporta verticais de pesquisa.

Pré-requisitos

• Tem de ser o administrador de pesquisa do inquilino do Microsoft 365 da sua organização.
• Para ligar à base de dados DataStax, precisa do Ponto Final da API dataStax e do ID da base de dados.
• Para ligar ao DataStax e permitir que o conector Copilot atualize tarefas DataStax regularmente, precisa de um token de aplicação com permissões de leitura.

Introdução

1. Escolha um nome a apresentar

O 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; pode personalizá-lo para um nome que os utilizadores na sua organização reconheçam.

2. Adicionar o Ponto Final da API dataStax

Para ligar à base de dados DataStax, precisa do Ponto Final da API DataStax. O ponto final pode ser encontrado na descrição geral da base de dados e é normalmente o seguinte: https://<your-database-id>-<region>.apps.astra.datastax.com.

3. Adicionar o ID da base de dados DataStax

Para ligar à base de dados DataStax, precisa do ID da base de dados DataStax. O ID da base de dados pode ser encontrado na descrição geral da base de dados.

4. Gerar o Token de Aplicação

Para utilizar o Token de Aplicação DataStax para autenticação, um administrador do DataStax tem de gerar o token de aplicação para a base de dados com uma função de utilizador adequada, como utilizar "Utilizador Só de Leitura".

Copie o token de aplicação gerado a partir dos detalhes do token, que é normalmente uma cadeia longa que começa com "AstraCS:..." e cole-o na configuração do conector. Selecione Autorizar e utilize o mesmo token para autenticar a permissão para pesquisar.

5. Implementar para uma audiência limitada

Implemente a ligação numa base de utilizadores limitada se quiser validá-la no Copilot e noutras superfícies de Pesquisa antes de a implementar para uma audiência mais ampla. Para obter mais informações, veja Implementação faseada para conectores.

Neste momento, está pronto para criar a ligação para DataStax. Selecione Criar para publicar os seus artigos de ligação e índice a partir da sua conta DataStax.

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 dados DataStax.

Usuários	Descrição
Permissões de acesso	Apenas pessoas com acesso a conteúdos na Origem de dados.
Identidades do mapa	Identidades de origem de dados mapeadas com Microsoft Entra IDs.

Conteúdo	Descrição
Gerir propriedades	Para obter informações sobre as propriedades predefinidas e o respetivo esquema, veja conteúdo.

Sincronização	Descrição
Pesquisa completa	É executado 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 DataStax 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 as 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 aos mesmos. No Atlassian DataStax, as permissões de segurança são definidas através de esquemas de permissão de projetos que contêm grupos ao nível do site e funções de projeto. A segurança ao nível da tarefa também pode ser definida através de esquemas de permissões ao nível da tarefa.

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 DataStax é o mesmo que o nome principal de utilizador (UPN) dos utilizadores no Microsoft Entra ID. 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:

1. Escolha a opção Microsoft Entra ID se o ID de e-mail dos utilizadores do DataStax for igual ao UPN no Microsoft Entra ID.
2. Escolha a opção Não Microsoft Entra ID se o ID de e-mail dos utilizadores do DataStax for diferente do UPN e do e-mail dos utilizadores no Microsoft Entra ID.

Conteúdo

Gerir propriedades

Para ver as propriedades disponíveis da origem de dados DataStax, 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 na propriedade. Algumas propriedades estão selecionadas por predefinição.

Propriedade predefinida	Rótulo	Descrição	Esquema
Coleção	Não aplicável	O nome da coleção	Consultar, Obter, Procurar.
Conteúdo	Não aplicável	O registo na coleção	Pesquisa.
IconUrl	IconUrl	O URL do ícone do registo	Obter.
Id	url	O ID de registo na coleção	Consulta, Obter.
Espaço de chaves	Não aplicável	A pessoa que criou esta tarefa	Consultar, Obter, Procurar.
Título	Título	O título criado ao combinar o nome da coleção e o ID de registo	Consultar, Obter, Procurar.

Pré-visualizar dados

Utilize o botão de resultados de 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 seus dados são sincronizados entre a origem de dados e o índice do conector DataStax Copilot. O conector do gráfico DataStax só suporta o intervalo de atualização – pesquisa completa. Para obter mais informações, veja Definições de atualização.

Pode alterar os valores predefinidos do intervalo de atualização.

Próximas etapas

Depois de publicar a ligação, pode rever o status em Origens de Dados no centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector.

Se tiver problemas ou quiser fornecer comentários, consulte Suporte do Microsoft Graph.