Token Lab검색

AGENT SYSTEMS / ARCHITECTURE

AI 에이전트 플랫폼 아키텍처와 신뢰할 수 있는 업무 실행

구성도로 이해하는 오케스트레이션, 신원, 기억, MCP, 승인과 지속 워크플로. 청구서 사례와 로컬 복구 실험을 포함합니다.

출처 및 버전 정보

독자와 선행 개념

에이전트 개발자와 플랫폼 엔지니어 대상입니다. API는 다른 서비스에 대한 작업 요청, 지속 상태는 재시작 후 남는 정보, 멱등성은 반복 시도를 하나의 업무 작업에 연결하는 성질입니다. 행동 경로를 설명하고 응답 유실 후 복구를 재현합니다.

독자가 제공한 교육용 구성도이며 그림의 서명은 Tech Fusionist입니다. 기술 이름은 예시이며 비공개 시스템의 구현을 뜻하지 않습니다.
독자가 제공한 교육용 구성도이며 그림의 서명은 Tech Fusionist입니다. 기술 이름은 예시이며 비공개 시스템의 구현을 뜻하지 않습니다. 원본 이미지 열기
이 글의 목차

1. 구성 요소보다 완료 기준을 먼저 정하기

“연체 청구서를 처리하라”는 업무 목표와 여러 행동이 섞인 요청입니다. 초안 작성, 전송 요청, 배달, 결제는 서로 다른 결과입니다. 자연스러운 완료 보고가 어느 것도 증명하지는 않습니다.

테넌트 A의 INV-42를 계속 따라갑니다. 잔액이 있고 14일 넘게 연체되었으며 이의가 없고 빈도 정책과 발신 권한이 유효할 때 한 번의 알림을 준비합니다. 예외는 확인하고 답장과 결제를 추적합니다.

결과 증거 가능한 결론
산출물 저장된 초안과 청구서 버전 초안 준비 완료
외부 작업 공급자 작업 ID와 수락 요청 수락
소통 검증된 배달 또는 답장 이벤트 배달 또는 답장 확인
업무 권위 있는 정산 기록 청구서 결제 완료
기여도 대조 실험 등 타당한 분석 알림의 회수 효과 추정

알림 뒤에 결제됐다는 사실만으로 인과관계를 증명할 수 없습니다. 관찰된 결제를 보고하되 전액을 에이전트 성과로 귀속시키지 않아야 합니다.

2. 세 가지 불변 조건으로 경계 도출

불변 조건은 재시도, 동시 실행, 업데이트, 사람을 기다리는 동안에도 유지되어야 합니다.

  1. 권한은 스스로 확대되지 않는다. 모델, 하위 에이전트, 외부 문서가 권한을 만들 수 없습니다. 신뢰할 수 있는 실행기가 강제합니다.
  2. 상태에는 권위 있는 출처가 있다. 모델은 제안, 사용자는 승인, 회계는 잔액, 공급자는 실행 증거를 담당합니다.
  3. 불확실성을 지우지 않는다. 시간 초과가 실패는 아니며 수락이 배달은 아닙니다. 불명확한 부작용은 대조 상태로 둡니다.

정의, 정책, 예산을 관리하는 제어 영역과 고정 설정으로 도구를 실행하고 기록하는 실행 영역을 분리합니다. 모델이 자신의 권한을 정하고 집행하는 유일한 주체가 되어서는 안 됩니다.

task_id는 목표, run_id는 실행 시도, operation_id는 업무 부작용을 식별합니다. 복구로 새 run이 생겨도 같은 발송의 재시도는 같은 operation_id를 유지합니다.

작업의 완료 대기 불명을 구분하기
직접 제작한 교육용 상태도입니다. 권한 검사 후 전송하며 응답 유실은 대조로 이어집니다. 수락은 배달이나 결제를 증명하지 않습니다.

이 조건에서 구성 요소가 도출됩니다. 신원은 권한을, 지속 상태는 진행을, 정책은 부작용 제한을, 대조는 불확실성을 관리합니다.

3. 실행 경로로 구성도 읽기

계층 구성 요소 질문
진입과 설정 Gateway, Identity & Auth, Agent Registry 누구의 요청이며 어떤 버전인가
판단과 문맥 Orchestrator, LLM Router, Memory Service 다음 행동과 필요한 근거는 무엇인가
권한과 실행 Permission Engine, Approval Queue, Tool Registry, MCP Gateway, Sandbox 허용되는가, 어디에서 실행하는가
운영과 관리 Task Queue, Tracing, Evals & Guardrails, Audit Log 어떻게 복구하고 결과를 검증하는가

작은 서비스도 데이터베이스와 백그라운드 워커로 이 경계를 구현할 수 있습니다. 서비스 분리보다 상태의 소유자와 제약을 적용할 위치를 먼저 정해야 합니다.

