Ir para conteúdo principal Pular para conteúdo complementar

Criando uma conexão Hugging Face

Para se comunicar com o Hugging Face, crie uma conexão com a origem de análise da Hugging Face. Crie a conexão na página Criar do centro de atividades de Análises, Editor da carga de dados ou Script.

Os dados recebidos dessas conexões podem ser usados no script de carregamento e em expressões de gráfico para aprimorar seus aplicativos de análise do Qlik Sense.

Definições e configurações definíveis

Configure sua conexão de análise da Hugging Face com uma das seguintes configurações. Cada conexão pode consistir em uma única configuração.

Cada configuração disponível do conector da Hugging Face corresponde a uma tarefa comum que você deseja executar com um modelo disponível por meio da plataforma da Hugging Face. Existem milhares de modelos disponíveis para ajudar em cada tarefa.

Nem todos os modelos da Hugging Face estão disponíveis para uso com o conector da Qlik do Hugging Face. A disponibilidade de um modelo para uso no Qlik Sense depende, em parte, de fatores externos. Limitações e requisitos adicionais específicos do modelo podem ser aplicados, afetando a forma como você configura o conector e troca dados com ele. Para detalhes completos sobre qualquer modelo específico, consulte a documentação oficial da Hugging Face.

Tasks

Models

Feature Extraction

Use essa configuração para trabalhar com modelos que executam tarefas de extração de recursos. Geralmente, a extração de recursos é um processo técnico de aprendizado de máquina com muitas aplicações práticas. Com essa tarefa, os dados de entrada são convertidos em recursos numéricos.

Consulte os seguintes recursos do Hugging Face para obter mais informações:

Definições configuráveis para a configuração Feature Extraction
Campo Descrição
Configuration Selecione a configuração do conector. Para modelos usados em tarefas de extração de recursos, selecione Feature Extraction.
Hugging Face Inference API endpoint Insira a URL do endpoint através do qual o Qlik Sense pode acessar o modelo. Isso geralmente é feito através da Hugging Face do Hugging Face.
Hugging Face API Token Insira o token da API do Hugging Face que você gerou após criar sua conta. Isso autentica as credenciais da sua conta para que você possa usar os serviços externos. Consulte Gerar um token de API.
Use Cache

É definido como True por padrão. Selecione se deseja utilizar o cache para reutilizar as respostas do modelo se a mesma solicitação for feita duas vezes. Dependendo do seu modelo, você pode querer desativar essa configuração.

Wait For Model

É definido como False por padrão. Se estiver ativado, você poderá reduzir o número de solicitações feitas à API aguardando que o modelo esteja pronto antes de fazer uma solicitação.

Association Field

Especifique um campo de associação, um campo da tabela de dados de entrada contendo um identificador exclusivo. Este é um parâmetro opcional.

É necessário incluir esse campo nos dados de origem ao fazer uma solicitação de terminal para que a tabela de resultados retornada seja associada à tabela de campo de origem usando uma chave. O campo designado será retornado como um campo na resposta e permitirá que a resposta seja associada aos dados de origem no modelo de dados. Pode ser qualquer campo com um ID exclusivo, seja dos dados de origem ou como parte do processo de carregamento da tabela.

Name O nome da conexão. O nome padrão será usado se você não inserir um nome.

Question Answering

Use esta configuração para trabalhar com modelos que executam tarefas de resposta a perguntas. Com a resposta a perguntas, um modelo pode ser usado para extrair a resposta a uma pergunta, dado um segmento de contexto fornecido separadamente. No Qlik Sense, tanto a pergunta quanto o contexto são fornecidos nos dados do aplicativo ou do script.

Consulte os seguintes recursos do Hugging Face para obter mais informações:

Definições configuráveis para a configuração Question Answering
Campo Descrição
Configuration Selecione a configuração do conector. Para modelos usados em tarefas de resposta a perguntas, selecione Question Answering.
Hugging Face Inference API endpoint Insira a URL do endpoint através do qual o Qlik Sense pode acessar o modelo. Isso geralmente é feito através da Hugging Face do Hugging Face.
Hugging Face API Token Insira o token da API do Hugging Face que você gerou após criar sua conta. Isso autentica as credenciais da sua conta para que você possa usar os serviços externos. Consulte Gerar um token de API.
Use Cache

É definido como True por padrão. Selecione se deseja utilizar o cache para reutilizar as respostas do modelo se a mesma solicitação for feita duas vezes. Dependendo do seu modelo, você pode querer desativar essa configuração.

Wait For Model

É definido como False por padrão. Se estiver ativado, você poderá reduzir o número de solicitações feitas à API aguardando que o modelo esteja pronto antes de fazer uma solicitação.

