Halaman ini menjelaskan cara menggunakan kemampuan agentic di Mainframe Connector untuk secara otomatis mentranskode dan memigrasikan data mainframe Anda.
Manfaat utama integrasi agentic
Mainframe Connector mendukung platform berbasis agen yang dapat Anda gunakan untuk modernisasi data. Anda dapat menggunakan agen bersama dengan Mainframe Connector untuk memodernisasi data mainframe yang ada di Cloud Storage dan secara lokal. Anda juga dapat menggunakan lingkungan agentik seperti Google Antigravity untuk membuat konfigurasi Mainframe Connector yang diperlukan untuk mentranskode dan memigrasikan data mainframe Anda.
Mengotomatiskan transkode dan migrasi data
Menulis konfigurasi transkode secara manual dapat menimbulkan error dan rumit karena
ketidakcocokan antara struktur COBOL lama (seperti REDEFINES,
COMP-3, dan PIC X), dan database cloud modern (seperti BigQuery).
Kompleksitas ini sering kali menyebabkan kesalahan dalam pemetaan jenis data, penyelarasan byte, dan
terjemahan desimal yang dipadatkan.
Untuk menyederhanakan proses ini, Mainframe Connector mendukung kemampuan agentik—serangkaian alat terfokus (endpoint API dan CLI) dan file kemampuan khusus—yang dirancang untuk digunakan oleh agen yang didukung LLM seperti Google Antigravity. Integrasi ini memungkinkan agen secara mandiri membuat draf, memvalidasi secara ketat, mengoreksi diri sendiri, dan menguji file konfigurasi transkode. Kemudian, agen dapat memigrasikan data yang ada dari Cloud Storage atau penyimpanan lokal ke BigQuery atau database lain, menggunakan konfigurasi yang dihasilkan.
Menggunakan kemampuan agentic di Mainframe Connector memberikan manfaat berikut:
- Pembuatan draf otomatis: Google Antigravity dapat membuat konfigurasi awal berdasarkan copybook COBOL dan aturan bisnis yang ditentukan pengguna.
- Feedback loop yang cepat: Alat validasi bawaan memungkinkan agen menguji konfigurasi dengan cepat dan mengoreksi sendiri kesalahan sebelum memproses data.
- Pemeriksaan tingkat byte: Agen dapat memeriksa data biner mentah untuk mendiagnosis masalah perataan dan encoding.
- Pengujian deterministik: Perintah ringan dan ber-thread tunggal menyediakan lingkungan pengujian yang andal untuk proses penalaran agen.
Sebelum memulai
- Untuk menggunakan kemampuan seperti agen, Anda harus menginstal Mainframe Connector versi terbaru. Kemampuan agentic tersedia mulai dari versi 5.20.
- Untuk menjalankan keterampilan agen, Anda harus menginstal CLI atau lingkungan agentik seperti Google Antigravity di mesin yang sama tempat Anda menginstal Mainframe Connector.
Ekstrak file keterampilan agen ke folder keterampilan lingkungan Anda dengan perintah berikut:
java -jar mainframe-connector.jar agent skill-file --output-dir SKILLS_FOLDER_PATH
Cara kerja integrasi dengan agen
File keterampilan Mainframe Connector berisi semua informasi yang diperlukan untuk memungkinkan agen membuat, memvalidasi, dan menguji transkode konfigurasi mainframe copybook dan file data. CLI ini mengabstraksi perintah CLI Mainframe Connector yang mendasarinya dan menyediakan antarmuka yang disederhanakan bagi agen untuk berinteraksi dengan produk.
Saat Anda meminta agen menggunakan file keterampilan, Anda mengizinkan agen menjalankan perintah Mainframe Connector versi yang dioptimalkan AI. Jika Anda memberikan copybook dan data contoh, agen dapat membuat file konfigurasi transkode dan memvalidasinya terhadap data sebenarnya. Dalam perintah Anda, pastikan Anda memberikan konteks dan aturan khusus yang harus diterapkan agen dalam transkode.
Alur kerja agentic
Alur kerja agentik terdiri dari lima fase, yang memungkinkan agen berkembang dari permintaan awal pengguna hingga konfigurasi yang berfungsi dan tervalidasi. Setelah perintah pengguna, agen dapat menyelesaikan langkah-langkah berikut secara mandiri.
| Fase | Deskripsi |
|---|---|
| Inisiasi | Pengguna meminta agen untuk membuat file konfigurasi transkode. Pengguna dapat secara opsional memberikan copybook COBOL, aturan bisnis kustom (seperti "hapus semua kolom FILLER"), dan data EBCDIC sampel opsional. |
| Penyusunan |
Agen membaca referensi configuration-doc untuk
memahami aturan pemformatan, lalu membuat file
konfigurasi draf.
|
| Validasi |
Agen memvalidasi sintaksis dan struktur draf dengan menjalankan
validate-configuration, memperbaiki error, dan memverifikasi
cetak biru struktural.
|
| Pengujian |
Jika data sampel disediakan, agen akan menguji konfigurasi dengan
menjalankan simple-encode atau simple-decode, dan
menggunakan inspect-data untuk memverifikasi bahwa output sesuai dengan
ekspektasi.
|
| Selesaikan |
Agen membuat DDL target menggunakan
generate-target-ddl, dan menampilkan konfigurasi
dan DDL yang berfungsi kepada pengguna.
|
Kasus penggunaan
Contoh berikut menggambarkan cara Anda dapat menggunakan kemampuan seperti agen untuk mentranskode dan memigrasikan data Anda.
Contoh 1: Membuat skema data untuk BigQuery menggunakan copybook
Perintah contoh berikut menunjukkan cara menggunakan kemampuan seperti agen untuk mentranskode data dari copybook mainframe dan membuat tabel BigQuery.
Contoh perintah
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.
Contoh 2: Mengupload data ke BigQuery setelah melakukan transkode
Perintah berikut menunjukkan cara menggunakan kemampuan seperti agen untuk mengupload data yang ditranskode dari contoh sebelumnya ke BigQuery.
Contoh perintah
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`.
Contoh 3: Men-deploy ke database PostgreSQL dengan kontrol privasi
Perintah berikut menunjukkan cara menggunakan kemampuan seperti agen untuk men-deploy data yang ditranskode dari contoh sebelumnya ke PostgreSQL, sekaligus menghapus data PII.
Contoh perintah
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.
Agentic Command Suite
Perintah berikut dirancang untuk agen LLM.
agent configuration-doc
Menampilkan dokumen konfigurasi untuk agen LLM ke stdout.
Synopsis
agent configuration-doc [-h]
Flag dan argumen
Perintah agent configuration-doc menggunakan flag dan argumen berikut:
--helpatau-h- (Opsional) Menampilkan pesan bantuan ini.
agent inspect-data
Membaca satu catatan logis yang dimulai pada offset byte tertentu, lalu mencetak dump hex dan representasi teksnya.
Synopsis
agent inspect-data [-h] [--byte-offset=BYTEOFFSET]
--input=INPUTPATH
Flag dan argumen
Perintah agent inspect-data menggunakan flag dan argumen berikut:
--byte-offset=BYTEOFFSET- (Opsional) Tentukan offset byte absolut dalam file untuk mulai membaca. Nilai defaultnya adalah 0.
--helpatau-h- (Opsional) Menampilkan pesan bantuan ini.
--input=INPUTPATH : DataPath- Tentukan jalur data input.
agent simple-decode
Mendekode beberapa baris file mainframe ke stdout untuk proses debug agen.
Synopsis
agent simple-decode [-h] [--byte-offset=BYTEOFFSET]
--copybook=COPYBOOKPATH
--input=INPUTPATH
[--limit=LIMIT]
[--output=OUTPUTPATH]
--transcode-configuration=CONFIGPATH
Flag dan argumen
Perintah agent simple-decode menggunakan flag dan argumen berikut:
--byte-offset=BYTEOFFSET- (Opsional) Tentukan offset byte absolut dalam file input untuk mulai membaca. Nilai defaultnya adalah 0.
--copybook=COPYBOOKPATH : DataPath- Tentukan jalur data copybook.
--helpatau-h- (Opsional) Menampilkan pesan bantuan ini.
--input=INPUTPATH : DataPath- Tentukan jalur data input.
--limit=LIMIT- (Opsional) Tentukan jumlah maksimum rekaman yang akan dicoba didekode. Rekaman yang dihilangkan oleh
record_filter_conditiontetap dihitung dalam batas ini. Nilai defaultnya adalah 5. --output=OUTPUTPATH : DataPath- (Opsional) Tentukan tujuan untuk output JSON yang didekode. Jika tidak diberikan, setelan defaultnya adalah
stdout. --transcode-configuration=CONFIGPATH : DataPath- Tentukan jalur data konfigurasi transcoding. Untuk mengetahui informasi selengkapnya tentang format konfigurasi transkoder, lihat konfigurasi transkoder.
agent simple-encode
Mengenkode kembali file JSON ke dalam data biner EBCDIC mainframe.
Synopsis
agent simple-encode [-h] --copybook=COPYBOOKPATH
--input=INPUTPATH
--output=OUTPUTPATH
--transcode-configuration=CONFIGPATH
Flag dan argumen
Perintah agent simple-encode menggunakan flag dan argumen berikut:
--copybook=COPYBOOKPATH : DataPath- Tentukan jalur data copybook.
--helpatau-h- (Opsional) Menampilkan pesan bantuan ini.
--input=INPUTPATH : DataPath- Tentukan jalur data JSON input.
--output=OUTPUTPATH : DataPath- Tentukan jalur data biner output.
--transcode-configuration=CONFIGPATH : DataPath- Tentukan jalur data konfigurasi transcoding. Untuk mengetahui informasi selengkapnya tentang format konfigurasi transkoder, lihat konfigurasi transkoder.
agent validate-configuration
Memvalidasi konfigurasi transkoder terhadap aturan copybook dan database.
Synopsis
agent validate-configuration [-h] --copybook=COPYBOOKPATH
--database=DATABASE
--transcode-configuration=CONFIGPATH
Flag dan argumen
Perintah agent validate-configuration menggunakan flag dan argumen berikut:
--copybook=COPYBOOKPATH : DataPath- Tentukan jalur data copybook.
--database=DATABASE- Tentukan database target (misalnya,
BIGQUERY,POSTGRES,MYSQL). --helpatau-h- (Opsional) Menampilkan pesan bantuan ini.
--transcode-configuration=CONFIGPATH : DataPath- Tentukan jalur data yang berisi konfigurasi transkode draf. Untuk mengetahui informasi selengkapnya tentang format konfigurasi transkoder, lihat Konfigurasi transkoder.