harness-sdk

Strands Agents

몇 줄의 코드로 AI 에이전트를 구축하는 모델 기반 접근 방식입니다.

문서
◆ 샘플
◆ CLI
◆ MCP Server
◆ Discord

Harness ( Python , TypeScript )
◆ SDK ( Python , TypeScript )
◆ Box
◆ Shell
◆ Evals
◆ Labs

Strands Agents는 Python과 TypeScript로 AI 에이전트를 구축하고 실행하기 위한 오픈소스 SDK입니다. 직접 에이전트 루프를 작성해야 할 상황에서 Strands를 선택하세요. Strands는 호스팅되는 컨트롤 플레인 없이 여러분의 프로세스 안에서 실행되며, 직접 만든 루프가 결국 필요로 하게 되는 작업들을 모두 처리합니다. 하나의 SDK에서 수명 주기 제어(턴 제한, 토큰 예산, 취소, 중지 사유), 도구와 구조화된 출력 , MCP , 멀티 에이전트 패턴 , 메모리와 세션 , 모델 이식성 , 스트리밍 , 가드레일 , 트레이싱 , 그리고 evals 를 모두 제공합니다.

코딩 에이전트를 사용 중이신가요? Claude Code, Codex, 또는 Cursor용 Strands 플러그인을 설치하세요.
프레임워크 선택, 스캐폴딩, 도구 작성, MCP 서버 연결, 웹
프레임워크 가이드, LangGraph 마이그레이션 가이드를 추가해 줍니다. 설치 및 검증 단계는
Use Strands with AI coding agents
를 참고하세요.

이 모노레포에는 Strands harness, Python 및 TypeScript SDK, 문서 사이트, 그리고 지원 패키지들이 포함되어 있습니다:

디렉터리
설명

harness-py/
Python Strands harness: create_harness() 를 통한 완전히 조립된 에이전트 ( PyPI · docs )

harness-ts/
TypeScript Strands harness: createHarness() 를 통한 완전히 조립된 에이전트 ( npm · docs )

strands-cli/
strands CLI: 터미널에서 harness 에이전트로 프로토타이핑하고 채팅 ( npm )

strands-py/
Python SDK: 에이전트 루프, 모델 제공자, 도구 ( PyPI · releases )

strands-ts/
TypeScript SDK: 에이전트 루프, 모델 제공자, 도구 ( npm · releases )

strands-mcp/
코딩 에이전트에게 Strands Agents로 구축하는 방법에 대한 지식을 제공하는 MCP 서버 ( PyPI )

site/
strandsagents.com 문서 사이트의 소스 (Astro/Starlight)

team/
거버넌스 및 크로스 SDK 프로세스 문서 (원칙, 결정, PR 및 호환성 가이드라인, designs/ 제안서)

test-infra/
일부 통합 테스트가 실행되는 AWS 리소스(지식 기반, SSH 샌드박스)를 프로비저닝하는 CDK 스택

Why Strands
에이전트 harness를 구축하세요. 엔드투엔드로 제어하세요.

원하는 방식으로 구축하세요. 어떤 모델, 어떤 클라우드든. 설정 한 줄 작성하기 전에 컨텍스트 관리, 실행 제한, 관측 가능성이 기본으로 내장됩니다. 확장할 때 백엔드를 교체해도 코드는 그대로 유지됩니다.
모델에 구애받지 않음. Amazon Bedrock, Anthropic, OpenAI, Gemini에 대한 일급 지원과 더불어 다양한 제공자 및 커스텀 제공자를 지원합니다.
제어권 유지. 에이전트 루프는 기본적으로 모든 결정을 트레이싱합니다. Hooks를 사용하면 모든 단계를 가로채서 로깅, 검증, 또는 리다이렉트할 수 있습니다.
작동하는 결과물 제공. 가드레일은 실수가 실행되기 전에 잡아냅니다. 스티어링 핸들러를 통해 에이전트가 조용히 실패하는 대신 스스로 교정할 수 있습니다.

MCP, 스트리밍, 멀티 에이전트 패턴, 구조화된 출력이 모두 기본으로 내장되어 있습니다.

Quick Start
가장 쉽게 시작하는 방법은 완전히 조립된 최신 에이전트인 Strands harness 를 사용하는 것입니다. create_harness() (Python) 또는 createHarness() (TypeScript)를 한 번 호출하면 모델, 도구, 메모리, 세션, 컨텍스트 관리에 대해 벤치마크된 기본값을 갖춘 최적화된 에이전트를 얻을 수 있습니다 — 아이디어에서 프로덕션까지 바로 사용할 준비가 된 상태입니다. harness quickstart 를 따르거나, Python Strands harness 및 TypeScript Strands harness 패키지를 참고하여 시작하세요.

