Inovacc Desenvolvedores

Referência da API / Conhecimento e busca vetorial

Buscar documentos por significado

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

Encontra os trechos mais próximos em significado de uma pergunta, do melhor para o pior.

Parâmetros do corpo

  • mode"local" | "shared" | "hybrid"obrigatório

    Qual escopo pesquisar; hybrid pesquisa os dois e combina por pontuação.

  • querystringobrigatório

    A pergunta ou o texto a comparar, de 1 a 8.000 caracteres.

  • top_kinteger

    Quantas correspondências devolver, de 1 a 50. Padrão 5.

  • filterobject

    Igualdade nas chaves de metadados filtráveis, ou {"$in": [...]} com até 20 valores.

  • retrieval"vector" | "vector_rerank"

    vector_rerank reordena uma lista maior de candidatos com uma etapa de reclassificação. Padrão vector.

  • rerank_profilestring

    O perfil de reclassificação a usar; obrigatório com vector_rerank e recusado caso contrário.

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-v1vectorquery
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.