そろそろ手動でAWS構成図を書くのはやめたい ~Amazon Q CLI カスタムエージェントでAWS構成図作成してみた~

そろそろ手動でAWS構成図を書くのはやめたい Amazon Q CLI カスタムエージェントでAWS構成図作成してみた生成AI GameDay

はじめに本日、GameDayの運営にご尽力いただい皆様、ありがとうございました。生成AI GameDay、とても楽しかったです！

はじめにこれで今日から生成AIマスター！

はじめにとは、行かないですかね笑

はじめにもともと生成AIに興味はあるのですが、残念なことに、私はそのうまい活用方法を見つけられていません、、

はじめにそんな中ですが、今回、私なりに生成AI活用方法を考えて、実践してみたのでそれをご紹介させていただければと思います！

システム構成図ってどう書いてますか？ ▪システム構成図の役割・運用管理の効率化 AWSリソースやサービスの全体像を「見える化」することで、運用管理や障害対応、新規メンバーへの知識共有をスムーズにする・運用自動化や改善施策の指針監視設定や自動復旧シナリオを設計したり、コスト最適化のポイントを整理したりする際のベース資料として活用

CFテンプレートや、AWSコンソールからその構成を理解する必要があるまずインプットに時間がかかる色々な作図ツールがあるが、一定の知識が必要作図ツールよくわからない更新作業が追いつかないことから、構成図が陳腐化し、実態と異なる資
料が増加品質担保ができないシステム構成図ってどう書いてますか？手動作成されている方、結構多いのではないでしょうか。手動作成の問題点

今回やったこと操作端末（Windows）にAmazon Q CLI のインストール Amazon Q CLI カスタムエージェントの作成

今回やったこと https://docs.aws.amazon.com/ja_jp/amazonq/latest/qdeveloper-ug/qdev-mcp-overview.html ➀Amazon Q CLI インストール ②カスタムエージェントの作成 AWS Document MCP
サーバ Aws diagram MCP サーバ

Amazon Q CLI カスタムエージェントとは特定のユースケースやワークフロー用に設定できるカスタマイズ可能な AI アシスタント。汎用アシスタントを使用する代わりに、カスタムエージェントを使用すると、たとえば、、、・AWS
ツールとドキュメントにアクセスできる AWS スペシャリストカスタムエージェント・プロジェクト固有のドキュメントとスクリプトツールを含むカスタムエージェントを作成できます。 https://docs.aws.amazon.com/ja_jp/amazonq/latest/qdeveloper-ug/command-line-custom-agents.html

Amazon Q CLI カスタムエージェントの定義（抜粋） { "name": "DiagramAgent", "prompt": "あなたはAWSアーキテクチャの専門家です。¥n最新のAWS公式ドキュメントとそのベストプラクティスに基づいて、要求されたシステムのAWS構成図を最適な設計で作成してください。¥n構成図はAWSのサービスアイコンを適切に使用し、関係性（通信経路や依存関係）をわかりやすく示してください。¥n最終的な出力は編集や利用がしやすいSVG形式で作成し、図の
説明も添えてください。", "mcpServers": { "awslabs.aws-documentation-mcp-server": { "command": "uvx", "args": ["awslabs.aws-documentation-mcp-server@latest"], "env": { "FASTMCP_LOG_LEVEL": "ERROR", "AWS_DOCUMENTATION_PARTITION": "aws" }, "disabled": false, "autoApprove": [] }, "awslabs.aws-diagram-mcp-server": { "command": "uvx", "args": ["awslabs.aws-diagram-mcp-server"], "env": { "FASTMCP_LOG_LEVEL": "ERROR" }, "autoApprove": [], "disabled": false } }, "allowedTools": [ "@awslabs.aws-documentation-mcp-server", "@awslabs.aws-diagram-mcp-server" ], "model": "claude-sonnet-4"

Amazon Q CLI カスタムエージェントの作成・q chatコマンドで、Amazon Q を開始・/agent create
--name DiagramAgentコマンドで、カスタム（ダイアグラム）エージェント作成

ダイアグラムエージェントの実行・AWSアップデート情報自動通知システム「WeeklyAWSStateMachine」（StepFunctins）について、現在の構成図を教えてください。現在の構成調査には、「master」プロファイルを使用してください。

ダイアグラムエージェントの実行結果

ちなみに、以前に私が手動で書いた同アーキテクチャがこれです。

Before → After

本日のまとめいかがだったでしょうか。まだまだ調整は必要ですが、カスタムエージェントはシステム構成図作成効率化の有力手段になるかもしれません。また、カスタムエージェント触るの楽しかったです。ぜひ自分好みのエージェント作ってみください！

そろそろ手動でAWS構成図を書くのはやめたい ~Amazon Q CLI カスタムエージェン...

そろそろ手動でAWS構成図を書くのはやめたい ~Amazon Q CLI カスタムエージェントでAWS構成図作成してみた~

KosakaYudai

More Decks by KosakaYudai

Other Decks in Technology

Featured

Transcript