Skip to content
Strands Agents SDK

Prompts

Section titled “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.

System Prompts

Section titled “System Prompts”

System prompts provide high-level instructions to the model about its role, capabilities, and constraints. They set the foundation for how the model should behave throughout the conversation. You can specify the system prompt when initializing an agent:

=== “Python”

```python
from strands import Agent


agent = Agent(
    system_prompt=(
        "You are a financial advisor specialized in retirement planning. "
        "Use tools to gather information and provide personalized advice. "
        "Always explain your reasoning and cite sources when possible."
    )
)
```

=== “TypeScript”

```typescript
const agent = new Agent({
  systemPrompt:
    'You are a financial advisor specialized in retirement planning. ' +
    'Use tools to gather information and provide personalized advice. ' +
    'Always explain your reasoning and cite sources when possible.',
})
```

If you do not specify a system prompt, the model will behave according to its default settings.

User Messages

Section titled “User Messages”

These are your queries or requests to the agent. The SDK supports multiple techniques for prompting.

Text Prompt

Section titled “Text Prompt”

The simplest way to interact with an agent is through a text prompt:

=== “Python”

```python
response = agent("What is the time in Seattle")
```

=== “TypeScript”

```typescript
const response = await agent.invoke('What is the time in Seattle')
```

Multi-Modal Prompting

Section titled “Multi-Modal Prompting”

The SDK supports multi-modal prompts, allowing you to include images, documents, and other content types in your messages:

=== “Python”

```python
with open("path/to/image.png", "rb") as fp:
    image_bytes = fp.read()


response = agent([
    {"text": "What can you see in this image?"},
    {
        "image": {
            "format": "png",
            "source": {
                "bytes": image_bytes,
            },
        },
    },
])
```

=== “TypeScript”

```typescript
const imageBytes = readFileSync('path/to/image.png')


const response = await agent.invoke([
  new TextBlock('What can you see in this image?'),
  new ImageBlock({
    format: 'png',
    source: {
      bytes: new Uint8Array(imageBytes),
    },
  }),
])
```

For a complete list of supported content types, please refer to the API Reference.

Direct Tool Calls

Section titled “Direct Tool Calls”

Prompting is a primary functionality of Strands that allows you to invoke tools through natural language requests. However, if at any point you require more programmatic control, Strands also allows you to invoke tools directly:

=== “Python”

```python
result = agent.tool.current_time(timezone="US/Pacific")
```

{{ ts_not_supported_code() }}

Direct tool calls bypass the natural language interface and execute the tool using specified parameters. These calls are added to the conversation history by default. However, you can opt out of this behavior by setting record_direct_tool_call=False in Python.

Prompt Engineering

Section titled “Prompt Engineering”

For guidance on how to write safe and responsible prompts, please refer to our Safety & Security - Prompt Engineering documentation.

Further resources: