From f64368f871217d9d9736460fcad29c6c059d7137 Mon Sep 17 00:00:00 2001 From: James Brubaker Date: Mon, 28 Jul 2025 08:57:10 -0400 Subject: [PATCH] fix: Updating Strands Tools documentation page --- docs/user-guide/concepts/agents/state.md | 3 +- .../concepts/tools/example-tools-package.md | 43 ++++++++++++++++++- 2 files changed, 42 insertions(+), 4 deletions(-) diff --git a/docs/user-guide/concepts/agents/state.md b/docs/user-guide/concepts/agents/state.md index d840adc2..1b8d4137 100644 --- a/docs/user-guide/concepts/agents/state.md +++ b/docs/user-guide/concepts/agents/state.md @@ -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): diff --git a/docs/user-guide/concepts/tools/example-tools-package.md b/docs/user-guide/concepts/tools/example-tools-package.md index 622c2e9b..a829f55f 100644 --- a/docs/user-guide/concepts/tools/example-tools-package.md +++ b/docs/user-guide/concepts/tools/example-tools-package.md @@ -8,10 +8,39 @@ Install the `strands-agents-tools` package by running: pip install strands-agents-tools ``` -If using `mem0_memory`, install the additional required dependencies by running: +Some tools require additional dependencies. Install the additional required dependencies in order to use the following tools: +- mem0_memory ```python -pip install strands-agents-tools[mem0_memory] +pip install 'strands-agents-tools[mem0_memory]' +``` +- local_chromium_browser +```python +pip install 'strands-agents-tools[local_chromium_browser]' +``` +- agent_core_browser +```python +pip install 'strands-agents-tools[agent_core_browser]' +``` +- agent_core_code_interpreter +```python +pip install 'strands-agents-tools[agent_core_code_interpreter]' +``` +- a2a_client +```python +pip install 'strands-agents-tools[a2a_client]' +``` +- diagram +```python +pip install 'strands-agents-tools[diagram]' +``` +- rss +```python +pip install 'strands-agents-tools[rss]' +``` +- use_computer +```python +pip install 'strands-agents-tools[use_computer]' ``` ## Available Tools @@ -19,6 +48,7 @@ pip install strands-agents-tools[mem0_memory] #### RAG & 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 +- [`agent_core_memory`]({{ tools_repo }}/src/strands_tools/agent_core_memory.py): Integration with Amazon Bedrock Agent Core Memory - [`mem0_memory`]({{ tools_repo }}/src/strands_tools/mem0_memory.py): Agent memory and personalization built on top of [Mem0](https://mem0.ai) #### File Operations @@ -30,13 +60,17 @@ pip install strands-agents-tools[mem0_memory] - [`environment`]({{ tools_repo }}/src/strands_tools/environment.py): Manage environment variables - [`shell`]({{ tools_repo }}/src/strands_tools/shell.py): Execute shell commands - [`cron`]({{ tools_repo }}/src/strands_tools/cron.py): Task scheduling with cron jobs +- [`use_computer`]({{ tools_repo }}/src/strands_tools/use_computer.py): Automate desktop actions and GUI interactions #### Code Interpretation - [`python_repl`]({{ tools_repo }}/src/strands_tools/python_repl.py): Run Python code +- [`code_interpreter`]({{ tools_repo }}/src/strands_tools/code_interpreter.py): Execute code in isolated sandboxes #### 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 +- [`browser`]({{ tools_repo }}/src/strands_tools/browser.py): Automate web browser interactions +- [`rss`]({{ tools_repo }}/src/strands_tools/rss.py): Manage and process RSS feeds #### Multi-modal - [`generate_image_stability`]({{ tools_repo }}/src/strands_tools/generate_image_stability.py): Create images with Stability AI @@ -44,6 +78,7 @@ pip install strands-agents-tools[mem0_memory] - [`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 +- [`diagram`]({{ tools_repo }}/src/strands_tools/diagram.py): Create cloud architecture and UML diagrams #### AWS Services - [`use_aws`]({{ tools_repo }}/src/strands_tools/use_aws.py): Interact with AWS services @@ -52,17 +87,21 @@ 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 with interrupt support #### 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 +- [`use_agent`]({{ tools_repo }}/src/strands_tools/use_agent.py): Run a new AI event loop with custom prompts and different model providers - [`think`]({{ tools_repo }}/src/strands_tools/think.py): Perform deep thinking by creating parallel branches of agentic reasoning - [`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 +- [`a2a_client`]({{ tools_repo }}/src/strands_tools/a2a_client.py): Enable agent-to-agent communication ## Tool Consent and Bypassing