Strands Agents 示例

一种基于模型的方法，只需几行代码即可构建 AI 代理。

文档 ◆ 示例 ◆ Python SDK ◆ TypeScript SDK ◆ 工具 ◆ Agent Builder ◆ MCP 服务器

欢迎来到 Strands Agents 示例仓库！

探索易于使用的示例，开始使用 Strands Agents。

本仓库中的示例仅用于演示和教育目的。它们展示了概念和技术，但不适用于直接在生产环境中使用。在生产环境中使用之前，请务必遵循适当的安全和测试流程。

快速入门

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# 在 macOS/Linux 上：
source venv/bin/activate
# 在 Windows 上：
venv\Scripts\activate

pip install strands-agents strands-agents-tools

from strands import Agent

agent = Agent()
response = agent("你好！给我讲个笑话。")
print(response)

npm install @strands-agents/sdk

import { Agent } from "@strands-agents/sdk";

async function main() {
    const agent = new Agent({
        systemPrompt: "你是一个乐于助人的助手。"
    });

    const response = await agent.invoke("你好！给我讲个笑话。");
    console.log(response.toString());
}

main();

模型提供商设置

请按照此处的说明配置您的模型提供商和模型访问权限。

探索仓库

Python 示例

• 01-learn - SDK 教程，涵盖基础知识、多智能体系统和流式处理
• 02-deploy - Lambda、Fargate 和 AgentCore 的部署模式
• 03-integrate - 与 AWS 服务、数据库和其他第三方工具的集成
• 04-industry-use-cases - 行业应用（金融、医疗、零售、生产力等）
• 05-technical-use-cases - 架构模式，包括 Agentic RAG
• 06-evaluate - 评估教程和测试模式
• 07-ux-demos - 带有用户界面的全栈应用
• 08-edge - 边缘设备集成，包括实体 AI 和机器人技术

TypeScript 示例

• 01-learn - TypeScript SDK 的教程
• 02-deploy - AgentCore 的部署模式

贡献 ❤️

我们欢迎贡献！请参阅我们的 贡献指南，了解有关以下内容的详细信息：

• 报告错误和功能需求
• 开发环境搭建
• 通过拉取请求贡献
• 行为准则
• 安全问题报告

许可证

该项目采用 Apache License 2.0 许可证——详情请参阅 LICENSE 文件。

安全性

更多信息请参阅 CONTRIBUTING。

Strands Agents Samples 快速上手指南

欢迎使用 Strands Agents Samples 仓库。本项目提供了一系列基于模型驱动构建 AI Agent 的示例代码，支持 Python 和 TypeScript 两种语言。

注意：本仓库中的示例仅用于演示和教育目的，不建议直接用于生产环境。在生产使用前，请务必实施适当的安全措施和测试流程。

1. 环境准备

请根据您的开发语言选择对应的环境要求：

Python 版本

• 系统要求：Python 3.10 或更高版本
• 包管理器：pip
  • 验证安装：pip --version 或 pip3 --version
  • 若未安装，可通过以下命令安装：

    # 方法 1：使用 Python 内置模块
    python -m ensurepip --upgrade
    
    # 方法 2：下载官方安装脚本
    curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
    python get-pip.py
    

TypeScript 版本

• 系统要求：Node.js 18 或更高版本
• 包管理器：npm 或 yarn

2. 安装步骤

Python 安装

第一步：创建并激活虚拟环境

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# macOS/Linux:
source venv/bin/activate
# Windows:
venv\Scripts\activate

第二步：安装依赖库

pip install strands-agents strands-agents-tools

TypeScript 安装

在项目目录下运行以下命令安装 SDK：

npm install @strands-agents/sdk

3. 基本使用

在运行代码前，请参考 官方文档 配置您的模型提供商（Model Provider）及访问凭证。

Python 示例

创建一个简单的 Agent 并与其对话：

from strands import Agent

agent = Agent()
response = agent("Hello! Tell me a joke.")
print(response)

👉 更多教程请查看：Python 教程目录

TypeScript 示例

创建一个带有系统提示词的 Agent 并调用：

import { Agent } from "@strands-agents/sdk";

async function main() {
    const agent = new Agent({
        systemPrompt: "You are a helpful assistant."
    });

    const response = await agent.invoke("Hello! Tell me a joke.");
    console.log(response.toString());
}

main();

👉 更多教程请查看：TypeScript 教程目录

4. 探索更多示例

本仓库包含丰富的应用场景示例：

Python 示例分类

• 01-learn: SDK 基础、多 Agent 系统与流式输出教程
• 02-deploy: Lambda、Fargate 及 AgentCore 部署模式
• 03-integrate: AWS 服务、数据库及第三方工具集成
• 04-industry-use-cases: 金融、医疗、零售等行业应用
• 05-technical-use-cases: 架构模式（如 Agentic RAG）
• 06-evaluate: 评估教程与测试模式
• 07-ux-demos: 带用户界面的全栈应用
• 08-edge: 边缘设备集成（物理 AI 与机器人）

TypeScript 示例分类

• 01-learn: TypeScript SDK 基础教程
• 02-deploy: AgentCore 部署模式