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:
@@ -31,6 +31,26 @@ imports:
|
||||
- time
|
||||
- warnings
|
||||
- typing.Callable
|
||||
params:
|
||||
- name: file_path
|
||||
desc: "Ruta del documento (PDF, TXT, Markdown) a procesar"
|
||||
- name: entity_presets
|
||||
desc: "Configuración de tipos de entidades a extraer con sus metadatos"
|
||||
- name: relation_types
|
||||
desc: "Tipos de relaciones a extraer (ej: 'owns', 'operates', 'communicates_with')"
|
||||
- name: llm_chat_json
|
||||
desc: "Función inyectada para llamadas al LLM (sin acoplamiento a proveedor)"
|
||||
- name: chunk_size
|
||||
desc: "Tamaño de chunks para procesamiento (default 500)"
|
||||
- name: chunk_overlap
|
||||
desc: "Solapamiento entre chunks (default 50)"
|
||||
- name: confidence_threshold
|
||||
desc: "Confianza mínima para incluir entidades (default 0.5)"
|
||||
- name: dedup_threshold
|
||||
desc: "Umbral fuzzy para deduplicación (default 0.85)"
|
||||
- name: on_progress
|
||||
desc: "Callback opcional para progreso (msg, percentage)"
|
||||
output: "ExtractionResult con entidades, relaciones y estadísticas del proceso de extracción"
|
||||
tested: true
|
||||
tests:
|
||||
- "documento con entidades y relaciones retorna ExtractionResult completo"
|
||||
|
||||
@@ -17,6 +17,10 @@ returns: []
|
||||
returns_optional: false
|
||||
error_type: "error_go_core"
|
||||
imports: []
|
||||
params:
|
||||
- name: app_name
|
||||
desc: "Nombre de la app cuya operations.db registrar en Metabase"
|
||||
output: "Void - registra la operations.db en Metabase como database SQLite y muestra mount requerido"
|
||||
tested: false
|
||||
tests: []
|
||||
test_file_path: ""
|
||||
|
||||
@@ -21,6 +21,10 @@ returns: []
|
||||
returns_optional: false
|
||||
error_type: "error_go_core"
|
||||
imports: []
|
||||
params:
|
||||
- name: app_name
|
||||
desc: "Nombre de la app para la que crear dashboard operativo"
|
||||
output: "Void - crea dashboard en Metabase con KPIs, distribuciones y tablas de entities/executions/assertions"
|
||||
tested: false
|
||||
tests: []
|
||||
test_file_path: ""
|
||||
|
||||
@@ -16,6 +16,7 @@ returns: []
|
||||
returns_optional: false
|
||||
error_type: "error_go_core"
|
||||
imports: []
|
||||
output: "Void - arregla permisos SQLITE_READONLY_DIRECTORY en contenedor Metabase vía chmod 777/666"
|
||||
tested: false
|
||||
tests: []
|
||||
test_file_path: ""
|
||||
|
||||
@@ -15,6 +15,16 @@ returns: []
|
||||
returns_optional: false
|
||||
error_type: "error_go_core"
|
||||
imports: [numpy]
|
||||
params:
|
||||
- name: n_simulations
|
||||
desc: "Número de simulaciones de mercado a ejecutar"
|
||||
- name: base_params
|
||||
desc: "Parámetros base aplicados a todas las simulaciones"
|
||||
- name: vary_params
|
||||
desc: "Parámetros a variar uniformemente: {param: (min, max)}"
|
||||
- name: seed_start
|
||||
desc: "Seed inicial para generador aleatorio (se incrementa por simulación)"
|
||||
output: "Lista de dicts con parámetros usados y métricas: spreads, trades, volatilidad, PnL"
|
||||
tested: false
|
||||
tests: []
|
||||
test_file_path: ""
|
||||
|
||||
@@ -16,6 +16,28 @@ returns: []
|
||||
returns_optional: false
|
||||
error_type: "error_go_core"
|
||||
imports: [numpy]
|
||||
params:
|
||||
- name: initial_price
|
||||
desc: "Precio inicial del activo"
|
||||
- name: n_ticks
|
||||
desc: "Número de ticks a simular"
|
||||
- name: sigma
|
||||
desc: "Volatilidad del precio fundamental"
|
||||
- name: mu
|
||||
desc: "Drift del precio fundamental"
|
||||
- name: jump_intensity
|
||||
desc: "Intensidad de saltos de Poisson"
|
||||
- name: jump_size_std
|
||||
desc: "Desviación estándar de tamaños de salto"
|
||||
- name: n_makers
|
||||
desc: "Número de market makers"
|
||||
- name: gamma
|
||||
desc: "Parámetro de aversión al riesgo de Avellaneda-Stoikov"
|
||||
- name: hawkes_alpha
|
||||
desc: "Parámetro de excitación del proceso Hawkes"
|
||||
- name: seed
|
||||
desc: "Seed para reproducibilidad"
|
||||
output: "Dict con trades, spreads, midprices, PnL de makers y estadísticas del matching"
|
||||
tested: false
|
||||
tests: []
|
||||
test_file_path: ""
|
||||
|
||||
Reference in New Issue
Block a user