Skip to content
Open
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,9 @@ __pycache__
.kiro
*.egg-info

node_modules
**/node_modules
**/dist
**/.astro
uv.lock

temp_python_sdk
Expand All @@ -22,3 +24,4 @@ docs/api-reference/
__*__/


.artifact/
4 changes: 4 additions & 0 deletions docs/community/community-packages.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Community Packages"
---

# Community Packages

The Strands Agents SDK is built on community contributions that extend agent capabilities through custom tools and integrations. If you've built a useful extension for Strands Agents that solves a common problem or integrates with popular services, packaging it for distribution allows other developers to benefit from your work.
Expand Down
4 changes: 4 additions & 0 deletions docs/community/get-featured.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Get Featured in the Docs"
---

# Get Featured in the Docs

Built something useful for Strands Agents? Getting featured in our docs helps other developers discover your work and gives your package visibility across the community.
Expand Down
4 changes: 4 additions & 0 deletions docs/community/integrations/ag-ui.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Build chat experiences with AG-UI and CopilotKit"
---

# Build chat experiences with AG-UI and CopilotKit

{{ community_contribution_banner }}
Expand Down
4 changes: 4 additions & 0 deletions docs/community/model-providers/clova-studio.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "CLOVA Studio"
---

# CLOVA Studio

{{ community_contribution_banner }}
Expand Down
4 changes: 4 additions & 0 deletions docs/community/model-providers/cohere.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Cohere"
---

# Cohere

{{ community_contribution_banner }}
Expand Down
4 changes: 4 additions & 0 deletions docs/community/model-providers/fireworksai.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "FireworksAI"
---

# FireworksAI

{{ community_contribution_banner }}
Expand Down
4 changes: 4 additions & 0 deletions docs/community/model-providers/mlx.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "MLX"
---

# MLX

{{ community_contribution_banner }}
Expand Down
4 changes: 4 additions & 0 deletions docs/community/model-providers/nebius-token-factory.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Nebius Token Factory"
---

# Nebius Token Factory

{{ community_contribution_banner }}
Expand Down
4 changes: 4 additions & 0 deletions docs/community/model-providers/nvidia-nim.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "NVIDIA NIM"
---

# NVIDIA NIM

{{ community_contribution_banner }}
Expand Down
4 changes: 4 additions & 0 deletions docs/community/model-providers/sglang.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "SGLang"
---

# SGLang

{{ community_contribution_banner }}
Expand Down
4 changes: 4 additions & 0 deletions docs/community/session-managers/agentcore-memory.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "AgentCore Memory Session Manager"
---

# AgentCore Memory Session Manager

{{ community_contribution_banner }}
Expand Down
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Strands Valkey Session Manager"
---

# Strands Valkey Session Manager

{{ community_contribution_banner }}
Expand Down
2 changes: 2 additions & 0 deletions docs/community/tools/strands-deepgram.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
---
title: "strands-deepgram"

project:
pypi: https://pypi.org/project/strands-deepgram/
github: https://github.com/eraykeskinmac/strands-deepgram
Expand Down
2 changes: 2 additions & 0 deletions docs/community/tools/strands-hubspot.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
---
title: "strands-hubspot"

project:
pypi: https://pypi.org/project/strands-hubspot/
github: https://github.com/eraykeskinmac/strands-hubspot
Expand Down
2 changes: 2 additions & 0 deletions docs/community/tools/strands-teams.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
---
title: "strands-teams"

project:
pypi: https://pypi.org/project/strands-teams/
github: https://github.com/eraykeskinmac/strands-teams
Expand Down
2 changes: 2 additions & 0 deletions docs/community/tools/strands-telegram-listener.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
---
title: "strands-telegram-listener"

project:
pypi: https://pypi.org/project/strands-telegram-listener/
github: https://github.com/eraykeskinmac/strands-telegram-listener
Expand Down
2 changes: 2 additions & 0 deletions docs/community/tools/strands-telegram.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
---
title: "strands-telegram"

project:
pypi: https://pypi.org/project/strands-telegram/
github: https://github.com/eraykeskinmac/strands-telegram
Expand Down
4 changes: 4 additions & 0 deletions docs/community/tools/utcp.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Universal Tool Calling Protocol (UTCP)"
---

# Universal Tool Calling Protocol (UTCP)

{{ community_contribution_banner }}
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Examples Overview"
---

# Examples Overview

The examples directory provides a collection of sample implementations to help you get started with building intelligent agents using Strands Agents. This directory contains two main subdirectories: `/examples/python` for Python-based agent examples and `/examples/cdk` for Cloud Development Kit integration examples.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/cdk/deploy_to_ec2/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "AWS CDK EC2 Deployment Example"
---

