Ai Infrastructure Agent

🚀 AIインフラストラクチャエージェント

自然言語対話によるインテリジェントなAWSインフラストラクチャ管理

🚀 クイックスタート

AIインフラストラクチャエージェントは、自然言語コマンドを使用してAWSインフラストラクチャを管理できるインテリジェントシステムです。高度なAIモデル（OpenAI GPT、Google Gemini、またはAnthropic Claude）を搭載し、インフラストラクチャ要求を実行可能なAWS操作に変換します。同時に、競合検出と解決機能を通じて安全性を維持します。

⚠️ 重要提示

このリポジトリには、AIを活用したインフラストラクチャ管理エージェントの概念実証実装が含まれています。現在、開発中であり、本番環境での使用を意図していません。将来的に本番環境で使用可能なバージョンをリリースする予定です。自己責任で使用し、必ず開発環境でテストしてください。

💡 使用建议

Amazon Novaを使用する場合、より適切なコンテキストを得るために、リクエストにリージョンを指定すると良いです。例えば、"us-east-1でApacheサーバーをホストするためのEC2インスタンスを作成してください..." のように指定します。

✨ 主な機能

• 自然言語インターフェース - 構築方法ではなく、目的を説明するだけです。
• 複数のAIプロバイダーサポート - OpenAI、Google Gemini、Anthropic、AWS Bedrock Nova、またはOllama（ローカルLLM）から選択できます。
• Webダッシュボード - インフラストラクチャ管理のための視覚的なインターフェースで、組み込みの競合検出とドライランモードがあります。
• Terraformのような状態管理 - 正確なインフラストラクチャ状態を維持します。
• 現在のリソースサポート - VPC、EC2、SG、オートスケーリンググループ、ALB。ロードマップはこちらを確認してください：Core Platform Development

📦 インストール

詳細ガイド

Installation Guide

リポジトリのクローン

git clone https://github.com/VersusControl/ai-infrastructure-agent.git
cd ai-infrastructure-agent

1. 設定ファイルの編集

# メイン設定の編集
nano config.yaml

2. AIプロバイダーの設定

config.yaml で好みのAIプロバイダーを選択します。

agent:
  provider: "openai"          # オプション: openai, gemini, anthropic, bedrock, ollama
  model: "gpt-4"             # 使用するモデル
  max_tokens: 4000
  temperature: 0.1
  dry_run: true              # 最初はドライランモードを有効にする
  auto_resolve_conflicts: false

3. 環境変数の設定

詳細な設定ガイド：

• OpenAI：OpenAI API Key Setup Guide
• Google Gemini：Gemini API Key Setup Guide
• Anthropic Claude：Anthropic API Key Setup Guide
• AWS Bedrock Nova：AWS Bedrock Nova Configuration Guide
• Ollama (Local LLM)：Ollama Setup Guide

# OpenAIの場合
export OPENAI_API_KEY="your-openai-api-key"

# Google Geminiの場合
export GEMINI_API_KEY="your-gemini-api-key"

# Anthropic Claudeの場合
export ANTHROPIC_API_KEY="your-anthropic-api-key"

# Ollama（オプション - デフォルトは http://localhost:11434）
export OLLAMA_SERVER_URL="http://localhost:11434"

# AWS Bedrock Nova - AWS認証情報を使用（APIキーは不要）
# AWS認証情報を設定するには、aws configure、環境変数、またはIAMロールを使用します

4. AWS認証情報の設定

# AWS CLIの設定
aws configure

# または環境変数を設定する
export AWS_ACCESS_KEY_ID="your-access-key"
export AWS_SECRET_ACCESS_KEY="your-secret-key"
export AWS_DEFAULT_REGION="us-west-2"

クイックインストール

方法1: Dockerインストール

基本的なDocker実行：

docker run -d \
  --name ai-infrastructure-agent \
  -p 8080:8080 \
  -v $(pwd)/config.yaml:/app/config.yaml:ro \
  -v $(pwd)/states:/app/states \
  -e OPENAI_API_KEY="your-openai-api-key-here" \
  -e AWS_ACCESS_KEY_ID="your-aws-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-aws-secret-key" \
  -e AWS_DEFAULT_REGION="us-west-2" \
  ghcr.io/versuscontrol/ai-infrastructure-agent

Docker Compose（推奨）。docker-compose.yml ファイルを作成します。

version: '3.8'

