부록 C - 작업 기록으로 익히는 AI 개발 용어
이 장에서 배우는 것
맥락·도구 호출·하네스·MCP·샌드박스·diff·worktree·CI를 실제 작업 기록에 연결한다.
입력과 실행을 설명하는 용어
맥락은 이번 응답을 만드는 데 제공된 요구·코드·대화·도구 결과 등의 입력 정보다. 맥락 창은 모델이 처리할 수 있는 범위에 관한 한도다. 토큰은 모델이 처리하는 입력·출력의 단위이며 글자 수와 같다고 가정하지 않는다. 이 책은 토큰 예산을 계산하는 제품별 수치를 제공하지 않는다.
도구 호출은 외부 기능을 쓰기 위한 요청이고 실제 실행과 결과는 실행 환경에서 확인한다. 하네스는 이 책에서 모델과 도구, 권한, 관찰 결과를 연결하는 실행 환경을 뜻한다. 에이전트는 목표를 처리하기 위해 도구 사용과 관찰을 이어가는 작업 방식을 가리킨다. 단어의 정의가 제품마다 다르면 해당 제품의 공식 설명을 함께 읽는다.
권한과 연결을 설명하는 용어
샌드박스는 접근 가능한 자원에 경계를 두는 실행 환경이다. 승인 정책은 어떤 행동 전에 확인을 요구할지 정하는 규칙이다. 하나가 다른 하나를 대신하지 않는다. MCP는 AI 응용과 외부 기능·자료를 연결하기 위한 프로토콜이며 연결한 도구의 안전성을 자동으로 보증하는 인증 마크는 아니다.
프롬프트 주입은 신뢰하지 않는 자료 속 지시가 작업자의 의도와 경계를 바꾸려는 문제로 이해할 수 있다. 이 교재는 방어적 구분을 연습하며 실제 공격 절차를 실습하지 않는다. 최소 권한은 이번 목적에 필요한 범위만 허용하는 설계 원칙이다. 필요한지 설명할 수 없는 쓰기·삭제 도구는 먼저 연결 범위를 재검토한다.
검토와 협업을 설명하는 용어
diff는 변경 전후의 차이를 보여 준다. 회귀 검사는 새 변경이 기존에 확인한 동작을 깨뜨리는지 확인하는 검사다. worktree는 한 Git 저장소의 추가 작업 디렉터리를 말하며 외부 서비스까지 격리하는 가상머신이 아니다. CI는 변경을 통합할 때 정한 빌드와 검사를 반복 실행하는 절차로 이해하면 된다. 이 책의 실습은 외부 CI 계정 없이 로컬에서 핵심 검사를 실행한다.
하위 에이전트나 분담 작업은 별도 입력과 산출물로 나눠진 작업 단위다. 이름이 다르더라도 소유 파일, 요구, 검사, 통합 책임을 확인한다. 용어를 암기하기보다 한 번의 변경 기록에서 무엇이 입력이고 무엇이 실행이며 무엇이 증거인지 색을 나누어 표시해 보자. 스스로 설명할 수 없는 단계가 다음 학습 지점이다.
| 항목 | 관찰·기대값 | 판단할 때 주의 |
|---|---|---|
| 입력 | 맥락·토큰 | 무엇을 제공했는가 |
| 실행 | 도구 호출·하네스 | 무엇이 실제 실행됐는가 |
| 검증 | diff·회귀 검사 | 어떤 근거로 맞다고 했는가 |
직접 해 보기
가상의 작업 기록을 다섯 줄로 쓴 뒤 맥락, 도구 호출, 실행 결과, diff, 회귀 검사가 어느 줄에 해당하는지 표시한다. 샌드박스와 승인 정책을 한 문장씩 구분해 설명한다.
해설과 확인 기준
예시 기록은 빈 파일 규칙 전달, 파일 읽기 요청, 파일 내용 반환, 함수 수정 diff, 빈 입력과 정상 입력 검사다. 명령을 제안한 문장만 있고 실행 로그가 없으면 도구 실행 결과라고 표시할 수 없다. 샌드박스는 가능한 접근 범위, 승인 정책은 행동 전 확인 규칙이라는 차이를 설명한다.
| 질문 | 완료 증거 |
|---|---|
| 핵심 구분을 설명할 수 있는가 | 요구문와 작업 로그의 차이를 자기 말로 설명 |
| 실습의 판단 근거가 있는가 | 실제 실행 로그가 있는가의 관찰 기록 |
| 확인하지 않은 부분을 구분했는가 | 출처 확인·실행 확인·미확인 상태를 구분 |
근거와 기준일
제품·자료 확인일: 2026-11-08. 설명 틀·대출 도구·연습·해설은 교재의 자체 구성이다. 제품별 세부 조건은 아래 공식 문서에서 해당 실행 방식과 계정 범위를 다시 확인한다.