Volver a proyectos
a2 / Habilidades verificadas y trabajo con datos

De una solución a una habilidad reutilizable.

a2 es un pequeño agente Python que resuelve transformaciones de datos, comprueba los resultados externamente e investiga la reutilización de soluciones aceptadas como habilidades ejecutables con versión. Código, flujo de trabajo, demostración y evaluación reunidos en un portal.

Estado del trabajo0.1.0a1 · versión preliminar técnicaFuentes comprobadas
Etiqueta del código
01

¿Por qué a2?

Resolver una tarea una vez y reutilizar su solución con seguridad en otras entradas son problemas distintos. a2 estudia esa diferencia con un pequeño bucle de agente que puede inspeccionarse. Su ámbito inicial son transformaciones acotadas: normalización de registros, correspondencia de fuentes, detección de conflictos y selección de campos.

Primero, el contrato.
Explicitar entradas, salidas y reglas. Una salida con el formato correcto no garantiza una respuesta correcta.
Comprobar de forma independiente.
Antes de guardar una habilidad derivada de una solución aceptada, se prueba con otras entradas y resultados esperados que no se envían a la conversación del modelo.
La reutilización tiene límites.
Deben coincidir el contrato y la versión de la habilidad. Si cambia el código de un plan revisado, no se sustituye silenciosamente por otra versión.
02

El recorrido de una tarea

Cuatro responsabilidades en torno a un núcleo pequeño

Bucle y memoria

Base + Trace

Construye contexto con el objetivo, las trazas previas y las observaciones de herramientas; elige acciones dentro de los límites de pasos y presupuesto.

Autorización de acciones

Gate

Solicita aprobación para acciones arriesgadas del agente general. La aprobación no es aislamiento a nivel de sistema operativo.

Comprobación de salidas

Auditor

Distingue el formato de la corrección frente a resultados esperados independientes. Sin referencia, schema_only no demuestra corrección.

Persistencia y reutilización

Skills

Guarda contrato, procedencia, versión, hash del código y verificaciones, con vías de revisión, desactivación y reversión.

De la tarea a un registro inspeccionable

  1. 01

    Contrato y resultado esperado independiente

    La persona responsable define el significado de los datos y el resultado aceptable.

  2. 02

    Solución y habilidad candidata

    En el aprendizaje con modelo se resuelve la tarea y se genera una candidata a partir de una solución aceptada. La demo utiliza habilidades escritas por personas.

  3. 03

    Verificación con otras entradas

    Antes de guardar se exigen al menos dos comprobaciones distintas aportadas por quien llama; el aprendizaje de datos integrado usa tres tareas de verificación separadas.

  4. 04

    Reutilización con versión fijada

    La habilidad se ejecuta directamente o mediante un plan explícito. Una propuesta del modelo no se ejecuta sola; un cambio de versión detiene la ejecución.

  5. 05

    Salida y registro de evaluación

    Calidad, llamadas, latencia y tokens observados se informan por separado. Una evaluación incompleta no se convierte en una afirmación de éxito.

Este es un mapa de uso. No todas las ejecuciones pasan por todas las etapas: la demo sin conexión y la reutilización directa no llaman a modelos; aprendizaje y propuesta de planes son vías distintas.

Tres usos concretos

Exportaciones de clientes de dos sistemas
Conciliar CSV de CRM y ERP mediante coincidencia exacta de códigos únicos compartidos. La demo sintética de dos días muestra coincidencias y registros pendientes de revisión, sin conector a sistemas reales.
La misma regla, otro archivo mañana
Aplicar una habilidad verificada de selección o correspondencia a nuevas entradas. Si el contrato no coincide, se detiene sin recurrir automáticamente al modelo; una referencia permite comprobar la corrección.
Cambia la habilidad de un plan revisado
Los planes nuevos fijan identificadores de habilidades y hashes del código. Una versión cambiada o no disponible detiene el plan antes del primer paso.
03

Primera ejecución

Empieza con la demo CRM/ERP que no necesita modelo. Obtén el código en tu espacio local; esta instalación es para Linux o macOS y Python 3.11 o posterior. La página no ejecuta estos comandos.

  1. 01

    Descarga o clona la etiqueta v0.1.0a1, crea un entorno virtual e instala el paquete.

  2. 02

    Ejecuta la demo de clientes sintéticos en un directorio de salida nuevo. No necesita clave API ni llamadas a modelos.

  3. 03

    Abre runs/customer-demo/report.html e inspecciona planes, coincidencias, incidencias y la comprobación de cambio de versión.