화살표는 책임이지 안전 보장이 아니다

기억에서 권한으로 이어진 선이 “예전에 동의했다”는 검색 결과를 승인 기록으로 바꾸지는 않습니다. 선호는 문체에 영향을 주고 권한에는 범위와 만료가 필요합니다. 시작 시 설정 버전을 고정하되 철회처럼 최신이어야 하는 정보는 실행 시에도 확인합니다.

4. 신원과 작업 범위 설정

Gateway는 채팅, Slack, API 요청을 공통 형식으로 바꾸고 사용자, 테넌트, 기한, 취소 방식, 작업 ID를 지정합니다. 오래 걸리는 요청은 ID를 반환하고 진행 상황을 알립니다. 브라우저가 닫혀도 작업을 잃을 필요는 없습니다. 사용자와 테넌트별 할당량으로 대규모 배치의 자원 독점을 막습니다.

SSO는 통합 로그인, OAuth는 주로 위임된 권한 부여를 다루며 OpenID Connect는 이 생태계에서 인증을 제공합니다. 로그인했다고 이메일 접근이 허용되는 것은 아닙니다. 이메일 연결도 임의의 자동 발송을 허용하지 않습니다.

실효 권한은 사용자 권한, 테넌트 정책, 에이전트 능력, 해당 작업의 위임 범위가 겹치는 부분으로 설계할 수 있습니다. Agent Registry는 프롬프트, 도구 허용 목록, 출력 계약, 모델 설정, 예산을 함께 버전 관리합니다. 복구 시 같은 버전을 유지하고 자동 발송 추가 같은 변경은 평가와 롤백 대상으로 취급합니다.

지속 가능한 작업 계약

주체, 테넌트, 자원, 성공 조건, 허용된 연결, 비용 상한, 기한, 취소 상태를 저장합니다. “완료를 알려 달라”와 “자동 발송을 허용한다”는 다릅니다.

사용자, 호출 에이전트, 서비스 신원을 유지합니다. 신뢰된 커넥터가 허용된 연결 참조에서 자격 증명을 고르며 모델은 임의의 비밀이나 scope를 선택하지 못합니다. 취소는 대기 작업을 막을 수 있지만 이미 수락된 이메일을 일반적으로 회수하지는 못합니다.

5. 오케스트레이션을 명시적 상태로 구현

Plan → Act → Observe는 행동 제안, 허용된 작업 실행, 결과 관찰을 반복합니다. 대기, 실행, 승인 대기, 외부 이벤트 대기, 성공, 실패, 취소 상태를 지속적으로 저장합니다.

이메일 제안은 도구, 수신자, 발신자, 본문, 대상 자원을 담은 구조화된 데이터여야 합니다. 매개변수를 검증하고 권한 계층을 통과시킨 뒤 실행합니다. 모델이 안전하다고 판단하는 것 자체는 권한이 아닙니다.

재시도는 부작용에 따라 달라야 합니다. 조회 시간 초과는 다시 시도할 수 있어도 발송 시간 초과는 이미 성공했을 수 있습니다. 공급자 조회나 안정적인 작업 키로 결과를 대조한 후 판단합니다. 결과 불명 상태를 별도로 표현해야 합니다.

하위 에이전트에는 제한된 도구, 예산, 출력 계약이 필요합니다. 상위 에이전트는 결과를 검증합니다. 독립 검증이나 병렬화의 이점이 있는 일을 위임하되 조정 비용, 지연, 장애 경로 증가도 고려합니다.

행동 계약의 필드

필드 예시 검증 주체
task_id / run_id 후속 처리 / 현재 시도 Gateway와 오케스트레이터
operation_id tenant-A:INV-42:reminder-1 원장과 실행기
tool / schema_version send_reminder / v2 Registry
resource / expected_version INV-42 / 17 업무 서비스
arguments_digest 정규화된 수신자 본문 첨부 승인과 실행
authorization_ref 위임 또는 승인 기록 정책 엔진
deadline / budget_remaining 남은 시간과 비용 오케스트레이터와 스케줄러

작업 키는 업무 의도를 식별하며 재시도마다 새로 만들지 않습니다. 매개변수 해시는 변경 감지용이지 작업 키의 대체물이 아닙니다. 문구가 같은 합법적인 알림 두 건이 있을 수 있습니다.

매 반복에서 완료 여부, 근거, 권한, 예산을 확인합니다. 근거가 없으면 조회하고, 권한이 없으면 대기하거나 멈추며, 예산이 소진되면 부분 결과와 미완료 이유를 반환합니다.

결정적 업무 구조 안의 동적 계획

자격 검사, 권한 확인, 전송, 저장은 일반 코드로 고정할 수 있습니다. 모델은 답장 해석과 문구 작성 등에 사용합니다. 이의 감지 에이전트와 발송 제안이 충돌하면 마지막 응답이 아니라 업무 정책으로 해결합니다.

