> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 에이전트 컨텍스트
> 각 에이전트가 수행해야 할 작업, 생성해야 할 결과물, 절대 해서는 안 되는 행동을 감사에 알립니다.
에이전트 컨텍스트는 각 에이전트의 존재 목적, 반드시 생성해야 할 결과물, 절대 해서는 안 되는 행동을 감사에 알려줍니다. Failproof AI는 이 컨텍스트를 에이전트별로 하나의 에이전트 계약으로 저장합니다.
에이전트 컨텍스트는 특정 감사가 아닌 조직에 귀속됩니다. 에이전트별로 한 번만 작성하면, 해당 에이전트를 범위에 포함하는 모든 모델 기반 감사에서 활용됩니다.
## 에이전트 컨텍스트 추가
1. **분석 → 감사**로 이동하여 **에이전트**를 선택하고, 세션에서 보고된 에이전트 ID를 선택합니다.
2. **콘텐츠 추가** 또는 **편집**을 선택합니다.
3. 에이전트의 목적, 생성해야 할 결과물, 완료 조건, 실행 주기, 절대 해서는 안 되는 행동을 작성합니다.
4. 컨텍스트를 저장한 후 감사 양식으로 돌아가 선택된 에이전트가 커버됨으로 표시되는지 확인합니다.
감사를 생성하거나 편집하는 중에 **에이전트** 드로어에서도 에이전트 컨텍스트를 추가하거나 편집할 수 있습니다. 컨텍스트는 독립적으로 저장되며, 즉시 해당하는 모든 감사에 적용됩니다.
Cloud CLI는 아직 계약 명령을 지원하지 않습니다. `audits:read` 및 `audits:write` 권한이 있는 키를 사용하여 공개 API를 통해 작업하세요.
```bash theme={null}
curl -X POST "https://app.befailproof.ai/v1/audits/contracts" \
-H "Authorization: Bearer $FAILPROOFAI_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "nightly-reconciler",
"enabled": true,
"body": "# Purpose\nReconcile yesterday's payouts.\n\n## Outputs\nPublish a signed summary.\n\n## Must not\nNever modify ledger entries."
}'
```
`GET /v1/audits/contracts`로 계약 목록을 조회하고, `GET /v1/audits/contracts/{id}`로 개별 계약을 조회합니다. `PUT`을 사용한 업데이트는 전체 교체 방식으로, `agent_id`와 `body`가 모두 필요합니다.
## 유용한 컨텍스트 작성 방법
컨텍스트는 5,000자 이내로 유지하고 테스트 가능하게 작성하세요. 유용한 컨텍스트에는 일반적으로 다음 내용이 포함됩니다.
* **목적:** 에이전트가 존재하는 이유
* **결과물:** 반드시 생성해야 할 산출물 또는 수행해야 할 작업
* **완료 조건:** 실행을 성공으로 판단하는 기준
* **주기:** 실행 빈도 또는 실행 시점
* **금지 사항:** 어떤 상황에서도 허용되지 않는 행동과 결과
```markdown theme={null}
---
agent: nightly-reconciler
purpose: Reconcile yesterday's payouts and publish a signed summary.
cadence: Once daily after 02:00 UTC. Never more than once.
---
## Outputs
- A signed reconciliation summary in the finance channel.
## Done when
- Every payout is matched or explicitly flagged.
## Must not
- Modify ledger entries. Report discrepancies instead.
```
에이전트 컨텍스트는 예상 동작을 정의하는 것으로, 분석이 도달할 결론을 지시하거나 검토할 증거를 제한할 수 없습니다. 컨텍스트가 없는 에이전트도 정상적으로 감사되지만, Failproof AI는 조직 고유의 의도를 기준으로 해당 에이전트의 동작을 판단할 수 없습니다.
## 에이전트 컨텍스트 일시 중지 및 변경
* 감사가 일시적으로 컨텍스트를 무시해야 할 때는 에이전트 컨텍스트를 일시 중지하세요. 일시 중지는 되돌릴 수 있습니다.
* 에이전트의 역할이 변경된 경우 컨텍스트를 편집하세요. 새로운 내용은 이후 실행부터 적용됩니다.
* 실행 중인 에이전트가 컨텍스트를 사용하지 않는 것처럼 보일 때는 **마지막 일치** 항목을 확인하세요. 일반적으로 에이전트 ID가 텔레메트리와 일치하지 않는 경우입니다.
* 텍스트를 영구적으로 삭제해야 할 때만 API를 통해 삭제하세요. 대시보드는 의도적으로 삭제 대신 일시 중지 기능을 제공합니다.
모든 감사 실행은 사용된 에이전트 컨텍스트 스냅샷을 정확히 저장합니다. 현재 계약 리소스를 편집, 일시 중지, 또는 삭제하더라도 이전 감사 결과의 근거는 변경되지 않습니다.
계약을 조회하려면 `audits:read` 권한이 필요합니다. 계약 생성, 편집, 일시 중지, 삭제에는 `audits:write` 권한이 필요합니다.