Association Field

Especifique um campo de associação, um campo da tabela de dados de entrada contendo um identificador exclusivo. Este é um parâmetro opcional.

É necessário incluir esse campo nos dados de origem ao fazer uma solicitação de terminal para que a tabela de resultados retornada seja associada à tabela de campo de origem usando uma chave. O campo designado será retornado como um campo na resposta e permitirá que a resposta seja associada aos dados de origem no modelo de dados. Pode ser qualquer campo com um ID exclusivo, seja dos dados de origem ou como parte do processo de carregamento da tabela.

Name O nome da conexão. O nome padrão será usado se você não inserir um nome.

Summarization

Use esta configuração para trabalhar com modelos que executam tarefas de resumo. Um modelo realiza a sumarização pegando um texto de entrada específico e gerando um resumo mais breve desse texto, retendo os detalhes essenciais.

Consulte os seguintes recursos do Hugging Face para obter mais informações:

Definições configuráveis para a configuração Summarization
Campo Descrição
Configuration Selecione a configuração do conector. Para modelos usados em tarefas de resumo, selecione Summarization.
Hugging Face Inference API endpoint Insira a URL do endpoint através do qual o Qlik Sense pode acessar o modelo. Isso geralmente é feito através da Hugging Face do Hugging Face.
Hugging Face API Token Insira o token da API do Hugging Face que você gerou após criar sua conta. Isso autentica as credenciais da sua conta para que você possa usar os serviços externos. Consulte Gerar um token de API.
Minimum Token Length Defina um valor inteiro como o número mínimo de tokens a serem usados na saída do modelo. Parâmetro opcional. Se nenhum valor for especificado, a saída não terá comprimento mínimo.
Maximum Token Length Defina um valor inteiro como o número máximo de tokens a serem usados na saída do modelo. Parâmetro opcional. Se nenhum valor for especificado, a saída não terá comprimento máximo.
Top K Defina um valor inteiro como o número de tokens mais prováveis a serem usados na saída. Parâmetro opcional. Se nenhum valor for especificado, a saída não terá um número superior do token mais provável para usar na saída.
Top P

Insira um número numérico (especificamente, um número de ponto flutuante) para controlar a aleatoriedade da saída, em termos de probabilidade do token. Para detalhes completos, consulte a documentação do Hugging Face.

Parâmetro opcional. Se nenhum valor for especificado, a saída não será controlada quanto à aleatoriedade por suas escolhas.

Temperature Especifique um valor de ponto flutuante (entre 0,00 e 100,0) para controlar a aleatoriedade da saída. Um valor mais alto geralmente resulta em mais aleatoriedade do token. O valor padrão é 1,0. Parâmetro opcional.
Repetition Penalty Especifique um valor de ponto flutuante (entre 0,00 e 100,0) para aplicar uma penalidade em tokens repetidos. O valor padrão é 1,0. Parâmetro opcional.
Maximum Query Time Especifique um valor de ponto flutuante (entre 0 e 120,0) para o tempo máximo em segundos que uma consulta pode levar. Este é um limite flexível. Parâmetro opcional. Se nenhum valor for especificado, nenhum tempo máximo de consulta será definido.
Use Cache

É definido como True por padrão. Selecione se deseja utilizar o cache para reutilizar as respostas do modelo se a mesma solicitação for feita duas vezes. Dependendo do seu modelo, você pode querer desativar essa configuração.

Wait For Model

É definido como False por padrão. Se estiver ativado, você poderá reduzir o número de solicitações feitas à API aguardando que o modelo esteja pronto antes de fazer uma solicitação.

Association Field

Especifique um campo de associação, um campo da tabela de dados de entrada contendo um identificador exclusivo. Este é um parâmetro opcional.

É necessário incluir esse campo nos dados de origem ao fazer uma solicitação de terminal para que a tabela de resultados retornada seja associada à tabela de campo de origem usando uma chave. O campo designado será retornado como um campo na resposta e permitirá que a resposta seja associada aos dados de origem no modelo de dados. Pode ser qualquer campo com um ID exclusivo, seja dos dados de origem ou como parte do processo de carregamento da tabela.

Name O nome da conexão. O nome padrão será usado se você não inserir um nome.

Sentence Similarity

Use esta configuração para trabalhar com modelos que realizam análises de similaridade de frases. Neste tipo de tarefa, um modelo compara uma ou mais frases distintas com uma frase fonte, produzindo incorporações que armazenam informações sobre a semelhança entre elas. Essas incorporações são valores numéricos. O uso de incorporações é um processo avançado de aprendizado de máquina.