6. 모델 라우팅과 기억

LLM Router는 추론 난도, 문맥 크기, 출력 형식, 지연, 데이터 제약으로 모델을 선택합니다. 대체 모델도 같은 계약과 개인정보 요구를 만족해야 합니다. 호출 단가가 낮아도 재시도와 사람의 수정이 늘면 총비용은 높아집니다. 검증된 성공 작업당 비용을 측정해야 합니다.

정보 예시 처리 원칙
작업 상태 현재 단계와 승인 대기 초안 복구를 위해 지속 저장
장기 선호 문체와 서명 출처, 갱신 시각, 수정 방법
업무 사실 잔액, 결제, 이의 권위 있는 업무 시스템에서 확인

Redis의 내구성은 설정과 배포에 달려 있습니다. 벡터 유사도는 진실이나 최신성을 보장하지 않습니다. 과거 결제 약속을 기억한다고 아직 미납이라는 뜻은 아닙니다. 검색 결과가 모델에 전달되기 전에 테넌트와 자원 접근 제한을 적용합니다.

문맥 관리는 목표, 유효한 제약, 최근 관찰, 미완료 작업과 근거를 제한된 창에 남깁니다. 요약에서도 출처와 불확실성을 보존해 추측이 사실로 바뀌지 않게 해야 합니다.

기억 쓰기를 관리하기

명시적 선호, 추론된 습관, 캐시된 사실을 구분하고 출처, 시각, 범위, 만료, 불확실성을 저장합니다. “이번에는 단호하게”는 영구 선호가 아닙니다. 요약으로 근거를 찾더라도 중요 작업 전 잔액과 버전을 다시 읽고 철회와 삭제를 인덱스와 캐시에도 반영합니다.

제약 아래 모델 선택

품질, 지연, 데이터 위치, 도구 계약을 충족하면서 검증된 성공당 기대비용을 줄입니다. 품질은 관련 평가로 판단하며 모델의 자신감으로 정하지 않습니다. 상위 모델 전환, 금지된 하향 전환, 사람에게 넘길 조건을 정의하고 무한 fallback을 피합니다.

7. 구체적 작업에 연결된 권한과 승인

Permission Engine은 신원, 테넌트, 자원, 행동, 매개변수를 감사 가능한 정책으로 판단합니다. 읽기와 쓰기만으로 위험을 구분할 수 없습니다. 고객 데이터 전체 내보내기가 개인 초안 저장보다 위험할 수 있습니다.

승인 화면에는 발신자, 수신자, 본문, 첨부, 영향 범위를 보여 줍니다. 정규화된 매개변수, 자원 버전, 승인자, 만료 시각에 승인을 연결합니다. 수신자나 본문이 바뀌면 권한을 다시 판단합니다.

대기 중 고객이 결제하거나 사용자가 접근을 철회할 수 있습니다. 재개 시 권한과 업무 전제를 다시 확인합니다. 거절, 만료, 취소, 중복 클릭을 처리해야 합니다. 담당자에게 알릴 수는 있어도 시간 초과를 자동 승인으로 바꾸면 안 됩니다.

승인이 시간을 멈추지는 않는다

10:00 승인, 10:02 결제, 10:05 실행이라면 검사와 사용 사이 경쟁인 TOCTOU가 발생합니다. 승인은 특정 매개변수에 대한 동의이지 업무 자격의 영구 보장이 아닙니다.

사전 조회는 창을 줄일 뿐 회계와 이메일을 하나의 원자적 트랜잭션으로 만들지 못합니다. 마지막 확인 직후 결제가 올 수 있습니다. 내부 경쟁은 버전 검사와 원자적 획득으로, 결제 이벤트는 대기 작업 취소로 다루고 이미 보낸 메시지는 사실대로 기록합니다.

오케스트레이터가 검사를 빠뜨려도 실행기가 범위, 만료, 승인된 매개변수, 자격 증명을 확인해야 합니다. 캐시된 정책 결정에도 무효화 규칙이 필요합니다.

8. 통제된 도구 실행

Tool Registry는 JSON Schema 외에도 부작용, 멱등성 지원, 기한, 재시도 정책, 권한, 할당량, 민감도를 기록합니다. 사용자에게 허용된 집합 안에서 관련 도구를 선택합니다.

MCP는 도구 및 자원과의 상호작용을 표준화합니다. Gateway는 연결, 자격 증명, 프록시, 응답 제한을 모을 수 있는 배포 방식이며 별도 서비스가 필수는 아닙니다. MCP 서버 접근이 뒤에 있는 모든 레코드의 권한을 의미하지 않습니다. 공식 보안 문서는 토큰 검증, 위험한 토큰 전달, confused deputy 문제를 다룹니다.[1]

