Ir para o conteúdo

Atividade de Busca de Registros Chroma (Beta)

Introdução

Uma atividade de Busca de Registros Chroma (Beta), utilizando sua conexão Chroma (Beta), recupera registros de uma coleção Chroma e é destinada a ser usada como uma fonte em uma operação.

Nota

Para acesso beta e para fornecer feedback, entre em contato com a Equipe de Produto Jitterbit.

Criar uma atividade de Busca de Registros Chroma (Beta)

Uma instância de uma atividade de Busca de Registros Chroma (Beta) é criada a partir de uma conexão Chroma (Beta) usando seu tipo de atividade Busca de Registros.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, veja Criando uma instância de atividade em Reutilização de componentes.

Uma atividade de Busca de Registros Chroma (Beta) existente pode ser editada a partir destes locais:

Configurar uma atividade de Busca de Registros Chroma (Beta)

Siga estas etapas para configurar uma atividade de Busca de Registros Chroma (Beta):

Passo 1: Insira um nome e selecione uma coleção

Neste passo, forneça um nome para a atividade e selecione uma coleção. Cada elemento da interface do usuário deste passo é descrito abaixo.

  • Menu de Endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, veja Alterar o endpoint atribuído em Telasc de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint atualmente selecionado.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade de Buscar Registros do Chroma (Beta) e não deve conter barras / ou dois pontos :.

  • Selecionar uma Coleção: Esta seção exibe as coleções disponíveis no endpoint do Chroma (Beta).

    • Coleção Selecionada: Após uma coleção ser selecionada, ela é listada aqui.

    • Buscar: Insira o valor de qualquer coluna na caixa de busca para filtrar a lista de coleções. A busca não diferencia maiúsculas de minúsculas. Se as coleções já estiverem exibidas na tabela, os resultados da tabela são filtrados em tempo real a cada tecla pressionada. Para recarregar coleções do endpoint ao buscar, insira critérios de busca e, em seguida, atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para recarregar coleções do endpoint do Chroma (Beta). Isso pode ser útil se coleções foram adicionadas ao Chroma. Esta ação atualiza todos os metadados usados para construir a tabela de coleções exibida na configuração.

    • Selecionando uma Coleção: Dentro da tabela, clique em qualquer lugar em uma linha para selecionar uma coleção. Apenas uma coleção pode ser selecionada. As informações disponíveis para cada coleção são obtidas do endpoint do Chroma (Beta):

      • Nome: O nome da coleção.

      • Descrição: A descrição da coleção.

    Dica

    Se a tabela não for preenchida com coleções disponíveis, a conexão Chroma (Beta) pode não ter sido bem-sucedida. Certifique-se de que está conectado reabrindo a conexão e testando novamente as credenciais.

  • Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Especificar configurações

Nesta etapa, especifique os critérios de busca de registros. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Menu de endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, veja Alterar o endpoint atribuído em Telasc de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint atualmente selecionado.

  • Buscar por: Selecione o método para buscar registros, um dos Híbrido, ID (padrão), Meta, Semântico ou Texto.

    • Híbrido: Selecione para usar uma combinação de opções de busca ID, Meta, Semântico e Texto. As opções reveladas por ID, Metadados, Buscar por filtro de texto e Semântico são descritas em suas respectivas áreas abaixo.

    • ID: Selecione para buscar IDs de registros específicos.

      • IDs: Defina os IDs a serem buscados na tabela.

        Clique no ícone de adicionar para adicionar uma linha à tabela e insira um valor de ID.

        Para salvar a linha, clique no ícone de enviar na coluna mais à direita.

        Para editar ou excluir uma única linha, passe o mouse sobre a coluna mais à direita e use o ícone de editar ou o ícone de excluir .

        Para excluir todas as linhas, clique em Limpar Tudo.

    • Meta: Selecione para buscar com um filtro de metadados.

      • Nome da chave de metadados: Insira o nome da chave de metadados para o filtro.

      • Operador de metadados: Selecione um dos Contém (padrão), Igual a, Não_Contém, Não_Igual a ou Regex para especificar o operador a ser usado entre a chave de metadados e o valor para filtragem. Por exemplo, filtre por uma chave (Nome da chave de metadados) que Contém um valor específico (Valor de metadados).

      • Valor de metadados: Insira o valor de metadados para o filtro.

      • Tipo de valor Meta: Selecione um dos Booleano, Int ou String (padrão) para especificar o tipo de valor para Valor de metadados.

    • Texto: Selecione para buscar com um filtro de texto.

      • Operador de texto: Selecione um dos Contém (padrão), Não_Contém ou Regex para especificar o operador a ser usado para filtragem de texto.

      • Valor de texto: Insira o valor de texto para o filtro.

    • Semântico: Selecione para buscar com embeddings vetoriais. Embeddings vetoriais são gerados pelo Chroma para indicar quão próximos valores relacionados estão e são tipicamente usados para levar em conta palavras mal soletradas ou conceitos semelhantes a palavras na busca.

      • Embeddings: Insira os valores de embedding para pesquisa como um array. Por exemplo, [0.1, 0.2, 0.3].

      • Top Nearest: Insira o número de resultados principais a serem incluídos na pesquisa. Os 10 resultados semanticamente mais semelhantes são incluídos por padrão.

      Nota

      Para mais informações sobre a configuração do índice vetorial para embeddings vetoriais, consulte a documentação de Chroma sobre VectorIndexConfig.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    • Limite: Insira o número de resultados para limitar a resposta da pesquisa. O limite é 10 por padrão.
    • Offset: Insira o número de resultados para deslocar a resposta da pesquisa. O deslocamento é 0 por padrão.
    • Incluir embeddings: Selecione para incluir embeddings na resposta da pesquisa. Selecionado por padrão.
    • Incluir distâncias: Selecione para incluir valores de distância na resposta da pesquisa. Selecionado por padrão.
    • Incluir URIs: Selecione para incluir URIs na resposta da pesquisa. Selecionado por padrão.
    • Incluir documentos: Selecione para incluir documentos na resposta da pesquisa. Selecionado por padrão.
    • Incluir metadados: Selecione para incluir metadados na resposta da pesquisa. Selecionado por padrão.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Finalizado na última etapa.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 3: Revisar os esquemas de dados

Quaisquer esquemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Esquema de dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformações.

    O conector Chroma (Beta) utiliza a Chroma REST API. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

  • Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para regenerar esquemas a partir do endpoint Chroma (Beta). Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Chroma (Beta) Buscar Registros, complete a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão nos mesmos ou em diferentes fluxos de trabalho.

As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, consulte o menu de ações da atividade em Conceitos básicos do conector.

As atividades Chroma (Beta) Buscar Registros podem ser usadas como fonte com esses padrões de operação:

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.