services:
  ai-infrastructure-agent:
    image: ghcr.io/versuscontrol/ai-infrastructure-agent
    container_name: ai-infrastructure-agent
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      # 設定ファイルをマウント（読み取り専用）
      - ./config.yaml:/app/config.yaml:ro
      # データディレクトリをマウント（永続的）
      - ./states:/app/states
    environment:
      # AIプロバイダーのAPIキー（1つを選択）
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      # - GEMINI_API_KEY=${GEMINI_API_KEY}
      # - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      
      # AWS設定
      - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
      - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
      - AWS_DEFAULT_REGION=${AWS_DEFAULT_REGION:-us-west-2}

アプリケーションを起動します。

# Docker Composeで起動
docker-compose up -d

# ログを表示
docker-compose logs -f

# アプリケーションを停止
docker-compose down

方法2: 自動化されたBashスクリプト

# リポジトリをクローン
git clone https://github.com/VersusControl/ai-infrastructure-agent.git
cd ai-infrastructure-agent

# インストールスクリプトを実行
./scripts/install.sh

Web UIを起動します。

./scripts/run-web-ui.sh

ダッシュボードへのアクセス

ブラウザを開き、次のURLにアクセスします。

http://localhost:8080

💻 使用例

基本的な使用法

# シンプルなEC2インスタンス
"Create a t3.micro EC2 instance with Ubuntu 22.04"

# Webサーバーのセットアップ
"Deploy a load-balanced web application with 2 EC2 instances behind an ALB"

# データベースのセットアップ
"Create an RDS MySQL database with read replicas in multiple AZs"

# 完全な環境のセットアップ
"Set up a development environment with VPC, subnets, EC2, and RDS"

高度な使用法

例えば、次のような要求でAWSインフラストラクチャを作成するシナリオを考えます。

"Create an EC2 instance for hosting an Apache Server with a dedicated security group that allows inbound HTTP (port 80) and SSH (port 22) traffic."

1. AI分析と計画

AIエージェントが要求を分析し、詳細な実行計画を作成します。

sequenceDiagram
    participant U as User
    participant A as AI Agent
    participant S as State Manager
    participant M as MCP Server
    participant AWS as AWS APIs
    
    U->>A: "Create EC2 instance for Apache Server..."
    A->>S: Get current infrastructure state
    S->>A: Return current state
    A->>M: Query available tools & capabilities
    M->>A: Return tool capabilities
    A->>A: Generate execution plan with LLM
    A->>AWS: Validate plan (dry-run checks)
    AWS->>A: Validation results
    A->>U: Present execution plan for approval
    
    Note over A,U: Plan includes:<br/>• Get Default VPC<br/>• Create Security Group<br/>• Add HTTP & SSH rules<br/>• Get Latest AMI<br/>• Create EC2 Instance

エージェントは計画を提示し、確認を求めます。

• 具体的に何が作成されるかを表示します。
• 承認を待ちます。

2. 実行と監視

承認されると、エージェントは以下のことを行います。

• 正しい順序でリソースを作成します。
• 進行状況をリアルタイムで監視します。
• 依存関係を自動的に処理します。
• 完了ステータスを報告します。

ライブデモを確認してください。

3. その他の例

• クイックチュートリアル：AI Infrastructure Agent for AWS
• シリーズチュートリアル：Building Your Business on AWS with AI Agent

📚 ドキュメント

• AI Infrastructure Agent documentation

🔧 技術詳細

アーキテクチャ

詳細はこちらを読んでください：Technical Architecture Overview

コンポーネント

• Webインターフェース：視覚的な対話のためのReactベースのダッシュボードです。
• MCPサーバー：モデルコンテキストプロトコルを実装するコアエージェントです。
• エージェントコア：AIによる意思決定と計画を行います。
• AWSクライアント：安全なAWS SDKの統合です。
• 状態管理：インフラストラクチャの状態追跡と競合解決を行います。

安全機能

ドライランモード

すべての操作は最初に「ドライラン」モードで実行できます。

• 具体的に何が作成/変更/削除されるかを表示します。
• 実行前にコストを見積もります。
• 実際のAWSリソースには触れません。

状態管理

• 正確なインフラストラクチャ状態を維持します。
• 期待される構成からのズレを検出します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

⚖️ 免責事項

これは概念実証プロジェクトです。ドライランモードや競合検出などの安全対策を実装していますが、常に以下のことを行ってください。

• 最初に開発環境でテストしてください。
• すべての生成された計画を実行前に確認してください。
• 適切なAWS IAMパーミッションを維持してください。
• コストとリソースの使用状況を監視してください。
• 重要なインフラストラクチャのバックアップを保持してください。

このソフトウェアの使用によって生じるいかなるコスト、データ損失、またはセキュリティ問題について、著者は責任を負いません。