As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Começando com o MCP
Cada API do Agente de Transformação de Dados está disponível como uma ferramenta MCP, para que você possa criar perfis, executar conversões de teste e depurar falhas de um agente de MCP-compatible IA sem sair do seu IDE.
Pré-requisitos
-
Um MCP-compatible cliente (como Kiro ou Cursor).
-
AWS credenciais configuradas com as permissões do Data Transformation Agent IAM deConfigurar.
Etapa 1: instalar e configurar o AWS Servidor MCP
Instale o servidor AWS MCP em sua ferramenta agente preferida (como Kiro ou Cursor) e configure-o com suas AWS credenciais e sua região. Para obter instruções de instalação e configuração, consulte a documentação do servidor AWS MCP
Etapa 2: verificar se as ferramentas estão disponíveis
Após a configuração, as operações do Agente de Transformação de Dados aparecem como ferramentas que podem ser chamadas em seu agente. Os nomes das ferramentas são mapeados diretamente para as operações da API:
| Nome da ferramenta | O que ela faz |
|---|---|
| CreateDataTransformationProfile | Cria um perfil no estado DRAFT |
| UpdateProfileWithAgent | Envia uma mensagem para o agente de IA para editar um perfil |
| PublishDataTransformationProfile | Publica o rascunho atual como uma versão imutável |
| GetDataTransformationProfile | Recupera metadados e conteúdo do perfil |
| StartDataTransformationJob | Inicia um trabalho de conversão em massa |
| DescribeDataTransformationJob | Verifica o status e o progresso do trabalho |
| DeleteDataTransformationProfile | Exclui metadados e conteúdo do perfil |
| ListDataTransformationProfiles | Lista os perfis em sua conta |
| ListDataTransformationJobs | Lista os trabalhos de transformação |
nota
A operação de conversão de sincronização (TransformData) é REST-only e pode não aparecer como uma ferramenta MCP. Seu agente pode criar e executar a chamada REST em seu nome: consulte Etapa 3: Teste com conversão de sincronização para o formato da solicitação.
Etapa 3: use as ferramentas em linguagem natural
Depois de conectado, conduza o ciclo de vida completo do perfil conversando com seu próprio agente, que interage com o agente de transformação de dados via MCP:
-
“Crie um C-CDA perfil a partir do Perfil AWS Inicial chamado 'Perfil de Cardiologia'.” → O agente liga CreateDataTransformationProfile e retorna o ID do perfil.
-
“Adicione um mapeamento para a seção Medicação.” → O agente liga UpdateProfileWithAgent, mostra a alteração proposta e solicita a confirmação.
-
“Publique o perfil e inicie um trabalho em massa em s3://my - bucket/ccda -files/” → O agente liga então. PublishDataTransformationProfile StartDataTransformationJob
-
“Qual é a situação do meu último emprego?” → O agente liga DescribeDataTransformationJob e relata o progresso.
-
“12 registros falharam: o que aconteceu?” → O agente inspeciona os erros e propõe uma correção do perfil.
As sessões mantêm o contexto em vários turnos, para que o agente se lembre de seu perfil, conversa e instruções anteriores em todo o fluxo de trabalho.
Solução de problemas
| Sintomas | Correção |
|---|---|
| As ferramentas não aparecem após a configuração | Verifique se o servidor AWS MCP está em execução e configurado para a região correta. Reinicie seu cliente MCP. |
| AccessDeniedException em chamadas de ferramentas | Adicione as ações healthlake: * DataTransformation * à sua política do IAM. Consulte Configurar. |
| ResourceNotFoundException | Certifique-se de que a região na configuração do servidor MCP corresponda à região em que seus perfis existem. |
