CloudFormation テンプレートから挑むプロンプトエンジニアリング

Transcript

1. # 役割 あなたは、AWS CloudFormationの構文、ベストプラクティスに精通 したエンジニアです。 # タスク 既存のVPC（VPC ID: vpc-123456）内に、CIDRブロックが 192.168.2.0/24で・・・を YAML 形式で作成する。 # 条件 出力はスタックテンプレートのみ 藪内 一貴 CloudFormationテンプレートから 挑むプロンプトエンジニアリング
2. 概要  AWSのリソース群IaCをAIで生成  主な内容はプロンプトエンジニアリング  効果的なプロンプトを模索  手作業を可能な限り削減  有効性や課題の分析  目標はWebアプリにアクセスできること ※AIの生成内容は確認した上で利用
3. AWS CloudFormation  Infrastructure as Code (IaC)  AWSリソース群のJSONやYAML形式のコード（テンプレート）による定義  同一の環境を容易に再現可能  再利用性や保守性の向上  手作業によるミスの削減
4. プロンプトエンジニアリング Role（役割） 生成AIに与える特定の専門家 や性格を記述する。回答内容 の専門度合いや口調を制御で きる。 Instruction（指示） 具体的に何をしてほしいかを 明確に記述する。調査や要約、 エラー対応などがある。5W1H を意識すると明確になる。 Constraint（制約） 出力形式の制約を記述する。 箇条書きや表形式、文字数な どがある。 # 役割 あなたは、AWS CloudFormationの構文、ベストプラ クティスに精通したエンジニアです。 # タスク 既存のVPC（VPC ID: vpc-123456）内に、CIDRブ ロックが・・・を YAML 形式で作成する。 # 条件 出力はスタックテンプレートのみ AIから望ましい生成結果を得るために、プロンプトの内容を最適化する技術
5. 作業の流れ プロンプトのひな型を作る プロンプト テンプレート用のプロンプト を作るプロンプト テンプレートを作るプロンプト # 役割 あなたは、AWS CloudFormationの構 文、ベストプラクティスに精通した エンジニアです。 # タスク 既存のVPC（VPC ID: vpc-123456） 内に、CIDRブロックが・・・を YAML 形式で作成する。 # 条件 出力はスタックテンプレートのみ 役割, 指示, 制限で構成されるプロン プトを作成するためのプロンプトを 作成して。ただし、プロンプトは日 本語で作成して。 以下の条件を満たして。 ・・・ プロンプトを作る プロンプト # プロンプト生成用メタプロンプト あなたはプロンプトエンジニアリン グ専門家向けの高品質なプロンプト を生成する。 ## 生成するプロンプトの構造 ### 1. 役割 - LLMが担うべき専門家の役割、性 格、視点を定義する ・・・ ## AWSリソースの最低限の要件 ・・・
6. 作業の流れ コードのチェックと修正 をするプロンプト Cloudformationによ るリソース群の作成 Webアプリの接続確認
7. 実行環境と作業の雰囲気 生成AI：Claude（Sonnet 4.5） テンプレートを作成するプロンプトを作成する  プロンプトのひな型を作るプロンプト  プロンプトの作成コストの削減 役割, 指示, 制限で構成されるプロンプトを作成するため のプロンプトを作成して。ただし、プロンプトは日本語 で作成して。 以下の条件を満たして。 ・「してください」や「ありがとう」などLLMに対して 丁寧でなくてよい。 ・・・ ・指示を達成するために、必要な情報や質問あれば対話 的に尋ねるように記述する。 # 役割 生成AIに与える特定の専門家や性格を記述する。回答内 容の専門度合いや口調を制御できる。 # 指示 ・・・
8. 実行環境と作業の雰囲気 生成AI：Claude（Sonnet 4.5） プロンプトに書き込むAWSリソース群の要件  最低限の要件を一連の文章で記述（楽）  生成されたテンプレートの可読性向上 表や簡潔な説明の指定 AWS CloudFormationで用いるスタックのテンプレートを 作成する。AWSのスタックで実現するのはPythonで作成す る「おみくじアプリ」を特定のグローバルIPアドレスからのみア クセル可能とすること。この特定のグローバルIPアドレスはテ ンプレート作成後に、私が記入する。 ・・・ テンプレートでどのリソースを作成したのか、どのパラメータを 用いたのかを簡潔に表でまとめる。 可能な限り低コスト・高セキュリティなリソース群を作成する。 どの点で低コスト・高セキュリティを実現したのかを簡潔に表 でまとめる。
10. テンプレート作成に使用したプロンプト  効果的な役割となるような細かな指定 # 役割 あなたはAWSインフラストラクチャ設計とCloudFormation実装に精通したシニアク ラウドアーキテクトである。セキュリティベストプラクティス、コスト最適化、IaCの原則 を深く理解し、本番環境レベルのテンプレートを設計する。 # 指示 ## 目的 FastAPIベースのPythonおみくじアプリケーションを、特定IPアドレスからのみアク セス可能な形でAWS上にデプロイするCloudFormationテンプレートを作成する。 ## アーキテクチャ要件 • 使用するリージョン: 東京 • アプリケーション配置: EC2インスタンス(プライベートサブネット内) ・・・
11. 人手で対応したエラー  テンプレートの文法規則の侵害  コード内で日本語禁止の箇所に日本語を記入  使えないリソース名の使用 例）セキュリティグループ名で使えないもの：sg-*  誤った構文の使用（一見、正しそうな書き方）  プロンプトの質向上や生成結果を確認するための知識は必要  想定外のリソース作成の回避  高セキュリティや低コストとなっているかの確認
12. 結果確認  リソース群の作成「CREATE COMPLETE」  Webアプリの接続と動作確認
13. まとめ  作業内容  CloudFormationとClaudeの使用  IaCを作成するためのプロンプトエンジニアリング  プロンプトの自動作成  学び  プロンプトエンジニアリングの有効性  プロンプトの修正や変更を管理する必要性の実感  雑にすると出力が不安定・生成結果の低い可読性  関連ツールへの興味  Kiro  Well-Architected IaC Analyzer