Command Line Interface

The SDK includes a command-line interface (CLI) for testing and interacting with agents. The CLI is implemented in the app.py file that comes with the SDK.

Basic Usage

# Start in interactive chat mode
python app.py --chat

# Run with a file
python app.py --file data.csv

# Use a specific AWS region and profile
python app.py --region us-west-2 --profile myprofile

Verbosity and Trace Levels

You can control the verbosity and trace levels using command-line arguments:

# Set verbosity level
python app.py --verbosity verbose

# Set trace level
python app.py --trace standard

# Use the raw trace level to see all trace data, including code interpreter output
python app.py --trace raw  # Shows complete unprocessed JSON trace data

# Combine options for specific debugging needs
python app.py --chat --verbosity quiet --trace raw  # Quiet SDK logs but full trace data

Available Options

The CLI supports the following options:

--chat                 Start in interactive chat mode
--region REGION        AWS region name
--profile PROFILE      AWS profile name
--verbosity {quiet,normal,verbose,debug}
                       Verbosity level
--trace {none,minimal,standard,detailed,raw}
                       Agent trace level (raw shows complete unprocessed trace data)
--file FILE            Path to a file to send to the agent
--kms-key KMS_KEY      Customer KMS key ARN for encryption

Example Commands

Here are some example commands to get you started:

# Start a chat session with verbose logging
python app.py --chat --verbosity verbose

# Start a chat session with detailed agent traces
python app.py --chat --trace detailed

# Start a chat session with raw trace level to see code interpreter output
python app.py --chat --trace raw

# Upload a file and start a chat session
python app.py --chat --file data.csv

# Use a customer KMS key for encryption
python app.py --chat --kms-key "arn:aws:kms:us-west-2:123456789012:key/abcd1234-ab12-cd34-ef56-abcdef123456"

# Combine multiple options
python app.py --chat --region us-west-2 --profile dev --verbosity normal --trace standard