⬡ Hub
Skip to content

AWS AI Agent Framework - Project Summary

This document provides a high-level overview of the AWS AI Agent Framework, detailing its current capabilities and outlining the roadmap for future enhancements. The framework is designed to provide an intelligent, natural language interface for managing AWS infrastructure.

Current Capabilities (Version 1.0)

Version 1.0 of the framework focuses on providing foundational management capabilities across a wide range of core AWS services. Each service is managed by a dedicated agent, capable of executing specific commands.

Agents and Commands Implemented:

  • EC2 Agent:
    • list instances: Lists all EC2 instances.
    • start instances: Starts specified EC2 instances.
    • stop instances: Stops specified EC2 instances.
    • terminate instances: Terminates specified EC2 instances.
    • create instance: Creates an EC2 instance with specified OS and optional type.
    • list idle-instances: Lists potentially idle EC2 instances based on low CPU utilization.
  • S3 Agent:
    • list buckets: Lists all S3 buckets.
    • create bucket: Creates a new S3 bucket.
    • smart-create bucket: Creates an S3 bucket with best practices (block public access, default encryption, optional logging).
    • delete bucket: Deletes an S3 bucket.
    • analyze bucket-cost-optimization: Analyzes an S3 bucket for cost optimization opportunities, suggesting lifecycle policies.
  • IAM Agent:
    • list users: Lists all IAM users.
    • list roles: Lists all IAM roles.
    • list policies: Lists all customer-managed IAM policies.
    • create user: Creates a new IAM user.
    • delete user: Deletes an IAM user.
    • create eks-cluster-role: Creates an IAM role for an EKS cluster.
    • create eks-nodegroup-role: Creates an IAM role for an EKS node group.
    • create lambda-execution-role: Creates an IAM role for a Lambda function.
  • VPC Agent:
    • create vpc: Create a new VPC (with safety prompt).
    • create subnet: Create a new subnet (with safety prompt).
  • RDS Agent:
    • create db instance: Create a new RDS DB instance (with safety prompt).
  • CloudWatch Agent:
    • cloudwatch smart-create cpu-alarm for <instance-id> in <region> [threshold <value>] [sns-topic <sns-topic-arn>]
      • Automatically creates a CloudWatch alarm for high CPU utilization on a specified EC2 instance.
    • list alarms: List CloudWatch alarms.
    • list dashboards: List CloudWatch dashboards.
  • CloudTrail Agent:
    • list trails: List CloudTrail trails.
    • describe trails: Describe CloudTrail trails.
  • Cost Management Agent:
    • list budgets: List AWS Budgets.
    • get monthly cost: Get total cost for the last full month.
    • get optimization suggestions: Scan for unattached EBS volumes and unassociated Elastic IPs.
  • Secrets Manager Agent:
    • list secrets: List Secrets Manager secrets.
    • get secret: Get metadata for a secret (not the secret value).
  • ACM Agent:
    • list certificates: List ACM certificates.
  • Route 53 Agent:
    • list hosted-zones: List Route 53 hosted zones.
    • list resource-record-sets: List resource record sets for a hosted zone.
  • ELB Agent:
    • elb smart-create alb named <name> in <region> [vpc <vpc-id>] [subnets <subnet-id-1> ...] [security-groups <sg-id-1> ...]
      • Intelligently creates an Application Load Balancer, a target group, and a listener. Automatically creates a VPC and subnets if not provided.
    • list loadbalancers: List Application and Network Load Balancers.
  • Lambda Agent:
    • lambda smart-create function <name> in <region> [runtime <runtime>] [handler <handler>] [memory <mb>] [timeout <seconds>]
      • Intelligently creates a simple "hello world" Python Lambda function with an associated IAM role.
    • list functions: List Lambda functions.
  • Autoscaling Agent:
    • list autoscaling-groups: List Auto Scaling groups.
  • OpenSearch Agent:
    • opensearch troubleshoot domain <name> in <region>
      • Automatically diagnoses issues within an OpenSearch domain by checking its status and health.
    • create domain: Create an OpenSearch domain (with safety prompt).
  • EKS Agent:
    • create cluster: Create an EKS cluster control plane (with safety prompt).
    • create nodegroup: Create an EKS node group (with safety prompt).

Version 2.0 Features (Intelligent Workflows)

Version 2.0 introduces advanced capabilities where the AI agent orchestrates multiple underlying agents to perform complex, multi-step tasks, often handling prerequisites and dependencies automatically.

