twilio-agent-connect-aws 1.0.2

AWS integrations for Twilio Agent Connect (TAC) - adapters and servers for AWS agent runtimes

Twilio Agent Connect AWS

AWS integrations for Twilio Agent Connect — connect AWS agent services to Twilio's communication channels.

Documentation ◆ Python SDK ◆ Examples ◆ Deployment

AWS-specific connectors for Twilio Agent Connect (TAC), enabling seamless integration with AWS agent services like Strands, Bedrock Agents, and Bedrock AgentCore.

---

Features

• StrandsConnector - AWS Strands SDK integration
  • Per-conversation agent isolation with SessionManager support
  • Context-aware agent factories
• BedrockConnector - AWS Bedrock Agents integration
  • Connect console-created agents to Twilio
  • Managed agent service with action groups and knowledge bases
• BedrockAgentCoreConnector - AWS Bedrock AgentCore integration
  • Deploy custom agent code (Strands, LangGraph, OpenAI SDK)
  • Managed runtime with built-in memory
• TACAWSFastAPIServer - AWS-optimized server for ALB deployments
  • Automatic header fixing for Twilio signature validation
  • Works with AWS ALB + ngrok for testing
  • Handles both HTTP (SMS) and WebSocket (Voice)
• Multi-channel support (SMS + Voice)
• Automatic TAC memory injection

Installation

With Strands SDK

pip install twilio-agent-connect-aws[strands,server]

With Bedrock Agents

pip install twilio-agent-connect-aws[bedrock,server]

With Bedrock AgentCore

pip install twilio-agent-connect-aws[agentcore,server]

Development

# Install with development tools (includes all connectors)
pip install twilio-agent-connect-aws[dev]

Configuration

twilio-agent-connect-aws requires TAC environment variables. See TAC Configuration for details.

Required Environment Variables

# Twilio Configuration
TWILIO_ACCOUNT_SID=your_account_sid
TWILIO_AUTH_TOKEN=your_auth_token
TWILIO_API_KEY=your_api_key          # Starts with SK
TWILIO_API_SECRET=your_api_secret    # Secret for API key
TWILIO_PHONE_NUMBER=[phone]
TWILIO_CONVERSATION_CONFIGURATION_ID=conv_configuration_xxx

# Server Configuration (for Voice)
TWILIO_VOICE_PUBLIC_DOMAIN=your-domain.ngrok.io

Examples

Full examples available in getting_started/examples/:

• strands_agents.py - Strands SDK with per-conversation agent management
• bedrock_agents.py - AWS Bedrock Agents (console-created agents)
• bedrock_agentcore_agents.py - AWS Bedrock AgentCore (custom agent code deployment)

Deployment

See deploy/README.md for production deployment guides:

• Strands AWS Fargate - Deploy Strands SDK agents
• Bedrock Agents AWS Fargate - Deploy console-created Bedrock agents
• Bedrock AgentCore AWS Fargate - Deploy custom agent code to AgentCore runtime

Development

Setup

# Clone repository
git clone https://github.com/twilio/twilio-agent-connect-aws.git
cd twilio-agent-connect-aws

# Install dependencies
make sync

# Setup dev environment
make dev-setup

Code Quality

# Format code
make format

# Type check
make type-check

# Lint
make lint

# Run tests
make test

# Run all checks
make check

Dependencies

twilio-agent-connect-aws depends on:

• tac - Core Twilio Agent Connect framework (installed from GitHub)
  • Requires tac[server] extra for TAC Server support
• strands-agents (optional) - AWS Strands SDK

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details.