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.
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:
-
Visão geral das tarefas de extração de recursos: Feature Extraction
-
Explicação detalhada dos parâmetros: Inference API - Detailed parameters
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:
-
Visão geral das tarefas de resposta a perguntas: Question Answering
-
Explicação detalhada dos parâmetros: Inference API - Detailed parameters
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:
-
Visão geral das tarefas de resumo: Summarization
-
Explicação detalhada dos parâmetros: Inference API - Detailed parameters
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:
-
Visão geral das tarefas de similaridade de frases: Sentence Similarity
-
Explicação detalhada dos parâmetros: Inference API - Detailed parameters
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:
-
Visão geral das tarefas de classificação de texto: Text Classification
-
Explicação detalhada dos parâmetros: Inference API - Detailed parameters
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:
-
Visão geral das tarefas de geração de texto: Text Generation
-
Explicação detalhada dos parâmetros: Inference API - Detailed parameters
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:
-
Visão geral das tarefas de classificação de token: Token Classification
-
Explicação detalhada dos parâmetros: Inference API - Detailed parameters
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:
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:
-
Visão geral das tarefas de tradução: Translation
-
Explicação detalhada dos parâmetros: Inference API - Detailed parameters
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.
Faça o seguinte:
-
Acesse o conector por meio do Editor da carga de dados ou do Script.
-
Clique em Criar nova conexão.
-
Em Espaço, selecione o espaço onde a conexão será localizada.
-
Selecione Hugging Face na lista de conectores de dados.
-
Preencha os campos da caixa de diálogo de conexão.
-
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.