에이전트를 실무에 어떻게 쓸까, 개요

🇰🇷 한국어 🇺🇸 English

📌 답변 먼저 보기

AI 에이전트 실무의 출발점은 검색창과 역할을 나누는 일입니다. 검색은 설명을 모으고, 에이전트는 파일·터미널·브라우저에서 작업을 실행합니다. 이 글은 도구 후기나 요금 없이, 맡기기 좋은 일과 사람이 남길 검수만 개요로 정리합니다.

범위는 “무엇을 넘기고 무엇을 읽을까”입니다. 특정 제품의 설치 플래그·가격은 시리즈의 도구 편과 공식 문서를 따릅니다.

검색창과 뭐가 다르나?

한 줄 답: 검색(또는 일반 채팅)은 질문에 답하고, 에이전트는 목표·범위·완료 기준을 받아 저장소나 문서에서 손을 움직입니다.

검색형 사용은 보통 한 턴입니다. “이 에러가 뭐야?”, “피벗은 어떻게 만들지?”에 설명·링크가 돌아옵니다. 복붙과 적용은 사람이 합니다.

에이전트형 사용은 작업입니다. 대상 경로, 하지 말 것, 끝난 뒤 보여줄 산출물(diff, 표, 초안)을 같이 줍니다. ADE나 CLI 에이전트는 worktree·터미널·브라우저를 붙일 수 있어서, 답이 아니라 변경과 로그가 나옵니다.

실무에서 헷갈리는 지점은 “똑똑한 검색창”과 “실행 권한을 준 에이전트”를 같은 창에 두는 경우입니다. 읽기만 필요한 조사는 검색·Ask에 두고, 파일을 바꿀 때만 Agent/워크트리로 올리는 편이 역할이 분명합니다. 권한을 넓힐수록 검수 비용도 같이 커집니다.

한 줄로 나누면 다음과 같습니다.

• 검색/채팅: 개념, API 이름, 에러 해석, 초안 아이디어.
• 에이전트: 재현, 패치, 테스트 실행, 문서 초안을 파일로 쓰기, 반복 리팩터.
• 사람: 목표 확정, 비밀·권한, 머지, 대외 메시지.

어떤 일을 맡기나?

한 줄 답: 범위가 닫혀 있고, 입출력이 파일이며, 실패해도 되돌리기 쉬운 일부터 맡깁니다.

맡기기 좋은 예입니다.

• 닫힌 버그: 재현 절차와 실패 로그가 있는 경우. “로그인 플래키 테스트 원인 후보와 최소 패치.”
• 기계적 변환: 포맷, import 정리, 테스트 스캐폴드, 주석을 문서 목차로 옮기기.
• 조사 후 요약: 지정한 디렉터리만 읽고, 표나 체크리스트로 반환. 쓰기 권한은 끄거나 worktree를 따로 둡니다.
• 초안: 커밋 메시지, PR 설명, 회의록 뼈대, 슬라이드 목차. 최종 문장은 사람이 고칩니다.

아직 이릅니다.

• 프로덕션 시크릿이 있는 디렉터리, 결제·권한·개인정보.
• “코드베이스를 더 좋게”처럼 완료가 없는 요청.
• 배포, 강제 푸시, 권한 변경처럼 되돌리기 비싼 명령.

도구를 고를 때는 모델 브랜드보다 실행 표면을 봅니다. 채팅만 되는 창, 로컬 diff가 보이는 IDE, worktree가 갈라지는 ADE는 같은 “에이전트”라도 사고 반경이 다릅니다. 이미 구독 중인 CLI가 있으면 그 구독을 실행기에 붙이는 구성(bring your own agent)이 흔합니다.

한 번에 여러 에이전트를 쓸 때는 일당 하나 목표, 쓰기 권한은 worktree별로, 통합은 사람 하나가 맡는 패턴이 안전합니다. 병렬은 속도가 아니라 충돌을 어디에 모을지를 정하는 문제입니다.

사람 검수는 어디에?

한 줄 답: 시작 전 목표·금지, 실행 중 권한·로그, 끝나기 전 diff·사실·톤, 머지 전 테스트·비밀입니다.

검수를 “느낌”이 아니라 지점으로 고정합니다.

1. 지시 전: 목표 한 문장, 대상 경로, 하지 말 것(다른 패키지, 포맷터 전체 실행, 원격 푸시). 완료 기준은 “테스트 X 통과”처럼 관찰 가능하게.
2. 실행 중: 네트워크·sudo·프로덕션 자격 증명이 필요하면 그 순간 사람이 허가합니다. 로그가 멈추면 추측으로 재지시하기 전에 출력을 읽습니다.
3. 산출물: 소스 diff, 숫자·인용, 대외 문구. 에이전트는 그럴듯한 문장을 잘 만들고, 잘못된 수치를 같이 넣습니다.
4. 통합: 병렬 작업은 한 브랜치로 모을 때 충돌이 납니다. rebase/머지와 CI는 사람 소유입니다.

읽기 전용 조사와 쓰기 작업을 세션으로 나누면 검수가 줄어듭니다. “일단 고쳐 봐”는 검색창 습관이 실행 권한에 붙는 경우입니다. 실패 시에는 같은 목표를 더 좁히거나, 재현만 다시 맡기고 패치는 사람이 씁니다.

이 개요의 다음 단계는 검색 문장을 작업 단위로 바꾸는 연습입니다. 도구별 클릭보다 역할 분담을 문장으로 쓰는 습관이 먼저입니다.

출처

• 역할 모델은 시리즈 공통(검색 → 지시 → 검수). 특정 제품 명령은 해당 공식 문서를 따릅니다.
• Orca ADE 맥락: What is Orca?, Worktrees