학습 목표
- AI 챗봇과 코딩 에이전트 이해하기의 역할과 적용 조건을 설명할 수 있다.
- 챗봇으로 설명만 받는 과제와 파일을 수정하는 과제를 나누세요.
- 변경 파일과 실제 결과·남은 위험을 검토하세요.
사전 지식
앞선 운영과 모니터링 준비하기를 먼저 읽으면 용어를 이해하기 쉽습니다. 이미 아는 내용이면 이 장부터 시작해도 됩니다.
개념 이해
챗봇이 답을 제안한다면 에이전트는 허용된 도구로 파일과 환경을 바꾸고 결과를 다시 관찰하는 작업 흐름을 가질 수 있습니다. 도구가 많아질수록 권한 경계와 검증이 중요해집니다.
도구 사용·탐색·파일 수정
에이전트는 코드베이스를 검색하고 필요한 파일을 읽어 수정할 수 있습니다. 작업 경로와 수정 가능 영역을 제한해야 의도치 않은 변경을 줄일 수 있습니다.
터미널·테스트 실행
명령 실행은 파일 수정보다 영향이 클 수 있습니다. 의존성 설치·DB 변경·배포를 구분하고 비밀이 출력되지 않는 명령을 사용합니다.
작업 계획과 피드백 루프
분석→계획→수정→관찰→보정으로 반복합니다. 오류가 나면 무한 반복하지 않고 원인과 중단 조건을 기록합니다.
결과 검증·컨텍스트 관리
에이전트의 요약만 믿지 말고 실제 diff와 실행 결과를 확인합니다. 필요한 문서·버전·결정이 전달되지 않으면 올바른 코드도 잘못된 환경에 적용할 수 있습니다.
실제 사용 사례
로그인 오류를 고칠 때 에이전트는 관련 요청과 상태를 찾아 수정하고 취소 흐름을 확인합니다. 운영 키 교체나 실제 계정 삭제는 별도 범위로 관리해야 합니다.
단계별 실습
실습은 운영 서비스가 아닌 별도 연습 프로젝트에서 진행하세요. 기존 파일이 있다면 변경 전 기록을 남깁니다.
- 챗봇으로 설명만 받는 과제와 파일을 수정하는 과제를 나누세요.
- 에이전트의 읽기·쓰기·명령·네트워크 권한을 확인하세요.
- 작은 버그 하나의 재현→분석→수정→검증을 요청하세요.
- 변경 파일과 실제 결과·남은 위험을 검토하세요.
코드와 프롬프트
아래 요청에서 대괄호 부분을 내 프로젝트에 맞게 바꾼 뒤 AI 도구에 전달하세요.
AI에게 요청하기
[버그]를 재현하고 관련 파일만 탐색해줘. 파일 수정·명령·데이터 변경 권한을 먼저 확인하고 작은 계획→수정→검증→결과 기록 순서로 진행해줘. 실행하지 않은 검사는 통과했다고 말하지 말아줘.자주 발생하는 문제와 해결
| 문제와 원인 | 해결 방법과 확인 기준 |
|---|---|
| 도구를 썼으니 성공했다고 생각함 | 사용자 관점 완료 조건과 실제 결과를 비교합니다. |
| 실패 후 같은 명령을 무한 반복함 | 재시도 한도와 사람에게 돌아올 조건을 정합니다. |
핵심 요약
- 도구 실행과 목표 달성은 다릅니다.
- 권한과 피드백이 에이전트 작업 품질을 좌우합니다.
완료 확인
참고자료
확인 기준일: 2026-10-20. 요금·사용 한도·제품 기능·설정 경로는 변경될 수 있으므로 작업 직전 공식 문서와 설치 버전을 확인하세요.