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,16 @@ returns: []
|
||||
returns_optional: false
|
||||
error_type: "error_go_core"
|
||||
imports: [warnings, typing.Callable]
|
||||
params:
|
||||
- name: text
|
||||
desc: "texto fuente para extraccion (ej: documento, parrafo, chunk de OSINT). Puede contener multiples entidades."
|
||||
- name: entity_schema
|
||||
desc: "lista de dicts describiendo tipos validos (ej: [{'type_ref': 'osint_person_go_cybersecurity', 'label': 'Person'}])"
|
||||
- name: llm_chat_json
|
||||
desc: "callable que toma list[dict] con messages OpenAI-format y retorna dict con clave 'entities'. Inyeccion de dependencia del LLM."
|
||||
- name: language_instruction
|
||||
desc: "instruccion de lenguaje para el LLM (defecto: 'Respond in English.'). Ej: 'Responde en Español.'"
|
||||
output: "lista de EntityCandidate extraidas, cada una con name, type_ref, confidence, atributos"
|
||||
tested: true
|
||||
tests:
|
||||
- "texto con entidades claras retorna EntityCandidate"
|
||||
|
||||
Reference in New Issue
Block a user