외부 응답은 신뢰할 수 없는 데이터입니다. 이메일 속 악성 지시가 권한을 부여하지는 않습니다. 출처 표시, 구조화된 파싱, 응답 크기 제한, 외부 전송 대상 제한, 실행 시점의 권한 검사를 함께 적용합니다.

Code Sandbox는 표 분석이나 파일 변환을 수행하는 별도의 실행 경로입니다. CPU, 메모리, 디스크, 프로세스, 실행 시간, 네트워크를 제한하고 필요한 단기 자격 증명만 제공합니다. 반출 파일도 관리해야 합니다. 컨테이너만으로 충분한 격리를 주장할 수 없으며 위협 모델에 맞는 경계가 필요합니다.

도구 등록과 호출은 다르다

도구 정의에는 버전, 담당자, 실행 계약이 필요합니다. 원격 설명을 발견했다고 사용이 승인되는 것은 아니며 설명 자체에 악성 문구가 있을 수 있습니다.

Gateway는 연결, 인증 교환, 트래픽 제한을 담당하고 업무 커넥터는 청구서 단위 접근과 발송 의미를 담당할 수 있습니다. 직접 API도 같은 검사가 필요합니다. 안정적인 쓰기는 좁은 API, 열린 계산은 제한된 Sandbox로 처리하고 모든 일을 임의 코드 실행 도구 하나로 합치지 않습니다.

9. 장애와 대기를 넘어 진행 상태 보존

그림에 Kafka와 Temporal이 함께 있지만 메시지 로그와 내구성 있는 워크플로 엔진은 다릅니다. 큐는 일을 분배하지만 단계, 대기, 복구는 별도로 필요합니다. Temporal은 이력을 저장하고 워크플로 로직을 재생해 진행 상태를 재구성합니다.[2]

이것만으로 외부 부작용의 정확히 한 번 실행이 보장되지는 않습니다. 공급자가 이메일을 수락한 뒤 로컬 성공 저장 전에 워커가 중단되면 결과를 대조해야 합니다. 확인할 수 없다면 추가 부작용을 멈추고 불확실성을 드러냅니다.

활성 궤적 수, 모델 호출 동시성, 도구별 동시성을 분리합니다. 이메일 할당량 부족이 독립적인 데이터베이스 조회까지 막아서는 안 됩니다. Batch makespan은 마지막 작업이 끝나는 시각으로 정해집니다. 도구 대기나 긴 궤적이 병목이면 추론만 빨라져도 전체 완료는 빨라지지 않습니다. 스케줄링 실험은 공정성, 품질, 비용을 함께 평가해야 합니다.

두 쓰기 사이의 복구

상태 저장과 메시지 발행을 별도로 하면 한쪽만 성공하는 틈이 생깁니다. Transactional outbox는 상태와 발행 예정 이벤트를 같은 로컬 트랜잭션에 저장한 뒤 발행합니다. 이중 쓰기 문제를 해결하지만 중복 발행은 남으므로 소비자가 중복을 제거해야 합니다.[4]

외부 이메일은 다른 경계입니다. outbox commit은 전송 완료가 아니며 소비 완료는 배달 완료가 아닙니다. planned, dispatching, accepted, unknown, failed 상태와 공급자 참조를 원장에 남깁니다.

리스만으로 한 번 실행을 보장할 수 없다

동시 워커는 원자적 획득이나 리스가 필요합니다. 리스 만료 후에도 이전 워커가 계속 실행될 수 있으므로 fencing token으로 오래된 로컬 쓰기를 거절할 수 있습니다. 공급자가 이 토큰을 이해하지 못하면 외부 멱등성이나 대조가 여전히 필요합니다.

Temporal Activity는 스케줄링, 결과 수집, 재시도 수명 주기를 가집니다.[5] 오류를 분류하고 비결정적 모델 호출과 네트워크 결과를 적절한 경계에서 저장해야 합니다. 워크플로 재생 중 새 판단과 부작용을 임의로 만들면 안 됩니다.

공급자 수락 경계 이후의 장애 복구
교육용 시퀀스입니다. 수락 후 응답을 잃으면 같은 작업 ID로 조회한 다음 증거를 저장합니다. 신뢰할 수 있는 공급자 조회를 가정합니다.

재시도도 같은 예산 사용

총 기한을 대기, 추론, 도구, 승인에 배분합니다. 남은 시간 안에서만 재시도하고 지터가 있는 backoff와 제한을 적용합니다. 세 계층이 각각 세 번 시도하면 하위 요청이 최대 27번 발생할 수 있습니다.

보상은 시간을 되돌리는 것이 아니라 새 업무 작업입니다. 환불은 원거래를 지우지 않고 배달된 이메일도 사라지지 않습니다. 별도의 권한과 감사 기록이 필요합니다.

10. 청구서 알림의 전체 흐름

