먼저 큰 그림부터

회사에 새로 온 비서를 떠올려 봅시다. 처음에는 묻는 말에 답만 합니다. 일이 손에 익으면 사내 규정을 찾아보고, 일정표를 확인하고, 휴가 신청서를 대신 써서 팀장의 결재함에 올립니다. 다만 비서는 남의 서랍을 열지 않고, 도장이 필요한 일은 꼭 본인에게 확인받고, 무엇을 했는지 업무 일지에 적습니다.

이 장은 과정에서 만든 것을 모두 묶어, 내 서버에서 도는 프라이빗 AI 에이전트를 끝에서 끝까지 만드는 프로젝트 장입니다. 질문에 답하는 데서 그치지 않고, 스스로 판단해 도구를 부르고 업무를 처리합니다. 9장의 도구 호출과 자율 루프, 7장와 16장의 빠른 검색, 15장의 가벼운 모델, 13장와 17장의 API 를 한 서비스로 잇습니다. 이 장에서 새로 보태는 것은 서비스로서 지켜야 할 세 가지입니다. 권한은 코드가 지키고, 쓰기 작업은 사람의 확인을 거치고, 무엇을 했는지 기록을 남깁니다.

프로젝트는 둘입니다. 직원의 규정 질문과 휴가 신청을 처리하는 사내 업무 도우미, 그리고 고객의 주문 조회와 반품 접수를 처리하는 상담 에이전트입니다. 회사, 쇼핑몰, 직원, 고객, 주문은 모두 연습용으로 지어낸 것입니다.