tools

环境要求

• Python 环境（建议使用较新版本，README 以 PyPI 版本徽章标注）
• 已可用的 pip 包管理工具
• 如需使用可选工具（mem0_memory、use_browser、rss、use_computer 等）需额外安装其依赖
• 如需二次开发需准备源码目录与 pre-commit 环境

安装与启动步骤

1. 1安装核心包

   在终端执行 pip 安装命令，把 strands-agents-tools 装进当前 Python 环境。建议先激活虚拟环境，避免污染全局环境。

   pip install strands-agents-tools

   复制

2. 2安装可选工具依赖

   部分工具（记忆、浏览器、RSS、计算机操作等）依赖额外库，需按 README 给出的 extras 方式一次性安装。

   pip install "strands-agents-tools[mem0_memory, use_browser, rss, use_computer]"

   复制

3. 3以开发模式安装

   想修改源码或参与开发时，在项目源码根目录执行开发模式安装，这会同时安装 dev 依赖，无需先装核心包。

   pip install -e ".[dev]"

   复制

4. 4安装 pre-commit 钩子

   开发模式下接着安装 pre-commit 钩子，用于提交代码前的自动检查与格式化。非开发用途可跳过此步。

   pre-commit install

   复制

5. 5在智能体中挂载工具

   工具安装完成后，按 README 示例把工具传入 Agent 的 tools 列表即可使用；同步调用直接用函数，异步需调用对应的 *_async 并 await。

   agent = Agent(tools=[tavily_search, tavily_extract, tavily_crawl, tavily_map])

   复制

6. 6自定义模型调用

   调用 use_agent 时可指定 model_provider 与 model_settings，切换不同模型提供商与参数，例如温度、最大 token 数。

   result = agent.tool.use_agent(
       prompt="Write a creative story",
       system_prompt="You are a creative writing assistant.",
       model_provider="github",
       model_settings={"model_id": "openai/o4-mini", "params": {"temperature": 1, "max_tokens": 4000}}
   )

   复制

如何确认成功

通过 pip 安装无报错，并在代码中把工具传入 Agent 的 tools 列表后能正常调用工具返回结果（如 tavily_search、batch 示例）。

常见问题

注意事项

• README 未列出具体的环境变量名称与取值，需要按官网文档 https://strandsagents.com 进一步确认。
• 可选工具的 extras 名需与安装时保持一致，拼写错误会导致安装失败。
• 开发模式安装需在项目源码根目录执行，否则会找不到 pyproject/setup 配置。
• 示例中的 Agent、tavily_search、batch 等对象需由 strands agents 主框架提供，本项目只提供工具集。