Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
AgentGuard는 AI 에이전트의 무한 루프나 오류로 인해 발생하는 과도한 API 비용을 방지하기 위한 도구입니다. 설정된 예산 한도에 도달하면 프로세스를 실시간으로 즉시 중단하여 예상치 못한 금전적 손실을 막아줍니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 HN Claude Code Search의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기당신의 AI 에이전트에 버그가 발생했습니다. 루프(loop) 내에서 1,000번의 API 호출을 수행합니다. 당신의 2,000달러 신용카드가 청구됩니다.
이런 일은 개발자들에게 매주 발생합니다:
기존 도구들은 피해가 발생한 이후에만 알려줍니다.
AgentGuard는 예산이 소진되기 전에 프로세스를 자동으로 종료합니다.
// 어떤 AI 프로젝트에도 2줄만 추가하세요:
const agentGuard = require('agent-guard');
await agentGuard.init({ limit: 50 }); // $50 예산 제한
...
결과: 2,000달러를 잃는 대신, 50달러만 잃고 상세 보고서를 받게 됩니다.
graph TD
A["🤖 당신의 AI 에이전트 시작"] --> B["📦 AgentGuard.init({ limit: $50 })"]
B --> C["🔍 모든 AI API 호출 모니터링"]
...
sequenceDiagram
participant App as 🤖 당신의 앱 (Your App)
participant AG as 🛡️ AgentGuard
...
graph LR
subgraph "🛠️ 보호 모드 (Protection Modes)"
A["mode: 'throw'<br/>🛡️ 가장 안전함"]
...
| 도구 | 기능 | 문제를 알게 되는 시점 |
|---|---|---|
| OpenAI Dashboard | 발생 후 사용량 표시 | 몇 시간 후 이메일로 알림 |
| LangChain Callbacks | 코드 내 토큰 (tokens) 추적 | 스크립트 종료 후 |
| tokencost | 호출 전 비용 추정 | 호출을 하기 전 |
| AgentGuard | 한도 도달 시 실행 중단 | 실행 도중 즉시 |
AgentGuard는 폭주하는 비용을 실시간으로 실제로 방지하는 유일한 도구입니다.
npm install agent-guard
const agentGuard = require('agent-guard');
await agentGuard.init({ limit: 50 }); // $50 예산
...
🛡️ AgentGuard v1.2.1 초기화됨
💰 예산 보호: $50 (모드: throw)
📊 $12.34 / $50.00 (24.7%) | OpenAI API 추적 중
...
// 1단계: AI 에이전트에 다음 두 줄을 추가하세요
const agentGuard = require('agent-guard');
await agentGuard.init({ limit: 25 }); // $25 예산 제한
...
try {
const guard = await agentGuard.init({
limit: 100, // USD 단위의 예산 제한
...
--------------------------------------------------
🛡️ AgentGuard v1.2.0 초기화됨
💰 예산 보호: $25 (모드: throw)
...
// 비싼 실수로부터 개발 스크립트를 보호하세요
await agentGuard.init({ limit: 10, mode: 'throw' });
// 예상치 못한 청구서 없이 AI를 안전하게 실험해 보세요
// Redis를 사용한 다중 프로세스 보호
await agentGuard.init({
limit: 1000,
...
<script src="https://unpkg.com/agent-guard@latest/dist/agent-guard.min.js"></script>
<script>
AgentGuard.init({ limit: 50, mode: 'notify' });
...
const guard = await agentGuard.init({ limit: 100 });
// 언제든지 비용을 확인하세요
...
AgentGuard가 실제 통제 불능의 비용 증가를 방지하는 것을 확인해 보세요:
# 무한 루프 보호 (무한 AI 루프 시뮬레이션)
node examples/runaway-loop-demo.js
...
확인 가능한 내용: 실시간 비용 추적, 자동 보호 활성화, 그리고 돈을 절약하는 우아한 오류 처리 방식입니다.
코드 변경이 필요 없습니다. AgentGuard는 다음 항목들을 자동으로 모니터링합니다:
tiktoken + Anthropic의 공식 토크나이저모든 주요 제공업체 지원: OpenAI, Anthropic, URL로부터 자동 감지
await agentGuard.init({
privacy: true, // 로그에서 요청/응답 콘텐츠를 마스킹 (Redacts request/response content from logs)
silent: true // 민감한 환경에서 비용 표시 비활성화 (Disables cost display for sensitive environments)
...
[REDACTED]로 표시됨// 우아한 성능 저하 (Graceful degradation) (권장)
mode: 'throw' // 포착 가능한 AgentGuardError를 발생시킴
mode: 'notify' // 경고를 보내지만 실행을 계속함
...
소프트 실패 (Soft failures)가 중요한 이유:
await agentGuard.init({
redis: 'redis://localhost:6379', // 프로세스 간 공유되는 예산
limit: 100 // 모든 인스턴스의 통합 제한
...
init(options)지정된 옵션으로 AgentGuard를 초기화합니다.
const agentGuard = require('agent-guard');
const guard = await agentGuard.init({
limit: 50, // USD 단위의 비용 제한
...
// 비용 모니터링 (Cost monitoring)
guard.getCost() // 현재 총 비용
guard.getLimit() // 현재 예산 제한
...
여러분의 기여를 환영합니다! 자세한 내용은 기여 가이드 (Contributing Guide)를 참조하세요.
git clone https://github.com/dipampaul17/AgentGuard.git
cd AgentGuard
node verify-installation.js
MIT - 상업적 프로젝트를 포함하여 어디에서든 사용할 수 있습니다.
AgentGuard: AI 비용 폭주가 발생하기 전에 이를 차단하는 유일한 도구입니다.
실시간 예산 집행 (Real-time budget enforcement) • 우아한 오류 처리 (Graceful error handling) • 코드 변경 없음 (Zero code changes)