Skip to content

README.md

Latest commit

 

History

History
135 lines (87 loc) · 2.97 KB

README.md

File metadata and controls

135 lines (87 loc) · 2.97 KB

Test Scripts

Utility scripts for deployment verification and operational tasks.

Setup

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create virtual environment
uv venv

# Install dependencies
uv pip install -r requirements.txt

Available Scripts

test-agent.py

Interactive chat interface for testing agent invocations with conversation continuity. Automatically detects the agent pattern from infra-cdk/config.yaml.

Modes:

  • Remote (default): Test deployed agent via Cognito authentication
  • Local (--local): Test agent running on localhost:8080

Usage:

# Remote mode (prompts for credentials, tests deployed agent)
uv run test-scripts/test-agent.py

# Local mode (auto-starts agent if not running, uses pattern from config.yaml)
uv run test-scripts/test-agent.py --local

# Override pattern for local testing
uv run test-scripts/test-agent.py --local --pattern strands-single-agent

Supported Patterns:

  • strands-single-agent - Basic Strands agent
  • langgraph-single-agent - LangGraph agent with streaming

Prerequisites:

  • Remote: Deployed stack with Cognito user
  • Local: Memory ID from deployed stack

test-memory.py

Tests AgentCore Memory operations (create, list, get events and pagination).

Usage:

# Auto-discover memory from stack
uv run test-scripts/test-memory.py

# Use specific memory ARN
uv run test-scripts/test-memory.py --memory-arn <arn>

Tests:

  1. Create conversation events
  2. List events with pagination
  3. Get specific events by ID
  4. Session ID validation
  5. Error handling

test-feedback-api.py

Tests the deployed Feedback API endpoint with Cognito authentication.

Prerequisites:

Usage:

uv run test-scripts/test-feedback-api.py

What it does:

  1. Fetches configuration from SSM Parameter Store
  2. Authenticates with Cognito (prompts for credentials)
  3. Runs API tests (positive/negative feedback, validation)
  4. Displays test results

test-gateway.py

Tests AgentCore Gateway directly without frontend.

Usage:

uv run test-scripts/test-gateway.py

What it does:

  1. Fetches Gateway configuration from SSM Parameter Store
  2. Authenticates with Cognito (prompts for credentials)
  3. Tests Gateway endpoints and authentication
  4. Displays test results

Shared Utilities

The test scripts use shared utilities from ../scripts/utils.py:

  • Stack configuration and SSM parameter retrieval
  • Cognito authentication
  • AWS client creation
  • Session ID generation

Troubleshooting

  • Authentication fails: Verify Cognito user exists and credentials are correct
  • Stack not found: Ensure stack is deployed and config.yaml has correct stack_name_base
  • Local agent fails: Check Memory ID and AWS credentials are configured
  • Port 8080 in use: Stop other services or use remote mode