Inovacc Desenvolvedores

Referência da API / Conhecimento e busca vetorial

Ingerir documentos

POSThttps://ai.inovacc.dev/v1/vector/ingest

Armazena trechos no Vector Database da sua organização, com embeddings prontos para busca por significado.

Parâmetros do corpo

  • scope"shared" | "local"obrigatório

    shared: visível para todos os serviços do seu workspace. local: visível apenas para a chave de API que grava.

  • documentsarrayobrigatório

    De 1 a 100 trechos. Um trecho que não pode ser armazenado aparece em skipped com o motivo; os demais são armazenados.

  • documents[].idstringobrigatório

    Seu id para o trecho, de 1 a 256 bytes. Ingerir um id já existente no mesmo escopo o substitui.

  • documents[].textstringobrigatório

    O trecho, devolvido pelas consultas. Junto com id e metadata, deve caber em 10 KiB.

  • documents[].metadataobject

    Valores simples: strings, números, booleanos ou arrays de strings. kind, source, category, tag, language e created_at podem ser usados como filtro.

  • documents[].document_idstring

    Agrupa trechos em um único documento que pode ser excluído ou substituído por inteiro.

  • documents[].generationinteger

    Sua versão do documento. Uma geração maior substitui a mais antiga; um documento excluído só aceita uma geração maior.

  • documents[].content_sha256string

    Seu SHA-256 do conteúdo do documento, 64 caracteres hexadecimais minúsculos, devolvido por GET /v1/vector/documents.

Cabeçalhos

  • Authorizationstringobrigatório

    Bearer <chave de API>

  • X-Operation-Idstringobrigatório

    um id único que você escolhe, em toda chamada exceto GET

  • Content-Typestringobrigatório

    application/json, em uma chamada com corpo

Veja também

Detalhes da fonte

Entrada do catálogo

Id
identity/component-taxonomy/capabilities#knowledge
Repositório
identity
Caminho
contracts/component-taxonomy/catalog/capabilities.json
Commit
08ef3cd75d82

Seção do contrato

Id
ai/ai/contract#post-v1vectoringest
Repositório
ai
Caminho
apps/cloudflare/workers/api/ai/CONTRACT.md
Commit
972a1c15b9d5
Versão documentada
2.37.0
Versão em produção
2.14.0
Atualizado em 2026-10-10.