Integrations

AWS

Cloud infrastructure management for EC2, S3, and CloudWatch

The AWS connector provides 40 actions for managing Amazon Web Services infrastructure including compute, storage, and monitoring.

Setup

Connect via IAM Credentials

  1. Go to Settings → Integrations → AWS
  2. Click Connect
  3. Enter your AWS Access Key ID
  4. Enter your AWS Secret Access Key
  5. Select your default region
  6. Click Save

IAM Policy Requirements

Create an IAM user with the following policy:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ec2:Describe*",
        "ec2:StartInstances",
        "ec2:StopInstances",
        "ec2:RebootInstances",
        "s3:GetObject",
        "s3:PutObject",
        "s3:ListBucket",
        "cloudwatch:GetMetricData",
        "cloudwatch:DescribeAlarms"
      ],
      "Resource": "*"
    }
  ]
}

Available Actions (40)

EC2 (Compute)

ActionDescription
List instancesGet all EC2 instances
Get instanceInstance details and status
Start instanceStart a stopped instance
Stop instanceStop a running instance
Reboot instanceRestart an instance
Get instance metricsCPU, memory, network stats

S3 (Storage)

ActionDescription
List bucketsGet all S3 buckets
List objectsFiles in a bucket
Get objectDownload file content
Put objectUpload a file
Delete objectRemove a file
Get bucket sizeStorage usage stats

CloudWatch (Monitoring)

ActionDescription
List alarmsGet all CloudWatch alarms
Get alarmAlarm details and history
Get metricsQuery metric data
Describe log groupsList log groups
Get log eventsRetrieve log entries

Use Cases

Server Down

Customer: "Our production server seems unresponsive"

AI:
1. Calls get_instance(i-abc123)
2. Checks status: running but high CPU
3. Retrieves CloudWatch metrics
4. Reports: "CPU at 98% for 15 min"
5. Offers to reboot if authorized

Storage Alert

Customer: "Getting storage full errors"

AI:
1. Calls get_bucket_size(prod-assets)
2. Finds bucket at 95% capacity
3. Lists largest objects
4. Provides cleanup recommendations

Configuration

  • Region: Default AWS region for operations
  • Instance access: Which EC2 instances AI can manage
  • Write permissions: Enable/disable start/stop actions
  • S3 buckets: Whitelist of accessible buckets