1. Integrar o conteúdo do Workvivo (apenas artigos públicos por enquanto) ao Microsoft Graph
2. Configurando o Copilot para usar os dados do Workvivo no Microsoft Graph para responder a perguntas.

Dispositivo(s): Computador / Dispositivo Móvel 

Funções/Permissões: Permissões de administrador na conta Microsoft, bem como a função de administrador no Workvivo.

Configuração do Microsoft Graph

1. Acesse o centro de administração do Microsoft Entra (entrada.microsoft.com)

 Nota: não confundir com o centro de administração do Microsoft 365 (admin.cloud.microsoft)
 

2. Na barra lateral esquerda, acesse Registros de aplicativos, clique em + Novo registro e insira os seguintes dados:

• Nome: Integração Workvivo Copilot
• Tipos de conta suportados: "Somente contas neste diretório organizacional (SUA EMPRESA - Locatário único)"
• URI de redirecionamento (opcional): Deixe em branco
• Clique no botão Registrar
   

3. Selecione Permissões de API - na barra lateral de Registro do aplicativo, acesse Permissões de API e clique em + Adicionar uma permissão.

• Na janela modal de permissões da API de solicitação, localize e clique em Microsoft Graph.
• Clique em Permissões do aplicativo
• Procure e adicione cada uma destas permissões:
  1. ConexãoExterna.LeituraGravação.PropriedadeDe
  2. ExternalItem.ReadWrite.OwnBy
• Clique em Adicionar permissões
   

4. Na lista de permissões da API, clique em ✓ Conceder consentimento de administrador para SUA EMPRESA.
 

5. Navegue até Certificados e segredos através da barra lateral, clique na aba Segredos do cliente e, em seguida, clique em + Novo segredo do cliente.

• Descrição: Token de integração do Workvivo Copilot
• Validade: Escolha um prazo de validade que esteja de acordo com suas políticas de segurança. Quando o token expirar, você precisará criar um novo manualmente e inseri-lo nas configurações do Workvivo.
• Clique em Adicionar
   

6. O novo token será adicionado à lista. Copie o valor e guarde-o em local seguro, pois ele será exibido apenas uma vez. Caso perca o token, você poderá excluí-lo e gerar um novo. Observação: a exclusão de um token atualmente em uso pelo Workvivo fará com que a integração com o Copilot pare de funcionar até que um novo token seja fornecido. 
 

7. Abra o Workvivo e navegue até Admin > Ferramentas > Integrações > Integrações de Aplicativos.

8. Localize a integração com o Microsoft Copilot. Caso não esteja visível, será necessário entrar em contato com o suporte da Workvivo para habilitar o recurso.
 

9. Clique no botão e, após alguns segundos, uma etiqueta "Configuração necessária" deverá aparecer.

10. Clique em Mostrar configurações e insira os seguintes detalhes:

• ID do locatário: Encontre esta informação na página de registro do aplicativo que você criou no centro de administração do Microsoft Entra, na tela Visão geral, em ID do diretório (locatário).
• ID do cliente: Encontre esta informação na mesma tela de Visão geral, em ID do aplicativo (cliente).
• Segredo do Cliente: Este é o valor do Segredo do Cliente (Token) que você criou e salvou anteriormente.
• Sincronizar artigos públicos: Ative esta opção para sincronizar artigos públicos (publicados para um público global ou em um espaço público).
• Preencher artigos existentes: Ative esta opção para importar todos os artigos públicos existentes na sua instância do Workvivo.
• Clique em Salvar.
   

11. Acesse admin.microsoft.com → Copilot → Conectores e encontre o conector que acabou de ser criado (deve se chamar WorkvivoArticles).
 

• Dê visibilidade ao Copiloto
   

12. Caso encontre alguma dificuldade, entre em contato com o suporte da Workvivo, que poderá ajudá-lo(a) com o processo.

Configuração do Microsoft Copilot

1. Acesse o Copilot Studio (copilotstudio.microsoft.com)
2. Na barra lateral esquerda, acesse Agentes e clique em Copilot para Microsoft 365.

