태그
28편
일곱 개 부서를 서른 개 에이전트로 옮긴 한 벌의 설계를 골격만 남기고 본다. 부서 이름을 지우면 일곱 파이프라인이 전부 입력 수집 → 분류·점수화 → 생성·초안 → 검수·게이트 → 발행·기록 다섯 단계로 겹친다. I/O 계약 4원칙, 도구 최소권한 매트릭스, 사람 개입 4등급, 파이프라인 복구 4종까지 부서를 관통하는 열 개의 패턴을 정리하고, 이 블로그에 이미 두 번 실린 7부서 30에이전트 표와 이 지도가 왜 같은 세트가 아닌지도 함께 짚는다.
빈 폴더 하나에서 배포까지 가는 8단계와, 그중 데이터·인증 구간만 확대한 6단계를 나란히 놓는다. 두 순서를 단계별로 대조하면 여덟 중 넷만 여섯과 맞물리고 나머지는 각자 남는다. RLS를 인증보다 먼저 두는 순서의 이유, AI 기능을 붙인 뒤에 터지는 비용 폭주와 프롬프트 주입을 막는 방어선, 그리고 정책을 만든 뒤 익명 역할로 직접 공격해 보는 네 줄짜리 검증까지 이어 붙인다.
배포 전·중·후·롤백·보안·성능 여섯 섹션을 65개 항목으로 펼치고, 섹션마다 다른 점검 주기를 한 장의 흐름도로 그린다. 롤백 섹션은 표가 둘이라 14로 세기 쉬운데 항목은 여덟이며, 합계가 65가 되는지로 검산한다. 뒤쪽은 디버깅 — 재현·가설·검증·회귀방지 4 Phase와 13행 함정 카탈로그, 프롬프트 10패턴이다. 이 카테고리의 다른 글이 쓰는 「증상→원인→해결→예방」 4단과 이름이 같은데 카탈로그가 겹치는지 행 단위로 세어 본 결과도 함께 적는다.
에이전트 운영 중 나는 장애를 외부 의존·자원 한도·내부 설정 3계층으로 먼저 좁히고, 증상→원인→해결→예방 4단으로 분해하는 진단 프레임. 가장 자주 나오는 문제 10선과 실제 장애 5건을 같은 틀에 넣고, 일일·주간·월간 점검 루틴과 계층별 진단 순서까지 정리한다.
복잡한 업무를 단계·파일·반복 세 가지로 나눠 시키는 법을 보고, 매 턴 전량 재전송되는 대화 이력을 어떤 임계에서 어떻게 회수할지, 세션이 끊겨도 결정이 남게 하려면 무엇을 파일로 빼야 하는지까지 정리한다.
에이전트가 시스템에 영향을 주는 통로는 도구뿐이라는 사실에서 출발해 내장 도구 일곱 개를 리스크 등급으로 다시 묶고, 즉시 실행의 부작용을 제어하는 네 가지 지시 패턴 — Plan Mode·SDD·@파일 참조·이미지 입력 — 을 상황별 선택 기준까지 정리한다.
에이전트에게 줄 권한의 상한을 정하는 것은 신뢰가 아니라 복구 가능성이다. Git이 안전망이자 컨텍스트 공급원이 되는 구조, 검증 가능한 규약 파일이 갖춰야 할 다섯 요소, 그리고 환경 문제 20여 건이 수렴하는 세 가지 원인을 정리한다.
검증 노드가 재는 것은 사실성이 아니라 문서와의 일치이며, 문서가 틀리면 통과한다. 다섯 가지 한계와 코드에서 센 LLM 호출 횟수, 그리고 실습 코드에 남아 있는 함정 여덟 개를 정리한다.
에이전트 루프가 무너지는 열 가지 방식을 증상·원인·해결로 정리하고, 모델을 바꾸기 전에 좁혀야 할 6단계 진단과 도입 자체를 루프로 다루는 조직 절차, 근거 강도 구분법까지 다룬다.
대용량 데이터를 LLM 컨텍스트에 넣지 않는 인터페이스 규약, 툴 안에 또 에이전트가 들어가는 4층 구조, 그리고 분기 하나가 실패했을 때 결과물을 어떻게 마감할 것인가를 정리한다.
선택지 열두 개가 각각 무엇을 얻고 무엇을 내주는지, 장애 아홉 가지가 어떤 증상으로 드러나는지를 표로 모으고, 저장소 선택·모델링·SQL·트랜잭션에 걸친 34개 질문에 결론부터 답한다.
선택지 열여섯 개가 각각 무엇을 얻고 무엇을 내주는지, 실패 모드 열한 가지가 어떤 증상으로 드러나고 무엇으로 되받는지를 표로 모았다. 파티셔닝과 샤딩, 복제, 분산 시스템, 합의에 걸친 서른두 개 문답은 먼저 답을 내고 근거를 뒤에 붙인다.
사내 인증 서비스 여섯 편의 마지막이다. 앞의 다섯 편을 세 벌로 다시 엮는다. 고를 때 저울질하는 선택지 다섯, 증상만 보고는 원인을 잘못 짚기 쉬운 실패 모드 여덟, 설명해야 할 때 필요한 문답 스물다섯과 길게 답해야 하는 넷이다.
알림센터 다섯 편의 마지막이다. 앞의 네 편이 주제별로 나눠 답한 것을 질문이 실제로 오는 세 자리로 다시 세운다 — 아직 아무것도 정하지 않은 「고를 때」, 이미 돌고 있는데 증상이 나온 「터졌을 때」, 그 판단의 근거를 남에게 대야 하는 「설명해야 할 때」다.
표·이미지 해설을 만드는 프롬프트 4종의 설계 의도와 XML 태그·가상질문·수치 강조가 필요한 이유, 그리고 파싱 품질이 의심될 때의 진단 순서를 정리한다.
같은 데이터를 여러 벌 두면 가용성과 읽기 처리량을 얻지만, 그 순간부터 복제본끼리 값이 다를 수 있다는 문제를 떠안는다. 토폴로지 세 가지가 그 문제를 어떻게 처리하는지, 동기·반동기·비동기가 무엇을 담보로 속도를 사는지, 복제 지연과 장애가 무엇을 사라지게 하는지를 정리한다.
생성한 코드를 돌려 보고 고치는 순환을 상태 설계부터 세우고, 임의 코드 실행의 위협 일곱 가지를 격리 등급에 매핑한 뒤 사이클이 있는 그래프를 어떻게 끝낼 것인가를 정리한다.
에이전트를 모델·도구·메모리·플래너·실행 루프 다섯 층으로 분해한 뒤, 프롬프트 체이닝부터 컴퓨터 유즈까지 열한 개 패턴을 자율성 수준과 무너지는 지점으로 나란히 세운다.
ACID 네 특성이 각각 어떤 장치로 구현되는지, 읽기 일관성과 격리수준 네 단계가 어떤 이상현상을 허용하고 막는지, 락이 어떻게 블로킹과 데드락으로 이어지는지, 그리고 데드락을 실무에서 어떤 순서로 없애는지를 정리한다.
검색이 빗나가도 답이 나오는 구조적 이유를 진단하고, 판정을 도구로 외부화해 자기교정 루프를 만드는 설계와 프롬프트 네 번의 개정 기록을 정리한다.
검색된 근거를 답변으로 바꾸는 생성 계층을 다루고, RAG가 잘 안 될 때 어느 단계의 문제인지 특정하는 진단표로 8단계를 닫는다.
사내 문서 RAG 정확도가 낮을 때 어디부터 보는지, 표와 그림을 살리는 방법, 그리고 검증 루프로 할루시네이션을 구조로 막는 설계를 정리한다.
캐시 전략과 자료구조 선택지를 한 표로 모으고, 운영에서 실제로 밟는 실패 모드 여덟 가지와 대응, 그리고 설계·무효화·동시성·운영에 걸친 25개 질문에 결론부터 답한다.
좋아요·구독을 Set으로 푸는 근거와 멱등 API 설계, 댓글을 Redis가 아닌 저장소에 두는 판단, 단일 스레드 모델이 낳는 운영 제약, 영속화·축출 정책·고가용성 구성을 정리한다.
앞의 네 편이 쌓아 온 판단을 세 벌로 다시 짠다. 아직 무엇으로 읽고 어떻게 벌릴지 고르는 중이라면 선택지 표를, 이미 도는 배치가 윈도우를 넘기거나 숫자가 안 맞는다면 증상에서 출발하는 실패 모드 표를, 그 선택의 근거를 대야 한다면 25문답을 쓴다.
같은 데이터에서 어떤 SQL만 느려지는 이유를 네 자리에서 짚는다. 하드 파싱과 바인드 변수, B-Tree 인덱스와 복합 인덱스의 선두 컬럼 규칙, 실행계획의 access와 filter 구분, 그리고 조인 알고리즘 세 가지의 선택 기준이다.
라우팅 함수가 lambda x: x['next'] 한 줄로 끝나는 이유를 구조화 출력에서 찾고, 관리자를 세운 대가로 따라오는 컨텍스트 오염·무한 루프·호출당 단가 상승을 각각의 방어책과 함께 정리한다.
클러스터 토폴로지와 OS 커널 튜닝, 샤드 할당과 watermark, ILM, 장애 복구 절차, 배포 전략, 모니터링, 성능 튜닝을 운영 관점에서 정리한다.