Usando habilidades de agentes com o Amazon MWAA

As habilidades do agente são pacotes de instruções que orientam um assistente de codificação de IA por meio de fluxos de trabalho gerenciados da Amazon para operações do Apache Airflow. O AWS Plugin de análise de dados (aws-data-analytics) no kit de ferramentas de agente de código aberto para AWS fornece um conjunto de habilidades que seguem o padrão aberto Agent Skills. Depois de instalar as habilidades, você descreve o que deseja fazer em linguagem natural e seu assistente usa a habilidade correspondente para fazer o trabalho. Este guia descreve as habilidades do Amazon MWAA, como instalá-las para vários assistentes e exemplos de solicitações que você pode usar.

Visão geral do

O AWS Plugin de análise de dados (aws-data-analytics) no código aberto Kit de ferramentas de agentes para AWS na GitHub O site fornece habilidades de agentes para fluxos de trabalho gerenciados da Amazon para Apache Airflow.

Uma habilidade é um pacote de instruções que orienta um assistente de codificação de IA (como Kiro, Claude Code, Amazon Q, Cursor ou Codex) por meio de uma operação comum do Amazon MWAA. Essas habilidades seguem o que está aberto. Padrão de habilidades do agente no site da Anthropic, para que você possa usá-los em assistentes que suportam o padrão.

As habilidades do Amazon MWAA funcionam com ambientes provisionados do Amazon MWAA e com o Amazon MWAA Serverless, exceto onde indicado. Em ambientes provisionados, você cria fluxos de trabalho como gráficos acíclicos direcionados (DAGs) do Python. No Amazon MWAA Serverless, você cria fluxos de trabalho como YAML.

O plug-in inclui as quatro habilidades do Amazon MWAA a seguir.

• authoring-mwaa-workflow cria e implanta DAGs do Apache Airflow em ambientes provisionados e fluxos de trabalho YAML para Amazon MWAA Serverless.

• debugging-mwaa-workflow encontra a causa raiz de falhas nas execuções e instâncias de tarefas, DAGs que não aparecem, erros de importação, erros de falta de memória do trabalhador e erros de permissão do IAM.

• testing-mwaa-workflow aciona um DAG ou fluxo de trabalho implantado, o monitora até a conclusão e testa novamente após as correções.

• upgrading-mwaa-environments atualiza um ambiente provisionado para uma versão mais recente do Apache Airflow, incluindo 2.x para 3.x, usando uma estratégia azul-esverdeada ou local. Essa habilidade oferece suporte somente a ambientes provisionados, não ao Amazon MWAA Serverless.

As habilidades correm AWS Interface de linha de comando (AWS Comandos CLI) para interagir com seu AWS recursos. Recomendamos que você também instale o AWS Servidor de protocolo de contexto modelo (MCP). As habilidades usam o AWS Servidor MCP para buscar a corrente AWS documentação em tempo de execução e para execução AWS Comandos CLI com execução em área restrita e registro de auditoria.

Instalando as habilidades

As habilidades do Amazon MWAA fazem parte do aws-data-analytics plugin no Agent Toolkit para AWS. Para instalar o AWS Servidor MCP e configure seu assistente de codificação, como Kiro, Claude Code, Codex, Cursor ou o AWS CLI, siga Começando no kit de ferramentas do agente para AWS Guia do usuário. Ao instalar plug-ins ou habilidades, escolha o aws-data-analytics plugin, que fornece as habilidades do Amazon MWAA.

Pré-requisitos

Preencha os pré-requisitos em Primeiros passos. Além disso, conceda seu AWS Identity and Access Management Permissões principais (IAM) para os namespaces de ação do Amazon MWAA que você usa, com base nos recursos que você usa. Use o airflow namespace para ambientes Amazon MWAA e a API REST do Apache Airflow e o airflow-serverless namespace para fluxos de trabalho e execuções sem servidor do Amazon MWAA.

Instalando o plugin aws-data-analytics

Instale o aws-data-analytics plugin para seu assistente. Por exemplo, no Claude Code, execute o seguinte comando:

/plugin install aws-data-analytics@claude-plugins-official

Para Kiro, Codex, Cursor e outros assistentes, instale o aws-data-analytics plugin ou suas habilidades, conforme descrito em Primeiros passos. Para instalar as habilidades diretamente do repositório, execute o seguinte comando:

npx skills add aws/agent-toolkit-for-aws/skills

Exemplos de prompt

Depois de instalar as habilidades, você pode dar instruções em linguagem natural ao seu assistente para concluir as operações do Amazon MWAA. Os exemplos a seguir são agrupados por habilidade.

Use as instruções a seguir para criar e implantar fluxos de trabalho com o authoring-mwaa-workflow habilidade.

• “Crie um DAG Apache Airflow que execute uma exportação diária de dados e implante-o em meu ambiente”

• “Crie um fluxo de trabalho YAML para o Amazon MWAA Serverless”

• “Escreva um pipeline que orquestre três tarefas e programe-o para ser executado a cada hora”

Use as instruções a seguir para testar fluxos de trabalho com o testing-mwaa-workflow habilidade.

• “Teste meu DAG e assista até que ele termine”

• “Acione um teste do meu fluxo de trabalho e relate se ele foi bem-sucedido”

• “Smoke-test o gasoduto que acabei de implantar”

Use as instruções a seguir para depurar fluxos de trabalho com o debugging-mwaa-workflow habilidade.

• “Encontre a causa raiz da minha falha no DAG”

• “Meu DAG não está aparecendo na interface do Airflow”

• “Por que meu funcionário está ficando sem memória?”

Use as instruções a seguir para atualizar ambientes com o upgrading-mwaa-environments habilidade.

• “Atualize meu ambiente do Apache Airflow 2 para 3"

• “Planeje uma atualização azul-esverdeada que preserve meu histórico de corridas”

• “Migrar meu ambiente MWAA para uma versão mais recente do Apache Airflow”

Você não precisa nomear uma habilidade em seu prompt. Seu assistente seleciona a habilidade correspondente automaticamente com base em sua solicitação.

Recursos relacionados

Para obter mais informações sobre o AWS habilidades dos agentes para o Amazon MWAA, consulte os seguintes recursos.

• Começando no kit de ferramentas do agente para AWS Guia do usuário.

• O Kit de ferramentas de agentes para AWS na GitHub site.

• O AWS Plugin de análise de dados na GitHub site, que fornece as habilidades do Amazon MWAA.

• O AWS Servidor MCP documentação.

• O Padrão aberto de habilidades de agente no site da Anthropic.