ForHosting KIT · Ricerca semantica

Indice semantico dai tuoi testi

Indicizzare un testo significa trasformarlo in una struttura che si può interrogare per significato, non solo per parola esatta. Il KIT prende i tuoi testi — appunti, contratti, email — li vettorizza e li organizza in un indice pronto per la ricerca semantica, senza database da configurare.

● Stabileper richiesta + per 1.000 chunk$0.002

Esegui — $0.002 + $0.0015/1.000 chunk 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.

Un indice, non vettori sparsi

Search.embed produce vettori singoli; index_text va oltre e li organizza in una struttura interrogabile con una query, senza dover confrontare ogni vettore a mano nel tuo codice. È la differenza tra avere gli ingredienti e avere il piatto pronto: qui ricevi un indice già collegato ai testi originali, pronto per la funzione di ricerca semantica dello stesso KIT, sia via web sia via API.

Cosa puoi indicizzare

Funziona con qualunque testo incollato o caricato: verbali di riunione, condizioni contrattuali, la knowledge base di un help desk, la raccolta di circolari di uno studio. Ogni blocco di testo diventa una voce dell'indice, con il proprio vettore e un riferimento al contenuto originale. Non serve struttura preesistente: dividi tu il materiale in blocchi con un senso compiuto, uno per concetto, e il resto lo fa il KIT.

Limiti e organizzazione dei blocchi

Un'esecuzione accetta fino a 10.000 blocchi e 20.000 token complessivi: per archivi più grandi conviene indicizzare per lotti, per esempio un mese di corrispondenza alla volta, poi il mese successivo. Blocchi brevi e su un solo argomento cercano meglio di paragrafi lunghi che mescolano temi diversi: vale la pena spezzare il materiale prima di indicizzare, non dopo, quando i risultati risultano già confusi e difficili da correggere.

Quanto costa e da dove si usa

Il prezzo è $0.002 a richiesta più $0.0015 ogni 1.000 blocchi indicizzati, in dollari, senza abbonamento né minimo mensile da rispettare. Lo lanci dalla pagina del KIT incollando il testo, oppure via API se l'indicizzazione fa parte di un flusso automatico, per esempio a ogni nuovo documento archiviato dal tuo sistema. L'indice risultante alimenta poi la ricerca semantica o quella ibrida, disponibili come strumenti a parte dentro lo stesso KIT.

Casi d'uso

Le circolari dello Studio Commercialista Bianchi

Lo Studio Commercialista Bianchi di Bologna indicizza dieci anni di circolari interne: un collega cerca “proroga versamenti” e trova anche le note che parlavano di “rinvio scadenze”, perché l'indice lavora sul significato.

I verbali di Tecnoedil Verona

Tecnoedil Verona S.n.c. indicizza i verbali dei cantieri per ritrovare in pochi secondi in quale riunione si era deciso un certo materiale, senza riaprire ogni file uno a uno.

La knowledge base di un help desk

Un servizio assistenza indicizza le risposte già scritte agli utenti così un operatore nuovo trova subito la spiegazione giusta anche se la cerca con parole diverse da quelle originali.

Domande frequenti

Che differenza c'è con search.embed?

Search.embed restituisce i vettori grezzi; index_text li organizza in una struttura pronta per essere interrogata con una query, senza che tu debba gestire il confronto tra vettori.

Posso aggiungere testi a un indice già creato?

Sì, puoi lanciare nuove indicizzazioni sullo stesso insieme quando arrivano documenti nuovi: ogni esecuzione aggiunge blocchi senza dover rifare da capo quelli già presenti.

Quanti blocchi entrano in un'esecuzione?

Fino a 10.000 blocchi e 20.000 token per volta. Un archivio più grande si indicizza in più invii successivi, senza perdere continuità.

Il testo che indicizzo resta sul server?

Viene elaborato per costruire l'indice e poi conservato solo come indice interrogabile, non come testo integrale esposto: la privacy dei contenuti è la stessa di ogni altro strumento a pagamento del KIT.

Serve sapere programmare per usarlo?

No: dalla pagina del KIT incolli il testo e ottieni l'indice. L'API serve solo se vuoi collegarlo a un tuo sistema che indicizza automaticamente.

Funziona bene con l'italiano tecnico e il burocratese?

Sì, il modello gestisce senza problemi termini giuridici e amministrativi italiani, comprese sigle come IVA o SDI, senza bisogno di tradurre prima il testo.

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/index-text

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

const res = await fetch("https://api.kit.forhosting.com/search/index-text", {
  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/index-text",
    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/index-text", 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/index-text", 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.index_text",
  "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 chunk$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 →