ForHosting KIT · Busca inteligente

Agrupar textos por assunto

Recebe uma lista de textos — respostas de pesquisa, comentários, chamados — e agrupa por semelhança de significado, sem que você defina categorias antes. Os temas emergem dos próprios dados: cada texto sai associado a um grupo. Para quem precisa entender milhares de opiniões sem ler uma por uma.

● Estávelpor 1.000 linhas de planilhaUS$ 0,002

Executar — US$ 0,002 + US$ 0,0015/1.000 linhas de planilha 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.

Ler mil respostas, ninguém merece

A pesquisa de satisfação voltou com 1.200 comentários abertos. Alguém propõe “vamos ler tudo e marcar numa planilha” — e três tardes depois a planilha tem 40 categorias inconsistentes, criadas conforme o cansaço. O agrupamento automático faz o trabalho braçal: junta o que fala da mesma coisa e deixa para o humano a parte nobre, que é interpretar os grupos e decidir o que fazer com cada um.

Grupos que nascem dos dados

Aqui não existe lista de categorias pré-definida — e isso é uma característica, não uma falta. Cada texto vira um vetor de significado, e os vetores que ficam próximos formam um grupo: reclamações de prazo se juntam, elogios ao atendimento se juntam, dúvidas sobre boleto se juntam. Aparecem inclusive temas que você não esperava — que costumam ser justamente os mais valiosos de descobrir.

O que entra e o que sai

A entrada é a lista de textos, um por linha — exportação de planilha, respostas de formulário, comentários do app. Cada chamada processa até 20.000 tokens; bases maiores entram em lotes. Na saída, cada linha volta associada ao seu grupo, em JSON, pronta para tabela dinâmica, gráfico ou relatório. Do caos de texto livre para dados estruturados, numa chamada.

Centavos por milhares de linhas

O preço é US$ 0,002 por chamada mais US$ 0,0015 por 1.000 linhas. Agrupar 10.000 respostas custa US$ 0,017 — menos que o cafezinho de quem ia passar a semana lendo tudo. A conta muda a frequência do exercício: em vez de uma análise heroica por ano, dá para agrupar o feedback todo mês e acompanhar como os temas evoluem.

Casos de uso

NPS com pergunta aberta

A TecnoSul Soluções Digitais agrupou 1.200 respostas da pesquisa anual. Emergiram cinco temas — preço, suporte, prazo de implantação, faltas de funcionalidade e elogios — e o relatório da diretoria saiu no mesmo dia.

Avaliações do app

Um app de delivery agrupa os comentários da loja de aplicativos a cada versão. Quando o grupo “pedido some da tela” cresceu de repente, o time achou o bug antes do fim de semana.

Chamados por tema, backlog por evidência

Um SaaS agrupa os chamados do trimestre antes da reunião de roadmap. O tema com mais volume — exportação para planilha — virou prioridade com número na mesa, não com achismo.

Formulário de evento

Os organizadores de uma conferência em Curitiba agruparam 800 respostas de “o que você quer ver no próximo ano?”. Três trilhas novas nasceram direto dos grupos.

Perguntas frequentes

Preciso definir as categorias antes?

Não — é o contrário: os grupos emergem dos próprios textos. Se você já tem categorias fixas e quer encaixar cada texto nelas, o que procura é classificação, não agrupamento; o KIT também tem tarefa para isso.

Qual a diferença para classificar texto por assunto?

A classificação usa rótulos que você fornece; o agrupamento descobre a estrutura sozinho. Agrupar é o passo exploratório — muita gente agrupa uma vez para descobrir as categorias e depois classifica o fluxo contínuo com elas.

Quantas respostas posso mandar de uma vez?

Cada chamada processa até 20.000 tokens de texto. Para bases maiores, divida em lotes — comentários curtos rendem milhares de linhas por chamada.

Quanto custa agrupar 10.000 comentários?

US$ 0,015 de processamento (US$ 0,0015 por 1.000 linhas) mais US$ 0,002 da chamada: US$ 0,017 no total. Dá para rodar todo mês sem pensar duas vezes.

As respostas têm nome e e-mail dos clientes. E agora?

O agrupamento só precisa do texto da opinião — deixe as colunas de identificação fora do envio. Mandar só o necessário é o caminho mais simples para ficar em paz com 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/search/cluster

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/search/cluster \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"text":"…"}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/cluster", 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

{
  "text": "…"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "search.cluster",
  "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,002

por 1.000 linhas de planilhaUS$ 0,0015

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.

Ver a documentação completa do KIT →