Risposte con le fonti
Chieda di una regola sui benefit e riceva la risposta con la clausola esatta da cui proviene, pronta da allegare a un ticket, così ogni affermazione si verifica in pochi secondi. Pensato per risposte che dovrà difendere. Si paga a consumo, senza abbonamento.
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.
Serve quando la risposta da sola non basta e occorre poter verificare da dove arriva ogni affermazione.
Perché una risposta senza fonte non basta
Un modello può scrivere una risposta fluida e sicura anche quando non si basa su nulla di reale. Per un'idea veloce va bene, ma diventa un rischio quando la risposta la useranno un cliente, un'autorità di controllo o un ufficio legale. Qui il sistema cerca prima nei suoi documenti i passaggi più pertinenti, poi scrive una risposta limitata a ciò che quei passaggi dicono davvero e li mostra accanto al testo, con i riferimenti per ritrovarli. La citazione non è un abbellimento: è il controllo che rende utile la ricerca, perché una fonte nascosta vale quanto nessuna fonte.
Quando serve davvero
È pensato per chi dovrà giustificare una risposta più tardi. Un ufficio del personale che interpreta una regola sui benefit può allegare la clausola alla pratica; un gruppo di ricerca che interroga una raccolta di articoli verifica ogni affermazione prima del rapporto; un ufficio legale scopre se una clausola esiste e in quale sezione si trova; un'assistenza clienti mostra all'operatore il passaggio da citare. L'errore tipico è fermarsi al riassunto: legga sempre il passaggio citato prima di affidarsi alla risposta.
Cosa cambia rispetto a rag.answer
Il motore di ricerca e di scrittura è lo stesso di rag.answer; la differenza è che ogni frase della risposta resta collegata al blocco esatto del documento da cui proviene, senza alcuna ambiguità residua. Se la domanda tocca più documenti, la risposta può citarne più di uno, ciascuno con il proprio riferimento distinto, invece di mescolare le fonti senza indicarle chiaramente.
Casi d'uso
Verifica contrattuale per lo Studio Bianchi
Lo Studio Commercialista Bianchi chiede “quale contratto prevede una penale per ritardo” e riceve la risposta con il riferimento esatto al documento e alla clausola, pronta da citare in una consulenza al cliente.
Documentazione tecnica di Tecnoedil Verona
Un tecnico chiede una specifica di cantiere e ottiene la risposta con il riferimento al capitolato e alla pagina esatta, utile per allegare la fonte a un rapporto interno.
Domande frequenti
Come sono indicate le fonti nella risposta?
Ogni frase o blocco di risposta è collegato al documento e al frammento specifico dell'indice da cui proviene, così puoi risalire al testo originale.
Costa di più rispetto a rag.answer?
Citare le fonti non comporta un costo aggiuntivo.
Se la domanda coinvolge più documenti, cita tutti quelli usati?
Sì, quando la risposta si basa su più fonti, ciascuna viene indicata separatamente invece di essere mescolata senza distinzione.
È adatto per un contesto dove serve dimostrare l'origine di un'informazione?
Sì, è pensato proprio per questo: contesti fiscali, legali o tecnici dove non basta una risposta corretta, ma serve anche poterla verificare rapidamente.
Cosa succede se una risposta non va a buon fine?
Il tentativo viene ripetuto automaticamente fino a tre volte e un tentativo fallito non viene mai addebitato; solo dopo riceve un errore chiaro. Così una coda di mille domande si comporta in modo prevedibile.
Strumenti correlati
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
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/rag/answer-sources \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"¿Cuánto dura la garantía?"}'const res = await fetch("https://api.kit.forhosting.com/rag/answer-sources", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"query": "¿Cuánto dura la garantía?"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/rag/answer-sources",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"query": "¿Cuánto dura la garantía?"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/rag/answer-sources", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"query":"¿Cuánto dura la garantía?"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"query":"¿Cuánto dura la garantía?"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/rag/answer-sources", 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
{
"query": "¿Cuánto dura la garantía?"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "rag.answer_sources",
"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
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. |
422 | task_failed | L'attività non è andata a buon fine: non ti viene addebitato nulla. |
Note tecniche
rag.answer_sources funziona come rag.answer — legge un indice e scrive una risposta alla domanda — ma aggiunge il riferimento preciso a ogni fonte usata: quale documento, quale pagina o blocco.
Perché la fonte conta quanto la risposta
In ambito contrattuale, tecnico o fiscale una risposta senza riferimento resta un'affermazione da controllare comunque a mano, vanificando gran parte del risparmio di tempo ottenuto con lo strumento. rag.answer_sources restituisce la risposta insieme all'elenco preciso dei documenti e dei passaggi da cui è stata costruita, così puoi citare la fonte esatta o riaprire il documento per verificare il contesto completo con calma.
Serve un indice costruito prima
Blocchi di testo troppo lunghi o che mescolano più argomenti insieme rendono il riferimento finale meno preciso e affidabile per chi legge la risposta. Come rag.answer, interroga un indice già creato con index_text, index_document o index_url: la qualità dei riferimenti restituiti dipende da quanto è ben organizzato l'indice di partenza usato per la ricerca stessa, blocco per blocco, riga per riga.
Prezzo per domanda
Solo un tracciamento più accurato, eseguito durante la stessa identica elaborazione della domanda posta dall'utente finale che interroga il sistema ogni volta che ne ha bisogno. $0.003 a richiesta più $0.015 ogni 1.000 token elaborati, in dollari: lo stesso identico prezzo di rag.answer, perché citare la fonte non richiede un calcolo aggiuntivo separato dal resto dell'elaborazione principale del testo ricevuto in ingresso.
Casi di integrazione
Verifica normativa in uno studio legale
Uno studio legale di Napoli usa rag.answer_sources per verificare rapidamente in quale documento archiviato compare un determinato riferimento normativo, citando la fonte esatta nella propria memoria difensiva.
Domande tecniche
Che differenza c'è con rag.answer?
La risposta è identica nel contenuto, ma rag.answer_sources aggiunge il riferimento preciso a ogni documento e passaggio usato per costruirla.
Serve un indice diverso rispetto a rag.answer?
No, lo stesso indice costruito con index_text, index_document o index_url funziona per entrambi gli strumenti, con o senza citazione delle fonti.