Implemented Workflows:

  • create-web-app named <name> in <region>:
    • Automatically creates a best-practice VPC, launches an EC2 web server instance, and sets up an Application Load Balancer to serve traffic.
  • troubleshoot web-app named <name> in <region>:
    • Automatically diagnoses issues within a web application stack by checking Load Balancer, Target Group, EC2 instance health, logs, and security groups.
  • eks smart-create cluster named <name> in <region> [instance-types <type1> ...] * Automatically creates all necessary IAM roles, a best-practice VPC, an EKS cluster control plane, and a managed node group. Installs essential add-ons: EBS CSI Driver, EFS CSI Driver, and prepares for AWS Load Balancer Controller.
  • ec2 create instance named <name> with <os> [type <instance-type>] in <region>:
    • Intelligently creates an EC2 instance, finding the latest AMI, creating a security group with common ports open, and using the default VPC/subnet.
    • vpc smart-create named <name> in <region> [cidr <cidr-block>] [public-subnets <count>] [private-subnets <count>]
      • Intelligently builds a complete, best-practice VPC environment with public/private subnets, IGW, NAT GW, and route tables. Allows specifying the number of public and private subnets.
  • rds smart-create db instance <id> engine <engine> username <user> password <pass> in <region> [class <class>] [storage <gb>] [vpc <vpc-id>]:
    • Intelligently creates an RDS DB instance, handling VPC, DB Subnet Group, and Security Group creation if needed.
  • rds troubleshoot db instance <id> in <region>:
    • Automatically diagnoses issues within an RDS DB instance by checking status, CloudWatch metrics, and security group configurations.

Future Enhancements (Roadmap for Version 2.0+)

This section outlines potential future enhancements and additional AWS services that could be integrated into the AI Agent Framework, building upon the intelligent workflows established in Version 2.0.

Core Services

*   `elasticbeanstalk smart-create web-app named <app-name> in <region> [environment <env-name>] [solution-stack <stack-name>] [instance-type <type>]`
    *   Intelligently creates an Elastic Beanstalk application, environment, and deploys a sample web application.
  • Elastic Beanstalk: For deploying and scaling web applications and services.
    • fargate smart-deploy container-app named <app-name> in <region> [vpc <vpc-id>] [subnets <subnet-id-1> ...] [image <image-name>] [port <port-number>] [cpu <cpu-units>] [memory <mb>]
      • Deploys a simple containerized application to ECS Fargate, creating an ECS cluster, task definition, and service. Automatically creates a VPC and subnets if not provided.
  • Fargate: Serverless compute for containers (for ECS and EKS).
  • Outposts: Extending AWS infrastructure and services to virtually any on-premises or edge location.
    • ebs smart-create volume <name> to <instance-id> in <region> [size <gb>] [type <volume-type>]
      • Intelligently creates an EBS volume and attaches it to a specified EC2 instance.
  • EBS (Elastic Block Store): More granular management of block storage volumes.
    • efs smart-create file-system <name> in <region> [subnet <subnet-id>] [vpc <vpc-id>] [performance-mode <mode>] [throughput-mode <mode>] [security-group <sg-id>]
      • Intelligently creates an EFS file system and a mount target in a specified subnet. Automatically creates a VPC and selects a subnet if not provided.
  • EFS (Elastic File System): Management of scalable file storage for EC2 instances.

Migration Services

  • AWS Migration Hub: Central location to track migrations.
    • dms smart-create replication-task <task-name> source <source-endpoint-id> target <target-endpoint-id> in <region> [replication-instance <rep-instance-id>] [source-engine <engine>] [target-engine <engine>] [instance-class <class>] [migration-type <type>]
      • Creates a DMS replication instance, source/target endpoints, and a replication task (simplified).
  • AWS Database Migration Service (DMS): For migrating databases.
  • AWS Server Migration Service (SMS): For migrating on-premises servers to AWS.

Networking & Content Delivery

*   `apigateway smart-create rest-api <api-name> in <region> [stage <stage-name>] [path <resource-path>]`
    *   Creates a simple REST API with a mock integration and deploys it to a stage.
  • API Gateway: For creating, publishing, maintaining, monitoring, and securing REST, HTTP, and WebSocket APIs.
    • cloudfront smart-create s3-distribution for bucket <bucket-name> in <region> [default-root-object <object-name>]
      • Creates a CloudFront web distribution for an S3 bucket.
  • CloudFront: Content Delivery Network (CDN) service.
  • Direct Connect: Dedicated network connection from your premises to AWS.

Artificial Intelligence & Machine Learning

*   `sagemaker smart-create notebook-instance <name> role <role-arn> in <region> [instance-type <type>] [volume-size <gb>]`
    *   Creates a SageMaker notebook instance.
  • Amazon SageMaker: For building, training, and deploying machine learning models.
    • rekognition analyze-image-labels in bucket <bucket-name> key <object-key> in <region> [max-labels <count>] [min-confidence <percentage>]
      • Detects labels in an image stored in an S3 bucket.
  • Amazon Rekognition: Image and video analysis.
    • comprehend detect-sentiment for text "<text>" in <region> [language <code>]
      • Detects the sentiment (POSITIVE, NEGATIVE, NEUTRAL, MIXED) of a given text.
  • Amazon Comprehend: Natural language processing (NLP).
    • polly synthesize-speech for text "<text>" to bucket <bucket-name> key <object-key> in <region> [voice <voice-id>] [format <output-format>]
      • Synthesizes speech from a given text and saves the audio output to an S3 bucket.
  • Amazon Polly: Text-to-speech service.

Analytics