3. Vá para a aba Agentes e clique em + Adicionar.

4. No canto superior direito, clique em "Pular para configurar" e insira os seguintes detalhes:
 

• Nome: Workvivo
• Descrição: Este agente tem acesso ao conteúdo da Workvivo, uma plataforma de experiência do colaborador. Os artigos podem conter atualizações da empresa, políticas, planos e notícias gerais. Quando o usuário tiver uma dúvida sobre sua própria empresa, poderá pesquisar conteúdo relevante da Workvivo para encontrar a resposta.
• Instruções: Pergunte ao usuário qual conteúdo do Workvivo ele está procurando. Se necessário, informe-os de que você não tem acesso a todo o conteúdo do Workvivo, apenas ao que a organização optou por compartilhar com a Copilot.
• Sugestões de perguntas: Opcionalmente, forneça alguns exemplos de perguntas que podem ajudar seus usuários, dependendo do conteúdo que você está sincronizando do Workvivo.
• Conhecimento: Aqui você selecionará o Conector Copilot criado pela Workvivo na seção anterior. Ao criar o Agente, o Conector pode não estar disponível e você poderá precisar adicioná-lo depois que o agente já tiver sido criado.
  1. Clique em + Adicionar conhecimento
  2. Clique em Avançado e, em seguida, em Conector Personalizado.
  3. Clique no conector e clique em Adicionar. O editor será o nome do registro do aplicativo que você criou na seção anterior. Se você seguiu o guia, esta deve ser a Integração do Workvivo Copilot.

Observação: Se esta página não carregar corretamente, você pode pular esta etapa e concluí-la depois que o agente for publicado.

• Configurações adicionais: Não habilite a navegação na Web, pois o Copilot tende a pesquisar conteúdo disponível publicamente na internet em vez de pesquisar conteúdo sincronizado do Workvivo.

5. Teste seu agente: faça uma pergunta sobre um artigo público que deveria ter sido sincronizado. Ele deve responder à sua pergunta com base no conteúdo do artigo e incluir um link para o artigo no Workvivo como referência.

 

6. Clique em Publicar e insira os seguintes detalhes:
 

• Descrição resumida: Um agente com acesso ao conteúdo sincronizado do Workvivo.
• Descrição longa: Encontre, resuma e faça perguntas sobre o conteúdo sincronizado do Workvivo.
• Nome do desenvolvedor: Workvivo
• Site: Sinta-se à vontade para fornecer um link próprio ou deixar o padrão.
• Declaração de privacidade: Sinta-se à vontade para fornecer seu próprio link ou manter o padrão.
• Termos de uso: Sinta-se à vontade para fornecer seu próprio link ou manter o padrão.
• Clique em Publicar e aguarde a publicação do agente. Isso pode levar um minuto.

7. Em Opções de disponibilidade > Acesso do usuário, clique em Mostrar para todos na minha organização, leia a mensagem e clique em Sim.
 

8. Navegue até o centro de administração do Microsoft 365 (admin.cloud.microsoft)
 

9. Na barra lateral esquerda, acesse Agentes > Todos os agentes e clique na guia Solicitações.

10. Você deverá ver seu agente Workvivo aqui. Caso não o veja, aguarde alguns minutos e clique em Atualizar. Clique no agente Workvivo e, na janela Detalhes do Agente, clique em Publicar, logo abaixo do nome do agente.
 

11. Após a publicação, clique em Implantar. Na janela modal Implantar Novo Agente, clique em Avançar. Em seguida, clique em Organização inteira e Avançar. Na próxima etapa, clique em Avançar. Na etapa seguinte, clique em Concluir implantação.
 

12. Assim que a implantação for concluída, clique em Concluído.
 

13. De volta à janela modal Detalhes do Agente, você pode clicar em Fixar para que os usuários possam fixar o agente.

Após a conclusão da configuração, os usuários podem acessar o agente do Microsoft Copilot visitando https://copilot.microsoft.com/ e selecionando o agente no menu da barra lateral esquerda.