# Encontrar embeddings

O bloco permite, com base em uma consulta-embedding[^1], encontrar na base de conhecimento, que consiste em uma tabela de objetos e seus embeddings, as linhas mais semelhantes e retornar os índices dessas linhas em forma de lista, ordenada em ordem decrescente de similaridade.

Os embeddings tanto para a consulta quanto para a tabela de embeddings, na qual a busca é realizada, podem ser obtidos com o bloco "Obter embeddings". Na primeira utilização do bloco, ocorre a construção do banco de dados de vetores, e isso pode levar um tempo considerável. Em chamadas subsequentes do bloco com o mesmo "ID do banco", será utilizada a base de dados de vetores já criada, e a velocidade de operação do bloco aumenta significativamente.

<table data-header-hidden><thead><tr><th width="283.36669921875" valign="top"></th><th width="317.98333740234375" valign="top"></th></tr></thead><tbody><tr><td valign="top">Embedding da consulta</td><td valign="top">[Texto] Embedding para o qual é necessário encontrar linhas semelhantes na tabela. O valor para este campo pode ser obtido com o bloco "Obter embedding".</td></tr><tr><td valign="top">Base de conhecimento</td><td valign="top">[Tabela de Dados] Tabela na qual a busca será realizada. Uma das colunas da tabela deve conter embeddings, outras colunas da tabela podem conter quaisquer dados do usuário.</td></tr><tr><td valign="top">ID do banco</td><td valign="top"><p>[Texto] É possível especificar outro ID do banco para que o bloco, na primeira execução, comece a construir o banco de dados de vetores novamente.</p><p>Na primeira utilização do bloco, ocorre a construção do banco de dados de vetores e isso pode levar um tempo considerável. Em chamadas subsequentes do bloco com o mesmo "ID do banco", será utilizada a base de dados de vetores já criada, e a velocidade de operação do bloco aumenta significativamente.</p></td></tr><tr><td valign="top">Coluna de embeddings</td><td valign="top"><p>[Número/Text] Índice ou nome da coluna da tabela especificada na propriedade "Base de conhecimento", onde os embeddings estão localizados.</p><p>Por padrão <code>1</code>.</p></td></tr><tr><td valign="top">Número de resultados</td><td valign="top"><p>[Número] Número máximo de linhas-resultados retornadas pelo bloco da base de conhecimento.</p><p>Por padrão <code>5</code>.</p></td></tr><tr><td valign="top">Índices das linhas</td><td valign="top">[Lista] Lista de índices das linhas da Base de conhecimento, contendo os embeddings mais semelhantes à consulta, ordenada em ordem decrescente de similaridade.</td></tr><tr><td valign="top">Similaridade</td><td valign="top">[Lista] Medidas numéricas de similaridade para cada um dos resultados.</td></tr><tr><td valign="top">Nível de processamento</td><td valign="top"><p>Seleção do nível de tratamento de erros. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Ignore" - erros são ignorados;</li><li>"Handle" - erros são tratados.</li></ul><p>Se o valor "Default" for selecionado, será utilizado o valor do bloco "Início" deste diagrama.</p></td></tr><tr><td valign="top">Nível de mensagens</td><td valign="top"><p>Seleção do nível de mensagens que os blocos exibirão durante a operação. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Release" - saída desativada;</li><li>"Debug" - saída de informações principais;</li><li>"Detailed" - saída de informações detalhadas.</li></ul><p>Se o valor "Default" for selecionado, será utilizado o valor do bloco "Início" deste diagrama.</p></td></tr><tr><td valign="top">Texto do erro</td><td valign="top">[Texto] Retorna informações detalhadas sobre o erro em caso de execução incorreta do bloco.</td></tr></tbody></table>

[^1]: Embedding é um vetor (conjunto de números) que caracteriza o significado associado ao texto de entrada fornecido. Palavras ou frases com significados próximos terão embeddings com distância coseno mínima. Embeddings também podem ser usados para buscar palavras, linhas ou parágrafos mais próximos em significado em bancos de dados de documentos.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/spravochnik-blokov/mashinnoe-obuchenie-machine-learning/naiti-embeddingi-openaisearchembeddings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
