View a markdown version of this page

Integração com o Visier Agent - Amazon Quick
Antes de começarConfigurando o VisierConfigurando o conector no Amazon QuickAções disponíveisGerenciamento e solução de problemas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Integração com o Visier Agent

Com o conector de ação do Visier Agent, você pode acessar a plataforma de análise de pessoas da Visier diretamente no Amazon Quick por meio de linguagem natural. Você pode consultar dados reais da força de trabalho, analisar tendências do número de funcionários, avaliar a integridade da retenção, gerar briefings da força de trabalho e muito mais sem sair do Amazon Quick.

O Visier Agent usa a autenticação personalizada do aplicativo OAuth. Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.

Antes de começar

Verifique se você tem o seguinte antes de configurar a integração.

  • Uma conta ativa do Visier com acesso à API e Visier Agent ativado. Para obter informações sobre como habilitar o Visier Agent e configurar a autenticação, consulte a documentação do Visier MCP Server.

  • Escopos de acesso a dados apropriados configurados em sua conta do Visier para os dados da força de trabalho que você deseja consultar.

  • Credenciais do OAuth (ID do cliente e segredo do cliente) do administrador do Visier.

  • Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.

Configurando o Visier

Antes de configurar o Amazon Quick, conclua as etapas a seguir no console de administração do Visier.

  1. Entre no console de administração do Visier e confirme se sua conta está ativa.

  2. Ative o recurso Visier Agent em Configurações, API e integrações.

  3. Registre um cliente OAuth para o Amazon Quick e adicione o URL de retorno de chamada do Amazon Quick à lista de URIs de redirecionamento: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

    {region}Substitua pela sua AWS região (por exemplo,us-east-1).

  4. Registre o ID do cliente e o segredo do cliente. Você precisa deles ao configurar o Amazon Quick.

  5. Confirme se os dados e as análises da força de trabalho que você deseja consultar estão acessíveis em sua conta.

Configurando o conector no Amazon Quick

  1. No console do Amazon Quick, escolha Conectores.

  2. Escolha a guia Criar para sua equipe.

  3. Encontre e escolha Visier Agent.

  4. Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.

  5. Em Tipo de conexão, escolha Rede pública.

  6. Para Configuração do OAuth, escolha Aplicativo OAuth personalizado e configure os seguintes campos:

    • URL base — A URL base do Visier Agent MCP, pré-preenchida pelo Amazon Quick.

    • ID do cliente — A ID do cliente OAuth do console de administração do Visier.

    • Cliente OAuth público (opcional) — Selecione essa opção se seu cliente Visier OAuth estiver configurado como um cliente público (sem segredo do cliente).

    • Segredo do cliente — O segredo do cliente OAuth do console de administração do Visier.

    • URL do token — O endpoint do token OAuth, pré-preenchido pelo Amazon Quick.

    • URL de autorização — O endpoint de autorização do OAuth, pré-preenchido pelo Amazon Quick.

    • URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.

  7. Escolha Próximo.

  8. No pop-up de login do Visier que aparece, insira suas credenciais do Visier e escolha Entrar para autorizar o Amazon Quick a acessar o Visier em seu nome.

  9. Na página de revisão, o Amazon Quick descobre as ferramentas que o Visier Agent expõe e as exibe em uma tabela. Examine a lista de ações disponíveis e escolha Avançar.

  10. Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.

  11. Selecione Publish.

Ações disponíveis

Depois de configurar o conector, você pode usar as seguintes ações. O Visier Agent expõe seus recursos de análise de pessoas como ferramentas que podem ser chamadas.

Ações disponíveis do Visier Agent
Ação Description
ask_vee_question Faz uma pergunta sobre a Vee AI da Visier sobre a força de trabalho em linguagem natural, como número de funcionários, rotatividade ou requisições.
aggregate_metric_values Calcula valores agregados para uma métrica, opcionalmente agrupados por uma dimensão e filtrados por membros específicos.
sample_vee_questions Retorna uma lista de exemplos de perguntas que você pode fazer à Vee para começar.
search_analytic_objects Encontra objetos analíticos (por exemplo, Funcionário ou Candidato) que correspondem a uma sequência de caracteres de pesquisa.
search_analytic_object_properties Retorna todas as propriedades disponíveis para um determinado objeto analítico.
list_analytic_object_property_values Lista valores de propriedades para membros específicos do objeto analítico, como estabilidade ou remuneração de funcionários.
search_metrics Encontra métricas que correspondem a uma string de pesquisa.
search_dimensions_for_metric Encontra dimensões disponíveis para uma determinada métrica, utilizáveis para agrupamento ou filtragem.
search_dimensions_for_analytic_object Encontra as dimensões disponíveis para um determinado objeto analítico.
search_filter_dimension_members Retorna membros filtráveis para uma determinada dimensão.
get_object_reference_graph Retorna o gráfico de referência mostrando como um determinado objeto analítico se conecta a outros.

Gerenciamento e solução de problemas

Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.

Problemas de autenticação

  • Falha na conexão do servidor MCP — Verifique se você ativou o recurso Visier Agent no console de administração do Visier em Configurações, API e integrações. Confirme se você inseriu a URL base, a URL do token e a URL de autorização corretamente no Amazon Quick.

  • Credenciais de cliente inválidas — Verifique se a ID do cliente e o segredo do cliente correspondem aos valores do console de administração do Visier. Confirme se o URI de redirecionamento em seu cliente Visier OAuth corresponde ao URL de retorno de chamada do Amazon Quick.

  • Erros de acesso aos dados — Verifique se os escopos de acesso aos dados configurados na sua conta do Visier incluem os dados da força de trabalho que você está tentando consultar. Entre em contato com o administrador do Visier para revisar as permissões da sua conta.

  • Nenhuma ferramenta descoberta — Se o Amazon Quick não descobrir nenhuma ferramenta depois de criar o conector, confirme se o Visier Agent está ativo e se suas credenciais de autenticação não expiraram.