Einsatz von Agentenfertigkeiten mit Amazon MWAA

Agentenfähigkeiten sind Anleitungspakete, die einen KI-Programmierassistenten durch Amazon Managed Workflows für Apache Airflow-Operationen führen. Das AWS Datenanalyse-Plugin (aws-data-analytics) im Open-Source-Agent-Toolkit für AWS bietet eine Reihe von Fähigkeiten, die dem offenen Agent Skills-Standard entsprechen. Nachdem Sie die Skills installiert haben, beschreiben Sie in natürlicher Sprache, was Sie tun möchten, und Ihr Assistent verwendet die entsprechende Fähigkeit, um die Arbeit zu erledigen. In diesem Handbuch werden die Amazon MWAA-Skills beschrieben, wie Sie sie für mehrere Assistenten installieren, und es gibt Beispiele für Prompts, die Sie verwenden können.

-Übersicht

Das AWS Datenanalyse-Plugin (aws-data-analytics) im Open-Source-Format Agenten-Toolkit für AWS auf der GitHub Die Website bietet Agentenkompetenzen für Amazon Managed Workflows für Apache Airflow.

Ein Skill ist ein Anweisungspaket, das einen KI-Programmierassistenten (wie Kiro, Claude Code, Amazon Q, Cursor oder Codex) durch eine übliche Amazon MWAA-Operation führt. Diese Fähigkeiten folgen dem Offenen Fähigkeiten von Agenten sind Standard auf der Anthropic-Website, sodass Sie sie für alle Assistenten verwenden können, die den Standard unterstützen.

Die Amazon MWAA-Skills funktionieren sowohl mit von Amazon MWAA bereitgestellten Umgebungen als auch mit Amazon MWAA Serverless, sofern nicht anders angegeben. In bereitgestellten Umgebungen erstellen Sie Workflows als von Python gesteuerte azyklische Graphen (DAGs). In Amazon MWAA Serverless erstellen Sie Workflows als YAML.

Das Plugin beinhaltet die folgenden vier Amazon MWAA-Skills.

• authoring-mwaa-workflow erstellt und implementiert Apache Airflow DAGs für bereitgestellte Umgebungen und YAML-Workflows für Amazon MWAA Serverless.

• debugging-mwaa-workflow findet die Hauptursache für fehlgeschlagene Läufe und Task-Instances, nicht angezeigte DAGs, Importfehler, Worker-Fehler und IAM-Berechtigungsfehler.

• testing-mwaa-workflow löst eine bereitgestellte DAG oder einen bereitgestellten Workflow aus, überwacht ihn bis zum Abschluss und testet ihn nach Korrekturen erneut.

• upgrading-mwaa-environments aktualisiert eine bereitgestellte Umgebung auf eine neuere Apache Airflow-Version, einschließlich 2.x bis 3.x, indem es eine Blau-Grün-Strategie oder eine In-Place-Strategie verwendet. Dieser Skill unterstützt nur bereitgestellte Umgebungen, nicht Amazon MWAA Serverless.

Die Skills laufen AWS Befehlszeilenschnittstelle (AWS CLI) -Befehle zur Interaktion mit Ihrem AWS Ressourcen. Wir empfehlen, dass Sie auch das installieren AWS Model Context Protocol (MCP) -Server. Die Fähigkeiten nutzen die AWS MCP-Server um aktuelle Daten abzurufen AWS Dokumentation zur Laufzeit und zum Ausführen AWS CLI-Befehle mit Sandbox-Ausführung und Audit-Logging.

Installation der Fähigkeiten

Die Amazon MWAA-Fähigkeiten sind Teil der aws-data-analytics Plugin im Agent Toolkit für AWS. Um das zu installieren AWS MCP Server und richten Sie Ihren Programmierassistenten ein, wie Kiro, Claude Code, Codex, Cursor oder den AWS CLI, folgen Erste Schritte im Agent Toolkit für AWS Benutzerleitfaden. Wenn Sie Plugins oder Skills installieren, wählen Sie das aws-data-analytics Plugin, das die Amazon MWAA-Fähigkeiten bereitstellt.

