AI 코딩 에이전트의 모든 도구 호출을 실행 전에 제어하고 PASS, AUTH 또는 BLOCK을 반환하는 런타임 가드입니다.
superagent-ai/superagent
프롬프트 인젝션을 차단하고 PII와 시크릿을 마스킹하며, 에이전트를 겨냥한 공격이 있는지 저장소를 검사하는 오픈소스 SDK입니다.
- 스타
- 6,847
- 포크
- 966
- 열린 이슈
- 21
- 마지막 커밋
- 2개월 전
어떤 프로젝트인가요?
Superagent SDK는 대규모 언어 모델 기반 애플리케이션에 안전성 검사를 추가하는 툴킷입니다. guard 메서드는 런타임에 사용자 입력을 검사해 프롬프트 인젝션, 악의적인 지침, 안전하지 않은 도구 호출을 탐지하고 차단합니다. redact 메서드는 텍스트에서 PII, PHI, 시크릿을 제거하고 <EMAIL_REDACTED> 같은 플레이스홀더로 대체합니다.
또한 SDK에는 repo poisoning이나 삽입된 악의적인 지침처럼 AI 에이전트를 겨냥한 공격이 있는지 저장소를 분석하는 scan 메서드가 포함되어 있습니다. 프로덕션 에이전트를 대상으로 레드팀 시나리오를 실행하는 테스트 기능은 곧 출시될 예정입니다.
이 프로젝트는 TypeScript 및 Python SDK, CLI, 그리고 Claude Code와 Claude Desktop에서 사용할 수 있는 MCP 서버를 제공합니다. OpenAI, Anthropic, Google, Groq, Bedrock 모델을 지원하며, 자체 인프라에서 Guard를 실행할 수 있는 오픈 웨이트 모델도 제공합니다.
핵심 기능
- 01런타임에 프롬프트 인젝션과 안전하지 않은 도구 호출을 탐지하고 차단
- 02텍스트에서 PII, PHI, 시크릿 마스킹
- 03repo poisoning 및 에이전트를 겨냥한 악의적인 지침이 있는지 저장소 검사
- 04TypeScript 및 Python SDK와 CLI 제공
- 05Claude Code 및 Claude Desktop용 MCP 서버
활용 사례
- 사용자 입력이 모델에 전달되기 전에 챗봇에 필터링 추가
- 프롬프트나 로그에서 민감한 고객 데이터 마스킹
- AI 코딩 에이전트가 읽을 서드파티 저장소 검사
- 오픈 웨이트 모델을 사용해 자체 호스팅 인프라에서 Guard 실행
빠른 시작
- 1
superagent.sh에 가입해 API 키를 받으세요
- 2
TypeScript SDK를 설치하세요
npm install safety-agent - 3
API 키를 설정하세요
export SUPERAGENT_API_KEY=your-key
사용 전 알아둘 점
- Guard, redact, scan을 사용하려면 Superagent API 키가 필요하므로, 오픈 웨이트 모델을 셀프 호스팅하지 않는 한 계정과 네트워크 접속이 필요합니다.
- Test 기능은 출시 예정으로 표시되어 있으며 아직 사용할 수 없습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- superagent은(는) 무엇인가요?
- 프롬프트 인젝션을 차단하고 PII와 시크릿을 마스킹하며, 에이전트를 겨냥한 공격이 있는지 저장소를 검사하는 오픈소스 SDK입니다. Superagent SDK는 대규모 언어 모델 기반 애플리케이션에 안전성 검사를 추가하는 툴킷입니다. guard 메서드는 런타임에 사용자 입력을 검사해 프롬프트 인젝션, 악의적인 지침, 안전하지 않은 도구 호출을 탐지하고 차단합니다. redact 메서드는 텍스트에서 PII, PHI, 시크릿을 제거하고 <EMAIL_REDACTED> 같은 플레이스홀더로 대체합니다.
- superagent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- superagent은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- superagent은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. superagent의 마지막 커밋은 2026년 8월 25일입니다.
- superagent은(는) 어디에 사용할 수 있나요?
- 사용자 입력이 모델에 전달되기 전에 챗봇에 필터링 추가 프롬프트나 로그에서 민감한 고객 데이터 마스킹 AI 코딩 에이전트가 읽을 서드파티 저장소 검사 오픈 웨이트 모델을 사용해 자체 호스팅 인프라에서 Guard 실행
- superagent는 어떻게 설치하나요?
- superagent.sh에 가입해 API 키를 받으세요 TypeScript SDK를 설치하세요: npm install safety-agent API 키를 설정하세요: export SUPERAGENT_API_KEY=your-key
- superagent은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/superagent-ai/superagent
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
LLM 시스템과 AI 에이전트를 레드팀 테스트하고, 공격을 시뮬레이션해 취약점을 찾으며 프로덕션 가드레일을 제공하는 오픈소스 Python 프레임워크입니다.
LLM 기반 대화형 애플리케이션에 프로그래밍 가능한 가드레일을 추가해 주제, 대화 흐름, 출력을 제어하는 오픈 소스 Python 툴킷입니다.
호스팅 환경이나 로컬에서 실행되는 Jev 스타일 의사결정 모델로 에이전트 평가와 가드레일을 수행하며, 한 트레이스의 모든 검사를 한 번의 요청으로 처리하는 Python 라이브러리입니다.
Claude Code와 Codex 같은 AI 코딩 에이전트가 위험한 Git·파일 시스템 명령을 실행하거나 비밀 파일에 접근하지 못하도록 차단하는 실행 전 보호 도구입니다.
도구를 사용하는 AI 에이전트와 도구 사이에서 위험한 호출을 차단하고 민감한 결과를 가리는 호스트에 구애받지 않는 안전 미들웨어입니다.