harness-sdk

Strands Agents는 Python과 TypeScript로 AI 에이전트를 구축하고 실행하기 위한 오픈소스 SDK입니다. 직접 에이전트 루프를 작성하는 것의 대안으로 자리 잡고 있으며, 호스팅되는 제어 플레인 없이 사용자 프로세스 안에서 실행되고, 수작업 루프가 쌓이기 마련인 기능들을 묶어 제공합니다. README에 설명된 핵심 기능: - 수명 주기 제어: 턴 제한, 토큰 예산, 취소, 중지 사유. - 도구와 구조화된 출력, 그리고 MCP(Model Context Protocol) 통합. - 다중 에이전트 패턴, 메모리 및 세션 관리. - 모델 이식성: Amazon Bedrock, Anthropic, OpenAI, Gemini에 대한 일급 지원과 추가 제공자 및 사용자 지정 제공자 지원. - 스트리밍, 가드레일, 추적/관측성, 평가 SDK. - 에이전트 루프 단계를 가로채어 로깅, 검증 또는 리디렉션할 수 있는 훅. 저장소 구조(모노레포): - harness-py/ — create_harness()를 통해 완전히 조립된 에이전트를 제공하는 Python 하네스. PyPI에 strands-harness로 게시. - harness-ts/ — createHarness()를 통한 TypeScript 하네스. npm에 @strands-agents/harness로 게시. - strands-cli/ — 터미널에서 하네스 에이전트를 프로토타이핑하고 대화하기 위한 strands CLI(npm @strands-agents/cli). - strands-py/ — 에이전트 루프, 모델 제공자, 도구를 포함한 Python SDK(PyPI strands-agents). - strands-ts/ — TypeScript SDK(npm @strands-agents/sdk). - site/ — strandsagents.com 문서 사이트 소스(Astro/Starlight). - team/ — 설계 제안을 포함한 거버넌스 및 SDK 간 프로세스 문서. 빠른 시작 경로: 하네스 경로는 pip install strands-harness와 create_harness(), 또는 npm install @strands-agents/harness와 createHarness()를 사용하여 모델, 도구, 메모리, 세션, 컨텍스트 관리에 대한 기본값을 갖춘 에이전트를 얻습니다. SDK 경로는 pip install strands-agents strands-agents-tools(Python 3.10+) 또는 npm install @strands-agents/sdk(Node.js 22+)를 사용하여 에이전트 루프를 직접 소유하고 도구와 제공자를 직접 연결합니다. 구성 참조 문서에는 재정의 가능한 하네스 기본값이 설명되어 있습니다. 개발: Python 패키지는 hatch(hatch test, hatch fmt)를 사용하고, TypeScript는 npm ci, npm run build, npm test를 사용하며, 문서 사이트는 localhost:4321에서 npm run dev로 실행됩니다. Apache 2.0 라이선스입니다. 문서, 샘플, MCP 서버, Discord 커뮤니티가 README에서 링크되어 있습니다.