Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Commencer à utiliser MCP
Chaque API de l'agent de transformation des données est disponible sous forme d'outil MCP, ce qui vous permet de créer des profils, d'exécuter des tests de conversion et de corriger les défaillances d'un agent d' MCP-compatible intelligence artificielle sans quitter votre IDE.
Conditions préalables
-
Un MCP-compatible client (tel que Kiro ou Cursor).
-
AWS informations d'identification configurées avec les autorisations IAM de l'agent de transformation des données depuisConfiguration.
Étape 1 : installer et configurer le AWS serveur MCP
Installez le serveur AWS MCP dans votre outil agentic préféré (tel que Kiro ou Cursor) et configurez-le avec vos informations d'identification et votre AWS région. Pour les instructions d'installation et de configuration, consultez la documentation du serveur AWS MCP
Étape 2 : vérifier que les outils sont disponibles
Après la configuration, les opérations de l'agent de transformation des données apparaissent sous forme d'outils appelables dans votre agent. Les noms des outils correspondent directement aux opérations de l'API :
| Nom de l'outil | Ce qu'il fait |
|---|---|
| CreateDataTransformationProfile | Crée un profil à l'état DRAFT |
| UpdateProfileWithAgent | Envoie un message à l'agent AI pour modifier un profil |
| PublishDataTransformationProfile | Publie le brouillon actuel sous forme de version immuable |
| GetDataTransformationProfile | Récupère les métadonnées et le contenu du profil |
| StartDataTransformationJob | Démarre une tâche de conversion en masse |
| DescribeDataTransformationJob | Vérifie le statut et la progression du travail |
| DeleteDataTransformationProfile | Supprime les métadonnées et le contenu du profil |
| ListDataTransformationProfiles | Liste les profils de votre compte |
| ListDataTransformationJobs | Répertorie les tâches de transformation |
Note
L'opération de conversion de synchronisation (TransformData) est REST-only et peut ne pas apparaître comme un outil MCP. Votre agent peut créer et exécuter l'appel REST en votre nom : voir Étape 3 : Test avec conversion synchronisée pour le format de demande.
Étape 3 : Utiliser les outils en langage naturel
Une fois connecté, pilotez le cycle de vie complet du profil en parlant à votre propre agent, qui interagit avec l'agent de transformation des données via MCP :
-
« Créez un C-CDA profil à partir du profil de AWS départ appelé « profil de cardiologie ». » → L'agent appelle CreateDataTransformationProfile et renvoie l'identifiant du profil.
-
« Ajoutez un mappage pour la section Médicaments. » → L'agent appelle UpdateProfileWithAgent, montre le changement proposé et demande une confirmation.
-
« Publiez le profil et lancez une tâche groupée sur s3://my - bucket/ccda -files/ » → L'agent appelle PublishDataTransformationProfile alors. StartDataTransformationJob
-
« Quel est le statut de mon dernier emploi ? » → L'agent appelle DescribeDataTransformationJob et rend compte de la progression.
-
« 12 enregistrements ont échoué : que s'est-il passé ? » → L'agent inspecte les erreurs et propose un correctif de profil.
Les sessions conservent le contexte pendant plusieurs tours, afin que l'agent se souvienne de votre profil, de votre conversation et des instructions précédentes tout au long du flux de travail.
Résolution des problèmes
| Symptôme | Corriger |
|---|---|
| Les outils n'apparaissent pas après la configuration | Vérifiez que le serveur AWS MCP est en cours d'exécution et configuré pour la bonne région. Redémarrez votre client MCP. |
| AccessDeniedException lors des appels d'outils | Ajoutez les actions healthlake : * DataTransformation * à votre politique IAM. Consultez Configuration. |
| ResourceNotFoundException | Assurez-vous que la région de la configuration de votre serveur MCP correspond à la région dans laquelle vos profils existent. |
