API/AI Gateway/Consulta RAG e ingestão de documentos

Consulta RAG e ingestão de documentos

POST/v1/ai/{project_id}/rag

Ingira documentos grandes (até 5 MB) com sobreposição configurável e consulte respostas LLM baseadas no contexto.

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

rag.tstypescript

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

// 2. Resposta RAG baseada em consulta
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"
  }
}

Ingestão

Parâmetros de fragmentação

Parâmetro	Tipo	Obrigatório	Descrição
`document`	`string`	sim	Conteúdo do documento (tamanho de carga útil de até 5 MB).
`namespace`	`string`	sim	Namespace da partição de destino.
`chunk_size`	`number`	não	Caracteres de destino por bloco (padrão `1000`).
`chunk_overlap`	`number`	não	Caracteres sobrepostos entre blocos consecutivos (padrão `200`).
`metadata`	`object`	não	Metadados JSON arbitrários anexados a cada bloco.

Gestão

Operações do ciclo de vida do namespace

GET /v1/ai/{project_id}/rag/namespaces: lista todos os namespaces RAG ativos.
DELETE /v1/ai/{project_id}/rag/{namespace}: Exclui todos os pedaços e entradas de vetor no namespace.
POST /v1/ai/{project_id}/rag/{namespace}/reindex: Recalcula incorporações para todos os pedaços no namespace ao alternar modelos de incorporação.

v1.0 · revisado 31 de out. de 2026
↗ Especificação OpenAPI↗ GitHub

← ANTERIOR

Pesquisa semântica

PRÓXIMO →

NL to SQL