Ir para o conteúdo

Bases de conhecimento

Criar, listar, renomear e apagar bases — o contêiner dos seus documentos.

Atualizado em 10 de ago. de 2026

A base é o contêiner: documentos, Q&A e buscas sempre acontecem dentro de uma. O id retornado na criação é o rag_id usado em todas as outras chamadas. A base nasce no escopo da chave — organização e projeto vêm da API key, não do corpo da requisição.

POSThttps://api.hinow.ai/v1/rag/ragsBearer

Cria uma base de conhecimento.

Parâmetros

  • namestring· bodyobrigatório
  • descriptionstring· body

    Opcional.

Respostas

200Base criada
{
  "id": "1d9cf4ae05f64a9faf987981b22cdeae",
  "name": "Central de ajuda",
  "description": "FAQ e políticas",
  "organization_id": "1e45f818-...",
  "project_id": "f4be996e-...",
  "created_at": "2026-08-10T21:22:41Z",
  "updated_at": "2026-08-10T21:22:41Z"
}
GEThttps://api.hinow.ai/v1/rag/ragsBearer

Lista as bases do escopo da chave.

Respostas

200Lista de bases
{
  "rags": [
    { "id": "1d9cf4ae...", "name": "Central de ajuda", ... }
  ]
}
GEThttps://api.hinow.ai/v1/rag/rags/{id}Bearer

Recupera uma base pelo id.

Parâmetros

  • idstring· pathobrigatório

Respostas

200A base
404Base inexistente (ou de outro escopo)
PUThttps://api.hinow.ai/v1/rag/rags/{id}Bearer

Renomeia a base ou troca a descrição.

Parâmetros

  • idstring· pathobrigatório
  • namestring· body
  • descriptionstring· body

Respostas

200Base atualizada
DELETEhttps://api.hinow.ai/v1/rag/rags/{id}Bearer

Apaga a base. Todos os documentos vão para a lixeira e podem ser restaurados por 15 dias.

Parâmetros

  • idstring· pathobrigatório

Respostas

200Base removida
{
  "rag_id": "1d9cf4ae...",
  "deleted": true,
  "trashed_documents": 7
}

Bases "vs_..." na listagem

As vector stores criadas pela Assistants API (file search) vivem no mesmo registro e aparecem na listagem com id vs_.... Você pode buscá-las por aqui normalmente; para gerenciá-las, prefira os endpoints de vector stores da Assistants API.

Esta página foi útil?