agent-harness은(는) 무엇을 하나요?
클린룸 하네스를 사용하여 스트리밍 루프, 도구 제어, 세션 저장, 안전한 자격 증명, 계층형 구성을 갖춘 코딩 에이전트를 구축합니다.
개요
vmy41/agent-harness는 코딩 에이전트 개발을 위한 경량 클린룸 하네스입니다. 에이전트의 실행 환경을 깔끔하게 유지하면서 핵심 기능(스트리밍, 도구 호출, 상태 관리, 보안)을 제공합니다.
주요 기능
- 스트리밍 루프: 에이전트의 응답을 청크 단위로 실시간 스트리밍
- 도구 제어: 에이전트가 안전하게 외부 도구를 호출하고 결과를 처리
- 세션 저장: 에이전트의 세션 상태를 저장하고 복원
- 안전한 자격 증명: 환경 변수와 암호화된 저장소를 통한 자격 증명 관리
- 계층형 구성: YAML/JSON 기반의 다중 레벨 구성 시스템
지원 플랫폼
- Cursor
- Claude Code
- Codex
- 기타 AI 코딩 에이전트 플랫폼
사용법
# 설치
npm install agent-harness
# 기본 사용법
import { Harness } from 'agent-harness';
const harness = new Harness({
model: 'claude-sonnet-4-20250514',
tools: ['read_file', 'write_file', 'bash'],
});
harness.run('파일을 생성하고 테스트를 실행하세요.');
구성 예시
# config.yaml
agent:
model: claude-sonnet-4-20250514
temperature: 0.7
max_tokens: 4096
tools:
enabled:
- read_file
- write_file
- bash
disabled:
- network
security:
creds:
provider: env
# 또는: provider: vault
sandbox: true
세션 저장
const session = await harness.saveSession('session-1');
// ... 나중에
await harness.restoreSession('session-1');
자격 증명 관리
// 환경 변수 사용
process.env.OPENAI_API_KEY = 'sk-...';
// 또는 암호화된 저장소 사용
await harness.setCredential('github_token', 'ghp_...');
라이선스
MIT