No Qlik Sense, a frase de origem é fornecida na configuração do conector e as frases de entrada (que o modelo compara com a frase de origem) são fornecidas nos dados do aplicativo ou script.

Consulte os seguintes recursos do Hugging Face para obter mais informações:

Definições configuráveis para a configuração Sentence Similarity
Campo Descrição
Configuration Selecione a configuração do conector. Para modelos usados em tarefas relacionadas à análise de similaridade de frases, selecione Sentence Similarity.
Hugging Face Inference API endpoint Insira a URL do endpoint através do qual o Qlik Sense pode acessar o modelo. Isso geralmente é feito através da Hugging Face do Hugging Face.
Hugging Face API Token Insira o token da API do Hugging Face que você gerou após criar sua conta. Isso autentica as credenciais da sua conta para que você possa usar os serviços externos. Consulte Gerar um token de API.
Source Sentence

A string de texto que o modelo compara com cada um dos itens de dados de entrada, avaliando a semelhança entre as duas strings.

Use Cache

É definido como True por padrão. Selecione se deseja utilizar o cache para reutilizar as respostas do modelo se a mesma solicitação for feita duas vezes. Dependendo do seu modelo, você pode querer desativar essa configuração.

Wait For Model

É definido como False por padrão. Se estiver ativado, você poderá reduzir o número de solicitações feitas à API aguardando que o modelo esteja pronto antes de fazer uma solicitação.

Association Field

Especifique um campo de associação, um campo da tabela de dados de entrada contendo um identificador exclusivo. Este é um parâmetro opcional.

É necessário incluir esse campo nos dados de origem ao fazer uma solicitação de terminal para que a tabela de resultados retornada seja associada à tabela de campo de origem usando uma chave. O campo designado será retornado como um campo na resposta e permitirá que a resposta seja associada aos dados de origem no modelo de dados. Pode ser qualquer campo com um ID exclusivo, seja dos dados de origem ou como parte do processo de carregamento da tabela.

Name O nome da conexão. O nome padrão será usado se você não inserir um nome.

Text Classification

Use esta configuração para trabalhar com modelos que executam tarefas de classificação de texto. A classificação de texto é um tipo de tarefa versátil, na qual um modelo pode realizar análises de sentimentos, verificações de correção gramatical e outras ações de processamento de linguagem.

Consulte os seguintes recursos do Hugging Face para obter mais informações:

Definições configuráveis para a configuração Text Classification
Campo Descrição
Configuration Selecione a configuração do conector. Para modelos usados em tarefas de classificação de texto, selecione Text Classification.
Hugging Face Inference API endpoint Insira a URL do endpoint através do qual o Qlik Sense pode acessar o modelo. Isso geralmente é feito através da Hugging Face do Hugging Face.
Hugging Face API Token Insira o token da API do Hugging Face que você gerou após criar sua conta. Isso autentica as credenciais da sua conta para que você possa usar os serviços externos. Consulte Gerar um token de API.
Use Cache

É definido como True por padrão. Selecione se deseja utilizar o cache para reutilizar as respostas do modelo se a mesma solicitação for feita duas vezes. Dependendo do seu modelo, você pode querer desativar essa configuração.

Wait For Model

É definido como False por padrão. Se estiver ativado, você poderá reduzir o número de solicitações feitas à API aguardando que o modelo esteja pronto antes de fazer uma solicitação.

Association Field

Especifique um campo de associação, um campo da tabela de dados de entrada contendo um identificador exclusivo. Este é um parâmetro opcional.

É necessário incluir esse campo nos dados de origem ao fazer uma solicitação de terminal para que a tabela de resultados retornada seja associada à tabela de campo de origem usando uma chave. O campo designado será retornado como um campo na resposta e permitirá que a resposta seja associada aos dados de origem no modelo de dados. Pode ser qualquer campo com um ID exclusivo, seja dos dados de origem ou como parte do processo de carregamento da tabela.

Name O nome da conexão. O nome padrão será usado se você não inserir um nome.

Text Generation

Use esta configuração para trabalhar com modelos que executam tarefas de geração de texto. Os modelos que usam esse tipo de tarefa normalmente podem concluir segmentos de texto incompletos ou realizar paráfrases de texto.

Consulte os seguintes recursos do Hugging Face para obter mais informações:

