# Strands Agents TS SDK — Agent + Tools + Swarm

> Strands Agents TS SDK provides an Agent runtime, model providers (Bedrock/OpenAI), tool helpers, and Graph/Swarm patterns for TypeScript workflows.

## Install

Copy the content below into your project:

## Quick Use

```bash
# Requires Node.js 20+ (per README)
npm install @strands-agents/sdk
```

## Intro

If you want an “agent runtime” in TS with pluggable models and explicit tool wiring, Strands gives you a batteries-included starting point.

**Best for:** TypeScript teams building agent workflows that need structured tools, hooks, and multi-agent orchestration patterns

**Works with:** Node.js 20+; default Amazon Bedrock provider; optional OpenAI provider (per README)

**Setup time:** 10–20 minutes

### Key facts (verified)

- README quick start shows `npm install @strands-agents/sdk` and a basic `new Agent()` invocation.
- Default provider is Amazon Bedrock; README notes you need AWS credentials and model access for default usage.
- README OpenAI provider example says it uses `process.env.OPENAI_API_KEY` and defaults to `gpt-5.4`.
- GitHub: 658 stars · 92 forks; pushed 2026-05-12 (GitHub API verified).

## Main

A clean way to adopt the SDK:

1. Start with a single agent and one or two small tools (I/O, search, DB query) so you can observe the loop.
2. Add hooks for logging/tracing early—multi-agent systems are hard to debug without visibility.
3. When you need more structure, move to Graph/Swarm patterns from the README and keep each agent’s responsibility narrow.
4. Treat model provider switches as configuration: Bedrock for AWS-native deployments, OpenAI for quick iteration, and pin model IDs for reproducibility.

The SDK’s value is “explicit wiring” — tools and orchestration are code, not hidden prompts.

### FAQ

**Q: Do I have to use Bedrock?**
A: No. Bedrock is the default, but the README includes an OpenAI provider example.

**Q: What Node version do I need?**
A: The README calls for Node.js 20+.

**Q: How do I keep runs reproducible?**
A: Pin model IDs and keep tool interfaces stable; log tool inputs/outputs via hooks early.

## Source & Thanks

> Source: https://github.com/strands-agents/sdk-typescript
> License: Apache-2.0
> GitHub stars: 658 · forks: 92

---

<!-- ZH -->

## 快速使用

```bash
# 需 Node.js 20+（README 说明）
npm install @strands-agents/sdk
```

## 简介

想在 TS 里做“可插拔模型 + 明确工具接线”的 agent runtime，Strands 是一个相对一体化的起点。

**最适合：** 用 TypeScript 做 agent 工作流的团队：需要结构化工具、hook 与多 agent 编排模式

**适配：** Node.js 20+；默认 Amazon Bedrock；README 也提供 OpenAI provider 示例

**配置时间：** 10–20 分钟

### 关键事实（已验证）

- README Quick Start 给出 `npm install @strands-agents/sdk` 与 `new Agent()` 的最小示例。
- README 说明默认 provider 是 Amazon Bedrock，需要配置 AWS 凭证并开通模型访问。
- README 的 OpenAI provider 示例提到读取 `OPENAI_API_KEY`，并默认使用 `gpt-5.4`。
- GitHub：658 stars · 92 forks；最近更新 2026-05-12（GitHub API 验证）。

## 正文

采用 SDK 的更干净的路径：

1. 先从单 agent + 1~2 个小工具开始（I/O、搜索、查库等），把循环跑通并能观测。
2. 早期就加 hook 做日志/trace：多 agent 没可观测性会非常难调。
3. 需要更强结构时，再按 README 的 Graph/Swarm 模式拆分，但每个 agent 的职责要尽量窄。
4. 把模型 provider 当配置管理：Bedrock 适合 AWS 原生部署；OpenAI 适合快速迭代；模型 ID 要固定以便复现。

SDK 的核心价值是“显式接线”：工具和编排写在代码里，而不是藏在提示词里。

### FAQ

**必须用 Bedrock 吗？**
答：不必须。Bedrock 是默认，但 README 提供了 OpenAI provider 示例。

**需要什么 Node 版本？**
答：README 写的是 Node.js 20+。

**如何保证可复现？**
答：固定 modelId，稳定工具接口，并尽早用 hook 记录工具入参/出参。

## 来源与感谢

> Source: https://github.com/strands-agents/sdk-typescript
> License: Apache-2.0
> GitHub stars: 658 · forks: 92


---
Source: https://tokrepo.com/en/workflows/strands-agents-ts-sdk-agent-tools-swarm
Author: Agent Toolkit