Uso de las habilidades de los agentes con Amazon MWAA

Las habilidades de los agentes son paquetes de instrucciones que guían a un asistente de codificación de IA en las operaciones de Amazon Managed Workflows para Apache Airflow. El AWS Plugin de análisis de datos (aws-data-analytics) en el Agent Toolkit de código abierto para AWS proporciona un conjunto de habilidades que siguen el estándar abierto de habilidades de agente. Tras instalar las habilidades, usted describe lo que quiere hacer en lenguaje natural y su asistente utilizará la habilidad correspondiente para realizar el trabajo. En esta guía se describen las habilidades de Amazon MWAA, cómo instalarlas para varios asistentes y ejemplos de instrucciones que puede utilizar.

Descripción general de

El AWS Plugin de análisis de datos (aws-data-analytics) en código abierto Kit de herramientas para agentes para AWS en el GitHub el sitio web proporciona habilidades de agente para Amazon Managed Workflows for Apache Airflow.

Una habilidad es un paquete de instrucciones que guía a un asistente de codificación de IA (como Kiro, Claude Code, Amazon Q, Cursor o Codex) a través de una operación común de Amazon MWAA. Estas habilidades siguen lo abierto Estándar de habilidades de agente en el sitio web de Anthropic, para que puedas utilizarlos en todos los asistentes compatibles con el estándar.

Los conocimientos de Amazon MWAA funcionan tanto con entornos aprovisionados de Amazon MWAA como con Amazon MWAA Serverless, excepto cuando se indique lo contrario. En los entornos aprovisionados, los flujos de trabajo se crean como gráficos acíclicos (DAG) dirigidos por Python. En Amazon MWAA Serverless, los flujos de trabajo se crean como YAML.

El complemento incluye las siguientes cuatro habilidades de Amazon MWAA.

• authoring-mwaa-workflow crea e implementa DAG de Apache Airflow para entornos aprovisionados y flujos de trabajo de YAML para Amazon MWAA Serverless.

• debugging-mwaa-workflow busca la causa principal de los errores en las ejecuciones y las instancias de tareas, los DAG que no aparecen, los errores de importación, los errores de falta de memoria de los trabajadores y los errores de permisos de IAM.

• testing-mwaa-workflow desencadena un DAG o un flujo de trabajo implementado, lo monitorea hasta su finalización y vuelve a realizar las pruebas después de corregirlo.

• upgrading-mwaa-environments actualiza un entorno aprovisionado a una versión más reciente de Apache Airflow, incluida la 2.x a la 3.x, mediante una estrategia azul-verde o local. Esta habilidad solo es compatible con entornos aprovisionados, no con Amazon MWAA Serverless.

Las habilidades se ejecutan AWS Interfaz de línea de comandos (AWS comandos de CLI (CLI) para interactuar con su AWS recursos. Le recomendamos que instale también el AWS Servidor de protocolo de contexto modelo (MCP). Las habilidades utilizan el AWS Servidor MCP para buscar la actual AWS documentación en tiempo de ejecución y para ejecutar AWS Comandos de la CLI con registro de auditoría y ejecución en espacio aislado.

Instalación de las habilidades

Las habilidades de Amazon MWAA forman parte del aws-data-analytics complemento del kit de herramientas del agente para AWS. Para instalar el AWS MCP Server y configure su asistente de codificación, como Kiro, Claude Code, Codex, Cursor o el AWS CLI, sigue Empezando en el kit de herramientas para agentes AWS Guía del usuario. Cuando instales complementos o habilidades, elige aws-data-analytics plugin, que proporciona las habilidades de Amazon MWAA.

Requisitos previos

Complete los requisitos previos en la sección Cómo empezar. Además, conceda su AWS Identity and Access Management (IAM) para los espacios de nombres de las acciones de Amazon MWAA que utilice, según los recursos que utilice. Utilice el airflow el espacio de nombres para los entornos de Amazon MWAA y la API REST de Apache Airflow, y el airflow-serverless espacio de nombres para los flujos de trabajo y las ejecuciones sin servidor de Amazon MWAA.

Instalación del complemento aws-data-analytics

Instala el aws-data-analytics plugin para tu asistente. Por ejemplo, en Claude Code, ejecuta el siguiente comando:

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

Para Kiro, Codex, Cursor y otros asistentes, instala el aws-data-analytics el plugin o sus habilidades, tal y como se describe en Primeros pasos. Para instalar las habilidades directamente desde el repositorio, ejecuta el siguiente comando:

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

Ejemplos de peticiones

Tras instalar las habilidades, puede indicarle a su asistente en lenguaje natural que le indique cómo completar las operaciones de Amazon MWAA. Los siguientes ejemplos están agrupados por habilidad.

Utilice las siguientes instrucciones para crear e implementar flujos de trabajo con el authoring-mwaa-workflow habilidad.

• «Crear un DAG Apache Airflow que ejecute una exportación de datos diaria e impleméntelo en mi entorno»

• «Cree un flujo de trabajo de YAML para Amazon MWAA Serverless»

• «Cree una canalización que organice tres tareas y prográmela para que se ejecute cada hora»

Usa las siguientes instrucciones para probar los flujos de trabajo con testing-mwaa-workflow habilidad.

• «Prueba mi DAG y míralo hasta que termine»

• «Haga una prueba de ejecución de mi flujo de trabajo e informe si se ha realizado correctamente»

• »Smoke-test el oleoducto que acabo de desplegar»

Usa las siguientes instrucciones para depurar los flujos de trabajo con debugging-mwaa-workflow habilidad.

• «Encuentre la causa principal de mi DAG fallido»

• «Mi DAG no aparece en la interfaz de usuario de Airflow»

• «¿Por qué se está agotando la memoria de mi empleado?»

Utilice las siguientes instrucciones para actualizar los entornos con el upgrading-mwaa-environments habilidad.

• «Actualice mi entorno de Apache Airflow 2 a 3"

• «Planifique una actualización azul-verde que conserve mi historial de ejecución»

• «Migre mi entorno MWAA a una versión más reciente de Apache Airflow»

No es necesario que nombre una habilidad en el mensaje. Tu asistente selecciona la habilidad correspondiente automáticamente en función de tu solicitud.

Recursos relacionados

Para obtener más información sobre la AWS habilidades de agente para Amazon MWAA, consulte los siguientes recursos.

• ¿Cómo empezar? en el kit de herramientas para agentes AWS Guía del usuario.

• El Kit de herramientas para agentes AWS en el GitHub sitio web.

• El AWS Plugin de análisis de datos en el GitHub sitio web, que proporciona las habilidades de Amazon MWAA.

• El AWS Servidor MCP documentación.

• La Estándar abierto de Agent Skills en el sitio web de Anthropic.