Definições configuráveis para a configuração Text Generation
Campo Descrição
Configuration Selecione a configuração do conector. Para modelos usados em tarefas de geração de texto, selecione Text Generation.
Hugging Face Inference API endpoint Insira a URL do endpoint através do qual o Qlik Sense pode acessar o modelo. Isso geralmente é feito através da Hugging Face do Hugging Face.
Hugging Face API Token Insira o token da API do Hugging Face que você gerou após criar sua conta. Isso autentica as credenciais da sua conta para que você possa usar os serviços externos. Consulte Gerar um token de API.
Maximum Token Length Defina um valor inteiro como o número máximo de tokens a serem usados na saída do modelo. Parâmetro opcional. Se nenhum valor for especificado, a saída não terá comprimento máximo.
Top K Defina um valor inteiro como o número de tokens mais prováveis a serem usados na saída. Parâmetro opcional. Se nenhum valor for especificado, a saída não terá um número superior do token mais provável para usar na saída.
Top P

Insira um número numérico (especificamente, um número de ponto flutuante) para controlar a aleatoriedade da saída, em termos de probabilidade do token. Para detalhes completos, consulte a documentação do Hugging Face.

Parâmetro opcional. Se nenhum valor for especificado, a saída não será controlada quanto à aleatoriedade por suas escolhas.

Temperature Especifique um valor de ponto flutuante (entre 0,00 e 100,0) para controlar a aleatoriedade da saída. Um valor mais alto geralmente resulta em mais aleatoriedade do token. O valor padrão é 1,0. Parâmetro opcional.
Repetition Penalty Especifique um valor de ponto flutuante (entre 0,00 e 100,0) para aplicar uma penalidade em tokens repetidos. O valor padrão é 1,0. Parâmetro opcional.
Maximum Query Time Especifique um valor de ponto flutuante (entre 0 e 120,0) para o tempo máximo em segundos que uma consulta pode levar. Este é um limite flexível. Parâmetro opcional. Se nenhum valor for especificado, nenhum tempo máximo de consulta será definido.
Use Cache

É definido como True por padrão. Selecione se deseja utilizar o cache para reutilizar as respostas do modelo se a mesma solicitação for feita duas vezes. Dependendo do seu modelo, você pode querer desativar essa configuração.

Wait For Model

É definido como False por padrão. Se estiver ativado, você poderá reduzir o número de solicitações feitas à API aguardando que o modelo esteja pronto antes de fazer uma solicitação.

Association Field

Especifique um campo de associação, um campo da tabela de dados de entrada contendo um identificador exclusivo. Este é um parâmetro opcional.

É necessário incluir esse campo nos dados de origem ao fazer uma solicitação de terminal para que a tabela de resultados retornada seja associada à tabela de campo de origem usando uma chave. O campo designado será retornado como um campo na resposta e permitirá que a resposta seja associada aos dados de origem no modelo de dados. Pode ser qualquer campo com um ID exclusivo, seja dos dados de origem ou como parte do processo de carregamento da tabela.

Name O nome da conexão. O nome padrão será usado se você não inserir um nome.

Token Classification

Use esta configuração para trabalhar com modelos que executam tarefas de classificação de token. Com a classificação de token, um modelo pode identificar strings de texto (tokens) como entidades classificáveis (por exemplo, lugares, pessoas e classes gramaticais).

Consulte os seguintes recursos do Hugging Face para obter mais informações:

Definições configuráveis para a configuração Token Classification
Campo Descrição
Configuration Selecione a configuração do conector. Para modelos usados em tarefas de classificação de token, selecione Token Classification.
Hugging Face Inference API endpoint Insira a URL do endpoint através do qual o Qlik Sense pode acessar o modelo. Isso geralmente é feito através da Hugging Face do Hugging Face.
Hugging Face API Token Insira o token da API do Hugging Face que você gerou após criar sua conta. Isso autentica as credenciais da sua conta para que você possa usar os serviços externos. Consulte Gerar um token de API.
Aggregation Strategy

A classificação das entidades na sua entrada pode passar por processamento de agregação. Esse parâmetro especifica o tipo de estratégia de agregação aplicada ao fazer classificações.

Escolha entre as seguintes opções:

  • NoneNenhuma agregação adicional.

  • SimpleUsa o esquema padrão.

  • Uma versão modificada da opção First, em que a ambiguidade é tratada usando a tag da primeira palavra.Simple Tags diferentes não podem ser aplicadas a palavras.

  • Uma versão modificada da opção Average, na qual um sistema de média é usado e tags diferentes não podem ser aplicadas às palavras.Simple

  • Uma versão modificada da opção Max, na qual um sistema de pontuação é usado e tags diferentes não podem ser aplicadas às palavras.Simple

Simple é a opção padrão.

Use Cache

É definido como True por padrão. Selecione se deseja utilizar o cache para reutilizar as respostas do modelo se a mesma solicitação for feita duas vezes. Dependendo do seu modelo, você pode querer desativar essa configuração.

