View a markdown version of this page

Utilizzo di agenti AI con DMS Schema Conversion - AWS Database Migration Service

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à.

Utilizzo di agenti AI con DMS Schema Conversion

Puoi utilizzare gli agenti AI per guidare i flussi di lavoro di conversione dello schema DMS tramite l'API. AWS Un agente AI è uno strumento software che utilizza modelli linguistici di grandi dimensioni per comprendere le istruzioni in linguaggio naturale e automatizzare le attività. Quando è connesso al server AWS MCP, un agente AI può creare progetti di migrazione, sfogliare l'albero dei metadati del database di origine, convertire schemi, generare report di valutazione, esportare risultati e spiegare vari aspetti del servizio. Puoi controllare queste operazioni tramite istruzioni in linguaggio naturale.

Per migliorare la precisione e l'efficienza dell'agente con DMS Schema Conversion, puoi installare la skill AWS DMS Schema Conversion. La skill fornisce il Conversion-specific contesto dello schema DMS, tra cui modelli di API, esclusioni degli schemi di sistema, sequenziamento delle operazioni e best practice di servizio.

Importante

La skill contiene istruzioni che prevengono gli errori comuni commessi dagli agenti AI quando utilizzano DMS Schema Conversion e riducono i cicli di tentativi ed errori, il che aiuta a ridurre l'utilizzo dei token e ad aumentare la velocità di raggiungimento dell'obiettivo desiderato. Ti consigliamo vivamente di installarlo prima di iniziare.

Questo argomento mostra come installare la skill e fornisce esempi di flussi di lavoro comuni di conversione dello schema DMS che è possibile eseguire tramite un agente AI.

Prerequisiti

Prima di cominciare, assicurati che i requisiti seguenti siano soddisfatti. Questa guida presuppone la conoscenza delle interfacce a riga di comando e delle interfacce a riga di comando AWS DMS .

Nota

Se hai già un progetto di migrazione configurato in DMS Schema Conversion, l'agente può utilizzarlo immediatamente. Altrimenti, l'agente può crearne uno per te. Per ulteriori informazioni, consulta Collaborazione con fornitori di dati, profili di istanza e progetti di migrazione in AWS DMS.

Installazione di AWS DMS Abilità di conversione dello schema

Una skill è un pacchetto curato di istruzioni e materiali di riferimento che aiuta il tuo agente AI a completare efficacemente le attività di conversione dello schema DMS. L'abilità AWS DMS Schema Conversion contiene modelli di API, esclusioni dello schema di sistema, regole di sequenziamento delle operazioni e best practice di servizio. Grazie a questa abilità, l'agente commette meno errori e richiede meno operazioni di conversione dello schema DMS per completare le operazioni di conversione dello schema DMS.

Scegliete uno dei seguenti metodi per installare la skill.

AWS MCP server

Se l'agente è connesso al server AWS MCP, può trovare e caricare la skill automaticamente tramite il server MCP. Prima di procedere, verificate che i server MCP siano caricati e connessi. Nella maggior parte degli agenti AI, puoi controllare lo stato del server MCP inserendo. /mcp Quindi chiedi al tuo agente:

Load "dms-schema-conversion" skill using the `retrieve_skill` tool.

L'agente recupera l'abilità dal server AWS MCP e la applica alla sessione corrente.

npx skills CLI

Se l'agente non utilizza il server AWS MCP, è possibile installare la skill localmente dall'AWS Agent Toolkit for repository on. AWS GitHub Esegui il comando seguente dalla directory del tuo progetto:

npx skills add aws/agent-toolkit-for-aws/skills/specialized-skills/migration-and-modernization-skills/dms-schema-conversion
Nota

Se utilizzi una definizione di agente personalizzata all'interno del tuo strumento di codifica AI, assicurati che la configurazione dell'agente includa una directory delle competenze. Altrimenti, l'agente non può scoprire e caricare l'abilità.

Manual installation

Clona l'AWS Agent Toolkit for AWS repository e copia la directory delle abilità nella posizione delle competenze del tuo agente. La tabella seguente mostra il percorso delle competenze per gli agenti supportati.