*   `kinesis smart-create data-stream <stream-name> in <region> [shards <count>]`
    *   Creates a Kinesis Data Stream with a specified number of shards.
  • Amazon Kinesis: For real-time streaming data.
    • redshift smart-create cluster <cluster-identifier> node-type <node-type> username <username> password <password> in <region> [node-count <count>] [security-groups <sg-id-1> ...] [vpc <vpc-id>]
      • Creates a Redshift cluster. Automatically creates a security group if not provided.
  • Amazon Redshift: Data warehousing service.
    • athena run-query "<query-string>" on database <database-name> output <s3-output-location> in <region>
      • Runs a SQL query on Athena and retrieves the results.
  • Amazon Athena: Interactive query service for S3 data.

Security, Identity, & Compliance

  • smart-create web-acl: Creates a WAF Web ACL with a common managed rule set.
    • troubleshoot web-acl: Retrieves and displays details about a WAF Web ACL, including its rules and default action.
  • AWS WAF (Web Application Firewall): Protecting web applications from common web exploits.
  • AWS Shield: DDoS protection.
    • guardduty smart-enable in <region>
      • Enables GuardDuty in the specified region, creating a detector if one doesn't exist.
  • AWS GuardDuty: Threat detection service.
    • config smart-enable bucket <s3-bucket-name> in <region>
      • Enables AWS Config in the specified region, creating a configuration recorder and delivery channel.
  • AWS Config: Assessing, auditing, and evaluating the configurations of your AWS resources.
    • list compliance-by-resource: Lists non-compliant resources based on AWS Config rules.

Internet of Things (IoT)

  • AWS IoT Core: Connecting IoT devices to AWS cloud services.

Messaging

  • Amazon SES (Simple Email Service): Email sending service.
    • sns smart-create topic <topic-name> email <email-address> in <region>
      • Creates an SNS topic and subscribes an email address to it.
  • Amazon SNS (Simple Notification Service): Pub/sub messaging service.
    • sqs smart-create queue <queue-name> in <region> [message-retention-period <seconds>] [visibility-timeout <seconds>]
      • Creates a standard SQS queue with basic attributes.
  • Amazon SQS (Simple Queue Service): Message queuing service.

Management & Governance

  • AWS Budgets (Enhanced): More detailed budget management and forecasting.
  • AWS Cost Explorer (Enhanced): Deeper cost analysis and reporting.

GCP AI Agent Framework - Project Summary

This section outlines the capabilities of the GCP AI Agent Framework.

Agents and Commands Implemented:

  • Compute Agent:
    • list instances: List all Compute Engine instances in a zone.
    • start instance: Start a specified Compute Engine instance.
    • stop instance: Stop a specified Compute Engine instance.
    • delete instance: Delete a specified Compute Engine instance (with safety prompt).
    • smart-create instance: Create a Compute Engine instance with sensible defaults.
  • Storage Agent:
    • list buckets: List all Cloud Storage buckets.
    • smart-create bucket: Create a Cloud Storage bucket with sensible defaults.
    • delete bucket: Delete a specified Cloud Storage bucket (with safety prompt).
  • SQL Agent:
    • smart-create instance: Create a Cloud SQL instance with sensible defaults.
  • Functions Agent:
    • smart-create function: Create a Cloud Function with sensible defaults (e.g., Python 3.9, HTTP trigger, sample code).
  • Network Agent:
    • smart-create network: Create a VPC network with sensible defaults.
  • GKE Agent:
    • smart-create cluster: Create a GKE cluster with sensible defaults, optionally enabling Anthos features.
  • BigQuery Agent:
    • run query: Runs a SQL query in BigQuery and retrieves the results.
  • Pub/Sub Agent:
    • smart-create topic: Creates a Pub/Sub topic.
  • Vertex AI Agent:
    • smart-create notebook: Creates a Vertex AI Workbench notebook instance.
  • Vision AI Agent:
    • analyze image-labels: Detects labels in an image stored in a Cloud Storage bucket.
  • Language AI Agent:
    • analyze sentiment: Detects the sentiment of a given text.
  • Text-to-Speech Agent:
    • synthesize speech: Synthesizes speech from a given text and saves the audio output to a local file.
  • IAM Agent:
    • smart-create service-account: Creates a service account and attaches a specified role.
  • Security Command Center (SCC) Agent:
    • smart-enable scc: Enables Security Command Center for a project (note: typically managed at organization level).
  • Cost Management Agent:

Azure AI Agent Framework - Project Summary

This section outlines the capabilities of the Azure AI Agent Framework.

Agents and Commands Implemented:

  • VM Agent:
    • list vms: List all Virtual Machines in a resource group.
    • start vm: Start a specified Virtual Machine.
    • stop vm: Stop a specified Virtual Machine.
    • delete vm: Delete a specified Virtual Machine (with safety prompt).
    • smart-create vm: Create a Virtual Machine with sensible defaults.
  • Storage Agent:
    • list storage-accounts: List all Storage Accounts in a resource group.
    • smart-create storage-account: Create a Storage Account with sensible defaults.
    • delete storage-account: Delete a specified Storage Account (with safety prompt).
  • SQL Agent:
    • smart-create sql-database: Create an Azure SQL Database with sensible defaults (including creating a SQL Server if needed).