| 핵심 | 승인 게이트approval gate | 실행 흐름에서 사람이 허락해야 다음 단계로 넘어가는 지점입니다. 승인 상태 확인과 실행 차단 로직을 구현하고 시험합니다. | 저장·전송 직전에 승인 게이트를 구현해 줘. 승인한 경우에만 다음 단계로 넘어가고 거절하면 저장·전송 없이 종료되는지 시험해 줘. 구현된 승인 단계에서 승인·거절 흐름을 시험합니다. 자연어 지시만으로 중단을 보장하지 않습니다. |
| 중요 | 하네스harness | 입력·도구·권한·승인·검증·기록을 조정하는 실행 장치 전체를 뜻합니다. 단일 제품 기능명이 아니며 실제 적용 범위를 시험합니다. | 이 업무 에이전트의 하네스(입력·도구·승인·검증·기록)를 그림과 표로 설계해 줘. 입력·도구·승인·검증·기록의 설계와 시험 범위를 정리합니다. |
| 중요 | 에이전트 루프agent loop | 판단→도구 실행→결과 확인을 반복합니다. | 판단 → 도구 실행 → 결과 확인 루프를 최대 10회로 제한하고 매회 무엇을 했는지 기록해 줘. 반복 횟수가 제한되고 회차별 기록이 남습니다. |
| 중요 | 도구 호출tool use | AI가 도구를 쓰기로 결정하고 실행하는 일입니다. | 허용할 도구를 파일 읽기와 검색으로 제한하는 실제 설정을 적용해 줘. 다른 도구와 하위 프로세스 접근 시험 결과도 보고해 줘. 설정한 도구 범위와 허용·차단 시험 결과를 확인합니다. 하위 프로세스 접근은 별도로 점검합니다. |
| 중요 | 검증 게이트verification gate | 결과가 기준을 통과해야 완료로 치는 지점입니다. 강의 설계 용어입니다. | 검증에 실패하면 완료로 표시하지 말고 실패 상태와 이유를 기록해 줘. 검증 통과 전에는 완료 보고가 나오지 않습니다. |
| 중요 | 실행 예산budget | 자동 실행의 비용·횟수·시간 상한입니다. 실제 계측과 중단 장치를 구현하고 상한 도달 시 동작을 시험합니다. | 비용 2달러·도구 호출 30회·10분 상한을 계측하고 중단하는 장치를 구현해 줘. 상한 도달 시험과 미계측 범위를 보고해 줘. 계측·중단 장치가 시험된 범위의 상한을 확인합니다. 계측 지연과 이미 진행 중인 호출 비용도 점검합니다. |
| 중요 | 작업 IDTask Identifier | 식별자(Identifier)의 줄임말인 ID를 작업마다 부여해 요청을 구별하는 값입니다. 재시도·재시작·중복 접수를 구분하는 기준이 됩니다. | 요청마다 작업 ID를 붙이고, 같은 ID가 다시 오면 저장하지 말고 기존 결과를 돌려줘. 중복 요청이 두 번 저장되지 않습니다. |
| 중요 | 멱등성idempotency | 재실행해도 중복 효과가 늘지 않는 성질입니다. | 이 저장 단계는 몇 번 다시 실행해도 결과가 하나만 남도록 멱등하게 만들어 줘. 재실행해도 중복이 생기지 않습니다. |
| 중요 | 재시도retry | 일시적 실패 뒤 같은 작업을 다시 시도하는 것입니다. 간격을 점점 늘리는 방식(지수 백오프)과 횟수 상한을 함께 정합니다. | 연결 오류만 간격을 늘려 최대 3회 재시도해 줘. 다른 오류는 즉시 멈추고 최대 횟수 후에도 실패하면 현재 상태와 이유를 보고해 줘. 제한된 횟수에서 복구 여부를 확인합니다. 복구되지 않으면 실패 상태와 원인을 보고합니다. |
| 중요 | 작업 상태(상태 전이)task state | 작업이 지금 어느 단계인지 나타내는 값입니다. 상태를 저장해야 재시작·중복 방지가 됩니다. | 접수·진행·승인 대기·완료·실패 상태를 파일에 기록하고 재시작 시 이어서 진행해 줘. 중단돼도 상태 파일에서 이어 갈 수 있습니다. |
| 중요 | 계획과 실행 분리plan/execute separation | 조회·계획 단계와 변경·실행 단계를 나누는 설계입니다. 강의 설계 용어입니다. | 자료를 읽는 단계와 초안을 쓰는 단계를 분리하고, 쓰기 도구는 두 번째 단계에서만 써 줘. 읽기와 쓰기가 섞이지 않아 범위 밖 변경이 줄어듭니다. |
| 중요 | 시스템 프롬프트system prompt | AI에게 미리 주어지는 기본 지시입니다. /context의 System prompt에 해당합니다. | 이 에이전트의 시스템 프롬프트에 '원본 수정 금지·근거 필수' 역할 규칙을 넣어 줘. 모든 대화에 앞서 적용되는 기본 지시가 정해집니다. |
| 중요 | 가드레일guardrail | 입력·출력·행동을 제한하는 장치들의 통칭입니다. 훅만을 뜻하지는 않습니다. | 개인정보 패턴이 결과에 포함되면 출력을 보류하는 가드레일을 구현해 줘. 가상 자료로 차단·누락·오탐을 시험하고 미지원 경로도 보고해 줘. 시험한 경로의 출력 보류·누락·오탐 결과를 확인합니다. 모든 개인정보 검출을 보장하지는 않습니다. |
| 참고 | 입력 게이트웨이input gateway | 요청이 들어오는 창구(Slack·이메일·폼 등)입니다. 강의 설계 용어이며 연결 방법은 수업에서 정한 범위로 한정합니다. | Slack 채널 메시지를 입력으로 받아 작업 큐에 넣고, 처리 결과를 같은 스레드에 보고하게 해 줘. Slack이 에이전트의 입력창이 되고 결과가 돌아옵니다. |
| 참고 | 에이전트 SDKAgent Software Development Kit | 소프트웨어 개발 도구 모음(Software Development Kit)의 줄임말인 SDK 중 코드로 에이전트를 만들 때 쓰는 라이브러리와 도구 모음입니다. | 이 흐름을 에이전트 SDK 코드로 옮기면 어떤 구조가 되는지 개요만 설명해 줘. 에이전트 SDK의 코드 구조 개요를 설명합니다. 구현은 별도 범위로 구분합니다. |