Agente Percorso delle competenze del progetto Percorso globale delle competenze
CLI Kiro .kiro/skills/ ~/.kiro/skills/
Codice Claude .claude/skills/ ~/.claude/skills/
Cursore .cursor/skills/ ~/.cursor/skills/
Codex .agents/skills/ ~/.codex/skills/
Nota

Se utilizzi una definizione di agente personalizzata all'interno del tuo strumento di codifica AI, assicurati che la configurazione dell'agente includa una directory delle competenze. Altrimenti, l'agente non può scoprire e caricare l'abilità.

Direct URL

Puoi caricare la skill direttamente dall' GitHub URL senza installare nulla localmente. Chiedi al tuo agente:

Load skill from https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/migration-and-modernization-skills/dms-schema-conversion/SKILL.md

L'agente recupera il contenuto delle abilità GitHub e lo applica alla sessione corrente.

Dopo che l'abilità è stata caricata correttamente, viene visualizzato un menu di azioni con le azioni di conversione dello schema disponibili.

Best practice

Segui questi consigli per ottenere i migliori risultati quando utilizzi agenti AI con DMS Schema Conversion.

  • Sfoglia prima della conversione: utilizza l'agente per esplorare l'albero dei metadati prima di iniziare a convertire gli schemi. Questo ti aiuta a comprendere l'ambito della migrazione e a identificare gli schemi da convertire.

  • Converti uno schema alla volta: per i database di grandi dimensioni, converti gli schemi singolarmente anziché tutti in una volta. In questo modo è più semplice rivedere il codice convertito e indirizzare le azioni in modo incrementale.

  • Ignora gli schemi di sistema: non converte i database o gli schemi di sistema. Contengono oggetti interni al motore che producono un gran numero di azioni non convertibili.

  • Rivedi il codice SQL convertito prima dell'applicazione: esporta il codice convertito come script SQL ed esaminalo prima di applicarlo al database di destinazione, in particolare per gli oggetti di codice.

  • Abilita la AI-assisted conversione generativa: abilita la AI-assisted conversione generativa per migliorare il tasso di conversione degli oggetti di codice. AI-assisted La conversione generativa utilizza l'apprendimento automatico per convertire oggetti che il convertitore basato su regole non è in grado di gestire automaticamente. Per ulteriori informazioni, consulta Conversione di oggetti di database con intelligenza artificiale generativa.

  • Utilizza il rapporto di valutazione: dopo la conversione o la valutazione, genera un rapporto di valutazione per ottenere un riepilogo dei risultati della conversione e del lavoro manuale rimanente. Per ulteriori informazioni, consulta Creazione di report di valutazione della migrazione del database con la conversione dello schema DMS.

Esempi

Gli esempi seguenti mostrano flussi di lavoro comuni di conversione dello schema DMS che è possibile eseguire tramite un agente AI dopo aver caricato la skill.

In questo esempio, utilizzi un agente AI per creare un progetto di migrazione per convertire un database Microsoft SQL Server in Amazon Aurora PostgreSQL. L'agente crea le AWS DMS risorse necessarie e le collega tra loro.

Il seguente prompt indica all'agente di creare un progetto di migrazione:

I want to migrate my SQL Server database to Aurora PostgreSQL using DMS Schema Conversion. The source database is on an EC2 instance at 10.0.1.50, port 1433, database name "AdventureWorks". The credentials are stored in Secrets Manager under "mydb-source-credentials". Create a migration project for me.

L'agente crea un provider di dati di origine, un fornitore di dati di destinazione, un profilo di istanza e il progetto di migrazione che li collega tra loro. Se non disponi ancora di un database di destinazione, l'agente crea un fornitore di dati di destinazione virtuale in modo da poter convertire ed esportare gli schemi come script SQL. L'agente crea anche i ruoli IAM e i bucket S3 richiesti e controlla la configurazione di rete.

Dopo che l'agente ha creato il progetto di migrazione, puoi sfogliare i metadati del database di origine, valutare o convertire gli schemi ed esportare i risultati.

