ForHosting KIT · Busca inteligente

Reescrita de consulta

Reescrita de consulta (query rewriting) é o passo que transforma o que o usuário digitou — curto, ambíguo, cheio de abreviação — em uma busca clara. A API recebe a consulta original, com o histórico da conversa se houver, e devolve a versão reescrita, pronta para alimentar sua busca semântica ou seu pipeline de RAG.

● Estávelpor consultaUS$ 0,003

Executar — US$ 0,003 + US$ 0,0135/consulta Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode online

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

Gente não busca do jeito que o índice espera

No mundo real, a caixa de busca recebe “nf atrasada”, “boleto venceu e agr”, “tenis corrida masc 42”. O índice, por melhor que seja, recupera mais quando a consulta é clara e completa. A reescrita fica entre os dois: pega o texto cru do usuário e produz algo como “o que fazer quando a nota fiscal não foi emitida no prazo” — mesma intenção, muito mais chance de recuperar o documento certo.

O que a API faz com cada consulta

Corrige digitação e português quebrado sem mudar a intenção; expande siglas e jargões do seu domínio quando o contexto pede; e resolve referências do histórico da conversa — se o usuário pergunta “e o prazo?” depois de falar de devolução, a consulta reescrita vira “qual o prazo para devolver um produto”. O retorno é texto: a consulta pronta para você mandar ao seu mecanismo de busca, seja ele qual for.

Onde encaixar no seu pipeline

O lugar dela é entre o campo de busca e o índice: o usuário digita, você chama a reescrita, manda o resultado para a sua busca — semântica, por palavra-chave ou híbrida — e segue o fluxo normal. Funciona com qualquer mecanismo: o seu Elasticsearch de sempre, um banco vetorial ou as capacidades de busca do próprio KIT. É uma chamada a mais por consulta, pensada para valer o custo exatamente onde busca ruim significa cliente perdido.

Custo por consulta reescrita

US$ 0,003 por chamada mais US$ 0,0135 por consulta, em dólar e sem mensalidade. Uma busca interna que processa 5.000 consultas no mês adiciona US$ 82,50 ao custo — e costuma se pagar quando o resultado certo aparece em primeiro, em vez de página vazia. Como não tem plano mínimo, dá para testar numa fração do tráfego, medir a diferença de acerto e só então ligar para todo mundo.

Casos de uso

Busca de e-commerce que entende abreviação

“tenis corrida masc 42” vira uma consulta completa, com categoria, gênero e tamanho, antes de chegar ao catálogo. A loja não precisa manter dicionário de sinônimos na mão — a reescrita absorve gíria, abreviação e erro de digitação.

Chat de suporte com pergunta de acompanhamento

No meio da conversa, o cliente manda só “e no cartão?”. Com o histórico junto na chamada, a consulta vira “posso pagar a fatura no cartão de crédito?”, e a busca na base de conhecimento encontra o artigo certo em vez de se perder.

Base de conhecimento contábil-fiscal

Sistema para contador convive com sigla: DAS, DARF, NF-e, SPED. A reescrita expande a sigla conforme o contexto, e a busca para de tratar “darf atrasado” e “guia da Receita vencida” como assuntos diferentes.

RAG que responde melhor sem trocar de modelo

Quando as respostas do seu RAG vêm rasas, o culpado costuma ser a recuperação, não o modelo. Reescrever a consulta antes do embedding é o ajuste mais barato do pipeline — melhora o material recuperado e, com ele, a resposta final.

Perguntas frequentes

A reescrita pode mudar o sentido da pergunta?

O serviço é instruído a reformular preservando a intenção. Ainda assim, trate como todo componente de IA: teste com consultas reais do seu domínio antes de colocar em produção — o retorno em texto simples facilita comparar o antes e o depois.

Funciona com histórico de conversa?

Sim, e é onde mais rende: mande as últimas mensagens junto com a consulta e as referências soltas (“e o prazo?”, “e no PJ?”) viram perguntas completas. O limite é de 20.000 tokens de contexto por chamada — histórico de sobra.

Preciso usar a busca do KIT junto?

Não. A saída é texto puro: use com Elasticsearch, banco vetorial, a busca do seu e-commerce ou qualquer outro mecanismo. As capacidades de busca do KIT são opcionais, não casadas.

Funciona em português?

Sim — português do Brasil incluído, com as abreviações e o jeito de escrever daqui. Consultas em outros idiomas também são aceitas, e a versão reescrita sai no idioma em que a consulta entrou.

Como funciona a cobrança?

Pré-paga e por uso: US$ 0,003 por chamada mais US$ 0,0135 por consulta, com pagamento via PayPal em dólar. Sem assinatura — quem processa pouco paga pouco, e o preço fica publicado nesta página.

As consultas dos usuários são armazenadas?

Elas são processadas para gerar a reescrita — é para isso que passam pela API. Não trafegue dado pessoal desnecessário na busca e mencione esse tratamento no seu aviso de privacidade, como pede a LGPD.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/rag/query-rewrite

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/rag/query-rewrite \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/rag/query-rewrite", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/rag/query-rewrite",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/rag/query-rewrite", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/rag/query-rewrite", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "input": "…"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "rag.query_rewrite",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,003

por consultaUS$ 0,0135

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`max_chunks`	10000
`max_tokens`	20000

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.
`422`	`task_failed`	A tarefa falhou do nosso lado. Você não paga nada por ela.

Ver a documentação completa do KIT →