From 86a0564ec7d9dbf7b396712c0e08a7ae2e69e825 Mon Sep 17 00:00:00 2001 From: Murat Kaan Meral Date: Thu, 11 Dec 2025 16:03:06 -0500 Subject: [PATCH 1/2] docs: add comprehensive feature availability matrix Updates documentation for better language choice guidance - Add detailed feature comparison between Python and TypeScript SDKs - Include feature categories: Core Agent, Model Providers, Tools, Multi-Agent, etc. - Provide clear guidance on choosing the right SDK for different use cases - Explain SDK development status and stability levels - Update quickstart navigation with enhanced context --- docs/user-guide/quickstart/overview.md | 85 +++++++++++++++++++++++++- 1 file changed, 83 insertions(+), 2 deletions(-) diff --git a/docs/user-guide/quickstart/overview.md b/docs/user-guide/quickstart/overview.md index fd174e9d..61be3c36 100644 --- a/docs/user-guide/quickstart/overview.md +++ b/docs/user-guide/quickstart/overview.md @@ -2,9 +2,90 @@ The Strands Agents SDK empowers developers to quickly build, manage, evaluate and deploy AI-powered agents. These quick start guides get you set up and running a simple agent in less than 20 minutes. +## Language Support + +Strands Agents SDK is available in both Python and TypeScript. The Python SDK is mature and production-ready with comprehensive feature coverage. The TypeScript SDK is experimental and focuses on core agent functionality. + +### Feature Availability Matrix + +The table below shows feature availability across both SDKs. Python is the primary SDK with complete feature coverage, while TypeScript provides essential agent capabilities with ongoing development. + +| Feature Category | Feature | Python | TypeScript | Notes | +|------------------|---------|--------|------------|-------| +| **Core Agent** | Basic agent creation | ✅ | ✅ | | +| | Agent invocation | ✅ | ✅ | | +| | Streaming responses | ✅ | ✅ | | +| | Agent state management | ✅ | ✅ | | +| | Structured output | ✅ | ❌ | TypeScript support planned | +| **Model Providers** | Amazon Bedrock | ✅ | ✅ | | +| | OpenAI | ✅ | ✅ | | +| | Anthropic | ✅ | ❌ | | +| | Google Gemini | ✅ | ❌ | | +| | LiteLLM | ✅ | ❌ | | +| | Ollama | ✅ | ❌ | | +| | Mistral | ✅ | ❌ | | +| | Llama API | ✅ | ❌ | | +| | SageMaker | ✅ | ❌ | | +| | Writer | ✅ | ❌ | | +| | Custom providers | ✅ | ❌ | | +| **Tools & Extensions** | Custom function tools | ✅ | ✅ | | +| | MCP (Model Context Protocol) | ✅ | ✅ | | +| | Built-in vended tools | Community package | 4 built-in tools | bash, file_editor, http_request, notebook | +| | Tool executors (sequential/concurrent) | ✅ | ❌ | | +| | Hot tool reloading | ✅ | ❌ | | +| | Automatic tool loading | ✅ | ❌ | | +| **Conversation Management** | Null conversation manager | ✅ | ✅ | | +| | Sliding window manager | ✅ | ✅ | | +| | Summarizing conversation manager | ✅ | ❌ | | +| **Multi-Agent Patterns** | Agent swarm | ✅ | ❌ | | +| | Agent workflows | ✅ | ❌ | | +| | Agent graphs | ✅ | ❌ | | +| | Agent-to-agent communication | ✅ | ❌ | | +| | Agents as tools | ✅ | ❌ | | +| **Session Management** | File session manager | ✅ | ❌ | | +| | S3 session manager | ✅ | ❌ | | +| | Repository session manager | ✅ | ❌ | | +| | Custom session managers | ✅ | ❌ | | +| **Observability** | OpenTelemetry traces | ✅ | ❌ | | +| | Metrics collection | ✅ | ❌ | | +| | Custom telemetry | ✅ | ❌ | | +| **Hooks & Lifecycle** | Agent lifecycle hooks | ✅ | ✅ | | +| | Custom hook providers | ✅ | ✅ | | +| | Multi-agent hooks | ✅ | ❌ | Experimental in Python | +| **Experimental Features** | Bidirectional streaming | ✅ | ❌ | Real-time voice/audio agents | +| | Agent steering | ✅ | ❌ | Dynamic behavior modification | +| | Agent configuration | ✅ | ❌ | Runtime configuration management | +| **Interrupts & Control** | Agent interrupts | ✅ | ❌ | Graceful stopping and resumption | +| | Context overflow handling | ✅ | ❌ | | +| **Development Tools** | Debug logging | ✅ | ✅ | | +| | Agent builder | ✅ | ❌ | AI-powered agent generation | +| | Community tools package | ✅ | ❌ | 30+ production-ready tools | + +!!! tip "Choosing the Right SDK" + **Choose Python if you need:** + + - Production deployments with full observability + - Multi-agent orchestration patterns + - Session management and persistence + - Comprehensive model provider support + - The complete ecosystem of tools and extensions + + **Choose TypeScript if you need:** + + - Browser-based agent applications + - Node.js/Deno/Bun runtime environments + - Simple agent workflows with core functionality + - Integration with existing TypeScript codebases + +### SDK Development Status + +**Python SDK:** Stable and production-ready. Receives regular updates with new features, model providers, and community contributions. + +**TypeScript SDK:** Experimental with active development. Breaking changes are expected as the API stabilizes. The roadmap includes expanding model provider support, adding multi-agent patterns, and implementing session management. + ## :material-language-python: **Python Quickstart** -Create your first Python Strands agent! +Create your first Python Strands agent with full feature access! [**→ Start with Python**](python.md) @@ -13,7 +94,7 @@ Create your first Python Strands agent! ## :material-language-typescript: **TypeScript Quickstart** !!! info "Experimental SDK" - The TypeScript SDK is experimental + The TypeScript SDK is experimental with limited feature coverage compared to Python. Create your first TypeScript Strands agent! From 2fa07c70e984dc67ee335a369de89af58207533b Mon Sep 17 00:00:00 2001 From: Murat Kaan Meral Date: Thu, 11 Dec 2025 16:24:36 -0500 Subject: [PATCH 2/2] fix: Small updates to organize feature availability matrix --- docs/user-guide/quickstart/overview.md | 58 +++++++++----------------- 1 file changed, 20 insertions(+), 38 deletions(-) diff --git a/docs/user-guide/quickstart/overview.md b/docs/user-guide/quickstart/overview.md index 61be3c36..88daab13 100644 --- a/docs/user-guide/quickstart/overview.md +++ b/docs/user-guide/quickstart/overview.md @@ -2,6 +2,26 @@ The Strands Agents SDK empowers developers to quickly build, manage, evaluate and deploy AI-powered agents. These quick start guides get you set up and running a simple agent in less than 20 minutes. +## :material-language-python: **Python Quickstart** + +Create your first Python Strands agent with full feature access! + +[**→ Start with Python**](python.md) + +--- + +## :material-language-typescript: **TypeScript Quickstart** + +!!! info "Experimental SDK" + The TypeScript SDK is experimental with limited feature coverage compared to Python. + +Create your first TypeScript Strands agent! + +[**→ Start with TypeScript**](typescript.md) + +--- + + ## Language Support Strands Agents SDK is available in both Python and TypeScript. The Python SDK is mature and production-ready with comprehensive feature coverage. The TypeScript SDK is experimental and focuses on core agent functionality. @@ -61,41 +81,3 @@ The table below shows feature availability across both SDKs. Python is the prima | | Agent builder | ✅ | ❌ | AI-powered agent generation | | | Community tools package | ✅ | ❌ | 30+ production-ready tools | -!!! tip "Choosing the Right SDK" - **Choose Python if you need:** - - - Production deployments with full observability - - Multi-agent orchestration patterns - - Session management and persistence - - Comprehensive model provider support - - The complete ecosystem of tools and extensions - - **Choose TypeScript if you need:** - - - Browser-based agent applications - - Node.js/Deno/Bun runtime environments - - Simple agent workflows with core functionality - - Integration with existing TypeScript codebases - -### SDK Development Status - -**Python SDK:** Stable and production-ready. Receives regular updates with new features, model providers, and community contributions. - -**TypeScript SDK:** Experimental with active development. Breaking changes are expected as the API stabilizes. The roadmap includes expanding model provider support, adding multi-agent patterns, and implementing session management. - -## :material-language-python: **Python Quickstart** - -Create your first Python Strands agent with full feature access! - -[**→ Start with Python**](python.md) - ---- - -## :material-language-typescript: **TypeScript Quickstart** - -!!! info "Experimental SDK" - The TypeScript SDK is experimental with limited feature coverage compared to Python. - -Create your first TypeScript Strands agent! - -[**→ Start with TypeScript**](typescript.md)