docs: params/output semántico en 506 funciones para composabilidad
Añade campos params y output al frontmatter YAML de las 506 funciones del registry. Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico) y cada función describe qué produce su output. Permite a agentes razonar sobre cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.
This commit is contained in:
@@ -14,6 +14,18 @@ returns: []
|
||||
returns_optional: false
|
||||
error_type: ""
|
||||
imports: ["collections"]
|
||||
params:
|
||||
- name: rows
|
||||
desc: "lista de dicts en formato largo (ej: [{'region': 'US', 'product': 'A', 'sales': 10}, ...])"
|
||||
- name: index
|
||||
desc: "columna que sera el indice de filas en la tabla pivote (ej: 'region'). Valores unicos -> filas."
|
||||
- name: columns
|
||||
desc: "columna cuyos valores unicos se expanden como nuevas columnas (ej: 'product'). Valores unicos -> columnas."
|
||||
- name: values
|
||||
desc: "columna con los valores a agregar en las celdas (ej: 'sales')"
|
||||
- name: agg
|
||||
desc: "funcion de agregacion si hay multiples valores por celda (defecto: 'sum'). Otras: count, mean, min, max, first, last."
|
||||
output: "lista de dicts en formato ancho, donde el indice y las columnas expandidas forman el schema"
|
||||
tested: true
|
||||
tests:
|
||||
- "Pivot basico con sum"
|
||||
|
||||
Reference in New Issue
Block a user