Exemplo didático fictício e original. Nenhum resultado do modelo está preenchido.
Um ponto de partida editável
- 1 · Texto para verificar
- L1| Os pedidos são despachados em até dois dias úteis após o pagamento. L2| Itens lacrados podem ser devolvidos em até 30 dias, com reembolso integral. L3| Itens abertos podem ser trocados em até 14 dias, mas não são reembolsados. L4| Os vales-presente nunca expiram e não podem ser convertidos em dinheiro. L5| Fale com o suporte por e-mail; as respostas costumam levar um dia útil.
- 2 · Sua pergunta
- Qual linha responde a esta consulta: “Posso receber meu dinheiro de volta depois de abrir a caixa?”
- 3 · Defina de 2 a 6 opções
- L1
- L2
- L3
- L4
- L5
- Nenhuma linha responde
Nenhuma das linhas trata da consulta.
São probabilidades do modelo, não uma precisão medida ou garantia. Sim e Não correspondem às suas regras; as opções são comparadas apenas entre as que você forneceu.
O Jev consegue buscar pelo significado, e não por palavras-chave?
Sim, dentro de uma lista delimitada. O cookbook de busca linha a linha da TypeSafe marca cada linha de um documento com um id, envia o texto marcado como estado e faz uma pergunta Choice: qual linha responde a esta consulta? A resposta traz uma probabilidade para cada linha, então o seu código pode ordená-las. O mesmo formato serve para qualquer lista curta de linhas de texto: os assuntos de uma caixa de entrada, as linhas de uma planilha, as cláusulas de uma política.
Abra o modelo editável de busca por linha. Ele traz cinco linhas fictícias da política de uma loja e uma consulta que quase não tem palavras em comum com a linha que a responde. Carregá-lo apenas cria um rascunho; a verificação só começa quando você a solicita.
Por que o modelo tem uma opção “nenhuma linha”
As probabilidades de Choice sempre somam um. Por isso, alguma linha fica em primeiro lugar mesmo quando nada no documento responde à consulta. O cookbook oficial resolve isso com uma segunda pergunta, de sim/não, feita na mesma requisição: alguma linha chega a tratar da consulta? O seu código lê essa resposta antes de confiar na ordenação.
O Playground faz uma pergunta por vez, então este modelo acrescenta uma sexta opção, “Nenhuma linha responde”, para ensinar o mesmo hábito. Em uma integração, prefira a forma com duas perguntas do cookbook.
| Parte | O que faz |
|---|---|
Ids de linha (L1 … L5) |
Dão a cada candidata um id curto e estável. |
| Pergunta Choice | Ordena os ids para uma consulta. |
| “Nenhuma linha responde” | Evita que uma consulta sem resposta pareça respondida. |
Mude uma coisa por vez e compare
- Execute o modelo e anote as probabilidades de L2 e L3. As duas falam de reembolso, mas só uma trata de caixa aberta.
- Troque a consulta por “Quanto tempo leva a entrega?” e execute de novo.
- Pergunte algo que as linhas não conseguem responder, como “Vocês enviam para o Canadá?”, e veja se a última opção vence.
Nenhuma resposta esperada vem preenchida. Três execuções sobre cinco linhas inventadas não dizem nada sobre a acurácia nos seus documentos.
Limites a considerar no planejamento
- Tamanho da lista. O cookbook observa que uma pergunta Choice aceita até 255 opções, então uma requisição cobre até 255 linhas; documentos mais longos precisam de uma primeira passagem que reduza as candidatas. O editor deste site permite 2–6 opções; esse é um limite do site.
- Limites de corte. Os cortes do cookbook para “respondida”, “parcial” e “ausente” separam os exemplos do próprio cookbook e foram pensados para ser ajustados aos seus documentos.
- A recuperação continua importando. O cookbook de reclassificação da TypeSafe primeiro monta uma lista curta por palavras-chave e só então faz uma pergunta por par consulta–trecho. O Jev avaliou as candidatas que recebeu; ele não pesquisou o corpus.
- Os fatos ficam no texto. Uma ordenação aponta para uma linha. Mostre a própria linha, não uma paráfrase, para que o leitor possa conferi-la.
A galeria de Projetos lista experimentos da comunidade com busca e reclassificação; cada um é uma única comparação relatada pelo autor, e não um benchmark. Para sinais mistos entre linhas próximas, leia probabilidade e confiança.
Fontes e leituras complementares
Este guia se baseia na documentação oficial e nos relatos da comunidade vinculados. As observações da comunidade são atribuídas a seus autores.
- TypeSafe: Cookbook de busca linha a linha (Line-by-line search)
- TypeSafe: Cookbook de reclassificação (Re-ranking)
- TypeSafe: Choice