Inovacc Desarrolladores

Referencia de la API / Conocimiento y búsqueda vectorial

Ingerir documentos

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

Guarda pasajes en la base de datos vectorial de tu organización, con embeddings listos para buscarse por significado.

Parámetros del cuerpo

  • scope"shared" | "local"obligatorio

    shared: visible para todos los servicios de tu workspace. local: visible solo para la clave de API que lo escribe.

  • documentsarrayobligatorio

    De 1 a 100 pasajes. Un pasaje que no se puede guardar aparece en skipped con un motivo; los demás se guardan.

  • documents[].idstringobligatorio

    Tu id para el pasaje, de 1 a 256 bytes. Ingerir un id existente en el mismo alcance lo reemplaza.

  • documents[].textstringobligatorio

    El pasaje, que devuelven las consultas. Junto con id y metadata debe caber en 10 KiB.

  • documents[].metadataobject

    Valores planos: cadenas, números, booleanos o arreglos de cadenas. Se puede filtrar por kind, source, category, tag, language y created_at.

  • documents[].document_idstring

    Agrupa pasajes en un documento que se puede eliminar o reemplazar como un todo.

  • documents[].generationinteger

    Tu versión del documento. Una generación mayor reemplaza a la anterior; un documento eliminado solo acepta una mayor.

  • documents[].content_sha256string

    Tu SHA-256 del contenido del documento, 64 caracteres hexadecimales en minúscula, que devuelve GET /v1/vector/documents.

Encabezados

  • Authorizationstringobligatorio

    Bearer <clave de API>

  • X-Operation-Idstringobligatorio

    un id único que tú eliges, en toda llamada excepto GET

  • Content-Typestringobligatorio

    application/json, en una llamada con cuerpo

Ver también

Detalles de la fuente

Entrada del catálogo

Id
identity/component-taxonomy/capabilities#knowledge
Repositorio
identity
Ruta
contracts/component-taxonomy/catalog/capabilities.json
Commit
08ef3cd75d82

Sección del contrato

Id
ai/ai/contract#post-v1vectoringest
Repositorio
ai
Ruta
apps/cloudflare/workers/api/ai/CONTRACT.md
Commit
972a1c15b9d5
Versión documentada
2.37.0
Versión en producción
2.14.0
Actualizado el 2026-10-10.