Skip to content

docs: add new tools documentation and update import statements #187

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed

docs: add new tools documentation and update import statements #187

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
4 changes: 2 additions & 2 deletions docs/user-guide/concepts/agents/state.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -158,8 +158,7 @@ except ValueError as e:
Agent state is particularly useful for maintaining information across tool executions:

```python
from strands import Agent
from strands.tools.decorator import tool
from strands import Agent, tool

@tool
def track_user_action(action: str, agent: Agent):
Expand Down Expand Up @@ -187,6 +186,7 @@ agent = Agent(tools=[track_user_action, get_user_stats])
# Use tools that modify and read state
agent("Track that I logged in")
agent("Track that I viewed my profile")

print(f"Actions taken: {agent.state.get('action_count')}")
print(f"Last action: {agent.state.get('last_action')}")
```
Expand Down
12 changes: 10 additions & 2 deletions docs/user-guide/concepts/tools/example-tools-package.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,10 @@ Install the `strands-agents-tools` package by running:
pip install strands-agents-tools
```

If using `mem0_memory`, install the additional required dependencies by running:
If using `use_computer` or `mem0_memory`, install the additional required dependencies by running:

```python
pip install strands-agents-tools[mem0_memory]
pip install strands-agents-tools[use_computer, mem0_memory]
```

## Available Tools
Expand All @@ -20,6 +20,7 @@ pip install strands-agents-tools[mem0_memory]
- [`retrieve`]({{ tools_repo }}/src/strands_tools/retrieve.py): Semantically retrieve data from Amazon Bedrock Knowledge Bases for RAG, memory, and other purposes
- [`memory`]({{ tools_repo }}/src/strands_tools/memory.py): Agent memory persistence in Amazon Bedrock Knowledge Bases
- [`mem0_memory`]({{ tools_repo }}/src/strands_tools/mem0_memory.py): Agent memory and personalization built on top of [Mem0](https://mem0.ai)
- [`agent_core_memory`]({{ tools_repo }}/src/strands_tools/agent_core_memory.py): Manage memories in Bedrock AgentCore Memory Service with event creation and retrieval

#### File Operations
- [`editor`]({{ tools_repo }}/src/strands_tools/editor.py): File editing operations like line edits, search, and undo
Expand All @@ -37,13 +38,16 @@ pip install strands-agents-tools[mem0_memory]
#### Web & Network
- [`http_request`]({{ tools_repo }}/src/strands_tools/http_request.py): Make API calls, fetch web data, and call local HTTP servers
- [`slack`]({{ tools_repo }}/src/strands_tools/slack.py): Slack integration with real-time events, API access, and message sending
- [`use_browser`]({{ tools_repo }}/src/strands_tools/use_browser.py): Browser automation with Playwright for web interaction and testing
- [`rss`]({{ tools_repo }}/src/strands_tools/rss.py): RSS feed management, subscription, and content retrieval

#### Multi-modal
- [`generate_image_stability`]({{ tools_repo }}/src/strands_tools/generate_image_stability.py): Create images with Stability AI
- [`image_reader`]({{ tools_repo }}/src/strands_tools/image_reader.py): Process and analyze images
- [`generate_image`]({{ tools_repo }}/src/strands_tools/generate_image.py): Create AI generated images with Amazon Bedrock
- [`nova_reels`]({{ tools_repo }}/src/strands_tools/nova_reels.py): Create AI generated videos with Nova Reels on Amazon Bedrock
- [`speak`]({{ tools_repo }}/src/strands_tools/speak.py): Generate speech from text using macOS say command or Amazon Polly
- [`use_computer`]({{ tools_repo }}/src/strands_tools/use_computer.py): Computer vision and UI automation with screenshot taking, OCR, and interaction

#### AWS Services
- [`use_aws`]({{ tools_repo }}/src/strands_tools/use_aws.py): Interact with AWS services
Expand All @@ -52,14 +56,18 @@ pip install strands-agents-tools[mem0_memory]
- [`calculator`]({{ tools_repo }}/src/strands_tools/calculator.py): Perform mathematical operations
- [`current_time`]({{ tools_repo }}/src/strands_tools/current_time.py): Get the current date and time
- [`load_tool`]({{ tools_repo }}/src/strands_tools/load_tool.py): Dynamically load more tools at runtime
- [`sleep`]({{ tools_repo }}/src/strands_tools/sleep.py): Pause execution for a specified number of seconds
- [`diagram`]({{ tools_repo }}/src/strands_tools/diagram.py): Create technical diagrams including AWS architecture, network, and flowcharts

#### Agents & Workflows
- [`graph`]({{ tools_repo }}/src/strands_tools/graph.py): Create and manage multi-agent systems using Strands SDK Graph implementation
- [`agent_graph`]({{ tools_repo }}/src/strands_tools/agent_graph.py): Create and manage graphs of agents
- [`journal`]({{ tools_repo }}/src/strands_tools/journal.py): Create structured tasks and logs for agents to manage and work from
- [`swarm`]({{ tools_repo }}/src/strands_tools/swarm.py): Coordinate multiple AI agents in a swarm / network of agents
- [`stop`]({{ tools_repo }}/src/strands_tools/stop.py): Force stop the agent event loop
- [`handoff_to_user`]({{ tools_repo }}/src/strands_tools/handoff_to_user.py): Enable human-in-the-loop workflows by pausing agent execution for user input or transferring control entirely to the user
- [`think`]({{ tools_repo }}/src/strands_tools/think.py): Perform deep thinking by creating parallel branches of agentic reasoning
- [`use_agent`]({{ tools_repo }}/src/strands_tools/use_agent.py): Run a new AI event loop with custom prompts and different model providers
- [`use_llm`]({{ tools_repo }}/src/strands_tools/use_llm.py): Run a new AI event loop with custom prompts
- [`workflow`]({{ tools_repo }}/src/strands_tools/workflow.py): Orchestrate sequenced workflows
- [`batch`]({{ tools_repo }}/src/strands_tools/batch.py): Call multiple tools from a single model request
Expand Down