Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Personalizzato
Cosa è AWS Trasforma personalizzata?
AWS Transform custom utilizza l'intelligenza artificiale agentica per eseguire la modernizzazione su larga scala di software, codice, librerie e framework per ridurre il debito tecnico. Gestisce diversi scenari, tra cui aggiornamenti delle versioni linguistiche, migrazioni di API e servizi, aggiornamenti e migrazioni del framework, refactoring del codice e trasformazioni specifiche dell'organizzazione.
Attraverso l'apprendimento continuo, l'agente migliora in base a ogni feedback relativo all'esecuzione e agli sviluppatori, offrendo trasformazioni ripetibili e di alta qualità senza richiedere competenze di automazione specializzate.
Funzionalità chiave
AWS Transform custom offre le seguenti funzionalità:
Definizione di trasformazione basata sul linguaggio naturale - Crea trasformazioni personalizzate utilizzando linguaggio naturale, documentazione ed esempi di codice
Esecuzione della trasformazione - Applica le trasformazioni in modo coerente e affidabile su più basi di codice
Apprendimento continuo - Migliora automaticamente la qualità della trasformazione da ogni esecuzione
AWS-trasformazioni gestite - Pronto all'uso, AWS-trasformazioni controllate per scenari comuni
Modelli di trasformazione
AWS Transform custom supporta diversi modelli di trasformazione per soddisfare le vostre esigenze di modernizzazione. Ogni modello presenta caratteristiche di complessità diverse in base all'ambito e alla natura delle modifiche richieste.
| Pattern | Description | Complessità | Esempi |
|---|---|---|---|
| Migrazioni di API e servizi | Migrazione tra versioni API o servizi equivalenti mantenendo la funzionalità | Medium | AWS SDK v1→v2 (Java, Python, JavaScript), Boto2→Boto3, JUnit 4→5, javax→Giacarta |
| Aggiornamenti della versione linguistica | Aggiornamento a versioni più recenti dello stesso linguaggio di programmazione, adozione di nuove funzionalità e sostituzione di funzionalità obsolete | Low-Medium | Java 8→17, Python 3.9→3.13, Node.js 12 → 22, TypeScript aggiornamenti della versione |
| Aggiornamenti del framework | Aggiornamento a versioni più recenti dello stesso framework, risoluzione delle principali modifiche | Medium | Spring Boot 2.x→3.x, React 17→18, aggiornamenti Angular, aggiornamenti Django |
| Migrazioni del framework | Migrazione verso framework completamente diversi che hanno scopi simili | Elevata | Angular→React, Redux→Condizione, Vue.js→ Reagire |
| Aggiornamenti della libreria e delle dipendenze | Aggiornamento delle librerie di terze parti a versioni più recenti mantenendo lo stesso linguaggio e lo stesso framework | Low-Medium | Pandas 1.x→2.x, NumPy aggiornamenti, Hadoop/HBase/Hive aggiornamenti della libreria, aggiornamenti Lodash |
| Refactoring del codice e modernizzazione dei pattern | Modernizzazione dei modelli di codice e adozione delle migliori pratiche senza modificare le funzionalità esterne | Low-Medium | Stampa → Framework di registrazione, concatenazione di stringhe → stringhe f, adozione di suggerimenti sui tipi, strumentazione per l'osservabilità |
| Script e File-by-File Traduzioni | Traduzione di script o file di configurazione indipendenti in cui i file sono per lo più autonomi | Low-Medium | AWS CDK → Terraform, Terraform →CloudFormation, Excel→Notebook Python, Bash→PowerShell |
| Migrazioni di architettura | Migrazione tra architetture hardware o ambienti di runtime con modifiche minime al codice | Medium-High | x86→AWS Graviton (ARM), on-premise→Lambda, server tradizionale→contenitori |
| Language-to-Language Migrazioni | Traduzione di basi di codice da un linguaggio di programmazione a un altro | Molto alto | Java→Python, JavaScript→TypeScript, C→Rust, Python→Vai |
| Personalizzato e Organization-Specific Trasformazioni | Requisiti organizzativi unici ed esigenze di modernizzazione specializzate | Può variare | Migrazioni personalizzate delle librerie interne, standard di codifica specifici dell'organizzazione, migrazioni di framework proprietari |
Per COBOL/mainframe lingue, uso AWS Transform for Mainframe. Per gli aggiornamenti di.NET Framework a .NET Core, prendi in considerazione AWS Transform per Windows. Per le migrazioni da VMware a AWS, considera AWS Transform per VMware.
In che modo AWS Trasforma Works personalizzati
AWS Transform custom viene solitamente utilizzato in progetti su larga scala in cui vengono trasformate più basi di codice o moduli. I team in genere seguono un flusso di lavoro in quattro fasi:
Definisci la trasformazione - Fornisci istruzioni in linguaggio naturale, documentazione ed esempi di codice all'agente, che genera una definizione di trasformazione iniziale. Questa definizione può essere perfezionata in modo iterativo tramite chat o modifiche dirette. Questa fase può essere saltata quando si utilizza AWS-trasformazioni gestite.
Pilota o Proof-of-Concept - Testa la trasformazione su basi di codice di esempio e perfeziona in base ai risultati. Questa fase di convalida aiuta a stimare il costo e l'impegno della trasformazione completa. L'apprendimento continuo migliora la qualità durante questa fase.
Esecuzione su scala - Imposta l'esecuzione automatica in blocco utilizzando la CLI, con gli sviluppatori che esaminano e convalidano i risultati. Monitora i progressi utilizzando l'applicazione web e tieni traccia delle trasformazioni su più repository.
Monitora e rivedi - L'apprendimento continuo migliora automaticamente la qualità della trasformazione. Rivedi le lezioni estratte dalle sessioni precedenti per assicurarti che soddisfino gli standard di qualità e archivia quelle non utili.
Comprensione dei concetti chiave di
Questa sezione spiega i concetti chiave con cui lavorare AWS Trasforma personalizzata.
Definizioni di trasformazione
A definizione di trasformazione contiene le istruzioni e le conoscenze necessarie per eseguire una trasformazione specifica del codice. È rappresentata come un'abilità e consiste in:
SKILL.md(obbligatorio) - Istruzioni in Markdown con YAML frontmatter (nameedescriptioncampi) che contiene la logica di trasformazione di base e le istruzioni di esecuzionereferences/cartella (opzionale): documentazione caricata secondo necessità durante l'esecuzione della trasformazionescripts/cartella (opzionale): script che la trasformazione scarica ed esegue durante l'esecuzione
AWS Transform CLI scarica automaticamente le definizioni di trasformazione nella directory corrente quando sono necessarie per l'esecuzione, l'ispezione o la modifica.
Quando si pubblica una trasformazione, la directory deve contenere solo SKILL.md e, facoltativamente, references/ cartella, scripts/ cartella o entrambe. Non sono consentiti altri file o sottodirectory.
La versione CLI 2.0 e successive utilizza il formato skills. Le definizioni di trasformazione esistenti vengono gestite automaticamente dalla CLI.
Categorie di definizione delle trasformazioni
Una definizione di trasformazione può avere un categoria che dice come viene utilizzato:
analysis— Legge il codice e riporta i risultati. La modernizzazione continua esegue queste definizioni di trasformazione come analisi personalizzata.remediation— Modifica il codice. La modernizzazione continua utilizza queste definizioni di trasformazione per correggere i risultati e le analisi personalizzate e relative al debito tecnologico possono corrispondere ai risultati.
Imposta la categoria con --category opzione di atx custom def publish o atx custom def save-draft:
atx custom def publish -n <transformation-name> --description "Description" --sd <directory> --category analysis atx custom def publish -n <transformation-name> --description "Description" --sd <directory> --category remediation atx custom def list # The Category column shows each transformation definition's category
AWS Transform utilizza la categoria per decidere dove è possibile utilizzare una definizione di trasformazione.
| Utilizzo | Definizioni di trasformazione consentite |
|---|---|
Analisi personalizzata (--type custom) |
Le tue definizioni di trasformazione con analysis categoria |
Risanamento con --transformation-name |
Le tue definizioni di trasformazione con remediation categoria, o AWS trasformazioni gestite |
| Trasformazione abbinata a un risultato derivante da un'analisi personalizzata o del debito tecnologico | Le tue definizioni di trasformazione con remediation categoria, o AWS trasformazioni gestite. Una scoperta non è mai abbinata a una definizione di trasformazione con analysis categoria o senza categoria. |
Prima di inviare un'analisi, una pianificazione o una correzione personalizzate, AWS Transform verifica la categoria della definizione di trasformazione.
Per far sì che i risultati siano abbinati ai tuoi remediation definizione di trasformazione, metti all'inizio cosa cambia. Un'analisi legge innanzitutto solo l'inizio di ogni definizione per decidere quali considerare e legge solo il testo completo di quelle. Inizia con un titolo e un breve ambito che indichino cosa cambia e dove (ad esempio, quali lingue o file) e limita ogni definizione a un tipo di modifica. Consulta Abbinamento dei risultati alle trasformazioni.
Per modificare la categoria di una definizione di trasformazione, pubblicala nuovamente con un'altra --category valore. Se pubblichi una nuova versione senza --category, la nuova versione mantiene la categoria della versione precedente.
Per sapere come eseguire un analysis definizione di trasformazione, vedere Analisi personalizzata.
Una categoria è diversa da un tag di risorsa. Per gestire i tag delle risorse, vedi Comandi di etichettatura.
Scrivere una definizione di trasformazione per l'analisi
Per ottenere risultati utili, scrivi la definizione di trasformazione in modo che descriva cosa cercare, come classificare ogni problema e cosa non fare. Consigliamo le seguenti sezioni in SKILL.md.
| Sezione | Cosa includere |
|---|---|
| Introduzione | Una o due frasi che indicano ciò che l'analisi rileva. Indica che è di sola lettura e non deve modificare alcun file. |
| Criteri di ingresso | Quando si applica l'analisi, ad esempio «L'archivio contiene un pom.xml o build.gradle archivio.» |
| Scope | I file e le directory da ispezionare e quelli da ignorare, ad esempio l'output della compilazione e le dipendenze fornite dai fornitori. |
| Cosa segnalare | I modelli o le condizioni specifici che contano come problema. Richiedi una risposta per problema, con il percorso del file e il numero di riga. |
| Categories | Un piccolo set fisso di valori di categoria e i problemi che appartengono a ciascuna categoria. |
| Criteri di gravità | Cosa causa un problema high, medium, o low. |
| Criteri di uscita | L'agente sa come è stato eseguito: ogni file incluso nell'ambito è stato ispezionato, ogni risultato ha un file, una categoria e un livello di gravità e nessun file è stato modificato. Indica inoltre cosa segnalare quando non viene trovato nulla. |
L'esempio seguente trova i progetti Java che hanno ancora come target una versione di Java precedente alla 17.
--- name: java-version-detector description: Report where a repository still targets a Java version earlier than 17, in build files, Dockerfiles, toolchain files, and CI workflows. Analysis only - no code is modified. --- # Java Version Detector Find where the repository targets a Java version earlier than Java 17. This is a read-only analysis: report findings, and do not modify any files. ## Entry Criteria The repository contains a Java build file (`pom.xml`, `build.gradle`, `build.gradle.kts`, or `gradle.properties`), or a file that selects a JDK (`.java-version`, `.tool-versions`, `.sdkmanrc`, a `Dockerfile`, or a file under `.github/workflows/`). ## Scope - Inspect build files, toolchain files, Dockerfiles, and CI workflow files. - Skip build output (`build/`, `target/`) and vendored dependencies. ## What to Report Report one finding for each place that selects a Java version earlier than 17: 1. A compile target, such as `maven.compiler.source`, `maven.compiler.release`, `java.version`, `sourceCompatibility`, or a Gradle toolchain `languageVersion`. 2. A Dockerfile base image that ships a JDK or JRE earlier than 17, such as `openjdk:8` or `amazoncorretto:11`. 3. A CI job or toolchain file that selects a JDK earlier than 17. For each finding, include the file path, the line number, and the version you found. ## Categories - `outdated-compile-target` - a build file compiles for an old Java version - `outdated-runtime-image` - a Dockerfile uses an old JDK or JRE image - `outdated-ci-jdk` - a CI workflow or toolchain file selects an old JDK ## Severity Criteria - **high** - the project compiles for Java 8 or earlier - **medium** - the project compiles for Java 9 through 16 - **low** - only the runtime image or CI uses an old JDK, and the compile target is 17 or later ## Exit Criteria 1. Every in-scope file has been inspected. 2. Every finding has a file path, line number, category, and severity from the lists above. 3. No file in the repository has been modified. 4. If nothing is found, state that the repository targets Java 17 or later.
Quando questa definizione di trasformazione viene eseguita su un progetto il cui pom.xml sets <source>1.8</source>, produce un high rilevazione della gravità nel outdated-compile-target categoria, abbinata al AWS/java-version-upgrade trasformazione.
Suggerimenti per scrivere analisi, definizioni di trasformazione
Mantienilo in sola lettura. Indica esplicitamente che l'analisi non deve modificare i file. Risolvere i problemi è il compito di porvi rimedio.
Sii specifico su ciò che è considerato un problema. Assegna un nome ai file, alle impostazioni e ai pattern da cercare. Istruzioni vaghe producono risultati incoerenti.
Richiedi un risultato per numero. Ogni risultato deve fare riferimento a un file e a una riga specifici in modo che possa essere esaminato e corretto individualmente.
Definisci la gravità e le categorie nella definizione della trasformazione. L'agente utilizza i tuoi criteri per classificare ogni risultato.
Mantieni l'ambito focalizzato. Un'analisi personalizzata riporta solo ciò che descrive la relativa definizione di trasformazione. Per individuare molti tipi di problemi, scrivete definizioni di trasformazione separate o utilizzate i tipi di analisi integrati.
Dite cosa fare quando non viene trovato nulla. Un archivio che non presenta problemi produce correttamente zero risultati.
Includete le istruzioni di ricerca nella definizione della trasformazione. Se si passa la configurazione con
-go--configurationquando si esegue l'analisi, AWS Transform utilizza la configurazione anziché le istruzioni predefinite. Mantenere la sezione «Cosa segnalare» inSKILL.mdfa sì che la definizione della trasformazione produca risultati in entrambi i casi.
Verifica la definizione di trasformazione su un repository che conosci contiene il problema prima di pubblicarlo. Salvala come bozza con atx custom def save-draft, oppure eseguilo localmente con atx ct analysis run (vedi Analisi personalizzata).
Registro delle trasformazioni
Il registro delle trasformazioni è tuo AWS l'archivio centralizzato dell'account per l'archiviazione e la gestione delle definizioni di trasformazione. Le trasformazioni nel registro possono essere:
Elencato utilizzando
atx custom def listEseguito su più basi di codice
Condiviso con altri utenti nel tuo AWS conto
Version-controlled
Le definizioni di trasformazione sono specifiche dell'account. Se desideri utilizzare una trasformazione in un'altra AWS account, devi pubblicarlo separatamente in quell'account.
Bozza e trasformazioni pubblicate
AWS Transform custom supporta due stati per le trasformazioni nel registro:
Bozza di trasformazioni sono definizioni di trasformazione in corso o non testate. Vengono salvate come versioni specifiche e possono essere recuperate, aggiornate ed eseguite dagli utenti che fanno riferimento a quella versione specifica. Le bozze sono utili per lo sviluppo, il test e il perfezionamento iterativi prima che la trasformazione sia pronta per essere condivisa con il team. Le bozze sono anche associate a una conversazione specifica. Se riavvii la CLI, puoi usare atx --conversation-id {id} per ripristinarne uno precedente.
Trasformazioni pubblicate sono disponibili nel registro di trasformazione del tuo account per l'esecuzione da parte di altri utenti con le autorizzazioni IAM richieste. Le trasformazioni pubblicate possono essere scoperte utilizzando atx custom def list.
Il flusso di lavoro tipico è:
Crea una trasformazione a livello locale
Salva come bozza per il test (
atx custom def save-draft)Perfeziona e convalida
Pubblica per condividerla con il tuo team (
atx custom def publish)
Puoi anche pubblicare una trasformazione direttamente senza salvarla come bozza.
Riferimenti e lezioni
AWS Transform custom utilizza due tipi di conoscenze per migliorare la qualità della trasformazione:
Riferimenti la documentazione fornita dall'utente è archiviata nel references/ cartella di una definizione di trasformazione. I riferimenti supportano solo i file di testo (massimo 10 MB in totale per tutti i file) e di solito contengono documentazione, specifiche API, guide alla migrazione ed esempi di codice. I riferimenti vengono caricati in base alle esigenze durante l'esecuzione della trasformazione. I riferimenti vengono aggiunti durante la creazione o l'aggiornamento di una definizione di trasformazione in modalità interattiva.
Lezioni vengono estratte automaticamente dalle precedenti esecuzioni di una trasformazione. Il sistema di apprendimento continuo li genera in base alle traiettorie di esecuzione, al feedback degli sviluppatori e alle correzioni di codice che incontra durante le trasformazioni. Raggruppa le lezioni correlate in categorie in modo da poterle rivedere insieme. A differenza dei riferimenti, che fornisci in anticipo, le lezioni si accumulano nel tempo man mano che esegui la trasformazione su diverse basi di codice e il sistema le applica automaticamente per migliorare le esecuzioni future. Rivedi e gestisci le lezioni in modo interattivo con atx custom def learnings.
Comandi di compilazione e convalida
I comando di compilazione o convalida è un parametro opzionale che specifica come convalidare il codice durante il processo di trasformazione. Questo comando viene eseguito in vari punti durante la trasformazione per garantire l'integrità del codice.
Fornire un comando che convalidi i risultati e restituisca i problemi in caso di fallimento della convalida è molto importante per migliorare la qualità della trasformazione attraverso l'apprendimento continuo. Se non è necessaria alcuna compilazione o convalida, ometti l'input.
Per esempi e linee guida dettagliate, consulta Comandi di compilazione e convalida nella sezione Flussi di lavoro.
Apprendimento continuo
Apprendimento continuo è il sistema che acquisisce automaticamente il feedback da ogni esecuzione di trasformazione e migliora la qualità della trasformazione nel tempo. Il sistema raccoglie informazioni tramite:
Feedback esplicito: commenti e correzioni di codice forniti in modalità interattiva
Osservazioni implicite: problemi riscontrati dall'agente durante la trasformazione e il debug del codice
Il sistema di apprendimento continuo elabora queste informazioni per creare lezioni che aggiunge alla definizione di trasformazione per migliorare le trasformazioni future. Il sistema esegue il processo di apprendimento automaticamente dopo il completamento delle trasformazioni, senza richiedere input aggiuntivi da parte dell'utente.
Le lezioni sono specifiche della trasformazione e non vengono condivise tra diverse trasformazioni o diversi account cliente.
Gestione delle lezioni
Il sistema genera lezioni automaticamente, ma tu hai il controllo di quelle da applicare alle sessioni future. Il atx custom def learnings Il comando apre una sessione terminale interattiva per la revisione e la cura delle lezioni accumulate da una trasformazione.
In questa sessione, puoi:
Sfoglia le lezioni raggruppate in categorie e scopri quante lezioni attive contiene ciascuna categoria.
Apri una lezione per leggerne tutti i dettagli, incluso il corpo della lezione, il suo impatto e il numero di sessioni precedenti in cui è stata consultata.
Archivia una lezione per evitare che il sistema la applichi a esecuzioni future e ripristinala in un secondo momento, se necessario.
Elimina definitivamente una lezione archiviata che non è più utile.
Per istruzioni dettagliate, consulta Apprendimento continuo.
Client-Side Competenze
Client-side abilità sono funzionalità aggiuntive che estendono l'agente durante le esecuzioni di trasformazione. A differenza delle definizioni di trasformazione che definiscono la trasformazione da eseguire, le competenze rivolte al cliente forniscono strumenti, script e istruzioni supplementari che l'agente può utilizzare insieme alle funzionalità integrate durante qualsiasi trasformazione.
Client-side le competenze vengono scoperte dagli elenchi a livello di progetto e a livello di utente. Posiziona le competenze a livello di progetto quando applicano gli standard specifici di un repository e a livello di utente quando si applicano a tutti i tuoi progetti. Project-level le competenze sono disponibili solo quando viene fornito un percorso di repository di codice. Per una configurazione e un utilizzo dettagliati, vedere Client-Side Competenze.
Introduzione ai comandi di trasformazione personalizzati
Ecco alcuni dei comandi che è possibile utilizzare con le trasformazioni personalizzate. L'elenco completo dei comandi si trova in AWS Riferimento al comando Transform custom transformations.
-
atx custom-
Esegue un'esperienza interattiva di trasformazione personalizzata, consentendo la creazione, la scoperta, l'esecuzione e il perfezionamento delle trasformazioni.
-
Questo è il comando predefinito per
atx. -
--trust-all-tools(-t) è facoltativo e consente implicitamente tutte le richieste di strumenti richieste dall'agente. Usare con cautela soprattutto negli ambienti di produzione. È possibile configurare l'attendibilità degli strumenti per strumenti e comandi specifici utilizzando file delle impostazioni di fiducia.
-
-
atx custom --help|atx custom -h-
Mostra il menu di aiuto.
-
Ogni comando include anche un menu di aiuto, ad esempio
atx custom def exec --help.
-
-
atx --version|atx -v-
Mostra la versione.
-
Il numero di versione cambia a ogni versione.
-
-
atx custom def list-
Stampa l'elenco delle trasformazioni disponibili nel registro delle trasformazioni.
-
-
atx custom def exec-
Esegue una trasformazione
-
-
atx custom def learnings-
Apre una sessione interattiva per visualizzare e gestire le lezioni apprese da una trasformazione dalle esecuzioni precedenti
-
-
atx mcp-
Utilizzato per gestire le configurazioni del server MCP
-