요청은 14일 넘게 연체된 청구서를 확인하고 이의가 있는 고객을 제외한 뒤 업무용 이메일에서 발송하되 예외는 확인받는 것입니다.

  1. 범위가 정해진 작업을 만들고 고정된 에이전트 버전을 불러옵니다.
  2. 업무 시스템에서 잔액, 이의, 기존 알림을 조회합니다.
  3. 사실에 근거한 구조화된 초안을 작성합니다.
  4. 발신자, 수신자, 빈도, 정책을 검사하고 필요한 승인을 저장합니다.
  5. 발송 직전 최근 결제, 권한, 중복 기록을 재확인합니다.
  6. 안정적인 작업 ID로 발송하고 모호한 결과를 대조합니다.
  7. 초안, 승인 대기, 공급자 수락, 실패, 불명을 구분합니다. 수락은 배달이나 열람 증거가 아닙니다.
  8. 답장과 결제 이벤트에 따라 알림을 중지하거나 허용된 후속 작업을 예약합니다.
  9. 완료, 대기, 실패, 결정이 필요한 항목을 보고합니다.

업무 결과가 다음 행동을 바꿔야 순환이 완성됩니다. 이메일 발송만으로 채권을 회수했다고 볼 수 없습니다.

세 분기로 순환 확인

정상: version 17이 적격이고 정확한 초안이 승인되며 사전 검사 후 message_id를 받습니다. accepted를 저장합니다. 알림 하위 목표는 완료해도 회계가 바뀌기 전 청구서는 미결제입니다.

상태 변경: 승인 중 결제됩니다. 자격을 다시 확인해 대기 발송을 취소하고 불필요해졌음을 알립니다. 올바른 미실행도 성공입니다.

결과 불명: 수락 후 응답이 사라집니다. dispatching/unknown을 유지하고 원래 키로 조회합니다. 미실행을 입증할 수 없으면 새 키를 만들지 말고 수동 대조로 보냅니다.

계획은 시도할 것, 정책은 허용할 것, 실행은 일어난 것, 검증은 보고할 수 있는 것을 정합니다.

11. 추적 감사 평가를 구분

OpenTelemetry의 trace와 span은 분산 작업을 연결합니다.[3] 작업 ID, 궤적 ID, 버전, 대기 시간, 실행 시간, 토큰, 오류, 재시도를 기록합니다. 며칠 걸리는 작업은 안정적인 ID로 여러 trace를 연결할 수 있습니다.

비밀을 제거하고 보존 기간과 접근 권한을 정합니다. 전체 작업 추적은 모든 민감 입력이나 모델의 내부 추론을 저장하라는 뜻이 아닙니다.

감사는 누가 어떤 권한, 정책, 승인에 따라 어느 자원에 무엇을 했는지 설명합니다. 중요한 감사 이벤트를 일반 로그 샘플링으로 버리면 안 됩니다. Evals는 출시 전 버전을 비교하고 Guardrails는 실행 중 계약과 제약을 검사합니다. 둘 다 권한 검사를 대체하지 않습니다.

검증된 완료율, 잘못된 외부 행동, 중복, 사람 개입, 성공당 비용, 전체 지연을 측정합니다. 기록 보기, 저장된 도구 결과로 재생하기, 실제 서비스를 다시 호출하기는 다릅니다. 마지막 방식은 새로운 부작용을 만듭니다.

지연 처리량 SLO를 분리

지연을 큐, 추론, 도구, 승인, 복구로 나눕니다. 승인이 두 시간 걸리면 추론을 2초에서 1초로 줄여도 전체 시간은 거의 달라지지 않습니다.

가상 계산: 분당 30작업 × 작업당 4호출 = 분당 120호출. 동시 슬롯 3개와 평균 2초라면 이상적 포화 처리량은 3 / 2 × 60 = 분당 90회입니다. 수요가 능력을 초과하므로 큐가 늘어납니다. 버스트, 긴 꼬리, 할당량, 실패 때문에 여유도 필요합니다. 실측값이 아닙니다.

SLO에는 분모, 검증 가능한 결과, 시간 경계가 필요하며 사람 승인 대기를 별도 집계할지 명시해야 합니다. 추적은 병목, 감사는 행동 근거, 평가는 변경 후 품질을 담당합니다.

12. 단계적으로 구축

처음에는 제한된 업무 하나, 소수 도구, 지속 상태, 워커, 필요한 승인, 작업 기록으로 시작합니다. 복잡한 복구와 장기 대기가 필요하면 워크플로 엔진을, 비용과 지연이 중요해지면 라우팅을, 독립적으로 검증 가능한 하위 작업이 있으면 위임을 추가합니다.

테넌트 격리, 비밀의 수명 관리, 권위 있는 작업 원장, 할당량, 취소 전파, 버전 평가와 롤백을 보완합니다. 발송 후 강제 중단, 승인 중 권한 철회, 처리 중 결제, 중복 메시지, 악성 도구 응답을 시험합니다.

