Risposte con le fonti
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. Serve quando la risposta da sola non basta e occorre poter verificare da dove arriva ogni affermazione.
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é 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.
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.
Serve un indice costruito prima
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. Blocchi di testo troppo lunghi o che mescolano più argomenti insieme rendono il riferimento finale meno preciso e affidabile per chi legge la risposta.
Prezzo per domanda
$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. 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.
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.
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 frequenti
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.
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?
No, il prezzo è identico: $0.003 a richiesta più $0.015 ogni 1.000 token, in dollari. 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.
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.
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 '{"input":"…"}'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({
"input": "…"
})
});
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={
"input": "…"
},
)
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" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
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
{
"input": "…"
}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. |