Wait For Model

É definido como False por padrão. Se estiver ativado, você poderá reduzir o número de solicitações feitas à API aguardando que o modelo esteja pronto antes de fazer uma solicitação.

Association Field

Especifique um campo de associação, um campo da tabela de dados de entrada contendo um identificador exclusivo. Este é um parâmetro opcional.

É necessário incluir esse campo nos dados de origem ao fazer uma solicitação de terminal para que a tabela de resultados retornada seja associada à tabela de campo de origem usando uma chave. O campo designado será retornado como um campo na resposta e permitirá que a resposta seja associada aos dados de origem no modelo de dados. Pode ser qualquer campo com um ID exclusivo, seja dos dados de origem ou como parte do processo de carregamento da tabela.

Name O nome da conexão. O nome padrão será usado se você não inserir um nome.

Translation

Use esta configuração para trabalhar com modelos que executam tarefas de tradução. Modelos podem traduzir o texto de entrada de um determinado idioma para outro idioma.

Consulte os seguintes recursos do Hugging Face para obter mais informações:

Definições configuráveis para a configuração Translation
Campo Descrição
Configuration Selecione a configuração do conector. Para modelos usados em tarefas de tradução, selecione Translation.
Hugging Face Inference API endpoint Insira a URL do endpoint através do qual o Qlik Sense pode acessar o modelo. Isso geralmente é feito através da Hugging Face do Hugging Face.
Hugging Face API Token Insira o token da API do Hugging Face que você gerou após criar sua conta. Isso autentica as credenciais da sua conta para que você possa usar os serviços externos. Consulte Gerar um token de API.
Source Language

Insira o idioma do texto de entrada que você deseja traduzir. Parâmetro opcional.

Nota informativaOs recursos de tradução de idiomas fornecidos por cada modelo podem variar. Por exemplo, um modelo pode ser projetado para traduzir apenas texto entre dois idiomas específicos. Neste caso, faz sentido deixar este parâmetro em branco.
Target Language

Insira o idioma para o qual deseja que o texto de entrada seja traduzido. Parâmetro opcional.

Nota informativaOs recursos de tradução de idiomas fornecidos por cada modelo podem variar. Por exemplo, um modelo pode ser projetado para traduzir apenas texto entre dois idiomas específicos. Neste caso, faz sentido deixar este parâmetro em branco.
Use Cache

É definido como True por padrão. Selecione se deseja utilizar o cache para reutilizar as respostas do modelo se a mesma solicitação for feita duas vezes. Dependendo do seu modelo, você pode querer desativar essa configuração.

Wait For Model

É definido como False por padrão. Se estiver ativado, você poderá reduzir o número de solicitações feitas à API aguardando que o modelo esteja pronto antes de fazer uma solicitação.

Association Field

Especifique um campo de associação, um campo da tabela de dados de entrada contendo um identificador exclusivo. Este é um parâmetro opcional.

É necessário incluir esse campo nos dados de origem ao fazer uma solicitação de terminal para que a tabela de resultados retornada seja associada à tabela de campo de origem usando uma chave. O campo designado será retornado como um campo na resposta e permitirá que a resposta seja associada aos dados de origem no modelo de dados. Pode ser qualquer campo com um ID exclusivo, seja dos dados de origem ou como parte do processo de carregamento da tabela.

Name O nome da conexão. O nome padrão será usado se você não inserir um nome.

Criando uma nova conexão

Você pode criar uma conexão com o conector analítico a partir do centro de atividades de Análises, do Editor da carga de dados em um aplicativo existente ou do Script de um script existente. Siga as etapas abaixo para criar uma conexão.

  1. Acesse o conector por meio do Editor da carga de dados ou do Script.

  2. Clique em Criar nova conexão.

  3. Em Espaço, selecione o espaço onde a conexão será localizada.

  4. Selecione Hugging Face na lista de conectores de dados.

  5. Preencha os campos da caixa de diálogo de conexão.

  6. Clique em Criar.

A conexão de dados é salva no espaço onde o aplicativo é criado, para que possa ser reutilizado em outros aplicativos e scripts do Qlik Sense. Ela também é listado em Conexões de dados, no Editor da carga de dados ou no Script.

Depois de criar a conexão, você pode usá-la para carregar dados com as solicitações e as respostas da plataforma a elas. Além disso, você pode usá-la em expressões de gráfico. Para obter mais informações, consulte Selecione e carregue os dados de uma conexão  Hugging Face e Usando conexões Hugging Face em expressões de visualização.

Saiba mais

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!