신뢰할 수 있는 플랫폼은 허용된 업무를 완료하면서 장애와 불확실성을 통제 가능한 상태로 유지합니다.

장애 영역과 자원에 따라 분리

처음에는 Gateway, 오케스트레이션, Registry, 정책을 한 앱에 두고 워커와 DB를 사용할 수 있습니다. Sandbox 격리, 도구별 동시성, 모델 용량, 독립 배포가 필요할 때 분리합니다.

과도한 서비스 분리는 네트워크와 일관성 문제를 늘리고 무제한 단일 루프는 복구와 격리를 잃습니다. 모듈과 지속 경계를 명확히 한 뒤 위험과 부하에 따라 분리합니다.

남은 작업량 예측, 예산 내 계획, 의미적 결과 검증, 테넌트 공정성은 연구 과제입니다. 권한과 상태 불변 조건 안에서 개선해야 하며 더 강한 모델도 독립적 검증을 없애지는 못합니다.

로컬 복구 실험과 연습

실패한 경계부터 판단하기

설계 검증용 가정이며 실제 사고 통계가 아닙니다. 복구 시 작업 ID와 근거를 유지합니다.

경계확실한 상태안전한 다음 단계잘못된 지름길
작업 commit 전지속 작업 없음접수 멱등 키로 재제출화면을 큐 증거로 간주
저장 후 발행 실패대기 이벤트 존재outbox 재시도와 중복 제거새 업무 작업 생성
입증된 전송 전 실패증거가 있을 때만 미실행같은 키로 예산 내 재시도모든 timeout을 미실행 처리
수락 후 응답 유실로컬에서 결과 불명조회 대조 또는 중지새 키로 재발송
승인 중 권한 철회과거 승인 불충분차단하고 이유 기록만 신뢰
중복 또는 역순 이벤트도착순은 최신 사실이 아님중복 제거와 권위 상태 확인마지막 도착으로 덮어쓰기

가상 계산: 100개 작업 × 3회 시도 = 300회 호출. 시도당 0.02 비용 단위, 검증된 성공 80개라면 성공당 비용은 300 × 0.02 / 80 = 0.075입니다. 호출 단가만 보면 실패 비용을 놓칩니다. 실제 업체 가격이 아닙니다.

Python 3.10 이상과 표준 라이브러리만 필요합니다. 두 SQLite 파일이 앱과 가상 공급자를 나타냅니다. 공급자 수락 후 워커가 실패하고 안정적인 작업 키로 조회하여 복구합니다. 이메일 전송이나 네트워크 접근은 없습니다.

agent-operation-recovery.py

python3 agent-operation-recovery.py
checks=7 provider_acceptances=1 local_state=accepted
Python · agent-operation-recovery.py
"""Python 3.10+, standard library only. Local synthetic provider; no email/API."""
import hashlib
import json
import sqlite3
import tempfile
from pathlib import Path


def digest(payload):
    return hashlib.sha256(json.dumps(payload, sort_keys=True).encode()).hexdigest()


def open_db(path):
    db = sqlite3.connect(path)
    db.execute("CREATE TABLE IF NOT EXISTS operations (id TEXT PRIMARY KEY, hash TEXT, state TEXT)")
    db.commit()
    return db


def execute(local, provider, key, payload, approval, allowed=True, paid=False,
            crash_after_send=False, lookup_available=True):
    # Recheck current authority and business preconditions on every resume.
    if not allowed or paid or approval != digest(payload):
        return "blocked"
    row = local.execute("SELECT hash,state FROM operations WHERE id=?", (key,)).fetchone()
    if row and row[0] != digest(payload):
        return "blocked"
    if row and row[1] == "accepted":
        return "accepted"
    if row and row[1] == "dispatching" and not lookup_available:
        return "unknown"
    # The mock provider durably supports lookup and a unique idempotency key.
    prior = provider.execute("SELECT hash FROM operations WHERE id=?", (key,)).fetchone()
    if prior and prior[0] != digest(payload):
        return "blocked"
    if not prior:
        local.execute("INSERT OR REPLACE INTO operations VALUES (?,?,?)",
                      (key, digest(payload), "dispatching"))
        local.commit()
        provider.execute("INSERT INTO operations VALUES (?,?,?)",
                         (key, digest(payload), "accepted"))
        provider.commit()
        if crash_after_send:
            raise RuntimeError("simulated crash after provider acceptance")
    local.execute("INSERT OR REPLACE INTO operations VALUES (?,?,?)",
                  (key, digest(payload), "accepted"))
    local.commit()
    return "accepted"


