Alex-harness은(는) 무엇을 하나요?
AI 워크플로우를 테스트, 실행 및 제어하기 위한 에이전트 하네스입니다.
개요
Alex-harness는 AI 에이전트 워크플로우를 위한 강력한 하네스로, 개발자가 복잡한 AI 기반 작업을 정의, 실행 및 모니터링할 수 있도록 지원합니다. 이 도구는 Claude Code, Cursor, Codex와 같은 주요 AI 코딩 에이전트와 원활하게 통합됩니다.
주요 기능
- 워크플로우 정의: YAML 또는 JSON을 사용하여 다단계 AI 워크플로우를 정의합니다.
- 상태 관리: 각 워크플로우 단계의 상태를 추적하고 재시도 로직을 적용합니다.
- 컨텍스트 유지: 에이전트 호출 간 컨텍스트를 유지하여 일관된 동작을 보장합니다.
- 모니터링: 워크플로우 실행을 실시간으로 모니터링합니다.
- 통합: 외부 도구 및 API와의 통합을 지원합니다.
설치
npm install alex-harness
또는
yarn add alex-harness
사용법
간단한 워크플로우 예제
const { Harness } = require('alex-harness');
const workflow = {
steps: [
{
name: '코드 생성',
agent: 'claude-code',
prompt: 'React 컴포넌트를 생성하세요.'
},
{
name: '테스트',
agent: 'cursor',
prompt: '생성된 코드를 테스트하세요.'
}
]
};
const harness = new Harness();
harness.run(workflow).then(result => {
console.log('워크플로우 완료:', result);
});
API
Harness 클래스
constructor(options)
options.retryCount: (선택 사항) 단계 실패 시 재시도 횟수 (기본값: 3)options.timeout: (선택 사항) 각 단계의 제한 시간 (밀리초, 기본값: 30000)
run(workflow)
정의된 워크플로우를 실행합니다.
on(event, callback)
워크플로우 이벤트를 수신합니다.
event: 'stepStart', 'stepComplete', 'stepError' 등callback: 이벤트 데이터를 수신하는 함수
환경 변수
| 변수명 | 설명 | 필수 |
|---|---|---|
ALEX_API_KEY | Alex-harness API 키 | 예 |
CLAUDE_API_KEY | Claude Code API 키 | 아니요 |
OPENAI_API_KEY | OpenAI (Codex) API 키 | 아니요 |
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 OpenAI 호환 API
라이선스
MIT