Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# 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.
**Topics**
+ [Panoramica di](#using-agent-skills-overview)
+ [Installazione delle competenze](#using-agent-skills-install)
+ [Prompt di esempio](#using-agent-skills-examples)
+ [Risorse correlate](#using-agent-skills-resources)
## Panoramica di
Le [AWS Plugin di analisi dei dati](https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-data-analytics) (`aws-data-analytics`) nell'open source [Agent Toolkit per AWS](https://github.com/aws/agent-toolkit-for-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](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) 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](https://docs.aws.amazon.com/aws-mcp/latest/userguide/what-is-mcp-server.html) 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](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/quick-start.html) 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](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/quick-start.html) nell'Agent Toolkit per AWS Guida per l'utente.
+ La [Agent Toolkit per AWS](https://github.com/aws/agent-toolkit-for-aws) sul GitHub sito web.
+ Il [AWS Plugin di analisi dei dati](https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-data-analytics) sul GitHub sito Web, che fornisce le competenze Amazon MWAA.
+ Il [AWS Server MCP](https://docs.aws.amazon.com/aws-mcp/latest/userguide/what-is-mcp-server.html) documentazione.
+ La [Agent Skills (standard aperto)](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) sul sito web di Anthropic.