Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Cómo empezar con MCP
Todas las API de Data Transformation Agent están disponibles como una herramienta de MCP, por lo que puede crear perfiles, realizar conversiones de prueba y depurar los errores de un agente de MCP-compatible IA sin salir de su IDE.
Requisitos previos
-
Un MCP-compatible cliente (como Kiro o Cursor).
-
AWS credenciales configuradas con los permisos de IAM del Agente de Transformación de Datos desde. Configuración
Paso 1: Instalar y configurar el AWS Servidor MCP
Instale el servidor AWS MCP en la herramienta de agencia que prefiera (como Kiro o Cursor) y configúrelo con sus credenciales y región. AWS Para obtener instrucciones de instalación y configuración, consulte la documentación del AWS servidor MCP.
Paso 2: Compruebe que las herramientas estén disponibles
Tras la configuración, las operaciones del agente de transformación de datos aparecen como herramientas invocables en el agente. Los nombres de las herramientas se asignan directamente a las operaciones de la API:
| Nombre de la herramienta | ¿Qué hace? |
|---|---|
| CreateDataTransformationProfile | Crea un perfil en estado DRAFT |
| UpdateProfileWithAgent | Envía un mensaje al agente de IA para que edite un perfil |
| PublishDataTransformationProfile | Publica el borrador actual como una versión inmutable |
| GetDataTransformationProfile | Recupera los metadatos y el contenido del perfil |
| StartDataTransformationJob | Inicia un trabajo de conversión masiva |
| DescribeDataTransformationJob | Comprueba el estado y el progreso del trabajo |
| DeleteDataTransformationProfile | Elimina los metadatos y el contenido del perfil |
| ListDataTransformationProfiles | Muestra los perfiles de tu cuenta |
| ListDataTransformationJobs | Enumera los trabajos de transformación |
nota
La operación de conversión de sincronización (TransformData) es REST-only y puede que no aparezca como una herramienta de MCP. Su agente puede crear y ejecutar la llamada REST en su nombre: consulte el paso 3: Pruebe el formato de solicitud con la conversión sincronizada.
Paso 3: Usa las herramientas en lenguaje natural
Una vez conectado, impulse todo el ciclo de vida del perfil hablando con su propio agente, que interactúa con el agente de transformación de datos a través de MCP:
-
«Cree un C-CDA perfil a partir del perfil AWS inicial denominado 'Perfil de cardiología'». → El agente llama CreateDataTransformationProfile y devuelve el ID del perfil.
-
«Agregue un mapa para la sección de medicamentos». → El agente llama UpdateProfileWithAgent, muestra el cambio propuesto y pide confirmación.
-
«Publica el perfil e inicia un trabajo masivo en s3://my - bucket/ccda -files/» → El agente llama entonces. PublishDataTransformationProfile StartDataTransformationJob
-
«¿Cuál es el estado de mi último trabajo?» → El agente llama DescribeDataTransformationJob e informa del progreso.
-
«Fallaron 12 registros: ¿qué pasó?» → El agente inspecciona los errores y propone corregir el perfil.
Las sesiones mantienen el contexto durante varios turnos, por lo que el agente recuerda tu perfil, conversación e instrucciones previas a lo largo del flujo de trabajo.
Resolución de problemas
| Síntoma | Fix |
|---|---|
| Las herramientas no aparecen después de la configuración | Compruebe que el servidor AWS MCP esté funcionando y configurado en la región correcta. Reinicie el cliente MCP. |
| AccessDeniedException en llamadas de herramientas | Añada las acciones de healthlake: * DataTransformation * a su política de IAM. Consulte Configuración. |
| ResourceNotFoundException | Asegúrese de que la región de la configuración de su servidor MCP coincida con la región en la que se encuentran sus perfiles. |
