Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Erste Schritte mit MCP
Jede Data Transformation Agent API ist als MCP-Tool verfügbar, sodass Sie Profile erstellen, Testkonvertierungen durchführen und Fehler von einem MCP-compatible AI-Agenten aus debuggen können, ohne Ihre IDE verlassen zu müssen.
Voraussetzungen
-
Ein MCP-compatible Client (wie Kiro oder Cursor).
-
AWS Anmeldeinformationen, die mit den IAM-Berechtigungen des Data Transformation Agent von konfiguriert wurden. Einrichtung
Schritt 1: Installieren und konfigurieren Sie den AWS MCP-Server
Installieren Sie den AWS MCP-Server in Ihrem bevorzugten Agent-Tool (wie Kiro oder Cursor) und konfigurieren Sie ihn mit Ihren Anmeldeinformationen und Ihrer Region. AWS Anweisungen zur Installation und Konfiguration finden Sie in der AWS MCP-Serverdokumentation.
Schritt 2: Stellen Sie sicher, dass die Tools verfügbar sind
Nach der Einrichtung werden die Data Transformation Agent-Operationen als aufrufbare Tools in Ihrem Agenten angezeigt. Die Namen der Tools sind direkt den API-Vorgängen zugeordnet:
| Name des Tools | Was macht es |
|---|---|
| CreateDataTransformationProfile | Erstellt ein Profil im Status ENTWURF |
| UpdateProfileWithAgent | Sendet eine Nachricht an den AI-Agenten, um ein Profil zu bearbeiten |
| PublishDataTransformationProfile | Veröffentlicht den aktuellen Entwurf als unveränderliche Version |
| GetDataTransformationProfile | Ruft Profilmetadaten und -inhalte ab |
| StartDataTransformationJob | Startet einen Massenkonvertierungsauftrag |
| DescribeDataTransformationJob | Überprüft den Status und den Fortschritt des Jobs |
| DeleteDataTransformationProfile | Löscht Profilmetadaten und -inhalte |
| ListDataTransformationProfiles | Listet Profile in Ihrem Konto auf |
| ListDataTransformationJobs | Listet Transformationsaufträge auf |
Anmerkung
Der Synchronisierungskonvertierungsvorgang (TransformData) ist ein MCP-Tool REST-only und wird möglicherweise auch nicht als solches angezeigt. Ihr Agent kann den REST-Aufruf in Ihrem Namen erstellen und ausführen: Informationen zum Anforderungsformat finden Sie unter Schritt 3: Testen mit Synchronkonvertierung.
Schritt 3: Verwenden Sie die Tools in natürlicher Sprache
Sobald die Verbindung hergestellt ist, können Sie den gesamten Profillebenszyklus steuern, indem Sie mit Ihrem eigenen Agenten sprechen, der über MCP mit dem Data Transformation Agent interagiert:
-
„Erstellen Sie aus dem C-CDA AWS Starter-Profil ein Profil mit dem Namen ‚Kardiologie-Profil'.“ → Der Agent ruft an CreateDataTransformationProfile und gibt die Profil-ID zurück.
-
„Fügen Sie eine Zuordnung für den Bereich Medikamente hinzu.“ → Der Mitarbeiter ruft an UpdateProfileWithAgent, zeigt die vorgeschlagene Änderung und bittet um Bestätigung.
-
„Veröffentlichen Sie das Profil und starten Sie einen Bulk-Job gegen s3://my - bucket/ccda -files/“ → Der Agent ruft PublishDataTransformationProfile dann an. StartDataTransformationJob
-
„Was ist der Status meines letzten Jobs?“ → Der Agent ruft an DescribeDataTransformationJob und meldet den Fortschritt.
-
„12 Datensätze sind fehlgeschlagen: Was ist passiert?“ → Der Agent untersucht die Fehler und schlägt eine Korrektur des Profils vor.
Sitzungen behalten den Kontext über mehrere Runden hinweg bei, sodass sich der Agent während des gesamten Workflows an Ihr Profil, Ihre Konversation und vorherige Anweisungen erinnert.
Fehlerbehebung
| Symptom | Korrigieren |
|---|---|
| Tools werden nach dem Setup nicht angezeigt | Stellen Sie sicher, dass der AWS MCP-Server läuft und für die richtige Region konfiguriert ist. Starten Sie Ihren MCP-Client neu. |
| AccessDeniedException bei Toolaufrufen | Fügen Sie die healthlake: DataTransformation * *-Aktionen zu Ihrer IAM-Richtlinie hinzu. Siehe Einrichtung. |
| ResourceNotFoundException | Stellen Sie sicher, dass die Region in Ihrer MCP-Serverkonfiguration mit der Region übereinstimmt, in der Ihre Profile existieren. |
