# Failproof AI: Korean

> Trace agent behavior, find failures with audits, and prevent repeat failures with deployed policies.

## Korean

### Start

#### Start here

- [에이전트를 안전하게 만드세요](https://docs.befailproof.ai/ko/index.md): 에이전트가 실행되는 모든 환경에 대한 가시성과 제어 — 코딩 CLI, 채팅 게이트웨이, 자체 호스팅 어시스턴트, 그리고 직접 계측한 에이전트까지.
- [빠른 시작](https://docs.befailproof.ai/ko/start/quickstart.md): 에이전트 세션을 캡처하고, 실패를 찾고, 이를 방지하기 시작하세요.
- [에이전트 하네스](https://docs.befailproof.ai/ko/reference/harnesses.md): 지원되는 12개의 에이전트 하네스 전반에서 세션을 캡처하고 정책을 적용합니다.
- [Failproof Assistant](https://docs.befailproof.ai/ko/sessions/assistant.md): 자연어로 Failproof AI를 분석하고 운영하세요. 질문과 조회부터 대시보드, 감사까지 모두 지원합니다.
- [첫 번째 실패 검사 실행](https://docs.befailproof.ai/ko/start/first-audit.md): Cloud 대시보드 또는 fp CLI에서 감사를 생성하고 첫 번째 결과를 검토합니다.
- [정책으로 첫 번째 실패를 방지하세요](https://docs.befailproof.ai/ko/start/first-policy.md): 정책 버전을 작성하고, 관찰 모드로 배포한 후 적용하세요.
- [설정 방식 선택](https://docs.befailproof.ai/ko/start/setup.md): 로컬 적용, Failproof AI Cloud, 또는 엔터프라이즈 배포 중 선택하세요.
- [핵심 개념](https://docs.befailproof.ai/ko/start/concepts.md): Failproof AI 전반에서 사용되는 핵심 개념 모음입니다.

##### Starter templates

- [커스텀 에이전트](https://docs.befailproof.ai/ko/start/quickstarts/custom-agents.md): 에이전트를 세 개의 `with` 블록으로 감싸면 바로 기록이 시작됩니다.
- [LangChain and LangGraph](https://docs.befailproof.ai/ko/start/quickstarts/langchain.md): 설치, 계측, 첫 번째 트레이스 확인.
- [CrewAI](https://docs.befailproof.ai/ko/start/quickstarts/crewai.md): 설치, 계측, 그리고 첫 번째 트레이스 확인.
- [LlamaIndex](https://docs.befailproof.ai/ko/start/quickstarts/llamaindex.md): 설치, 계측, 첫 번째 트레이스 확인.
- [Pydantic AI](https://docs.befailproof.ai/ko/start/quickstarts/pydantic-ai.md): 설치, 계측, 그리고 첫 번째 트레이스 확인.

### Trace Agents

#### Understand every run

- [세션](https://docs.befailproof.ai/ko/sessions/overview.md): 에이전트 실행의 완전한 기록에서 시작하세요.
- [라이브 이벤트](https://docs.befailproof.ai/ko/sessions/live-events.md): 세션이 실행 중인 동안 에이전트 활동이 들어오는 것을 실시간으로 확인하세요.
- [트레이스 읽기](https://docs.befailproof.ai/ko/sessions/read-a-trace.md): 에이전트 세션의 흐름을 바꾼 이벤트를 찾습니다.
- [모델](https://docs.befailproof.ai/ko/sessions/models.md): 모델 레이턴시, 토큰, 컨텍스트 사용량, 트래픽 분포를 비교합니다.
- [Hooks](https://docs.befailproof.ai/ko/sessions/hooks.md): 정책 결과와 별도로 훅 활동, 트리거, 지연 시간을 측정합니다.
- [정책 결정](https://docs.befailproof.ai/ko/sessions/policy-decisions.md): 정책이 평가, 차단, 지시 또는 허용한 내용을 확인하세요.
- [도구](https://docs.befailproof.ai/ko/sessions/tools.md): 에이전트 세션 전반에서 느리거나 실패하거나 과다 사용된 도구를 찾아보세요.
- [오류](https://docs.befailproof.ai/ko/sessions/errors.md): 반복되는 오류를 그룹화하고 해당 세션을 열어 확인하세요.
- [메트릭](https://docs.befailproof.ai/ko/sessions/metrics.md): 지연 시간, 비용, 토큰 사용량 등 규모 메트릭을 시각화합니다.
- [대시보드](https://docs.befailproof.ai/ko/sessions/dashboards.md): 에이전트 또는 워크플로우에서 중요한 신뢰성 신호를 추적합니다.
- [쿼리](https://docs.befailproof.ai/ko/sessions/queries.md): 재사용 가능한 SQL로 세션, 이벤트, 평가 데이터를 탐색합니다.

#### Plug in your agent

- [에이전트 계측하기](https://docs.befailproof.ai/ko/start/integrations.md): 지원되는 에이전트 프레임워크를 Failproof AI에 한 번의 호출로 연결하세요.
- [커스텀 에이전트](https://docs.befailproof.ai/ko/start/integrations/custom-agents.md): 직접 작성한 에이전트나 어댑터가 없는 프레임워크에 계측을 적용하세요.
- [LangChain and LangGraph](https://docs.befailproof.ai/ko/start/integrations/langchain.md): 한 번의 호출로 그래프, 노드, 도구, 리트리버, 모델 호출을 계측합니다.
- [CrewAI](https://docs.befailproof.ai/ko/start/integrations/crewai.md): 역할, 도구, 메모리, 사람 피드백 기반으로 크루, 플로우, 에이전트를 계측합니다.
- [LlamaIndex](https://docs.befailproof.ai/ko/start/integrations/llamaindex.md): 워크플로우, 스텝, 함수 에이전트, 리트리버를 계측합니다.
- [Pydantic AI](https://docs.befailproof.ai/ko/start/integrations/pydantic-ai.md): 타입이 지정된 에이전트, 도구, 모델 호출, 재시도를 계측합니다.

### Find failures

#### Evaluate agents

- [에이전트 평가](https://docs.befailproof.ai/ko/evaluations/overview.md): 완료된 모든 세션을 직접 정의한 평가로 채점합니다: 호스팅된 Python 체크 또는 자체 워커의 LLM 심사위원을 사용할 수 있습니다.
- [평가 작성하기](https://docs.befailproof.ai/ko/evaluations/write.md): 측정할 내용을 설명하면 어시스턴트가 호스팅된 Python 평가를 초안으로 작성하거나, 직접 코드를 작성할 수 있습니다. LLM 판정자는 사용자 자신의 워커에서 실행됩니다.
- [평가 테스트](https://docs.befailproof.ai/ko/evaluations/test.md): 평가를 배포하기 전에 실제 세션에 대해 실행해 보세요. 아무것도 저장되지 않습니다.
- [평가 배포 및 버전 관리](https://docs.befailproof.ai/ko/evaluations/deploy.md): 불변 버전을 배포하고, 현재 운영 중인 항목을 확인하고, 새 버전을 게시하고, 롤백하고, 기존 세션을 채점하세요.
- [평가 결과 읽기](https://docs.befailproof.ai/ko/sessions/evaluations.md): 시간 경과에 따른 평가 점수를 차트로 확인하고, 에이전트와 환경을 비교하며, 세션 점수가 낮은 이유를 파악하고, 어시스턴트에게 질문하세요.

#### Find and manage failures

- [감사(Audits)](https://docs.befailproof.ai/ko/audits/overview.md): 트레이스만으로는 발견할 수 없는 장애를 파악하기 위해 정의된 세션 집합을 검토합니다.
- [로컬 에이전트 히스토리 감사](https://docs.befailproof.ai/ko/audits/local-audit.md): 지원되는 에이전트 CLI 히스토리를 오프라인으로 스캔하여 위험하거나 낭비적인 동작을 로컬에서 검토합니다.
- [감사 설정](https://docs.befailproof.ai/ko/audits/setup.md): 감사 목표, 세션 모집단, 증거 컨텍스트를 정의합니다.
- [에이전트 컨텍스트](https://docs.befailproof.ai/ko/audits/agent-contracts.md): 각 에이전트가 수행해야 할 작업, 생성해야 할 결과물, 절대 해서는 안 되는 행동을 감사에 알립니다.
- [감사 실행 및 검토](https://docs.befailproof.ai/ko/audits/run.md): 감사를 실행하고, 적용 범위를 확인하며, 결과로 나온 발견 사항을 검토합니다.
- [감사 주기](https://docs.befailproof.ai/ko/audits/cadence.md): 반복 감사가 실행되는 시점과 검토할 데이터 범위를 설정합니다.
- [발견 사항 및 이슈](https://docs.befailproof.ai/ko/audits/findings-and-issues.md): 감사 증거를 소유권이 있는 추적 가능한 개선 작업으로 전환합니다.
- [알림](https://docs.befailproof.ai/ko/audits/alerts.md): 재발을 감지하고 적절한 담당자에게 인시던트를 라우팅합니다.
- [감사 레시피](https://docs.befailproof.ai/ko/audits/recipes.md): 일반적인 에이전트 실패 조사를 위한 시작 목표.

### Prevent failures

#### Prevent repeat failures

- [정책](https://docs.befailproof.ai/ko/policies/overview.md): 알려진 실패가 반복되기 전에 에이전트 작업을 관찰하고, 안내하거나, 차단하세요.

#### Get a policy

- [정책 작성](https://docs.befailproof.ai/ko/policies/editor.md): Failproof AI가 감사 결과를 바탕으로 정책 초안을 작성하거나, 직접 소스를 작성한 후 검토, 테스트, 게시할 수 있습니다.
- [정책 팩 사용하기](https://docs.befailproof.ai/ko/policies/packs.md): 사용 사례에 맞는 Failproof AI 정책 팩이나 정책 허브의 커뮤니티 팩을 연결하고, 적용할 내용을 선택하세요.

#### Ship a policy

- [정책 테스트](https://docs.befailproof.ai/ko/policies/test.md): 이미 보유한 트래픽을 기반으로 초안을 백테스트하고, 어떤 기계도 실행하기 전에 차단해야 할 것은 차단하고 허용해야 할 것은 허용함을 증명하세요.
- [정책 배포하기](https://docs.befailproof.ai/ko/policies/deploy.md): 테스트된 정책 버전을 관찰 모드로 머신에 배포하고, 적용(enforce)한 뒤 모든 머신이 정상적으로 업데이트를 수신했는지 확인합니다.
- [버전과 롤백](https://docs.befailproof.ai/ko/policies/rollback.md): 모든 게시는 불변 버전으로 저장되므로, 유효한 에이전트 작업을 방해하는 배포는 마지막으로 정상 동작하던 버전을 재배포하여 되돌릴 수 있습니다.
- [정책 팩 배포하기](https://docs.befailproof.ai/ko/policies/publish-a-pack.md): 누구든 설치할 수 있는 GitHub 릴리스로 자신의 정책을 패키징하여 배포하세요.
- [실패 동작](https://docs.befailproof.ai/ko/policies/failure-behavior.md): 정책 평가 또는 로컬 데몬을 사용할 수 없을 때 어떤 일이 발생하는지 이해합니다.

### Admin

#### Operate Failproof AI

- [관리](https://docs.befailproof.ai/ko/admin/overview.md): 접근, 사용량, 조직, 보안을 안정성 워크플로우와 분리하여 운영합니다.
- [사용량](https://docs.befailproof.ai/ko/admin/usage.md): 조직의 소비량과 활성 청구 기간을 확인합니다.
- [키와 권한](https://docs.befailproof.ai/ko/admin/keys-and-permissions.md): 머신, 자동화, 운영자를 위한 범위 지정 API 키를 생성합니다.
- [사용자 및 조직](https://docs.befailproof.ai/ko/admin/users-and-organizations.md): 멤버십을 관리하고 각 조직의 데이터와 작업 범위를 제한하세요.
- [설정 및 보안](https://docs.befailproof.ai/ko/admin/settings-and-security.md): 운영 설정을 구성하고 에이전트 데이터에 대한 정책을 결정합니다.

### Integrations and reference

#### Connect your agents

- [통합 및 참조](https://docs.befailproof.ai/ko/reference/overview.md): 지원되는 에이전트 하네스, SDK, CLI, HTTP API를 연결합니다.
- [에이전트 하네스](https://docs.befailproof.ai/ko/reference/harnesses.md): 지원되는 12개의 에이전트 하네스 전반에서 세션을 캡처하고 정책을 적용합니다.
- [커스텀 에이전트](https://docs.befailproof.ai/ko/reference/custom-agents.md): failproofai-sdk의 설정, 이벤트 카탈로그, 상관관계 규칙 및 전달 방식.
- [Evaluator SDK](https://docs.befailproof.ai/ko/reference/evaluator-sdk.md): 자체 평가 워커를 실행하세요. LLM 판정자나 호스팅 Python으로 처리할 수 없는 모든 작업에 활용할 수 있습니다.
- [커스텀 정책](https://docs.befailproof.ai/ko/reference/policy-sdk.md): 에이전트에 특화된 장애에 대응하는 JavaScript 또는 TypeScript 정책을 작성, 테스트, 배포하세요.
- [Failproof AI Cloud 자체 호스팅](https://docs.befailproof.ai/ko/reference/self-hosting.md): 고객 관리형 Kubernetes 클러스터에 Failproof AI 컨트롤 플레인을 배포합니다.

#### Reference

- [Failproof AI CLI](https://docs.befailproof.ai/ko/reference/failproof-cli.md): 훅 설치, 로컬 정책 관리, Cloud 연결 및 로컬 데몬 운영.
- [로컬 대시보드](https://docs.befailproof.ai/ko/reference/local-dashboard.md): 로컬 프로젝트, 세션, 정책 활동, 설정, 감사, 예약된 스캔을 검토합니다.
- [로컬 설정](https://docs.befailproof.ai/ko/policies/local-configuration.md): 정책 범위, 파라미터, 사용자 정의 파일, 머신 수준 Failproof AI 설정을 제어합니다.
- [Failproof Cloud CLI](https://docs.befailproof.ai/ko/reference/cloud-cli.md): fp를 사용하여 Failproof AI Cloud를 쿼리하고 관리하는 완전한 참조 가이드입니다.
- [HTTP API](https://docs.befailproof.ai/ko/reference/http-api.md): Failproof AI Cloud `/v1` 공개 API에 인증하고 생성된 엔드포인트 레퍼런스를 활용하세요.
- [이벤트 및 구성](https://docs.befailproof.ai/ko/reference/events-and-configuration.md): 이벤트 모델, 환경, 로컬 스토리지, 구성 경계에 대한 참조 문서입니다.
- [문제 해결](https://docs.befailproof.ai/ko/reference/troubleshooting.md): 누락된 세션, 누락된 정책, 전달 실패, 차단된 에이전트 동작을 진단합니다.