È possibile utilizzare l'agente per esplorare la struttura del database di origine. L'agente naviga gerarchicamente nell'albero dei metadati, elencando database, schemi, tabelle, stored procedure e altri oggetti.

Show me the databases and schemas in my source database.

L'agente importa i metadati di origine se non sono ancora stati importati, quindi naviga nell'albero dei metadati utilizzando l'API. AWS DMS Puoi approfondire schemi specifici:

Show me the stored procedures in the AdventureWorks.dbo schema.

Dopo aver esplorato l'albero dei metadati, è possibile utilizzare l'agente per valutare o convertire gli schemi ed esportare i risultati.

Convert the AdventureWorks.dbo schema to Aurora PostgreSQL and export the converted SQL scripts.

L'agente converte gli oggetti dello schema ed esporta gli script SQL convertiti nel bucket S3. Ogni operazione di conversione ed esportazione viene eseguita in modo asincrono e l'agente verifica il completamento prima di iniziare l'operazione successiva. Dopo la conversione, l'agente genera un rapporto di valutazione.

Il rapporto di valutazione include un riepilogo degli oggetti convertiti, delle azioni per gli oggetti che richiedono modifiche manuali e delle stime degli sforzi. Puoi anche chiedere all'agente di spiegare il significato di azioni specifiche e fornire indicazioni su come risolverle.

Alcune operazioni di conversione dello schema DMS, come la conversione dello schema, l'importazione e la valutazione dei metadati, vengono eseguite in modo asincrono e possono richiedere tempo. Mentre l'agente verifica il completamento dei sondaggi, potresti voler porre domande, ottenere chiarimenti o fornire istruzioni aggiuntive senza interrompere il flusso di lavoro.

I seguenti approcci consentono di interagire con l'agente durante un'operazione di lunga durata. Scegliete un metodo basato sulle capacità del vostro agente.

Ctrl+C

Questo approccio funziona nella maggior parte degli agenti di intelligenza artificiale, tra cui Kiro CLI, Claude Code e Cursor.

Premi Ctrl+C per interrompere l'agente mentre verifica i progressi. Puoi quindi porre la tua domanda o dare una nuova istruzione. L'agente sospende l'operazione corrente ma non annulla l'operazione sul lato server: continua a AWS DMS funzionare.

Dopo che l'agente ha risposto alla tua domanda, puoi chiedergli di riprendere a controllare lo stato dell'operazione.

Check if the conversion is done now.
Separate session

Questo approccio funziona con qualsiasi agente AI.

Apri una nuova scheda del terminale e avvia una sessione di agente separata. Utilizzate una sessione per eseguire l'operazione e completare il sondaggio e l'altra sessione per porre domande o svolgere altro lavoro. Entrambe le sessioni possono accedere agli stessi server e AWS risorse MCP.

Instructing the agent not to poll

Questo approccio funziona con qualsiasi agente AI.

Invece di aspettare il completamento di un'operazione, chiedi all'agente di avviare l'operazione e di tornare immediatamente. Potrai quindi porre domande, fare altro lavoro e controllare lo stato quando sei pronto.

Richiesta di esempio:

Start converting the AdventureWorks.dbo schema but don't wait for it to finish. I'll ask you to check the status later.

Poi più tardi:

Check if the dbo schema conversion is complete.
/btw command

Questo approccio è disponibile in Claude Code e in altri agenti che supportano i messaggi in background.

Entra /btw seguito dalla tua domanda per inviare un messaggio secondario senza interrompere l'attività corrente dell'agente. L'agente elabora la tua domanda in background mentre continua a eseguire il sondaggio per completarlo.

Esempio:

/btw What action items typically appear for stored procedures?
Subagents

Questo approccio è disponibile negli agenti che supportano i subagenti in background, come Claude Code.

Indica all'agente di eseguire l'operazione in un subagente in background. Il subagente verifica il completamento dei sondaggi mentre la sessione principale rimane libera per domande e altro lavoro.

Richiesta di esempio:

Run the AdventureWorks.dbo schema conversion in a background subagent and let me know when it's done.