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à.
Guida introduttiva a MCP
Ogni API di Data Transformation Agent è disponibile come strumento MCP, quindi puoi creare profili, eseguire conversioni di test ed eseguire il debug degli errori da un agente MCP-compatible AI senza uscire dall'IDE.
Prerequisiti
-
Un MCP-compatible client (come Kiro o Cursor).
-
AWS credenziali configurate con le autorizzazioni IAM di Data Transformation Agent da. Configurazione
Fase 1: Installare e configurare AWS Server MCP
Installa il server AWS MCP nel tuo strumento agentico preferito (come Kiro o Cursor) e configuralo con le tue credenziali e la tua regione. AWS Per le istruzioni di installazione e configurazione, consultate la documentazione del server MCP.AWS
Fase 2: Verificare che gli strumenti siano disponibili
Dopo la configurazione, le operazioni di Data Transformation Agent vengono visualizzate come strumenti richiamabili nell'agente. I nomi degli strumenti si riferiscono direttamente alle operazioni dell'API:
| Nome dello strumento | Cosa fa |
|---|---|
| CreateDataTransformationProfile | Crea un profilo in stato DRAFT |
| UpdateProfileWithAgent | Invia un messaggio all'agente AI per modificare un profilo |
| PublishDataTransformationProfile | Pubblica la bozza corrente come versione immutabile |
| GetDataTransformationProfile | Recupera i metadati e il contenuto del profilo |
| StartDataTransformationJob | Avvia un processo di conversione in blocco |
| DescribeDataTransformationJob | Controlla lo stato e l'avanzamento del lavoro |
| DeleteDataTransformationProfile | Elimina i metadati e il contenuto del profilo |
| ListDataTransformationProfiles | Elenca i profili presenti nel tuo account |
| ListDataTransformationJobs | Elenca i lavori di trasformazione |
Nota
L'operazione di conversione di sincronizzazione (TransformData) è REST-only e potrebbe non apparire come uno strumento MCP. Il tuo agente può creare ed eseguire la chiamata REST per tuo conto: vedi Fase 3: Test con conversione di sincronizzazione per il formato della richiesta.
Fase 3: Usa gli strumenti in linguaggio naturale
Una volta connesso, gestisci l'intero ciclo di vita del profilo parlando con il tuo agente, che interagisce con Data Transformation Agent tramite MCP:
-
«Crea un C-CDA profilo dal profilo AWS iniziale chiamato 'Cardiology Profile'». → L'agente chiama CreateDataTransformationProfile e restituisce l'ID del profilo.
-
«Aggiungi una mappatura per la sezione Farmaci». → L'agente chiama UpdateProfileWithAgent, mostra la modifica proposta e chiede conferma.
-
«Pubblica il profilo e avvia un lavoro collettivo su s3://my - bucket/ccda -files/» → L'agente chiama quindi. PublishDataTransformationProfile StartDataTransformationJob
-
«Qual è lo stato del mio ultimo lavoro?» → L'agente chiama DescribeDataTransformationJob e segnala i progressi.
-
«12 record falliti: cosa è successo?» → L'agente controlla gli errori e propone una correzione del profilo.
Le sessioni mantengono il contesto in più turni, in modo che l'agente ricordi il profilo, la conversazione e le istruzioni precedenti durante tutto il flusso di lavoro.
Risoluzione dei problemi
| Caratteristiche | Correggi |
|---|---|
| Gli strumenti non vengono visualizzati dopo la configurazione | Verifica che il server AWS MCP sia in esecuzione e configurato per la regione corretta. Riavvia il client MCP. |
| AccessDeniedException sulle chiamate agli strumenti | Aggiungi le azioni healthlake: * DataTransformation * alla tua policy IAM. Per informazioni, consulta Configurazione. |
| ResourceNotFoundException | Assicurati che la regione nella configurazione del tuo server MCP corrisponda alla regione in cui esistono i tuoi profili. |
