ForHosting KIT · Ricerca semantica

Ricerca semantica

La ricerca semantica interroga un indice già creato con il KIT e restituisce i risultati più vicini per significato, non solo quelli che contengono la stessa parola. Cerchi “disdire un contratto” e trovi anche il documento che parlava di “recesso”, perché il motore confronta concetti, non stringhe.

● Stabileper richiesta + per query$0.002

Esegui — $0.002 + $0.0015/query 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é batte la ricerca per parola esatta

Un motore per parola esatta non trova nulla se il documento usa un sinonimo o una formulazione diversa dalla query. La ricerca semantica trasforma anche la domanda in un vettore e la confronta con quelli già presenti nell'indice: vince chi è più vicino per concetto, indipendentemente dalle parole usate. Serve per archivi dove i testi non sono scritti tutti allo stesso modo, come corrispondenza o note libere.

Prima l'indice, poi la ricerca

Questo strumento presuppone un indice già costruito con index_text, index_document o index_url: la ricerca semantica interroga quello, non parte da zero ogni volta. Se non hai ancora un indice, il primo passo è crearne uno con lo strumento adatto al tipo di contenuto; da lì in poi ogni query costa poco e risponde in pochi secondi, anche su archivi con migliaia di voci indicizzate.

Quanto costa cercare

$0.002 a richiesta più $0.0015 ogni 1.000 token della query, in dollari: cercare costa una frazione di centesimo, decisamente meno che costruire l'indice di partenza da cui parte ogni singola ricerca eseguita. Puoi lanciare quante query vuoi, pagando solo quelle effettivamente eseguite dal tuo account, senza abbonamento né numero minimo mensile garantito da rispettare per tenere attivo lo strumento nel tempo.

Dove si usa

Dalla pagina del KIT digiti la domanda e ricevi subito i risultati più pertinenti; via API la colleghi alla barra di ricerca del tuo sito o a uno strumento interno di consultazione. Se ti serve anche il confronto con le parole chiave classiche, oltre al significato, esiste la versione ibrida, pensata proprio per unire i due approcci in un solo risultato ordinato.

Casi d'uso

L'archivio dello Studio Commercialista Bianchi

A Bologna, un collaboratore cerca “agevolazioni startup” nell'archivio delle circolari e trova anche la nota che parlava di “incentivi per nuove imprese”, senza dover indovinare la formulazione esatta usata dall'autore.

Il catalogo di Rossi & Figli S.r.l.

Un cliente cerca “borsa da lavoro capiente” sul sito di Rossi & Figli e trova il prodotto anche se la scheda lo descriveva come “zaino professionale ampio”, grazie alla ricerca per significato.

Le email di un help desk

Un operatore cerca “il cliente non riceve la fattura” tra migliaia di email archiviate e trova anche i messaggi che parlavano di “mancata ricezione del documento contabile”.

Domande frequenti

Devo prima creare un indice per usarla?

Sì: la ricerca semantica interroga un indice già costruito con index_text, index_document o index_url. Senza indice non c'è nulla da cercare.

Trova risultati anche se non uso le parole esatte del documento?

Proprio questo è il punto: confronta il significato della domanda con quello dei contenuti indicizzati, non la sequenza di caratteri.

Quanto costa una singola ricerca?

$0.002 a richiesta più $0.0015 ogni 1.000 token, in dollari. Cercare costa molto meno di indicizzare, quindi puoi farlo spesso senza pensarci.

Funziona bene con l'italiano e i suoi sinonimi?

Sì, il modello è addestrato su testi multilingue e riconosce sinonimi e formulazioni diverse dello stesso concetto anche in italiano.

Che differenza c'è con la ricerca ibrida?

La ricerca semantica lavora solo sul significato; quella ibrida combina significato e parole chiave esatte, utile quando servono entrambi i criteri.

Posso integrarla nella barra di ricerca del mio sito?

Sì, via API: colleghi la query digitata dall'utente allo strumento e mostri i risultati semantici al posto del solito filtro per parola esatta.

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/semantic

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

const res = await fetch("https://api.kit.forhosting.com/search/semantic", {
  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/search/semantic",
    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/search/semantic", 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/search/semantic", 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

{
  "input": "…"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "search.semantic",
  "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 query$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 →