Repolode
ifixai-ai

ifixai-ai/iFixAi

AI 에이전트가 역할을 벗어나지 않고, 조작에 저항하며, 사실을 지어내지 않는지 61개 검사 항목으로 감사하는 Python CLI입니다.

스타
43,588
포크
1,785
열린 이슈
3
마지막 커밋
15시간 전

어떤 프로젝트인가요?

iFixAi는 AI 에이전트를 위한 독립 감사 도구입니다. 프로필과 정책 파일을 바탕으로 비즈니스 환경을 시뮬레이션하고, 역할을 벗어나게 하는 요청을 포함해 일상적으로 접할 만한 요청을 에이전트에 보낸 뒤 별도의 판정 모델이 각 답변을 평가합니다. 각 감사 결과에는 요청 내용과 에이전트의 응답이 기록됩니다.

기본 실행에서는 일반 채팅 엔드포인트에서 작동하는 검사 10개를 수행합니다. 검사 항목은 도구 권한, prompt injection, 정책 위반, 사용자 간 데이터 유출, 불확실성 처리, 지시 따르기 등을 다룹니다. --full-run 옵션을 사용하면 에이전트에 적용할 수 없는 항목은 건너뛰고 전체 61개 검사를 실행합니다. 결과는 다섯 가지 기준에 따라 A부터 F까지 평가하며, 필수 최소 기준 세 가지 중 하나라도 통과하지 못하면 등급은 D를 넘을 수 없습니다.

판정 모델은 테스트 대상 에이전트와 다른 제공업체에서 선택합니다. 보고서는 JSON과 Markdown으로 작성되며, --min-score 임계값을 설정해 CI 파이프라인을 차단하도록 할 수 있습니다. 기본 제공 데모 에이전트를 사용하면 API 키 없이도 전체 흐름을 확인할 수 있습니다.

핵심 기능

  • 01일반 채팅 엔드포인트에서 기본 검사 10개를 빠르게 실행합니다.
  • 02--full-run 옵션으로 61개 검사를 제공합니다.
  • 03테스트 대상 에이전트와 다른 제공업체의 판정 모델을 사용합니다.
  • 04필수 최소 기준에 따라 점수를 제한하며 결과를 A부터 F까지 평가합니다.
  • 05보고서를 JSON과 Markdown으로 내보내고, CI에서 점수 기준을 적용할 수 있습니다.

활용 사례

  • 고객 지원 에이전트가 환불 및 계정 변경 권한을 준수하는지 확인합니다.
  • 에이전트를 프로덕션에 배포하기 전에 prompt injection에 취약한지 테스트합니다.
  • EU AI Act 또는 NIST AI RMF와 같은 AI 거버넌스 프레임워크에 필요한 감사 증거를 생성합니다.
  • CI 파이프라인에 에이전트 동작의 회귀 검사를 추가합니다.

빠른 시작

  1. 1

    virtualenv를 만들고 활성화합니다

    python3 -m venv .venv && source .venv/bin/activate
  2. 2

    PyPI에서 iFixAi를 설치합니다

    pip install ifixai
  3. 3

    참조용 시뮬레이션 환경을 생성합니다

    ifixai author reference -o reference.yaml
  4. 4

    내장 데모 에이전트에 기본 검사를 실행합니다(API 키 불필요)

    ifixai run --provider mock --eval-mode self --fixture reference.yaml

사용 전 알아둘 점

  • 실제 감사를 실행하려면 다른 공급자의 judge 모델과 해당 API 키가 필요합니다.
  • Python 3.10 이상이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

iFixAi은(는) 무엇인가요?
AI 에이전트가 역할을 벗어나지 않고, 조작에 저항하며, 사실을 지어내지 않는지 61개 검사 항목으로 감사하는 Python CLI입니다. iFixAi는 AI 에이전트를 위한 독립 감사 도구입니다. 프로필과 정책 파일을 바탕으로 비즈니스 환경을 시뮬레이션하고, 역할을 벗어나게 하는 요청을 포함해 일상적으로 접할 만한 요청을 에이전트에 보낸 뒤 별도의 판정 모델이 각 답변을 평가합니다. 각 감사 결과에는 요청 내용과 에이전트의 응답이 기록됩니다.
iFixAi은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
iFixAi은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
iFixAi은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. iFixAi의 마지막 커밋은 2026년 11월 6일입니다.
iFixAi은(는) 어디에 사용할 수 있나요?
고객 지원 에이전트가 환불 및 계정 변경 권한을 준수하는지 확인합니다. 에이전트를 프로덕션에 배포하기 전에 prompt injection에 취약한지 테스트합니다. EU AI Act 또는 NIST AI RMF와 같은 AI 거버넌스 프레임워크에 필요한 감사 증거를 생성합니다. CI 파이프라인에 에이전트 동작의 회귀 검사를 추가합니다.
iFixAi는 어떻게 설치하나요?
virtualenv를 만들고 활성화합니다: python3 -m venv .venv && source .venv/bin/activate PyPI에서 iFixAi를 설치합니다: pip install ifixai 참조용 시뮬레이션 환경을 생성합니다: ifixai author reference -o reference.yaml 내장 데모 에이전트에 기본 검사를 실행합니다(API 키 불필요): ifixai run --provider mock --eval-mode self --fixture reference.yaml
iFixAi은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ifixai-ai/iFixAi

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트

불확실성 정량화를 통해 LLM 응답의 환각 가능성을 평가하는 Python 라이브러리로, 블랙박스·화이트박스·심판·앙상블 스코어러를 제공합니다.

AI·머신러닝#hallucination-detection#uncertainty-quantification#llm-evaluation
1.2천+2 이번 주140PythonApache-2.0활발히 관리됨업데이트 24일 전