API/AI Gateway/Query RAG e inserimento documenti

Query RAG e inserimento documenti

POST/v1/ai/{project_id}/rag

Acquisisci documenti di grandi dimensioni (fino a 5 MB) con sovrapposizione configurabile e query risposte LLM basate sul contesto.

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

rag.tstypescript

// 1. Inserisci un documento di testo di grandi dimensioni nello spazio dei nomi
await aura.ai.ragIngest({
  document: 'Full text of enterprise security guide...',
  namespace: 'security-kb',
  chunk_size: 1000,
  chunk_overlap: 200,
})

// 2. Interrogare la risposta RAG con messa a terra
const { data: answer } = await aura.ai.rag({
  question: 'How are database backups encrypted?',
  namespace: 'security-kb',
  system: 'Answer using only the provided context.',
})
console.log('Answer:', answer?.answer)
console.log('Sources cited:', answer?.sources)

200.jsonjson

{
  "data": {
    "answer": "Database backups are encrypted at rest using AES-256-GCM via Vault Transit KEK...",
    "sources": [
      {
        "id": "b1a2c3d4-...",
        "content": "All automated WAL and snapshot backups utilize AES-256-GCM keys...",
        "similarity": 0.912
      }
    ],
    "model": "claude-3-5-sonnet",
    "provider": "anthropic"
  }
}

Ingestione

Parametri di suddivisione in blocchi

Parametro	Digitare	Obbligatorio	Descrizione
`document`	`string`	sì	Contenuto del documento (dimensione del payload fino a 5 MB).
`namespace`	`string`	sì	Spazio dei nomi della partizione di destinazione.
`chunk_size`	`number`	no	Caratteri target per blocco (predefinito `1000`).
`chunk_overlap`	`number`	no	Caratteri sovrapposti tra blocchi consecutivi (impostazione predefinita `200`).
`metadata`	`object`	no	Metadati JSON arbitrari allegati a ciascun blocco.

Gestione

Operazioni del ciclo di vita dello spazio dei nomi

GET /v1/ai/{project_id}/rag/namespaces: Elenca tutti gli spazi dei nomi RAG attivi.
DELETE /v1/ai/{project_id}/rag/{namespace}: Elimina tutti i blocchi e le voci dei vettori nello spazio dei nomi.
POST /v1/ai/{project_id}/rag/{namespace}/reindex: ricalcola gli incorporamenti per tutti i blocchi nello spazio dei nomi quando si cambiano i modelli di incorporamento.

v1.0 · rivisto 31 ott 2026
↗ Specifiche OpenAPI↗ GitHub

← PRECEDENTE

Ricerca semantica

AVANTI →

NL to SQL