Compartilhar via


Implemente o Aha! conector Microsoft 365 Copilot

O Aha! Funcionalidades e Ideias Microsoft 365 Copilot conectores capacitam a sua organização para indexar e procurar no Aha! funcionalidades e ideias em toda a sua empresa. Este artigo descreve os passos para implementar e personalizar o Aha! conector.

Para Aha avançado! informações de configuração, veja Configurar o serviço Aha! para ingestão de conectores.

Pré-requisitos

Antes de implementar o Aha! conector, certifique-se de que o Aha! o ambiente está configurado na sua organização. A tabela seguinte resume os passos para configurar o Aha! e implemente o conector.

Tarefa Função
Configurar o ambiente Aha! administrador
Implementar o conector no Centro de administração do Microsoft 365 Administrador do Microsoft 365
Personalizar as definições do conector (opcional) Administrador do Microsoft 365

Antes de implementar o conector, certifique-se de que cumpre os seguintes pré-requisitos:

  • Tem de ser um administrador do Microsoft 365.
  • Tem a Aha! URL da instância (por exemplo, https://contoso.aha.io).
  • Criou um Aha! Aplicação OAuth e tem o ID de cliente e o segredo do cliente.
  • O acesso à rede e à API está ativado para Microsoft 365 Copilot endereços IP.

Implementar o conector

Para adicionar o Aha! conector para a sua organização:

  1. Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectoresCopilot>.
  2. Aceda ao separador Conectores e, no painel esquerdo, selecione Galeria.
  3. Na lista de conectores disponíveis, selecione Aha!.

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 predefinido do Aha! 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 Aha! URL da instância. O URL segue o formato https://<company>.aha.io.

Escolher tipo de autenticação

O Aha! O conector utiliza o OAuth 2.0 para autenticação. Para configurar:

  • Crie um Aha! Aplicação OAuth no Aha! consola do programador.
  • Introduza o ID de cliente e o segredo do cliente obtidos durante o registo da aplicação OAuth.
  • Utilize o URI de redirecionamento:
    • Para Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
    • Para o Microsoft 365 Administração Pública: https://gcsgcc.office.com/v1.0/admin/oauth/callback

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 Aha! O conector 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 Permissões de acesso: apenas os utilizadores com acesso ao conteúdo na origem de dados. Identidades mapeadas com IDs de Microsoft Entra.
Conteúdo Propriedades predefinidas indexadas para funcionalidades e ideias.
Sincronização A pesquisa incremental é executada a cada 15 minutos; a pesquisa completa é executada 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 o Aha! definições do conector. 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 Asana suporta as seguintes permissões de acesso de utilizador:

  • Apenas pessoas com acesso a esta origem de dados (predefinição)
  • Todos

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 do mapa

Mapear Aha! identidades para Microsoft Entra IDs para controlo de acesso seguro.

Personalizar definições de conteúdo

Gerir propriedades

Pode adicionar ou remover propriedades, atribuir etiquetas semânticas e configurar atributos de esquema.

As seguintes propriedades estão indexadas por predefinição para Aha! Funcionalidades.

Propriedade predefinida Rótulo Descrição Esquema
assignToUser O utilizador ao qual a funcionalidade está atribuída. Pesquisar
assignToUserEmail Email endereço do utilizador atribuído. Pesquisar
createTime Data e hora de criação Data e hora em que a funcionalidade foi criada na origem de dados. Consultar, Obter
createdBy Criado por O utilizador que criou a funcionalidade. Consultar, Obter, Procurar
description Conteúdo A descrição da funcionalidade. Pesquisar
dueDate A data de conclusão do destino da funcionalidade. Consultar
epicName O nome do épico a que a funcionalidade pertence. Obter, Procurar
id Identificador exclusivo da funcionalidade. Consultar, Obter
link Uma ligação ou referência à funcionalidade. Consultar, Obter, Procurar
nome Título O título da funcionalidade apresentado em Copilot e experiências de pesquisa. Consultar, Obter, Procurar
referência Identificador de referência interno ou externo. Consultar
releaseName O nome da versão associada. Pesquisar
pontuação Uma classificação numérica ou qualitativa associada à funcionalidade. Consulta, Pesquisa
startDate A data de início planeada da funcionalidade. Consultar
status O estado atual da funcionalidade (por exemplo, planeado, em curso, concluído). Consulta, Refinar, Procurar
tag Etiquetas ou etiquetas associadas à funcionalidade. Consultar, Obter, Procurar
updateTime Hora da última modificação Data e hora em que a funcionalidade foi atualizada pela última vez na origem de dados. Consultar, Obter
url url O URL de destino da funcionalidade na origem de dados. Obter, Procurar

As seguintes propriedades estão indexadas por predefinição para Aha! Ideias.

Propriedade predefinida Rótulo Descrição Esquema
assignToUser O utilizador a quem a ideia está atribuída. Consulta, Pesquisa
assignToUserEmail Email endereço do utilizador atribuído. Consulta, Pesquisa
categories Categorias ou grupos associados à ideia. Consultar, Obter
createTime Data e hora de criação Data e hora em que a ideia foi criada na origem de dados. Consultar, Obter
createdBy Criado por O utilizador que criou a ideia. Consultar, Obter, Procurar
description Conteúdo A descrição ou os detalhes da ideia. Pesquisar
iconUrl IconUrl URL do ícone que representa a ideia. Obter
id Identificador exclusivo da ideia. Consultar, Obter
link Uma ligação ou referência à ideia. Consultar, Obter, Procurar
nome Título O título da ideia apresentado em Copilot e outras experiências de pesquisa. Consultar, Obter, Procurar
referência Identificador de referência interno ou externo. Consultar
pontuação Uma classificação numérica ou qualitativa que indica importância ou relevância. Consulta, Pesquisa
status O estado atual da ideia (por exemplo, novo, planeado, enviado). Consulta, Refinar, Obter
updateTime Hora da última modificação Data e hora em que a ideia foi atualizada pela última vez na origem de dados. Consultar, Obter
url url O URL de destino da ideia na origem de dados Obter, Procurar
votos O número de votos submetidos para a ideia. Consultar, Obter

Personalizar intervalos de sincronização

Pode personalizar os intervalos de sincronização para pesquisa completa e pesquisa incremental. Valores predefinidos:

  • Pesquisa incremental: a cada 15 minutos
  • Pesquisa completa: todos os dias

Para obter mais informações, veja Diretrizes para definições de sincronização.

Limites de taxa

A tabela seguinte lista os limites de taxa que se aplicam ao Aha! conector (para funcionalidades e ideias).

Número aproximado de itens Hora aproximada para concluir a ingestão
Até 10 000 Até 1 hora
10.000 a 300.000 Horas a 1 dia
300.000 a 2.000.000 2 dias a 1 semana
2000 000 ou mais 1 a 2 semanas (varia de acordo com a carga do ambiente)