Voraussetzungen

Erfüllen Sie die Voraussetzungen unter Erste Schritte. Gewähren Sie außerdem AWS Identity and Access Management (IAM-) Prinzipalberechtigungen für die Amazon MWAA-Aktionsnamespaces, die Sie verwenden, bezogen auf die Ressourcen, die Sie verwenden. Verwenden Sie die airflow Namespace für Amazon MWAA-Umgebungen und die Apache Airflow REST-API sowie airflow-serverless Namespace für Amazon MWAA Serverless-Workflows und -Läufe.

Installation des AWS-Data-Analytics-Plug-ins

Installieren Sie das aws-data-analytics Plugin für deinen Assistenten. Führen Sie beispielsweise in Claude Code den folgenden Befehl aus:

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

Installieren Sie für Kiro, Codex, Cursor und andere Assistenten den aws-data-analytics Plugin oder dessen Fähigkeiten, wie unter Erste Schritte beschrieben. Um die Skills direkt aus dem Repository zu installieren, führen Sie den folgenden Befehl aus:

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

Beispiele für Prompts

Nachdem Sie die Skills installiert haben, können Sie Ihrem Assistenten Anweisungen in natürlicher Sprache geben, um Amazon MWAA-Vorgänge abzuschließen. Die folgenden Beispiele sind nach Fähigkeiten gruppiert.

Verwenden Sie die folgenden Eingabeaufforderungen, um Workflows mit dem zu erstellen und bereitzustellen authoring-mwaa-workflow Fähigkeit.

• „Erstellen Sie eine Apache Airflow DAG, die täglich einen Datenexport durchführt, und stellen Sie sie in meiner Umgebung bereit“

• „Erstellen Sie einen YAML-Workflow für Amazon MWAA Serverless“

• „Schreiben Sie eine Pipeline, die drei Aufgaben orchestriert, und planen Sie, dass sie jede Stunde ausgeführt wird“

Verwenden Sie die folgenden Eingabeaufforderungen, um Workflows mit dem zu testen testing-mwaa-workflow Fähigkeit.

• „Testen Sie meine DAG und schauen Sie sie sich an, bis sie fertig ist“

• „Löse einen Testlauf meines Workflows aus und melde, ob er erfolgreich war“

• “Smoke-test die Pipeline, die ich gerade bereitgestellt habe“

Verwenden Sie die folgenden Eingabeaufforderungen, um Workflows mit dem zu debuggen debugging-mwaa-workflow Fähigkeit.

• „Finde die Ursache für meine ausgefallene DAG“

• „Meine DAG wird nicht in der Airflow-Benutzeroberfläche angezeigt“

• „Warum geht meinem Worker der Speicher aus?“

Verwenden Sie die folgenden Eingabeaufforderungen, um Umgebungen mit dem zu aktualisieren upgrading-mwaa-environments Fähigkeit.

• „Aktualisiere meine Umgebung von Apache Airflow 2 auf 3"

• „Plane ein blau-grünes Upgrade, bei dem mein Laufverlauf erhalten bleibt“

• „Migrieren Sie meine MWAA-Umgebung auf eine neuere Apache Airflow-Version“

Sie müssen in Ihrer Eingabeaufforderung keinen Skill benennen. Ihr Assistent wählt auf der Grundlage Ihrer Anfrage automatisch den passenden Skill aus.

Zugehörige Ressourcen

Für weitere Informationen über die AWS Die Fähigkeiten von Agenten für Amazon MWAA finden Sie in den folgenden Ressourcen.

• Erste Schritte im Agent Toolkit für AWS Benutzerleitfaden.

• Das Agenten-Toolkit für AWS auf der GitHub Webseite.

• Die AWS Datenanalyse-Plugin auf dem GitHub Website, die die Amazon MWAA-Fähigkeiten bereitstellt.

• Die AWS MCP-Server Dokumentation.

• Die Fähigkeiten für Agenten sind ein offener Standard auf der Anthropic-Website.