En esta página, se explica cómo puedes usar las capacidades de agentes en Mainframe Connector para transcodificar y migrar automáticamente tus datos de la unidad central.
Beneficios clave de la integración de agentes
Mainframe Connector admite una superficie de agentes que puedes usar para la modernización de datos. Puedes usar agentes en combinación con Mainframe Connector para modernizar tus datos existentes de la unidad central en Cloud Storage y de forma local. También puedes usar entornos de agentes, como Google Antigravity, para crear las configuraciones de Mainframe Connector necesarias para transcodificar y migrar tus datos de la unidad central.
Automatiza la transcodificación y la migración de datos
Escribir configuraciones de transcodificación de forma manual puede ser complejo y propenso a errores debido a la falta de coincidencia entre las estructuras de COBOL heredadas (como REDEFINES, COMP-3 y PIC X) y las bases de datos modernas en la nube (como BigQuery).
Esta complejidad suele generar errores en la asignación de tipos de datos, la alineación de bytes y la traducción de decimales empaquetados.
Para simplificar este proceso, Mainframe Connector admite capacidades de agentes, un conjunto de herramientas enfocadas (extremos de API y CLI) y un archivo de habilidades dedicado, diseñado para que lo usen agentes potenciados por LLM, como Google Antigravity. Esta integración permite que un agente redacte, valide de forma estricta, corrija automáticamente y pruebe archivos de configuración de transcodificación de forma autónoma. Luego, el agente puede migrar tus datos existentes de Cloud Storage o de un almacenamiento local a BigQuery o a otras bases de datos con las configuraciones generadas.
El uso de capacidades de agentes en Mainframe Connector proporciona los siguientes beneficios:
- Redacción automatizada: Google Antigravity puede generar la configuración inicial en función de un copybook de COBOL y reglas de negocios definidas por el usuario.
- Ciclos de retroalimentación rápidos: Las herramientas de validación integradas permiten que el agente pruebe rápidamente las configuraciones y corrija automáticamente los errores antes de procesar los datos.
- Inspección a nivel de bytes: El agente puede inspeccionar datos binarios sin procesar para diagnosticar problemas de alineación y codificación.
- Pruebas deterministas: Los comandos ligeros de un solo subproceso proporcionan un entorno de pruebas confiable para el proceso de razonamiento del agente.
Antes de comenzar
- Para usar las capacidades de agentes, debes instalar la versión más reciente de Mainframe Connector. Las capacidades de agentes están disponibles a partir de la versión 5.20.
- Para ejecutar las habilidades del agente, debes instalar una CLI o un entorno de agentes, como Google Antigravity, en la misma máquina en la que instalaste Mainframe Connector.
Extrae el archivo de habilidades del agente a la carpeta de habilidades de tu entorno con el siguiente comando:
java -jar mainframe-connector.jar agent skill-file --output-dir SKILLS_FOLDER_PATH
Cómo funciona la integración de agentes
El archivo de habilidades de Mainframe Connector contiene toda la información necesaria para permitir que un agente cree, valide y pruebe el copybook de la unidad central y los archivos de datos de configuración de transcodificación. Abstrae los comandos subyacentes de la CLI de Mainframe Connector y proporciona una interfaz simplificada para que el agente interactúe con el producto.
Cuando le solicitas al agente que use el archivo de habilidades, le permites ejecutar versiones optimizadas para IA de los comandos de Mainframe Connector. Si proporcionas el copybook y los datos de muestra, el agente puede crear el archivo de configuración de transcodificación y validarlo con datos reales. En tu solicitud, asegúrate de proporcionar al agente el contexto y las reglas especiales que se deben aplicar en la transcodificación.
Flujo de trabajo de agentes
El flujo de trabajo de agentes consta de cinco fases, lo que permite que el agente avance desde la solicitud inicial del usuario hasta una configuración validada y en funcionamiento. Después de la solicitud del usuario, el agente puede completar los siguientes pasos de forma autónoma.
| Fase | Descripción |
|---|---|
| Inicio | El usuario le solicita al agente que cree un archivo de configuración de transcodificación. De manera opcional, el usuario puede proporcionar un copybook de COBOL, reglas de negocios personalizadas (como "quitar todos los campos FILLER") y datos de muestra de EBCDIC opcionales. |
| Redacción |
El agente lee la referencia configuration-doc para
comprender las reglas de formato y, luego, genera el archivo de configuración de borrador.
|
| Validación |
El agente valida la sintaxis y la estructura del borrador mediante la ejecución de
validate-configuration, la corrección de errores y la verificación del
plano estructural.
|
| Prueba |
Si se proporcionan datos de muestra, el agente prueba la configuración mediante la ejecución de
simple-encode o simple-decode, y
usa inspect-data para verificar que el resultado coincida con
las expectativas.
|
| Finalizar |
El agente genera el DDL de destino con
generate-target-ddl, y le presenta al usuario la configuración y el DDL en funcionamiento.
|
Casos de uso
En los siguientes ejemplos, se muestra cómo puedes usar las capacidades de agentes para transcodificar y migrar tus datos.
Ejemplo 1: Genera esquemas de datos para BigQuery con un copybook
En la siguiente solicitud de muestra, se muestra cómo usar las capacidades de agentes para transcodificar los datos de un copybook de la unidad central y generar una tabla de BigQuery.
Solicitud de muestra
Your task is to produce a transcode configuration file and target DDL for a
mainframe dataset using the Mainframe Connector skill.
You are migrating a master file from a European subsidiary's mainframe into
BigQuery. Each record holds a customer name, a city, and a price.
The source is an EBCDIC extract from a German z/OS system; the system metadata
gives its CCSID as 1140.
The data is staged here in this directory:
- `copybook.cpy`: the COBOL layout.
- `input.dat`: the binary extract itself (CCSID 1140 - the German Euro-enabled
EBCDIC code page).
Produce two artifacts here:
1. `config.json`: the transcode configuration that correctly decodes this file.
2. `schema.sql`: the BigQuery `CREATE TABLE` DDL for the destination.
Ejemplo 2: Sube los datos a BigQuery después de la transcodificación
En la siguiente solicitud, se muestra cómo usar las capacidades de agentes para subir los datos transcodificados del ejemplo anterior a BigQuery.
Solicitud de muestra
Using the Mainframe Connector skill and the config.json and schema.sql files
you created before, migrate the data to BigQuery at
`table_name.dataset_name.project_id`.
Ejemplo 3: Realiza la implementación en una base de datos de PostgreSQL con controles de privacidad
En la siguiente solicitud, se muestra cómo usar las capacidades de agentes para implementar los datos transcodificados del ejemplo anterior en PostgreSQL y quitar los datos de PII.
Solicitud de muestra
Using the Mainframe Connector skill, migrate the data to Cloud SQL for
PostgreSQL at `table_name.schema_name.host_name`.
Compliance constraint: `CUST-NAME` and `CITY` are classified as
personally identifying or residency restricted information. They must NOT
appear in the PostgreSQL CSV staging file, must NOT decode into a JSM
string at any point, and must NOT appear in the Postgres table DDL.
Only `PRICE-TEXT` should appear.
Deliverables in the current working directory:
1. `config-postgres.json`: a NEW transcode configuration (do not overwrite
the BigQuery config.json).
2. `schema-postgres.sql`: the PostgreSQL `CREATE TABLE` DDL for the
destination.
3. `copy-postgres.sql`: the PostgreSQL `COPY FROM` command to load the
data into the table.
Conjunto de comandos de agentes
Los siguientes comandos están diseñados para agentes de LLM.
agent configuration-doc
Muestra el documento de configuración para los agentes de LLM en stdout.
Synopsis
agent configuration-doc [-h]
Marcas y argumentos
El comando agent configuration-doc usa los siguientes argumentos y marcas:
--helpo-h- (Opcional) Muestra este mensaje de ayuda.
agent inspect-data
Lee un solo registro lógico a partir de un desplazamiento de bytes específico y, luego, imprime su volcado hexadecimal y su representación de texto.
Synopsis
agent inspect-data [-h] [--byte-offset=BYTEOFFSET]
--input=INPUTPATH
Marcas y argumentos
El comando agent inspect-data usa los siguientes argumentos y marcas:
--byte-offset=BYTEOFFSET- (Opcional) Especifica el desplazamiento de bytes absoluto dentro del archivo desde el que se comenzará a leer. El valor predeterminado es 0.
--helpo-h- (Opcional) Muestra este mensaje de ayuda.
--input=INPUTPATH : DataPath- Especifica la ruta de acceso de los datos de entrada.
agent simple-decode
Decodifica algunas filas de un archivo de la unidad central a stdout para la depuración del agente.
Synopsis
agent simple-decode [-h] [--byte-offset=BYTEOFFSET]
--copybook=COPYBOOKPATH
--input=INPUTPATH
[--limit=LIMIT]
[--output=OUTPUTPATH]
--transcode-configuration=CONFIGPATH
Marcas y argumentos
El comando agent simple-decode usa los siguientes argumentos y marcas:
--byte-offset=BYTEOFFSET- (Opcional) Especifica el desplazamiento de bytes absoluto en el archivo de entrada desde el que se comenzará a leer. El valor predeterminado es 0.
--copybook=COPYBOOKPATH : DataPath- Especifica la ruta de acceso de los datos del copybook.
--helpo-h- (Opcional) Muestra este mensaje de ayuda.
--input=INPUTPATH : DataPath- Especifica la ruta de acceso de los datos de entrada.
--limit=LIMIT- (Opcional) Especifica la cantidad máxima de registros que se intentarán decodificar. Los registros descartados por
record_filter_conditionaún se cuentan en este límite. El valor predeterminado es 5. --output=OUTPUTPATH : DataPath- (Opcional) Especifica el destino del resultado JSON decodificado. Si no se proporciona, el valor predeterminado es
stdout. --transcode-configuration=CONFIGPATH : DataPath- Especifica la ruta de acceso de los datos de la configuración de transcodificación. Para obtener más información sobre el formato de configuración del transcodificador, consulta la configuración del transcodificador.
agent simple-encode
Vuelve a codificar un archivo JSON en datos binarios EBCDIC de la unidad central.
Synopsis
agent simple-encode [-h] --copybook=COPYBOOKPATH
--input=INPUTPATH
--output=OUTPUTPATH
--transcode-configuration=CONFIGPATH
Marcas y argumentos
El comando agent simple-encode usa los siguientes argumentos y marcas:
--copybook=COPYBOOKPATH : DataPath- Especifica la ruta de acceso de los datos del copybook.
--helpo-h- (Opcional) Muestra este mensaje de ayuda.
--input=INPUTPATH : DataPath- Especifica la ruta de acceso de los datos JSON de entrada.
--output=OUTPUTPATH : DataPath- Especifica la ruta de acceso de los datos binarios de salida.
--transcode-configuration=CONFIGPATH : DataPath- Especifica la ruta de acceso de los datos de la configuración de transcodificación. Para obtener más información sobre el formato de configuración del transcodificador, consulta la configuración del transcodificador.
agent validate-configuration
Valida una configuración de transcodificador con un copybook y reglas de base de datos.
Synopsis
agent validate-configuration [-h] --copybook=COPYBOOKPATH
--database=DATABASE
--transcode-configuration=CONFIGPATH
Marcas y argumentos
El comando agent validate-configuration usa los siguientes argumentos y marcas:
--copybook=COPYBOOKPATH : DataPath- Especifica la ruta de acceso de los datos del copybook.
--database=DATABASE- Especifica la base de datos de destino (p.ej.,
BIGQUERY,POSTGRES,MYSQL). --helpo-h- (Opcional) Muestra este mensaje de ayuda.
--transcode-configuration=CONFIGPATH : DataPath- Especifica la ruta de acceso de los datos que contienen la configuración de transcodificación de borrador. Para obtener más información sobre el formato de configuración del transcodificador, consulta la configuración del transcodificador.