Strands Agents SDK Python 项目启动和配置教程

1. 项目的目录结构及介绍

Strands Agents SDK Python 项目是一个开源项目，旨在提供一个模型驱动的AI代理构建工具。以下是项目的目录结构及其介绍：

.
├── .github/                # GitHub 工作流和配置文件
├── src/                    # 源代码目录
│   ├── strands/            # 核心代码模块
│   ├── strands_tools/      # 额外工具模块
├── tests/                  # 测试代码目录
├── tests-integ/            # 集成测试目录
├── .gitignore              # Git 忽略文件
├── CONTRIBUTING.md         # 贡献指南
├── LICENSE                 # 开源许可证
├── NOTICE                  # 法律通知文件
├── README.md               # 项目自述文件
├── pyproject.toml          # 项目配置文件

• .github/：包含项目GitHub工作流和配置文件，例如代码审查和自动部署等。
• src/：源代码目录，包含项目的核心逻辑和工具模块。
  • strands/：Strands Agents SDK 的核心代码，包括构建和运行AI代理的功能。
  • strands_tools/：提供了一组可选的工具，用于快速实验和增强代理的功能。
• tests/：包含单元测试代码。
• tests-integ/：包含集成测试代码。
• .gitignore：指定Git应该忽略的文件和目录。
• CONTRIBUTING.md：提供贡献指南，说明如何向项目贡献代码和文档。
• LICENSE：Apache-2.0 许可证文件，说明了项目的版权和使用条款。
• NOTICE：包含项目的法律通知。
• README.md：项目的自述文件，介绍了项目的基本信息和如何使用。
• pyproject.toml：项目配置文件，用于配置项目的构建系统和依赖。

2. 项目的启动文件介绍

项目的启动通常是通过Python的命令行界面来执行的。主要的启动文件是位于 src/strands/ 目录下的Python脚本。以下是一个简单的启动示例：

from strands import Agent
from strands_tools import calculator

agent = Agent(tools=[calculator])
agent("What is the square root of 1764")

这段代码创建了一个名为 agent 的AI代理，该代理使用了一个名为 calculator 的工具。然后，它询问代理 "What is the square root of 1764?"，代理将利用工具来计算并返回答案。

3. 项目的配置文件介绍

项目的配置主要通过 pyproject.toml 文件来进行。这个文件定义了项目的元数据、依赖项和其他构建系统配置。

以下是 pyproject.toml 文件的一个示例：

[build-system]
requires = ["setuptools", "wheel"]
build-backend = "setuptools.build_meta"

[tool.setuptools]
packages = find:
python_requires = ">=3.10"

[project]
name = "strands-agents"
version = "0.1.0"
description = "A model-driven approach to building AI agents in just a few lines of code."
authors = ["Strands Agents <[e-mail]>"]
license = { file = "LICENSE" }
readme = "README.md"
requires-python = ">=3.10"
classifiers = [
    "Programming Language :: Python :: 3.10",
    "License :: OSI Approved :: Apache Software License",
    "Operating System :: OS Independent",
]

在这个配置文件中：

• [build-system] 指定了构建系统所需的依赖项和后端。
• [tool.setuptools] 定义了如何查找项目中的包以及Python版本要求。
• [project] 包含了项目的元数据，如名称、版本、描述、作者、许可证、自述文件路径、Python版本要求以及项目分类。

确保在启动项目之前，你已经根据项目的需求和依赖正确配置了 pyproject.toml 文件。