# AWS CDK EC2 Deployment Example

## Introduction
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/cdk/deploy_to_fargate/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "AWS CDK Fargate Deployment Example"
---

# AWS CDK Fargate Deployment Example

## Introduction
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/cdk/deploy_to_lambda/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "AWS CDK Lambda Deployment Example"
---

# AWS CDK Lambda Deployment Example

## Introduction
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/deploy_to_eks/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Amazon EKS Deployment Example"
---

# Amazon EKS Deployment Example

## Introduction
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/agents_workflows.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Agentic Workflow: Research Assistant - Multi-Agent Collaboration Example"
---

# Agentic Workflow: Research Assistant - Multi-Agent Collaboration Example

This [example](https://github.com/strands-agents/docs/blob/main/docs/examples/python/agents_workflow.py) shows how to create a multi-agent workflow using Strands agents to perform web research, fact-checking, and report generation. It demonstrates specialized agent roles working together in sequence to process information.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/cli-reference-agent.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "A CLI reference implementation of a Strands agent"
---

# A CLI reference implementation of a Strands agent

The Strands CLI is a reference implementation built on top of the Strands SDK. It provides a terminal-based interface for interacting with Strands agents, demonstrating how to make a fully interactive streaming application with the Strands SDK.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/file_operations.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "File Operations - Strands Agent for File Management"
---

# File Operations - Strands Agent for File Management

This [example](https://github.com/strands-agents/docs/blob/main/docs/examples/python/file_operations.py) demonstrates how to create a Strands agent specialized in file operations, allowing users to read, write, search, and modify files through natural language commands. It showcases how Strands agents can be configured to work with the filesystem in a safe and intuitive manner.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/graph_loops_example.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "🔄 Graph with Loops - Multi-Agent Feedback Cycles"
---

# 🔄 Graph with Loops - Multi-Agent Feedback Cycles

This [example](https://github.com/strands-agents/docs/blob/main/docs/examples/python/graph_loops_example.py) demonstrates how to create multi-agent graphs with feedback loops using the Strands Agents SDK. It showcases a write-review-improve cycle where content iterates through multiple agents until quality standards are met.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/knowledge_base_agent.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Knowledge Base Agent - Intelligent Information Storage and Retrieval"
---

# Knowledge Base Agent - Intelligent Information Storage and Retrieval

This [example](https://github.com/strands-agents/docs/blob/main/docs/examples/python/knowledge_base_agent.py) demonstrates how to create a Strands agent that determines whether to store information to a knowledge base or retrieve information from it based on the user's query. It showcases a code-defined decision-making workflow that routes user inputs to the appropriate action.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/mcp_calculator.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "MCP Calculator - Model Context Protocol Integration Example"
---

# MCP Calculator - Model Context Protocol Integration Example

This [example](https://github.com/strands-agents/docs/blob/main/docs/examples/python/mcp_calculator.py) demonstrates how to integrate Strands agents with external tools using the Model Context Protocol (MCP). It shows how to create a simple MCP server that provides calculator functionality and connect a Strands agent to use these tools.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/memory_agent.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "🧠 Mem0 Memory Agent - Personalized Context Through Persistent Memory"
---

# 🧠 Mem0 Memory Agent - Personalized Context Through Persistent Memory

This [example](https://github.com/strands-agents/docs/blob/main/docs/examples/python/memory_agent.py) demonstrates how to create a Strands agent that leverages [mem0.ai](https://mem0.ai) to maintain context across conversations and provide personalized responses. It showcases how to store, retrieve, and utilize memories to create more intelligent and contextual AI interactions.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/meta_tooling.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Meta-Tooling Example - Strands Agent's Dynamic Tool Creation"
---

# Meta-Tooling Example - Strands Agent's Dynamic Tool Creation

Meta-tooling refers to the ability of an AI system to create new tools at runtime, rather than being limited to a predefined set of capabilities. The following [example](https://github.com/strands-agents/docs/blob/main/docs/examples/python/meta_tooling.py) demonstrates Strands Agents' meta-tooling capabilities - allowing agents to create, load, and use custom tools at runtime.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/multi_agent_example/index.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Multi-Agent Example"
---

# Multi-Agent Example

This directory contains the implementation files for the Multi-Agent Example architecture, where specialized agents work together under the coordination of a central orchestrator.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Teacher's Assistant - Strands Multi-Agent Architecture Example"
---

# Teacher's Assistant - Strands Multi-Agent Architecture Example

This [example](https://github.com/strands-agents/docs/blob/main/docs/examples/python/multi_agent_example/teachers_assistant.py) demonstrates how to implement a multi-agent architecture using Strands Agents, where specialized agents work together under the coordination of a central orchestrator. The system uses natural language routing to direct queries to the most appropriate specialized agent based on subject matter expertise.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/multimodal.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Multi-modal - Strands Agents for Image Generation and Evaluation"
---

# Multi-modal - Strands Agents for Image Generation and Evaluation

This [example][example_code] demonstrates how to create a multi-agent system for generating and evaluating images. It shows how Strands agents can work with multimodal content through a workflow between specialized agents.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/structured_output.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Structured Output Example"
---

# Structured Output Example

This example demonstrates how to use Strands' structured output feature to get type-safe, validated responses from language models using [Pydantic](https://docs.pydantic.dev/latest/concepts/models/) models. Instead of raw text that you need to parse manually, you define the exact structure you want and receive a validated Python object.
Expand Down
4 changes: 4 additions & 0 deletions docs/examples/python/weather_forecaster.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Weather Forecaster - Strands Agents HTTP Integration Example"
---

# Weather Forecaster - Strands Agents HTTP Integration Example

This [example](https://github.com/strands-agents/docs/blob/main/docs/examples/python/weather_forecaster.py) demonstrates how to integrate the Strands Agents SDK with tool use, specifically using the `http_request` tool to build a weather forecasting agent that connects with the National Weather Service API. It shows how to combine natural language understanding with API capabilities to retrieve and present weather information.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "TypeScript Agent Deployment to Amazon Bedrock AgentCore Runtime"
---

# TypeScript Agent Deployment to Amazon Bedrock AgentCore Runtime

This example demonstrates deploying a TypeScript-based Strands agent to Amazon Bedrock AgentCore Runtime using Express and Docker.
Expand Down
4 changes: 4 additions & 0 deletions docs/README.md → docs/index.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Strands Agents SDK"
---

# Strands Agents SDK

=== "Python"
Expand Down
4 changes: 4 additions & 0 deletions docs/user-guide/concepts/agents/agent-loop.md
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we get away with not modifying the files, by generating the titles from these at build time by readingh the markdown and extracting the first header?

Or could we update the starlight template to not require a title field?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point! I'll investigate using a custom Starlight schema that auto-generates titles from the first markdown heading at build time, avoiding source file modifications.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great suggestion! I'll create an inline loader that reads titles from mkdocs.yml navigation structure. This avoids modifying any source files.

Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Agent Loop"
---

# Agent Loop

A language model can answer questions. An agent can *do things*. The agent loop is what makes that difference possible.
Expand Down
4 changes: 4 additions & 0 deletions docs/user-guide/concepts/agents/conversation-management.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Conversation Management"
---

# Conversation Management

In the Strands Agents SDK, context refers to the information provided to the agent for understanding and reasoning. This includes:
Expand Down
4 changes: 4 additions & 0 deletions docs/user-guide/concepts/agents/hooks.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Hooks"
---

# Hooks

Hooks are a composable extensibility mechanism for extending agent functionality by subscribing to events throughout the agent lifecycle. The hook system enables both built-in components and user code to react to or modify agent behavior through strongly-typed event callbacks.
Expand Down
4 changes: 4 additions & 0 deletions docs/user-guide/concepts/agents/prompts.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Prompts"
---

# Prompts

In the Strands Agents SDK, system prompts and user messages are the primary way to communicate with AI models. The SDK provides a flexible system for managing prompts, including both system prompts and user messages.
Expand Down
4 changes: 4 additions & 0 deletions docs/user-guide/concepts/agents/session-management.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Session Management"
---

# Session Management

{{ ts_not_supported("Session Management is not currently supported in the TypeScript SDK, but will be coming soon!") }}
Expand Down
4 changes: 4 additions & 0 deletions docs/user-guide/concepts/agents/state.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "State Management"
---

# State Management

Strands Agents state is maintained in several forms:
Expand Down
4 changes: 4 additions & 0 deletions docs/user-guide/concepts/agents/structured-output.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Structured Output"
---

# Structured Output


Expand Down
4 changes: 4 additions & 0 deletions docs/user-guide/concepts/bidirectional-streaming/agent.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "BidiAgent Experimental"
---

# BidiAgent [Experimental]

{{ experimental_feature_warning() }}
Expand Down
4 changes: 4 additions & 0 deletions docs/user-guide/concepts/bidirectional-streaming/events.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Events Experimental"
---

# Events [Experimental]

{{ experimental_feature_warning() }}
Expand Down
4 changes: 4 additions & 0 deletions docs/user-guide/concepts/bidirectional-streaming/hooks.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: "Hooks Experimental"
---

# Hooks [Experimental]

{{ experimental_feature_warning() }}
Expand Down
Loading