Instalación local desde la etiqueta

git clone --branch v0.1.0a1 --single-branch https://github.com/omasim/a2.git
cd a2
python -m venv .venv
source .venv/bin/activate
python -m pip install -e .

Demo de presentación sin API

python -m a2.customer_demo --output runs/customer-demo --compact

Ejecuta los comandos en la misma terminal desde la carpeta del código. Elige una salida nueva al repetir. La demo reutiliza las mismas dos habilidades verificadas escritas por personas en dos lotes sintéticos; no demuestra aprendizaje del modelo ni validación con clientes reales. Para inspeccionar habilidades persistentes, consulta data init --with-demo-skills en el README.

04

Artículos relacionados

05

Documentos y enlaces

Código y versión

Etiqueta verificada, archivo de código y commit revisado.

Arquitectura y habilidades

Bucle central, contratos y ciclo de vida de habilidades.

Inicio y demostración

De la instalación a la inspección de ejemplos sintéticos.

Experimentos y evaluación

Medición, requisitos pendientes y protocolo de piloto real.

Contribución y seguridad

Historial de CI, incidencias, contribución y licencia.

Documentos de publicación

Alcance preliminar y preparación de la publicación.

06

Estado y límites

En la comprobación del 22 de octubre de 2026, el repositorio es público, tiene licencia MIT y dispone de la etiqueta v0.1.0a1. Las ejecuciones recientes de CI fueron satisfactorias. GitHub Releases no tiene una entrada de versión separada; la descarga apunta al ZIP del código etiquetado. La versión preliminar no equivale a una aceptación completa para lanzamiento general.

La documentación registra cuatro familias de habilidades verificadas independientemente en un ensayo acotado de aprendizaje con modelo. Un piloto de desarrollo pequeño e incompleto no mostró ventaja de eficiencia. Siguen pendientes la evaluación completa con habilidades fijadas y varias semillas, y la validación con usuarios reales. El ejecutor restringido no es un aislamiento del sistema operativo para Python arbitrario y hostil.

Demo sintética ≠ aprendizaje del modelo. Formato válido ≠ corrección semántica. CI satisfactorio ≠ aceptación completa de usuarios o del lanzamiento.

El portal se basa en README, arquitectura, habilidades, evaluación y documentos públicos del mismo commit que v0.1.0a1. No se ejecutó un nuevo experimento con modelo ni una llamada de pago. La documentación está principalmente en inglés; la guía de demo y algunos textos de publicación están en turco.

Texto existente del proyecto y fuentes fechadas

El registro editable inferior conserva el resumen anterior del 13 de octubre de 2026. Sus afirmaciones previas a la publicación son históricas; el estado actual del código aparece arriba.

Pregunta

¿Puede una solución correcta convertirse en una habilidad reutilizable en otras tareas? a2 investiga esta cuestión mediante transformaciones de datos.

Partes operativas

Combina herramientas, memoria compartida, validación de salidas y habilidades ejecutables. Las tareas actuales incluyen normalización, comparación de fuentes, detección de conflictos y selección de campos. Los candidatos deben superar comprobaciones externas con entradas independientes antes de guardarse.

Evaluación

Las habilidades aprendidas se fijan y se comparan en tareas separadas con resolución sin historial, ejemplos previos, habilidades escritas por personas y habilidades no relacionadas. Se registran por separado calidad, latencia, llamadas y uso observado de tokens.

Estado y límites

La documentación revisada el 13 de octubre de 2026 describe una alfa de desarrollo. La demostración sin conexión reutiliza habilidades escritas por personas y no demuestra aprendizaje del modelo. Un ensayo acotado registró habilidades verificadas; un piloto de desarrollo incompleto no mostró ventaja de eficiencia. La evaluación fijada con varias semillas y la validación con usuarios siguen pendientes. Publicar esta página no equivale a lanzar el paquete de software.

Fuentes

Resumen del README y los documentos de arquitectura y evaluación de a2, revisados el 13 de octubre de 2026. No se ejecutó un nuevo experimento.

07

Conceptos del Atlas