사내 지식 검색, 업무 자동화, 정책 감사, 실행 추적을 하나의 흐름으로 묶은 Agent 백엔드 구현 기록이다.

Agent 실행을 운영 리소스로 다루기 위해 FastAPI, use case, domain policy, repository adapter를 분리했다.

문서 적재, chunking, query classification, retrieval strategy, citation을 하나의 실행 경로로 묶었다.

Agent 추론과 외부 tool 실행 사이에 registry, scope, policy, audit를 통과하는 runtime 경계를 만들었다.

쓰기성 tool call을 승인 리소스로 승격하고 API key scope, tenant guard, Idempotency-Key를 연결했다.

외부 tool 호출에 timeout, retry, fallback, circuit breaker를 적용하고 gateway 상태를 운영 API로 노출했다.

Agent 답변 품질을 EvaluationRun으로 기록하고 expected facts 기반 회귀 평가를 CI gate로 연결했다.

Agent 실행, 승인, 평가, 정책 결과를 audit event로 남기고 webhook delivery outbox로 외부 연동을 분리했다.

운영자가 봐야 하는 지표를 summary, usage, SLO, alerts, incident snapshot API와 dashboard로 묶었다.

문서 metadata에서 ontology graph read model을 만들고 운영 시나리오를 실행 가능한 runbook으로 모델링했다.