def main():
    with tempfile.TemporaryDirectory() as directory:
        root = Path(directory)
        local = open_db(root / "local.sqlite")
        provider = open_db(root / "provider.sqlite")
        payload = {"recipient": "customer@example.test", "invoice": "INV-42", "body": "Reminder"}
        approval = digest(payload)
        try:
            execute(local, provider, "tenant-A:INV-42:reminder-1", payload, approval,
                    crash_after_send=True)
        except RuntimeError:
            pass
        local.close()  # Reopen durable local state after the simulated crash.
        local = open_db(root / "local.sqlite")
        key = "tenant-A:INV-42:reminder-1"
        assert execute(local, provider, key, payload, approval, lookup_available=False) == "unknown"
        assert execute(local, provider, key, payload, approval) == "accepted"
        assert execute(local, provider, key, payload, approval) == "accepted"
        assert execute(local, provider, "new", payload, approval, allowed=False) == "blocked"
        assert execute(local, provider, "new", payload, approval, paid=True) == "blocked"
        changed = {**payload, "recipient": "other@example.test"}
        assert execute(local, provider, "new", changed, approval) == "blocked"
        count = provider.execute("SELECT count(*) FROM operations").fetchone()[0]
        assert count == 1
        print("checks=7 provider_acceptances=1 local_state=accepted")
        local.close()
        provider.close()


if __name__ == "__main__":
    main()

단일 워커, 공급자의 고유 작업 키, 조회 가능 시 신뢰할 수 있는 결과를 가정합니다. 분산 잠금, 실제 OAuth, 정확히 한 번 배달을 구현하지 않습니다. 운영 환경에는 원자적 작업 획득, 테넌트별 키, 재시도 간 키 유지, 공급자 중복 제거 기간 만료 처리가 필요합니다.

연습과 검증 기준

  1. 승인 후 수신자를 바꾸고 추가 수락 없이 blocked가 되는지 확인합니다.
  2. 재개 전 권한을 철회하거나 결제 완료로 바꿔 새 전송을 막습니다.
  3. 장애 후 공급자 조회를 끄면 무조건 재시도하지 않고 unknown이 되어야 합니다. 조회를 복원하고 대조합니다.
  4. 두 동시 워커를 설계하고 원자적 획득 또는 리스, 멱등성, 대조를 설명합니다. 예제는 동시성 안전성을 증명하지 않습니다.

일차 자료

  1. Model Context Protocol Security Best Practiceshttps://modelcontextprotocol.io/docs/2025-11-25/tutorials/security/security_best_practices
  2. Temporal Workflow Executionhttps://docs.temporal.io/workflow-execution
  3. OpenTelemetry Traceshttps://opentelemetry.io/docs/concepts/signals/traces/
  4. AWS Transactional Outboxhttps://docs.aws.amazon.com/prescriptive-guidance/latest/cloud-design-patterns/transactional-outbox.html
  5. Temporal Activity Executionhttps://docs.temporal.io/activity-execution

관련 학습

Agent authorization · AI observability · RAG

선수 지식을 이해하기

방법을 뒷받침하는 공통 기초를 복습하고 예제와 확인 문제로 이해의 빈틈을 찾습니다.

에이전트는 관찰, 제안, 권한 검사, 실행, 결과 확인을 반복하는 상태 기반 루프입니다. 스키마는 인자 형식만 검증하며 권한이나 부수 효과의 완료를 증명하지 않습니다. 모델의 문장은 제안입니다. 호출 시도, 성공 응답, 검증된 완료를 구분해야 합니다.

답을 보기 전에 추론하기

결제 도구가 요청을 받은 뒤 시간 초과가 났습니다. 즉시 재시도해야 하나요?

단계별 해설

아니요. 결제는 성공하고 응답만 사라졌을 수 있어 결과는 불명확합니다. 멱등성 키와 상태 조회를 사용하거나 정산 확인까지 멈추세요. 무조건 재시도하면 되돌리기 어려운 작업을 중복 실행할 수 있으며 단계 제한만으로 해결되지 않습니다.

실제 응용과의 연결

도구 사용에는 애플리케이션 수준의 상태 관리, 인가, 종료 조건이 필요합니다. 알려진 사실과 불확실한 결과, 확인 대기 작업을 기록하세요. 자율성에는 검증 가능한 완료와 제한된 권한이 필요합니다.

이해를 입증하는 방법

성공, 거부, 시간 초과, 잘못된 응답을 추적하세요. 거부한 행동은 실행되지 않고 재시도는 멱등적이어야 합니다. 단계·시간·비용을 별도로 제한하고 먼저 모의 도구로 확인하세요.

완전한 Python 예제 실행

Python 3.10+ · 표준 라이브러리만 · 결정적 계산으로 시드 불필요 · 통신 없음. 저장 후 아래 명령을 실행하세요. 교육용 확인이며 모델 벤치마크가 아닙니다.

