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 de Microsoft 365 Copilot do Asana permite que a sua organização indexe tarefas asana. Depois de configurar o conector e o conteúdo do índice a partir das áreas de trabalho do Asana, os utilizadores podem procurar esses itens no Microsoft Search e Microsoft 365 Copilot.
Este artigo destina-se a administradores do Microsoft 365 ou a qualquer pessoa que configure, execute e monitorize um conector Asana Copilot.
Recursos
- Tarefas de índice.
- Permita que os seus utilizadores façam perguntas relacionadas com o controlo de projetos e informações de tarefas no Copilot. Por exemplo:
- Identificar tarefas que não foram atribuídas em todos os meus projetos.
- Identifique quaisquer tarefas em atraso num projeto.
- Resumir as minhas tarefas para as próximas duas semanas.
- Utilize a pesquisa semântica no Copilot para permitir que os utilizadores encontrem conteúdos relevantes com base em palavras-chave, preferências pessoais e ligações sociais.
Limitações
- O conector não indexa comentários.
- O conector não indexa campos personalizados.
Pré-requisitos
- Tem de ser o administrador de pesquisa do inquilino do Microsoft 365 da sua organização.
- Para ligar à área de trabalho do Asana, precisa do URL do Asana. Normalmente, o URL é o seguinte:
https://app.asana.com. - Para ligar ao Asana e permitir que o conector Copilot atualize tarefas do Asana regularmente, precisa de uma conta de serviço com permissões de leitura. A conta de serviço tem de ter a função Administração.
Introdução
Escolher 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.
Adicionar o URL do Asana
Para ligar à área de trabalho do Asana, precisa do URL do Asana. Normalmente, o URL é o seguinte: https://app.asana.com.
Escolher o tipo de autenticação
Para utilizar o Asana OAuth para autenticação, um administrador da Asana tem de criar uma aplicação na consola do programador asana.
Utilize as informações na tabela seguinte para preencher o formulário de criação do cliente OAuth.
| Campo | Descrição | Valor recomendado |
|---|---|---|
| Nome do aplicativo | Valor exclusivo que identifica a aplicação para a qual precisa de acesso OAuth. | Pesquisa da Microsoft |
| O que melhor descreve o que a sua aplicação irá fazer? | Descreva o objetivo da aplicação. | Obtenha dados do Asana para criar relatórios. |
| URL de redirecionamento | Um URL de chamada de retorno necessário para o qual o servidor de autorização redireciona. | Para Microsoft 365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callbackPara o Microsoft 365 Administração Pública: https://gcsgcc.office.com/v1.0/admin/oauth/callback |
| Gerir a distribuição | Selecione áreas de trabalho a distribuir. | Adicione áreas de trabalho específicas às quais o conector possa aceder ou selecione Qualquer área de trabalho. |
Copie o ID de cliente e o segredo do cliente do separador OAuth na aplicação Asana que criou e cole-os na configuração do conector. Selecione Autorizar e utilize as mesmas credenciais da conta de administrador do Asana para autenticar a permissão de pesquisa.
Observação
Tem de autorizar o acesso à aplicação Asana numa janela de pop-up. Certifique-se de que o browser permite janelas de pop-up ou concede acesso se a janela de pop-up estiver bloqueada.
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 o Asana. Selecione Criar para publicar os seus artigos de ligação e índice a partir da sua conta asana.
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 Asana.
| 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 obter informações sobre as propriedades predefinidas e o respetivo esquema, veja conteúdo. |
| Sincronização | Descrição |
|---|---|
| Pesquisa incremental | É executado a cada 15 minutos. |
| Pesquisa completa | É executado todos os dias. |
Se quiser editar qualquer um destes valores, selecione a opção Configuração personalizada .
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 Asana 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. No Atlassian Asana, 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 Asana é 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:
- Escolha a opção Microsoft Entra ID se o ID de e-mail dos utilizadores do Asana for igual ao UPN no Microsoft Entra ID.
- Selecione a opção Não Microsoft Entra ID se o ID de e-mail dos utilizadores do Asana for diferente do UPN e do e-mail dos utilizadores no Microsoft Entra ID.
Conteúdo
Gerir propriedades
Para poder adicionar ou remover propriedades disponíveis do Asana, 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. As seguintes propriedades estão indexadas por predefinição.
| Propriedade predefinida | Rótulo | Descrição | Esquema |
|---|---|---|---|
| Assignee | Não aplicável | A pessoa que deve concluir esta tarefa | Consultar, Obter, Procurar |
| Concluído | Não aplicável | O corpo main do artigo | Consultar, Obter |
| ConcluídoAt | Não aplicável | Data e hora em que a tarefa foi concluída | Consultar, Obter |
| CreatedAt | Data e hora de criação | Data e hora em que a tarefa foi criada | Consultar, Obter |
| CriarPor | Criado por | A pessoa que criou esta tarefa | Consultar, Obter, Procurar |
| DueOn | Não aplicável | Quando esta tarefa deve ser concluída | Consultar, Obter |
| Gid | Não aplicável | ID Global desta tarefa | Consultar, Obter |
| ModifiedAt | Hora da última modificação | Data e hora em que a tarefa foi modificada | Consultar, Obter |
| Nome | Título | Nome da tarefa | Consultar, Obter, Procurar |
| Notas | Não aplicável | Descrição da tarefa | Pesquisar |
| ProjectIds | Não aplicável | IDs do Projeto | Não aplicável |
| ProjectNames | Não aplicável | Nomes de projetos | Consultar, Obter |
| Marcações | tags | Etiquetas atribuídas a esta tarefa | Consultar, Obter |
| TaskUrl | url | A ligação da tarefa | Consultar, Obter, Procurar |
| WorkspaceName | Não aplicável | Nome da área de trabalho | 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 Asana Copilot. Existem dois tipos de intervalos de atualização: pesquisa completa e pesquisa incremental. 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.