Python
pip install strands-harness
from strands_harness import create_harness

agent = create_harness ()
agent ( "Find the slowest test in this repo and explain why it's slow" )
TypeScript
npm install @strands-agents/harness
import { createHarness } from '@strands-agents/harness'

const agent = await createHarness ( )
await agent . invoke ( "Find the slowest test in this repo and explain why it's slow" )
배터리가 포함된 에이전트를 얻으려면 여기서 시작하고, 에이전트 루프를 직접 소유하며 도구, 모델 제공자, 메모리를 직접 연결하고 싶을 때 아래 SDK로 내려가세요. harness 구성 레퍼런스는 재정의할 수 있는 모든 기본값을 문서화합니다.

Quickstart Guide 는 제공자 구성(Amazon Bedrock, Anthropic, OpenAI, Gemini, Ollama 등)을 다룹니다.

Working with the SDK
Strands Harness SDK를 사용하면 더 깊이 들어가 에이전트의 모든 부분을 제어할 수 있습니다: 루프, 도구, 모델 제공자, 메모리, 세션, hooks. Strands harness를 사용해 본 후 SDK로 들어가거나, 조립된 기본값이 충분하지 않을 때 자신만의 harness를 처음부터 구축하고 싶다면 SDK를 살펴보세요.

Python
Python 3.10+ 필요:

pip install strands-agents
from strands import Agent
from strands . vended_tools import http_request

agent = Agent ( tools = [ http_request ])
agent ( "Tell me about the Strands harness features: https://strandsagents.com/docs/user-guide/harness/index.md" )
Python SDK README 는 도구, 모델 제공자, MCP, 양방향 스트리밍을 다룹니다.

TypeScript
TypeScript로 Strands 에이전트를 구축하려면 Node.js 22+ ESM 프로젝트( "type": "module" )에 SDK를 설치하세요:

npm install @strands-agents/sdk
import { Agent } from '@strands-agents/sdk'
import { httpRequest } from '@strands-agents/sdk/vended-tools/http-request'

const agent = new Agent ( { tools : [ httpRequest ] } )
await agent . invoke ( 'Tell me about the Strands harness features: https://strandsagents.com/docs/user-guide/harness/index.md' )
에이전트는 기본적으로 Amazon Bedrock을 사용하므로 AWS 자격 증명을 구성하거나 다른 모델을 전달하세요.
TypeScript quickstart 로 시작하여
모델 제공자를 구성하고, 첫 에이전트를 실행하고, 도구를 추가하세요. 전체
SDK 표면은 TypeScript API reference 를 사용하거나,
TypeScript SDK README 에서 더 많은 예제를 살펴보세요.

Documentation
자세한 안내와 예제는 문서를 살펴보세요:

User Guide
Strands Harness Guide ( quickstart · configuration reference )
Quick Start Guide
Agent Loop
Bidirectional Streaming (Python)
Examples
API Reference: Python · TypeScript
Production & Deployment Guide

문서 자체는 이 모노레포의 site/ 아래에 있으며, 코드 변경과 함께 문서 PR도 환영합니다.

Development
Git 작업(커밋, 브랜치, PR)은 레포 루트에서 수행합니다. 각 패키지는 자체 툴체인을 가집니다:

Python SDK ( strands-py/ ):

cd strands-py
pip install hatch
hatch test # run unit tests
hatch fmt # format & lint
TypeScript SDK ( strands-ts/ ):

npm ci # install from repo root
npm run build # build
npm test # run unit tests
문서 사이트 ( site/ ):

cd site
npm install
npm run dev # local dev server at http://localhost:4321/
Contributing ❤️
기여를 환영합니다! 자세한 내용은 Contributing Guide 를 참고하세요:

버그 및 기능 보고
개발 환경 설정
Pull Request를 통한 기여
행동 강령
보안 이슈 보고

Stay in touch with the team
Discord 에서 Strands 팀과 다른 사용자들을 만나보세요

License
이 프로젝트는 Apache License 2.0에 따라 라이선스가 부여됩니다 - 자세한 내용은 LICENSE.APACHE 파일을 참고하세요.

Security
자세한 내용은 CONTRIBUTING 을 참고하세요.