Python 다운로드 · agent.py
python3 agent.py
# Python 3.10+; standard library; deterministic; no network.
# In-memory mock only: no real payment or network call.
ledger = {}
def pay(key, amount):
    if key in ledger:
        if ledger[key] != amount:
            raise ValueError("same key with different request")
        return "already applied"
    ledger[key] = amount
    return "applied"

assert pay("order-1", 10) == "applied"
# Pretend the reply was lost. Reconcile and retry with the same key.
assert ledger.get("order-1") == 10
assert pay("order-1", 10) == "already applied"
assert len(ledger) == 1
try:
    pay("order-1", 20)
    raise AssertionError("conflicting retry accepted")
except ValueError:
    pass
print("one effect; duplicate retry suppressed")

예상 출력

one effect; duplicate retry suppressed

선수 지식 복습 →

기초 해설 수정:

출처 및 버전 정보

목적 있는 영상 학습

시청 → 설명 → 구현 → 검증

외부 영어 영상입니다. 자막과 공개 여부는 YouTube가 관리합니다. 재생을 누른 후에만 YouTube에 연결하며 실험 입력은 전송하지 않습니다.

하나의 사례를 끝까지 이해하기

예약 에이전트는 승인된 작업 하나를 정확히 완료해야 한다

합성 교육 시나리오와 손으로 계산한 수치이며 운영 벤치마크가 아닙니다. 관련 수업은 같은 사례를 공유하여 동일한 시스템을 여러 관점에서 살펴봅니다.

사례 업데이트:

직원이 예산 내 환불 가능한 호텔을 요청합니다. 검색은 되돌릴 수 있지만 예약은 지출입니다. 에이전트는 제안하고 신뢰 서비스가 신원·예산·정확한 승인을 강제해야 합니다. 성공 기준은 유창한 메시지가 아닌 검증된 예약입니다.

100+ 10= 110100
합성 예:100작업과10재시도는110요청입니다. 중복 제거로 확정 효과는100개로 유지됩니다.

1. 요청을 제한된 상태 머신으로 전환

검색·제안·승인·확정·검증으로 나누고 날짜·통화·환불 조건·한도를 명시합니다. 누락은 확인합니다. 웹페이지의 예산 무시 지시는 신뢰하지 않습니다. 상태 전환마다 허용된 이전 상태와 이유를 기록합니다.

2. 정확한 작업 승인

승인을 호텔·날짜·가격·조건에 연결합니다. 실행 전 재고와 가격을 재확인하고 변경 시 재승인합니다. 제한된 자격증명을 쓰며 모델이 권한을 만들거나 모호한 동의를 다른 구매에 전용하지 못하게 합니다.

3. 불확실한 결과 복구

확정 후 타임아웃은 실패 증거가 아닙니다. 안정된 작업 키로 조회한 뒤 재시도합니다.100건 중10건이 성공 후 타임아웃이면 무조건 재시도는110건 효과를, 멱등 재시도는100건을 만듭니다. 공급자 지원이나 대사가 필요합니다.

4. 권한 확대 없이 검증하고 개선

공급자 확인·승인 조건·미해결 예외를 반환합니다. 도구 호출과 복구 이유를 추적하고 단계·시간을 제한합니다. 검색·계획을 개선해도 독립 권한 검사는 유지합니다. 더 나은 계획이 안전한 실행을 보장하지 않습니다.

근거와 절충

지표 / 조건기준비교해석
업무 효과 수100 + 10 = 110100명시한 멱등성 가정에서만 중복을 방지합니다.
원래 작업당 중복률10/100 = 10%0/100 = 0%실측 보장이 아닌 예제입니다.
재시도 포함 요청 수100 + 10 = 110100 + 10 = 110멱등성은 효과를 제어하며 요청 수를 줄이지 않습니다.

수용 및 실패 테스트

성공 후 타임아웃·동일 키 반복·승인 가격 변경·자격 취소·단계 소진을 시험하여 예약1건, 변경 거부, 검증 불가 시 제한된 미해결 상태를 확인합니다.

Python 3.10+ · topic-cases.py ↓

python3 topic-cases.py

이 예제의 한계

동시 실행·공급자 장애·외부 상태 불일치는 생략했습니다. 운영에는 원자적 중복 제거·대사·보상 정책이 필요하며 취소는 유료일 수 있어 보편적 롤백이 아닙니다.

다음 학습 단계

잘못된 인수, 만료된 권한, 중복 재시도와 최종 상태를 검증하세요.

구현과 검증 → · 학습 경로 계속 →

예측, 검증, 근거 기록

답을 보기 전에 결과를 예측하세요. 연습 후 차이와 전이 테스트를 기록합니다. 로컬에 저장되며 언어판 간 공유됩니다.

학습 기록 열기 / 내보내기 / 지우기 →

수학 검토 범위는 강의별로 기록합니다. 논문의 실증 재현 인증은 아닙니다. 의심되는 오류를 노트에 남겨 주세요. 검토 범위