ForHosting KIT · Ricerca semantica

Raggruppa testi simili

Il raggruppamento prende un elenco di testi — recensioni, ticket di assistenza, risposte a un sondaggio — e li organizza in gruppi coerenti in base al significato, senza che tu debba definire prima le categorie. Utile per capire di cosa parlano davvero centinaia o migliaia di righe senza leggerle tutte una per una.

● Stabileper richiesta + per 1.000 righe$0.002

Esegui — $0.002 + $0.0015/1.000 righe Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Esegui online

Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.

Perché serve quando i temi non sono noti in anticipo

Classificare un testo in una categoria fissa richiede sapere prima quali sono le categorie possibili. Il raggruppamento fa il contrario: scopre da solo i temi ricorrenti nei dati, mettendo vicini i testi che si somigliano per contenuto reale. È il primo passo naturale quando hai un mucchio di testi non organizzati e vuoi capire subito da dove iniziare l'analisi vera e propria.

Come si legge il risultato

Il motore restituisce ogni testo assegnato a un gruppo, insieme a una stima di quanti gruppi distinti sono emersi dai dati. Non assegna un nome al gruppo — quello richiede una lettura umana o un altro strumento del KIT che riassuma il contenuto — ma organizza il materiale in modo che leggere tre righe per gruppo basti per capire il tema comune.

Quanti dati entrano in un'esecuzione

Un'elaborazione accetta fino a 10.000 righe e 20.000 token complessivi per volta, senza distinzione tra i tipi di testo caricato. Per archivi più grandi, per esempio un anno intero di ticket di assistenza accumulati, conviene raggruppare per periodi, ad esempio un trimestre alla volta, e poi confrontare tra loro i temi emersi in ciascun periodo separato in un secondo momento.

Prezzo per mille righe

$0.002 a richiesta più $0.0015 ogni 1.000 righe elaborate, in dollari, senza costi aggiuntivi legati al numero esatto di gruppi distinti individuati dal motore semantico interno del KIT. Mille recensioni raggruppate costano una frazione di dollaro: molto meno del tempo che servirebbe a un collaboratore per leggerle tutte una per una e capire davvero i temi ricorrenti nel materiale analizzato.

Casi d'uso

I ticket di assistenza di un e-commerce

Un negozio online a Bari raggruppa tremila ticket di un trimestre e scopre che un terzo riguarda un solo problema di consegna, prima non evidente perché ogni ticket era scritto con parole diverse.

Le recensioni di Rossi & Figli S.r.l.

Rossi & Figli S.r.l. raggruppa le recensioni ricevute nell'ultimo anno per capire quali temi tornano più spesso, senza dover leggere ogni singolo commento uno per uno.

Le risposte a un sondaggio interno

Un'azienda di Padova raggruppa le risposte libere di un sondaggio tra i dipendenti per individuare i temi principali emersi, senza dover codificare a mano ogni risposta.

Domande frequenti

Devo dire in anticipo quanti gruppi voglio ottenere?

No, il motore individua da solo i temi ricorrenti nei dati: non serve fissare in anticipo il numero di gruppi.

Il risultato include un nome per ogni gruppo?

No, restituisce l'assegnazione dei testi ai gruppi; dare un nome al tema richiede una lettura veloce o un altro strumento del KIT dedicato al riassunto.

Quante righe posso raggruppare in un'esecuzione?

Fino a 10.000 righe e 20.000 token complessivi per volta; per archivi più grandi si divide il lavoro in più elaborazioni successive.

Che differenza c'è con la ricerca di anomalie?

Il raggruppamento organizza tutti i testi in gruppi coerenti; la ricerca di anomalie fa l'opposto, individua quelli che non si adattano bene a nessun gruppo.

Funziona su testi in italiano con gergo interno di un'azienda?

Sì, il modello riconosce il significato anche con terminologia specifica di un settore, purché i testi siano formulati in modo comprensibile.

Quanto costa raggruppare un archivio di diecimila righe?

Servirebbe dividere il lavoro in più esecuzioni da 10.000 righe l'una; il costo resta $0.0015 ogni 1.000 righe più $0.002 a richiesta, in dollari.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/search/cluster

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

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)

Esempio di richiesta

{
  "text": "…"
}

Esempio di risposta

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

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

per 1.000 righe$0.0015

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Limiti

`max_chunks`	10000
`max_tokens`	20000

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →