Utilizzo delle competenze degli agenti con Amazon MWAA

Le competenze degli agenti sono pacchetti di istruzioni che guidano un assistente di codifica AI nelle operazioni di Amazon Managed Workflows for Apache Airflow. Il AWS Plugin per l'analisi dei dati (aws-data-analytics) nell'Agent Toolkit open source per AWS fornisce una serie di competenze che seguono lo standard aperto Agent Skills. Dopo aver installato le competenze, descrivi cosa vuoi fare in linguaggio naturale e l'assistente utilizza l'abilità corrispondente per svolgere il lavoro. Questa guida descrive le competenze di Amazon MWAA, come installarle per diversi assistenti e istruzioni di esempio che puoi utilizzare.

Panoramica di

Le AWS Plugin di analisi dei dati (aws-data-analytics) nell'open source Agent Toolkit per AWS sul GitHub il sito Web fornisce competenze di agente per Amazon Managed Workflows for Apache Airflow.

Una skill è un pacchetto di istruzioni che guida un assistente di codifica AI (come Kiro, Claude Code, Amazon Q, Cursor o Codex) attraverso una comune operazione Amazon MWAA. Queste competenze seguono le regole aperte Agent Skills standard sul sito Web di Anthropic, in modo da poterli utilizzare tra gli assistenti che supportano lo standard.

Le competenze di Amazon MWAA sono valide sia con gli ambienti con provisioning Amazon MWAA che con Amazon MWAA Serverless, tranne dove indicato. Negli ambienti con provisioning, crei flussi di lavoro come grafici aciclici diretti da Python (DAG). In Amazon MWAA Serverless, crei flussi di lavoro come YAML.

Il plugin include le seguenti quattro competenze Amazon MWAA.

• authoring-mwaa-workflow crea e distribuisce DAG Apache Airflow per ambienti con provisioning e flussi di lavoro YAML per Amazon MWAA Serverless.

• debugging-mwaa-workflow trova la causa principale delle esecuzioni e delle istanze di attività non riuscite, dei DAG che non vengono visualizzati, degli errori di importazione, degli errori di esaurimento della memoria dei lavoratori e degli errori di autorizzazione IAM.

• testing-mwaa-workflow attiva un DAG o un workflow implementato, ne monitora il completamento e riprova dopo le correzioni.

• upgrading-mwaa-environments aggiorna un ambiente sottoposto a provisioning a una versione più recente di Apache Airflow, comprese quelle da 2.x a 3.x, utilizzando una strategia blu-verde o sul posto. Questa competenza supporta solo ambienti con provisioning, non Amazon MWAA Serverless.

Le competenze funzionano AWS Interfaccia a riga di comando (AWS comandi CLI) per interagire con il tuo AWS risorse. Ti consigliamo di installare anche AWS Server Model Context Protocol (MCP). Le competenze utilizzano il AWS Server MCP per recuperare la corrente AWS documentazione in fase di esecuzione e da eseguire AWS Comandi CLI con esecuzione in modalità sandbox e registrazione di controllo.

Installazione delle competenze

Le competenze Amazon MWAA fanno parte di aws-data-analytics plug-in nell'Agent Toolkit per AWS. Per installare AWS MCP Server e configura il tuo assistente di codifica, come Kiro, Claude Code, Codex, Cursor o AWS CLI, segui Guida introduttiva nell'Agent Toolkit per AWS Guida per l'utente. Quando installi plugin o competenze, scegli aws-data-analytics plug-in, che fornisce le competenze Amazon MWAA.

Prerequisiti

Completa i prerequisiti in Guida introduttiva. Inoltre, concedi il tuo AWS Identity and Access Management le autorizzazioni principali (IAM) per i namespace delle azioni Amazon MWAA che utilizzi, in base alle risorse che utilizzi. Usa il airflow namespace per gli ambienti Amazon MWAA e l'API REST di Apache Airflow e airflow-serverless namespace per flussi di lavoro ed esecuzioni Amazon MWAA Serverless.

Installazione del plugin aws-data-analytics

Installa aws-data-analytics plugin per il tuo assistente. Ad esempio, in Claude Code, esegui il seguente comando:

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

Per Kiro, Codex, Cursor e altri assistenti, installa aws-data-analytics plugin o le sue competenze, come descritto in Guida introduttiva. Per installare le competenze direttamente dal repository, esegui il seguente comando:

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

Prompt di esempio

Dopo aver installato le competenze, puoi fornire all'assistente istruzioni in linguaggio naturale per completare le operazioni di Amazon MWAA. Gli esempi seguenti sono raggruppati per abilità.

Utilizza i seguenti prompt per creare e distribuire flussi di lavoro con authoring-mwaa-workflow abilità.

• «Crea un DAG Apache Airflow che esegua un'esportazione giornaliera dei dati e distribuiscilo nel mio ambiente»

• «Crea un flusso di lavoro YAML per Amazon MWAA Serverless»

• «Scrivi una pipeline che orchestri tre attività e pianificane l'esecuzione ogni ora»

Utilizza le seguenti istruzioni per testare i flussi di lavoro con testing-mwaa-workflow abilità.

• «Metti alla prova il mio DAG e guardalo finché non finisce»

• «Avvia un test del mio flusso di lavoro e segnala se è andato a buon fine»

• »Smoke-test l'oleodotto che ho appena installato»

Utilizza i seguenti prompt per eseguire il debug dei flussi di lavoro con debugging-mwaa-workflow abilità.

• «Trova la causa principale del mio DAG fallito»

• «Il mio DAG non viene visualizzato nell'interfaccia utente di Airflow»

• «Perché il mio lavoratore sta esaurendo la memoria?»

Utilizza le seguenti istruzioni per aggiornare gli ambienti con upgrading-mwaa-environments abilità.

• «Aggiorna il mio ambiente da Apache Airflow 2 a 3"

• «Pianifica un aggiornamento blu-verde che conservi la cronologia delle mie esecuzioni»

• «Esegui la migrazione del mio ambiente MWAA a una versione più recente di Apache Airflow»

Non è necessario indicare un'abilità nel prompt. L'assistente seleziona automaticamente l'abilità corrispondente in base alla tua richiesta.

Risorse correlate

Per ulteriori informazioni su AWS le competenze degli agenti per Amazon MWAA, consulta le seguenti risorse.

• Guida introduttiva nell'Agent Toolkit per AWS Guida per l'utente.

• La Agent Toolkit per AWS sul GitHub sito web.

• Il AWS Plugin di analisi dei dati sul GitHub sito Web, che fornisce le competenze Amazon MWAA.

• Il AWS Server MCP documentazione.

• La Agent Skills (standard aperto) sul sito web di Anthropic.