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à.
Flussi di lavoro
Esecuzione di trasformazioni
Questa sezione descrive i diversi modi per eseguire le trasformazioni e le opzioni per controllare il comportamento di esecuzione.
Modalità di esecuzione
AWS Transform custom supporta tre modalità di esecuzione per adattarsi a diversi flussi di lavoro.
Modalità conversazionale interattiva
Avvia la CLI con atx e chiedi all'agente di eseguire una trasformazione tramite linguaggio naturale. Questa modalità consente di avere una conversazione completa con l'agente, interrompere l'esecuzione in qualsiasi momento e fornire un feedback durante il processo di trasformazione.
Utilizzate questa modalità quando desiderate il massimo controllo e la capacità di guidare l'agente attraverso scenari complessi.
Esecuzione interattiva diretta
Usa atx custom def exec -n <transformation-name> -p <path> per avviare una trasformazione specifica in modo interattivo. Questa modalità consente di esaminare e interagire con l'agente all'inizio, durante o alla fine dell'esecuzione. L'agente si fermerà nei punti decisionali chiave e chiederà il tuo contributo.
È ideale per testare e perfezionare le trasformazioni prima di eseguirle in modo autonomo.
È possibile eseguire trasformazioni in modalità non interattiva o in modalità headless. Non-interactive la modalità sopprime i prompt durante una trasformazione denominata. La modalità Headless consente di eseguire l'agente con un prompt in testo normale, ignorando completamente l'interfaccia interattiva.
Non-interactive modalità
Usa atx custom def exec -n <transformation-name> -p <path> -x -t per una completa automazione. Inserisci -x da eseguire in modalità non interattiva e -t per fidarsi automaticamente di tutti gli strumenti senza chiedere conferma.
Questa modalità è progettata per CI/CD integrazione della pipeline ed esecuzione in blocco laddove non sia disponibile o desiderato alcun intervento umano.
modalità Headless
Per completare le attività senza interagire con l'agente, esegui atx -x "<prompt>" -t e fornisci le tue istruzioni in testo semplice.
Esecuzione di trasformazioni senza testa
Utilizzate questa modalità per applicare una definizione di trasformazione esistente alla vostra base di codice. La trasformazione esegue automaticamente ogni passaggio senza richiedere l'approvazione dell'utente.
atx -x "apply transformation definition <transformation_definition_name> to <codebase_path>" -t
Sviluppo di trasformazioni senza testa
Crea o modifica le definizioni di trasformazione.
Per convertire una definizione di trasformazione precedente nel nuovo formato di abilità (SKILL.md + references/), esegui il comando seguente:
atx -x "convert <legacy_transformation_definition_name> transformation definition to skill and save as draft" -t
Per creare una nuova definizione di trasformazione, esegui il comando seguente:
atx -x "create a transformation definition to <description> with references docs <reference_docs_path>" -t
Bandiere di comando comuni
Quando si eseguono trasformazioni con atx custom def exec, i seguenti flag sono comunemente usati:
-no--transformation-name- Specifica il nome della trasformazione da eseguire-po--code-repository-path- Specifica il percorso della tua base di codice (usa «.» per la directory corrente)-co--build-command- Specifica il comando di compilazione o convalida da eseguire-xo--non-interactive- Abilita la modalità non interattiva (nessuna richiesta utente)-to--trust-all-tools- Si fida automaticamente di tutti gli strumenti senza chiedere conferma-do--do-not-learn- Impedisce l'estrazione della lezione da questa esecuzione--tvo--transformation-version- Specifica una versione specifica della trasformazione-go--configuration- Fornisce un file di configurazione o una configurazione in linea
Il -t o --trust-all-tools flag approva automaticamente tutte le esecuzioni degli strumenti senza chiedere conferma e aggira la maggior parte dei guardrail di sicurezza (comandi corrispondenti al tuo alwaysPromptCommands l'elenco richiede ancora un'autorizzazione esplicita a meno che non venga sovrascritto da trustedShellCommands). Di passaggio --non-interactive e --trust-all-tools è richiesto per un'esperienza completamente autonoma ma non necessario per eseguire la trasformazione. Utilizzare con cautela negli ambienti di produzione.
Utilizzo dei file di configurazione
AWS Transform custom supporta file di configurazione opzionali in formato YAML o JSON. I file di configurazione consentono di specificare i parametri di esecuzione e fornire un contesto aggiuntivo all'agente.
Per utilizzare un file di configurazione:
atx custom def exec --configuration file://config.yaml
Puoi anche fornire la configurazione come coppie chiave-valore in linea:
atx custom def exec --configuration "key=value,key2=value2"
File di configurazione di esempio (config.yaml):
codeRepositoryPath: ./my-project transformationName: my-transformation buildCommand: mvn clean install additionalPlanContext: | The target Java version to upgrade to is Java 17. Ensure compatibility with our internal logging framework version 2.3. validationCommands: | mvn test mvn verify
Il additionalPlanContext il parametro fornisce un contesto aggiuntivo per il piano di esecuzione dell'agente. Ciò è particolarmente utile con AWS-trasformazioni gestite per personalizzarne il comportamento in base alle vostre esigenze specifiche.
Comandi di compilazione e convalida
Il comando di compilazione o validazione è un parametro opzionale che specifica come convalidare il codice durante il processo di trasformazione. AWS Transform custom tenterà di dedurre il miglior comando di compilazione in base alla trasformazione, se non specificato, anche se si consiglia di specificare la qualità.
Esempi di comandi di compilazione e convalida:
Java:
mvn clean installogradle buildPython:
pytestopython -m py_compileNode.js:
npm run buildonpm testLinters:
eslint .opylint .
Anche per linguaggi o trasformazioni che non richiedono la compilazione, 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.
Se non è necessaria alcuna compilazione o convalida, ometti l'input.
Controllo del comportamento di apprendimento
Per impostazione predefinita, AWS Transform custom estrae le lezioni da ogni esecuzione di trasformazione. Puoi impedire l'apprendimento per esecuzioni specifiche.
Per impedire l'apprendimento da un'esecuzione:
atx custom def exec -n my-transformation -p ./my-project -d
Il -d o --do-not-learn flag sceglie di non consentire l'estrazione della lezione dall'esecuzione corrente.
Ripresa delle conversazioni
AWS Transform custom consente di riprendere le conversazioni precedenti entro 30 giorni dalla creazione.
Per riprendere la conversazione più recente:
atx --resume
Per riprendere una conversazione specifica:
atx --conversation-id <conversation-id>
Le conversazioni possono essere riprese solo entro 30 giorni dalla creazione. Dopo 30 giorni, la conversazione non può più essere ripresa.
Monitoraggio dei minuti degli agenti
AWS Trasforma le tracce personalizzate in minuti dell'agente
Agent minutes used: 12.50
I minuti degli agenti persistono anche dopo le interruzioni. Se si interrompe una sessione con Ctrl+C e la si riprende in un secondo momento, i minuti accumulati in precedenza vengono trasferiti e continuano ad accumularsi nella sessione ripresa.
Per controllare Agent Minutes durante una sessione interattiva:
Digitare /usage alla richiesta di immissione per visualizzare gli attuali minuti dell'agente accumulati senza terminare la conversazione.
Per impostare un limite di budget per gli Agent Minutes:
atx custom def exec -n my-transformation -p ./my-project --limit 30
Il --limit l'opzione imposta un massimo Verbali dell'agente
⚠️ Budget limit reached: 30.00 / 30.00 Agent Minutes. Exiting.
Puoi riprendere la conversazione in un secondo momento con un limite maggiore:
atx --conversation-id <conversation_id> -t --limit <increased_limit>
Apprendimento continuo
Questa sezione descrive come rivedere e gestire le lezioni create dall'apprendimento continuo.
Comprensione delle lezioni
Il sistema di apprendimento continuo estrae automaticamente le lezioni dalle precedenti esecuzioni di una trasformazione. Il sistema li crea in modo asincrono in base a:
Feedback degli sviluppatori fornito in modalità interattiva
Problemi relativi al codice riscontrati durante le trasformazioni
Le lezioni si accumulano nel tempo man mano che si esegue la trasformazione su diverse basi di codice. Il sistema le applica automaticamente per migliorare le esecuzioni future. Ogni lezione appartiene a una categoria contenente tutte le lezioni di un dominio simile in modo da poter rivedere insieme le lezioni correlate. Per le lezioni che non desideri utilizzare, puoi archiviare o eliminare completamente la lezione.
Visualizzazione e gestione delle lezioni
Usa il learnings Il comando per aprire una sessione interattiva per sfogliare e gestire le lezioni di una definizione di trasformazione.
Per aprire il visualizzatore delle lezioni:
atx custom def learnings -n my-transformation
Il visualizzatore si apre su un elenco di categorie di lezioni, ognuna delle quali mostra quante lezioni attive contiene. Seleziona una categoria per visualizzarne le lezioni, quindi seleziona una lezione per visualizzarne tutti i dettagli, incluso il corpo della lezione, il suo impatto e il numero di sessioni precedenti in cui è stata consultata.
Archiviazione e ripristino delle lezioni
Il sistema applica le lezioni automaticamente. Se non vuoi che il sistema applichi una lezione, puoi archiviarla. Il sistema conserva le lezioni archiviate ma non le applica alle sessioni future. Tutte le lezioni archiviate sono raggruppate in modo da poterle rivedere e ripristinarne l'uso attivo.
Eliminazione delle lezioni
Rimuovi definitivamente una lezione che non è utile. L'eliminazione non può essere annullata e il sistema potrebbe apprendere nuovamente una lezione eliminata dalle esecuzioni future.
Una lezione deve essere archiviata prima di poter essere eliminata.
Configurazione avanzata
Questa sezione descrive le funzionalità avanzate e le opzioni di configurazione per AWS Trasforma personalizzata.
Variabili di ambiente
È possibile personalizzare il comportamento della CLI utilizzando variabili di ambiente.
Gli esempi seguenti mostrano la sintassi di Linux e macOS (export). In Windows, imposta le variabili di ambiente in PowerShell utilizzando $env:. Vedi il Windows (PowerShell) schede per i comandi equivalenti.NAME="value"
ATX_SHELL_TIMEOUT
Sostituisci il timeout predefinito per i comandi della shell (900) seconds/15 minuti).
Ciò è utile per codebase di grandi dimensioni o processi di compilazione di lunga durata.
ATX_DISABLE_UPDATE_CHECK
Disabilita i controlli automatici delle versioni e le notifiche di aggiornamento durante l'esecuzione dei comandi.
ATX_GIT_COMMITTER_NAME e ATX_GIT_COMMITTER_EMAIL
Configura l'identità dell'autore utilizzata per i commit del checkpoint che AWS Trasforma le creazioni personalizzate nel tuo repository man mano che applica le modifiche durante una trasformazione. Quando queste variabili non sono impostate, i commit dei checkpoint vengono attribuiti a un'identità predefinita (ATX Bot <checkpoint@atx.bot>). Imposta entrambe le variabili per attribuire i checkpoint a un autore specifico.
Impostazioni di fiducia
Le impostazioni di attendibilità consentono di preapprovare strumenti e comandi specifici da eseguire senza richieste. È inoltre possibile richiedere un'autorizzazione esplicita per comandi di shell specifici indipendentemente dal livello di attendibilità. Queste impostazioni sono configurate in ~/.aws/atx/trust-settings.yaml file.
Il file contiene tre elenchi:
trustedTools- Strumenti che possono essere eseguiti senza chiedere confermatrustedShellCommands- Comandi Shell che possono essere eseguiti senza chiedere confermaalwaysPromptCommands- Schemi di comando Shell che richiedono un'autorizzazione esplicita a meno che non vengano sovrascritti datrustedShellCommands, indipendentemente dal-tcontrassegna l'attendibilità della sessione. Questi modelli non vengono applicati in modalità non interattiva (-x).
Strumenti affidabili predefiniti:
file_readget_transformation_from_registrylist_available_transformations_from_registry
Modifica delle impostazioni di fiducia:
Puoi modificare manualmente il file trust-settings.yaml per aggiungere o rimuovere strumenti e comandi affidabili. Entrambi trustedShellCommands e alwaysPromptCommands supporta i modelli di caratteri jolly glob utilizzando *.
Se un comando corrisponde a entrambi gli elenchi, trustedShellCommands ha la priorità.
Quanto segue descrive ogni elenco di comandi e fornisce esempi:
-
trustedShellCommands- I comandi che corrispondono a questi schemi vengono eseguiti senza chiedere conferma, ignorando tutti gli altri guardrail. I pattern vengono confrontati con l'intera stringa di comando.Esempi:
cd *- Corrisponde ai comandi composti che iniziano con cd*&&*- Affida tutti i comandi con gli operatori &&
-
alwaysPromptCommands- I comandi che corrispondono a questi modelli richiedono un'autorizzazione esplicita a meno che non vengano sovrascritti datrustedShellCommands, indipendentemente dal-tcontrassegna l'attendibilità della sessione. Questi modelli non vengono applicati in modalità non interattiva (-x). I pattern vengono confrontati con ogni sottocomando nelle espressioni composte (&&,||, sostituzioni di comandi).Esempi:
rm -rf *- Richiede sempre i comandi ricorsivi di cancellazione forzatasudo *- Richiede sempre l'esecuzione dei comandi con sudofind * -exec *- Richiede sempre i comandi di ricerca con -exec
Session-level fidati:
Durante le istruzioni interattive, puoi scegliere:
(y)es- Esegui una volta(n)o- Nega(t)rust- Trust solo per la sessione corrente
Session-level le impostazioni di fiducia sono temporanee e vengono ripristinate al riavvio della CLI, fornendo un'approvazione temporanea senza modificare permanentemente trust-settings.yaml.
L'attendibilità della sessione non è disponibile per i comandi corrispondenti ai tuoi alwaysPromptCommands elenco.
Server Model Context Protocol (MCP)
I AWS Transform CLI supporta i server Model Context Protocol (MCP), che ne estendono le funzionalità con strumenti aggiuntivi.
Configurazione:
Configurare i server MCP in ~/.aws/atx/mcp.json file. Il AWS Transform CLI supporta due tipi di server MCP: server locali basati su comandi e server HTTP remoti.
Server locali basati su comandi:
I server locali vengono eseguiti come processi secondari sul computer. Configurali con command proprietà:
{ "mcpServers": { "my-local-server": { "command": "npx", "args": ["-y", "@example/mcp-server"] } } }
Server HTTP remoti:
I server remoti si connettono ai server MCP ospitati su un URL HTTP o HTTPS. Configurali con url proprietà:
{ "mcpServers": { "my-remote-server": { "url": "https://api.example.com/mcp", "headers": { "Authorization": "Bearer ${MCP_API_TOKEN}" } } } }
La headers la proprietà è opzionale e supporta l'espansione delle variabili di ambiente utilizzando ${VAR_NAME} sintassi. Ciò consente di memorizzare valori sensibili come i token API nelle variabili di ambiente anziché nel file di configurazione.
Proprietà di configurazione:
I server locali basati su comandi supportano le seguenti proprietà:
command(obbligatorio): il comando per eseguire il serverargs(opzionale) - Matrice di argomenti della riga di comandoenv(opzionale) - Variabili di ambiente da passare al processo del server
I server HTTP remoti supportano le seguenti proprietà:
url(obbligatorio): l'URL HTTP o HTTPS del server MCP remotoheaders(opzionale): intestazioni HTTP da includere nelle richieste, con supporto per${VAR_NAME}espansione delle variabili di ambiente
Gestione dei server MCP:
Visualizza l'elenco dei server MCP configurati:
atx mcp tools
Elenco degli strumenti disponibili offerti da un server MCP specifico:
atx mcp tools --server <server-name>
Monitoraggio dell'utilizzo:
La CLI traccia automaticamente l'utilizzo dello strumento MCP durante le esecuzioni di trasformazione. Le statistiche di utilizzo vengono mantenute come mcp_usage.json nella directory delle conversazioni a fianco metadata.json. Il file registra le metriche per strumento per ogni esecuzione, tra cui:
Numero di chiamate per strumento
Numero di errori per utensile
Tempo totale di esecuzione per strumento
Dettagli dell'ultimo errore (se presente)
Client-Side Competenze
Client-side le competenze sono funzionalità aggiuntive che estendono l'agente durante le esecuzioni di trasformazione. Consentono di fornire strumenti, script e istruzioni personalizzati che l'agente può utilizzare insieme alle sue funzionalità integrate.
Elenchi per la scoperta delle competenze:
Le competenze vengono scoperte da quattro elenchi in ordine di precedenza. Se un'abilità con lo stesso nome esiste in più directory, la prima cartella dell'elenco ha la priorità:
<project>/.aws/atx/skills/- Project-level, AWS Trasforma CLI-specific<project>/.agents/skills/- Project-level, cross-client (disponibile per qualsiasi strumento di agente compatibile)~/.aws/atx/skills/- User-level, AWS Trasforma CLI-specific~/.agents/skills/- User-level, cross-client (disponibile per qualsiasi strumento di agente compatibile)
Il .aws/atx/skills/ gli elenchi sono specifici per AWS Trasforma la CLI. La .agents/skills/ le directory sono interclient, il che significa che le competenze acquisite sono disponibili per qualsiasi agente compatibile oltre a AWS Trasforma la CLI.
Struttura della directory delle competenze:
Ogni abilità è una cartella contenente un SKILL.md file con frontespizio YAML:
~/.aws/atx/skills/ └── my-skill/ ├── SKILL.md # Required: frontmatter + instructions ├── references/ # Optional: reference docs the agent can read │ └── guide.md └── scripts/ # Optional: scripts the agent can execute └── validate.py
SKILL.md formato:
--- name: my-skill description: When to use this skill --- # Skill Title Instructions for the agent...
Il name il campo deve corrispondere al nome della directory principale.
Disabilitare un'abilità:
Per evitare che un'abilità venga caricata senza rimuoverne i file, aggiungi disable-model-invocation: true al frontespizio:
--- name: my-skill description: When to use this skill disable-model-invocation: true ---
Quando questa proprietà è impostata, la CLI ignora l'abilità durante la scoperta. L'agente non può vedere o utilizzare l'abilità a meno che una definizione di trasformazione non gli indichi esplicitamente di leggere il file delle abilità. Usalo per disattivare temporaneamente un'abilità, contrassegnarla come in corso o conservare il materiale di riferimento destinato esclusivamente ai lettori umani.
I file di un'abilità disattivata rimangono su disco. Se una definizione di trasformazione indica all'agente di leggere un percorso di file specifico, l'agente può comunque accedere al contenuto. Il disable-model-invocation la proprietà impedisce il rilevamento automatico e l'inserimento del contesto, non l'accesso al file system.
Disponibilità delle competenze in base alla modalità di esecuzione:
modalità Exec (
atx custom def execcon--code-repository-path) - Scopre le competenze dalle directory a livello di utente e di progetto.Modalità interattiva (
atx) - Inizialmente vengono scoperte solo le competenze a livello di utente. Quando si fornisce un percorso di repository di codice durante la sessione, vengono caricate anche le competenze a livello di progetto.
Verifica della scoperta delle competenze:
Controlla il registro di debug della CLI dopo un'esecuzione per verificare quali competenze sono state scoperte:
Le abilità che non superano la convalida vengono ignorate con un avviso nei log di debug.
Client-side le competenze richiedono la versione CLI 2.0 o successiva.
Scegliere tra Project-Level e User-Level Competenze
Il luogo in cui posizioni un'abilità determina chi ne trae beneficio e quando viene attivata.
Project-level abilità (<project>/.aws/atx/skills/):
Inseriscili nel controllo della versione in modo che ogni membro del team che esegue le trasformazioni sul repository li scopra automaticamente. Usa le competenze a livello di progetto per:
Repository-specific controlli di conformità (regole Dockerfile, politiche Terraform, validatori di sicurezza della migrazione)
Standard di codifica organizzativa che si applicano a questa base di codice (modelli di osservabilità, gestione degli errori, convenzioni di denominazione)
Crea o testa script specifici per il progetto (linter personalizzati, funzioni di adattamento dell'architettura)
Guide alla migrazione delle API per le librerie interne utilizzate in questo repository
User-level abilità (~/.aws/atx/skills/):
Rimangono sul computer e si attivano durante tutte le trasformazioni indipendentemente dal repository scelto come destinazione. Usa le competenze a livello utente per:
Strumenti personali per il flusso di lavoro (generatori di changelog, formattatori di messaggi di commit)
Cross-project preferenze (modelli di test preferiti, promemoria sullo stile della documentazione)
Controlli di conformità delle licenze richiesti dall'organizzazione in tutti i repository
Soglie di copertura o parametri di qualità che applichi a ogni base di codice con cui lavori
Suggerimenti per competenze efficaci:
Scrivi in modo chiaro
descriptioncampi nel tuoSKILL.mdfrontespizio. L'agente utilizza questo campo per decidere quando un'abilità è rilevante.Esci dagli script di convalida con codice 0 in caso di successo e diverso da zero in caso di fallimento. L'agente interpreta i codici di uscita per determinare la conformità.
Stampa messaggi di errore chiari e utilizzabili negli script. L'agente legge l'output per capire cosa correggere.
Inserisci le competenze nella directory interclient (
.agents/skills/) a entrambi i livelli per condividerle con altri strumenti di sviluppo AI oltre a AWS Trasforma la CLI.
Client-Side Esempi di abilità
Questi esempi mostrano due modelli comuni: un'abilità di convalida basata su script e un'abilità di solo riferimento.
Esempio: Dockerfile Compliance Checker (Script-Based)
Questa abilità convalida i Dockerfiles rispetto alle migliori pratiche operative e di sicurezza. Utilizza uno script di convalida che l'agente esegue prima e dopo aver apportato le modifiche.
Struttura della directory:
.aws/atx/skills/ └── dockerfile-compliance/ ├── SKILL.md ├── scripts/ │ └── lint_dockerfile.sh └── references/ └── dockerfile-best-practices.md
SKILL.md:
--- name: dockerfile-compliance description: Validates Dockerfiles against security and operational best practices --- # Dockerfile Compliance Checker When a transformation creates or modifies Dockerfiles, run the compliance checker. ## When to use - After creating a new Dockerfile - After modifying FROM, RUN, USER, or EXPOSE directives - When containerizing an application as part of a transformation ## How to use Run: `bash scripts/lint_dockerfile.sh <path-to-Dockerfile>` If violations are found, consult `references/dockerfile-best-practices.md` for compliant patterns.
Lo script di convalida verifica la presenza di tag di immagine di base non bloccati, eseguiti come root, segreti codificati in ENV direttive e mancanti HEALTHCHECK definizioni. L'agente esegue lo script, corregge le violazioni utilizzando i modelli del file di riferimento ed esegue nuovamente lo script per confermare la conformità.
Esempio: API Deprecation Helper (Reference-Only)
Questa abilità guida l'agente nella sostituzione delle chiamate API obsolete durante le trasformazioni di aggiornamento. Utilizza solo file di riferimento senza script.
Struttura delle directory:
.aws/atx/skills/ └── api-deprecation-helper/ ├── SKILL.md └── references/ ├── aws-sdk-v2-to-v3.md └── react-class-to-hooks.md
SKILL.md:
--- name: api-deprecation-helper description: Guides the agent through replacing deprecated API calls with modern equivalents --- # API Deprecation Helper When performing upgrade transformations, use this skill to identify and replace deprecated API calls with their modern equivalents. ## When to use - During any version upgrade transformation - When build warnings mention deprecated APIs - When transforming code that uses legacy patterns ## Process 1. Identify deprecated API calls in the codebase 2. For each deprecated call, find the replacement in `references/` 3. Apply the replacement, preserving the original behavior 4. Verify the replacement compiles and tests pass
I file di riferimento contengono esempi di codice precedenti e successivi. Ad esempio aws-sdk-v2-to-v3.md mappe, modelli come s3.putObject(params).promise() all'equivalente modulare v3 usando S3Client e PutObjectCommand.
Tag e organizzazione
È possibile organizzare le definizioni di trasformazione di proprietà del cliente con tag per il controllo degli accessi, la categorizzazione e l'allocazione dei costi.
È possibile aggiungere, aggiornare o rimuovere tag solo nelle definizioni di trasformazione di proprietà del cliente. Non è possibile gestire i tag su AWS-trasformazioni gestite.
Alcuni di questi comandi richiedono la specificazione dell'Amazon Resource Name (ARN) per una definizione di trasformazione. La struttura ARN è: arn:aws:transform-custom:<region>:<account-id>:package/<td-name>
Per elencare i tag per una trasformazione:
atx custom def list-tags --arn <transformation-arn>
Per aggiungere tag a una trasformazione:
atx custom def tag --arn <transformation-arn> --tags '{"env":"prod","team":"backend"}'
Per rimuovere i tag da una trasformazione:
atx custom def untag --arn <transformation-arn> --tag-keys "env,team"
I tag possono essere utilizzati per il controllo degli accessi raggruppati nelle policy IAM. È possibile creare politiche che concedono autorizzazioni a tutte le trasformazioni con tag specifici (ad esempio, tutte le trasformazioni contrassegnate con team:frontend o environment:production).
Usa i tag per l'allocazione dei costi
Puoi utilizzare i tag nelle definizioni di trasformazione di proprietà del cliente per organizzare le tue AWS fattura. AWS Transform custom registra la definizione di trasformazione come risorsa di fatturazione per Verbali degli agenti
Dopo aver etichettato le definizioni di trasformazione di proprietà del cliente, attiva le chiavi dei tag nel AWS Console di fatturazione e gestione dei costi. I valori dei tag non vengono visualizzati nei dati di costo finché la chiave del tag non viene attivata. L'attivazione si applica all'utilizzo futuro. Per attribuire l'utilizzo dei mesi precedenti, richiedi un backfill del tag di allocazione dei costi. Per ulteriori informazioni, consulta Allocazione e etichettatura dei costi nel AWS Guida per l'utente di fatturazione e gestione dei costi.
Dopo che un tag key è attivo, puoi raggruppare AWS Trasforma gli addebiti con quella chiave in Cost Explorer. Puoi anche includere gli ID delle risorse in AWS Rapporti sui costi e sull'utilizzo per visualizzare la definizione della trasformazione ARN e i relativi valori dei tag su ogni voce. Per le colonne che contengono questi valori, vedi Colonne relative ai tag delle risorse nel AWS Guida per l'utente di Data Exports. L'esempio seguente restituisce AWS Trasforma i costi e i minuti degli agenti per un giorno, raggruppati per un CostCenter etichetta.
aws ce get-cost-and-usage \ --time-period Start=2026-09-01,End=2026-09-02 \ --granularity DAILY \ --metrics UnblendedCost UsageQuantity \ --filter '{"Dimensions":{"Key":"SERVICE","Values":["AWS Transform"]}}' \ --group-by Type=TAG,Key=CostCenter
Cost Explorer restituisce gli addebiti senza valore per la chiave come un singolo gruppo con un valore vuoto. Questo mostra l'importo della spesa che rimane non attribuito.
Cosa non puoi attribuire tramite tag
Tag-based l'attribuzione opera sulla definizione di trasformazione. Verifica quanto segue confrontandolo con il tuo modello di costo prima di affidarti ai tag per il chargeback.
| Utilizzo | Perché non viene attribuito e cosa fare invece |
|---|---|
| AWS-trasformazioni gestite | Non è possibile aggiungere, aggiornare o rimuovere tag su AWS-definizioni di trasformazione gestite. I relativi addebiti Agent Minutes non ereditano i tag di allocazione dei costi definiti dal cliente. |
| Sessioni che non eseguono alcuna definizione di trasformazione | Minuti degli agenti consumati in un atx le sessioni che non eseguono una definizione di trasformazione vengono registrate senza un ID di risorsa, quindi non esiste alcuna risorsa per ereditare i tag. Esegui il lavoro attraverso una definizione di trasformazione con tag quando la spesa deve essere attribuita. |
| Esecuzioni individuali di una definizione | I tag sono una proprietà della definizione di trasformazione, non di un'esecuzione, e atx custom def exec non accetta tag. Tutte le esecuzioni di una definizione condividono i valori dei tag. Per separare due responsabili dei costi, assegnate a ciascuno la propria definizione di trasformazione. |
| Utenti singoli o responsabili IAM | Gli addebiti vengono attribuiti alla definizione della trasformazione e all'account di esecuzione, non all'identità che ha avviato l'esecuzione. Per-user l'attribuzione non è disponibile tramite tag di allocazione dei costi. |
Log
AWS Transform CLI mantiene tre tipi di log per la risoluzione dei problemi e il debug.
Registri delle conversazioni:
Questi registri contengono la cronologia completa delle conversazioni per una sessione specifica.
Registri dei subagenti:
Questi registri contengono l'output dei subagenti generati dall'agente principale durante le trasformazioni. Non è necessario gestire direttamente i subagenti.
Registri di debug degli sviluppatori:
Questi registri forniscono informazioni avanzate sulla risoluzione dei problemi per la CLI stessa.
Potrebbero essere presenti più file di registro di debug nella directory dei logs (ad esempio debug1.log, debug2.log). Rivedi e fornisci tutti i log pertinenti, ad esempio ~/.aws/atx/custom/ /* e <conversation-id>~/.aws/atx/logs/ *, quando si aprono i ticket di supporto per una risoluzione più rapida.
Aggiornamenti CLI
Mantieni aggiornata la tua CLI per accedere a nuove funzionalità e miglioramenti.
Per verificare la presenza di aggiornamenti:
atx update --check
Per eseguire l'aggiornamento alla versione più recente:
atx update
Per eseguire l'aggiornamento a una versione specifica:
atx update --target-version <version>
Crea trasformazioni personalizzate
Questa sezione descrive come creare, modificare e gestire definizioni di trasformazione personalizzate.
Creazione di una nuova trasformazione
Usa la CLI interattiva per creare una nuova definizione di trasformazione.
Per creare una definizione di trasformazione
Avviare il AWS Trasforma la CLI:
atxInforma l'agente che desideri creare una nuova trasformazione.
Fornisci una descrizione chiara e dettagliata dell'obiettivo di trasformazione. Includi:
Lo stato di origine e di destinazione (ad esempio, «aggiornamento dalla versione X alla versione Y»)
Sono richieste modifiche specifiche (ad esempio, «aggiornare le dichiarazioni di importazione, sostituire i metodi obsoleti»)
Eventuali considerazioni o vincoli speciali
Quando l'agente richiede chiarimenti o informazioni aggiuntive, fornisci esempi specifici e materiali di riferimento.
Rivedi la definizione di trasformazione iniziale creata dall'agente.
Testate la trasformazione su una base di codice di esempio.
Esegui l'iterazione fornendo feedback, correzioni di codice o esempi aggiuntivi.
Salvate la trasformazione localmente o pubblicatela nel registro.
Procedure consigliate per la creazione di trasformazioni:
Inizia con trasformazioni semplici e ben definite prima di tentare trasformazioni complesse
Fornisci materiali di riferimento completi, tra cui guide alla migrazione ed esempi di codice
Esegui test su più codebase di esempio prima della pubblicazione
Utilizza comandi deterministici di compilazione o convalida per consentire l'apprendimento continuo
Prendi in considerazione la possibilità di suddividere le trasformazioni complesse in più passaggi più piccoli
Contrassegna le informazioni cruciali con «CRITICO:» o «IMPORTANTE:» nelle definizioni di trasformazione per assicurarti che l'agente dia priorità a questi requisiti
Quando è necessario seguire i requisiti esatti (ad esempio utilizzando un comando o un valore di stringa specifico), specificate esplicitamente la stringa completa nelle definizioni di trasformazione. Puoi racchiuderli tra virgolette bash per indicare chiaramente che si tratta di comandi da terminale o stringhe letterali, il che riduce la variabilità e garantisce un'esecuzione coerente
Fornitura di materiali di riferimento
È possibile fornire file di riferimento a AWS Trasforma in modo personalizzato specificando i percorsi dei file durante la conversazione. Questi file sono archiviati in references/ cartella della definizione di trasformazione.
Tipi di file di riferimento consigliati:
Before/after codice di esempio
Documentazione per le API, le librerie o le funzionalità coinvolte
Human-readable guide alla migrazione
Per fornire un file di riferimento:
Take a look at the documentation here: /path/to/migration-guide.md
Puoi anche fornire una directory contenente più file di riferimento:
Take a look at the docs we have here: /path/to/docs/
Sono supportati solo i file di testo (.md, .html, .txt, file di codice). I file binari, le immagini e i file RTF (ad es. .pdf, .png, .docx) non sono attualmente supportati. Spesso è possibile estrarre il contenuto del testo e utilizzarlo come riferimento. Se hai molti file di testo di piccole dimensioni, valuta la possibilità di concatenarli in pochi file con nomi descrittivi. C'è un limite totale di 10 MB per tutti i file.
Modifica di una trasformazione esistente
È possibile modificare le trasformazioni personalizzate sia prima che dopo averle salvate come bozze o pubblicate. Non è possibile modificare AWS-trasformazioni gestite. Se è necessario personalizzarli, è possibile fornire un contesto aggiuntivo utilizzando il file di configurazione.
Per modificare una trasformazione esistente
Avviare il AWS Trasforma la CLI:
atxInforma l'agente che desideri modificare una trasformazione esistente.
Scegli se:
Fornisci un percorso di file a una trasformazione archiviata localmente (cioè non una bozza salvata o pubblicata)
Richiedete l'elenco delle trasformazioni dal registro
Se scegli dal registro, seleziona la trasformazione che desideri modificare.
Collabora con l'agente per descrivere le modifiche che desideri apportare.
Prova la trasformazione aggiornata su una base di codice di esempio.
Se lo desideri, pubblica gli aggiornamenti nel registro.
Pubblicazione e gestione delle trasformazioni
Puoi pubblicare e gestire le tue trasformazioni utilizzando l'esperienza interattiva o con i seguenti comandi.
Per salvare una trasformazione come bozza:
atx custom def save-draft -n my-transformation --description "Description of the transformation" --sd ./transformation-directory
Per pubblicare una trasformazione:
atx custom def publish -n my-transformation --description "Description of the transformation" --sd ./transformation-directory
Per elencare le trasformazioni disponibili:
atx custom def list
Per scaricare una definizione di trasformazione:
atx custom def get -n my-transformation
In questo modo la definizione di trasformazione viene scaricata nella directory di lavoro corrente. È possibile specificare una directory di destinazione con --td bandiera e una versione con --tv bandiera.
Per eliminare una definizione di trasformazione:
atx custom def delete -n my-transformation
Questa operazione elimina definitivamente la definizione di trasformazione specificata dal tuo account.
Gestione delle versioni di trasformazione
AWS Transform custom mantiene le versioni delle definizioni di trasformazione. È possibile specificare una versione durante l'esecuzione o il download di una trasformazione.
Per eseguire una versione specifica:
atx custom def exec -n my-transformation --tv v1 -p ./my-project
Per scaricare una versione specifica:
atx custom def get -n my-transformation --tv v1
Se non viene specificata alcuna versione, viene utilizzata la versione più recente.