빠른 시작 - Failproof AI

이 빠른 시작 가이드는 한 대의 머신에서 세션을 보고하고, 감사를 실행하며, 정책을 배포하는 과정을 안내합니다. 스킬을 사용하거나 아래의 수동 단계를 따라 Failproof AI를 설정하세요. Node.js 20.9 이상이 필요합니다.

스킬 사용
수동 설정

Failproof AI 스킬 설치

npx skills add FailproofAI/skills

에이전트에게 전체 설정 요청

Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.

에이전트가 프로젝트를 검사하고, 적절한 통합 방식을 선택하고, 설정을 수행한 후 세션이 정상적으로 도착하는지 확인합니다. 개별 스킬 및 고급 설치 옵션은 FailproofAI 스킬 저장소를 참고하세요.

시작하기 전에

Failproof AI 대시보드를 열고 계정을 생성하거나 업무용 이메일로 로그인하세요.
관리 → 키로 이동하여 events:add 및 policies:pull 권한을 가진 키를 생성하세요.
일회용 시크릿을 복사하고 대상 머신에 저장하세요:

export FAILPROOFAI_KEY="<one-time-secret>"

설치

Failproof AI 설치 및 연결

npm install -g failproofai
failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY"

세션 트랜스크립트는 기본적으로 전송됩니다. 트랜스크립트 내용 없이 훅 활동 및 정책 결정만 보고하려면 --no-transcripts를 추가하세요.이 머신에 이미 에이전트 기록이 있다면, 최근 7일 치를 미리 확인하고 가져온 후 전송이 완료될 때까지 기다리세요. 새 머신에서는 이 단계를 건너뛰세요.

failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d
failproofai flush --wait

Failproof AI에서 세션을 열고 가져온 세션을 선택하세요.

에이전트 훅 및 정책 설치

이 단계는 Failproof AI를 에이전트 CLI에 연결하고 기본 제공 정책을 설치합니다. Failproof AI가 세션을 감사하고 에이전트에 맞는 정책을 작성하기 전에, 로컬 정책 결정을 확인하고 적용을 미리 시험해볼 수 있습니다.에이전트 CLI를 자동으로 감지하도록 두거나 명시적으로 지정할 수 있습니다.

failproofai policies --install --cli claude --scope user

동작 감사

첫 번째 실패 검사 실행을 따라 진행하세요. “에이전트가 접근 방식을 바꾸지 않고 실패한 도구를 반복 재시도한 세션 찾기”와 같이 구체적인 목표를 사용하세요.

실패 방지

정책으로 첫 번째 실패 방지하기를 따라 진행하세요. 관찰 모드로 시작하여 일치 항목을 검토한 후, 검토된 버전을 적용하세요.

failproofai config --status를 실행하세요. 정상적으로 설정된 경우 클라우드 연결 상태, 데몬 상태, 그리고 적용이 일시 중지되었는지 여부가 표시됩니다.

​시작하기 전에

​설치

시작하기 전에

설치