Filtros

Fyso soporta filtros simples en query_records y filtros por campo en la REST API.

Filtros en MCP (query_records)

El parametro filter acepta una expresion con el formato:

campo operador valor

Operadores

Operador	Descripcion	Ejemplo
=	Igual (case-insensitive)	estado = activo
!=	Distinto	estado != inactivo
>	Mayor que (numerico)	precio > 1000
<	Menor que (numerico)	stock < 10
>=	Mayor o igual	total >= 500
<=	Menor o igual	descuento <= 20
contains	Contiene texto (case-insensitive)	nombre contains juan

Ejemplos

query_records({ entityName: "productos", filter: "precio > 100" })
query_records({ entityName: "clientes", filter: "nombre contains perez" })
query_records({ entityName: "facturas", filter: "estado = pagada" })

Notas

• El filtro se aplica en memoria despues de obtener los registros (salvo busqueda semantica)
• Los valores string no necesitan comillas, pero se soportan: nombre = "Juan Perez"
• Las comparaciones numericas (>, <, >=, <=) convierten los valores a numero

Filtros en REST API

La REST API soporta filtros por campo usando query parameters:

GET /api/entities/{entityName}/records?filter.estado=activo&filter.ciudad=buenos+aires

Tambien soporta busqueda full-text:

GET /api/entities/{entityName}/records?search=juan+perez

Busqueda semantica

La busqueda semantica usa vectores para encontrar registros por similitud de significado, no por coincidencia exacta de texto.

query_records({
  entityName: "productos",
  semantic: "algo para sentarse en la oficina",
  minSimilarity: 0.6,
  limit: 10
})

Cuando se usa semantic, el filtro simple se puede combinar para post-filtrar los resultados.