API/AI Gateway/Consulta RAG e ingesta de documentos

Consulta RAG e ingesta de documentos

POST/v1/ai/{project_id}/rag

Ingiere documentos grandes (hasta 5 MB) con superposición configurable y consulta respuestas de LLM basadas en el contexto.

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

rag.tstypescript

// 1. Ingerir un documento de texto grande en el espacio de nombres
await aura.ai.ragIngest({
  document: 'Full text of enterprise security guide...',
  namespace: 'security-kb',
  chunk_size: 1000,
  chunk_overlap: 200,
})

// 2. Consulta de respuesta RAG fundamentada
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"
  }
}

Ingestión

Parámetros de fragmentación

Parámetro	Tipo	Requerido	Descripción
`document`	`string`	si	Contenido del documento (hasta 5 MB de tamaño de carga útil).
`namespace`	`string`	si	Espacio de nombres de la partición de destino.
`chunk_size`	`number`	no	Caracteres de destino por fragmento (predeterminado `1000`).
`chunk_overlap`	`number`	no	Caracteres superpuestos entre fragmentos consecutivos (predeterminado `200`).
`metadata`	`object`	no	Metadatos JSON arbitrarios adjuntos a cada fragmento.

Gestión

Operaciones del ciclo de vida del espacio de nombres

GET /v1/ai/{project_id}/rag/namespaces: enumera todos los espacios de nombres RAG activos.
DELETE /v1/ai/{project_id}/rag/{namespace}: elimina todos los fragmentos y entradas de vectores en el espacio de nombres.
POST /v1/ai/{project_id}/rag/{namespace}/reindex: vuelve a calcular las incrustaciones de todos los fragmentos en el espacio de nombres al cambiar los modelos de incrustación.

v1.0 · revisado 31 oct 2026
↗ Especificaciones de OpenAPI↗ GitHub

← ANTERIOR

búsqueda semántica

SIGUIENTE →

NL to SQL