「말하기」에서 「하기」로: 첫 도구를 연결하세요
M1을 세운 뒤, 손에 있는 건 말을 아주 잘하는 AI입니다. Alice의 도구 132개 이야기도 이미 봤고요. Agent와 챗봇의 분수령은, 실제로 실행된 첫 번째 도구입니다. 132개가 아니라, 1개면 됩니다.
「도구를 연결한다」는 기술 일처럼 들리지만, 체인은 네 단계뿐입니다. 그리고 모델은 아무것도 실행하지 않습니다. 입만 열 뿐이고, 실제로 손대는 건 프레임워크예요. 이 네 단계를 보면, 문제가 났을 때 어디를 봐야 하는지 알 수 있습니다.
모델이 입을 여는 것부터 결과가 되먹임되기까지
모델이 요청함
JSON 한 덩어리를 출력: 어떤 도구를, 어떤 파라미터로
프레임워크가 파라미터를 검증
형식이 맞는지, 값이 유효한지. 아니면 되돌려 다시
실제 실행
데이터베이스 조회, 요청 발송, 파일 쓰기 — 이 단계에서야 실제 세계를 건드립니다
결과 되먹임
실행 결과를 대화에 다시 넣고, 모델이 소화한 뒤에야 사람 말을 합니다
첫 도구는 어떻게 고르나요
기준 세 가지, 하나도 빼지 마세요. 고빈도(당신 장면에서 거의 매번 쓰임), 저위험(읽기 전용 우선. 날씨 조회, 문서 검색이 메일 발송보다 안전함), 입출력이 분명함(파라미터 두세 개, 반환 구조가 고정). 이 장에서 도구 설명의 요령을 다뤘습니다. 같은 기능이라도 좋은 설명과 나쁜 설명은 호출 성공률이 세 배 차이 납니다. 골랐으면, 연결 이야기 전에 설명부터 분명히 쓰세요.
이 장의 실습 체크리스트
0 / 3 완료
첫 도구를 고르기
15분 누구나위 세 기준(고빈도, 저위험, 입출력 분명)으로 장면에서 첫 도구를 고르고 적으세요. 도구 이름, 한 줄 기능, 파라미터 두세 개가 각각 무엇인지. 고르기 어려우면 「내 ○○ 자료 검색」을 고르세요. 거의 모든 장면에 맞습니다.
무엇이 완료인가
도구 설명을 세 줄로 쓰기
1시간 정확하게 호출되게 하고 싶다면첫째 줄: 언제 이 도구를 써야 하는지(언제 쓰면 안 되는지도 쓰세요). 둘째 줄: 각 파라미터의 의미, 형식, 예시 값. 셋째 줄: 무엇을 반환하고, 받은 뒤 어떻게 써야 하는지. 쓴 뒤 「한 대화 뒤의 메시지 5개」 레슨의 시선으로 자가 점검하세요. 모델은 이 세 줄만 보고 어떻게 호출할지 정합니다. 당신 코드는 보이지 않습니다.
무엇이 완료인가
완전한 루프를 한 번 뚫기
반나절 진짜로 만들어 볼 준비손에 익은 플랫폼(Coze, Dify, Cursor, 또는 직접 코드)으로 이 도구를 진짜 연결하세요. 반드시 이 도구가 필요한 질문을 던져, 네 단계가 끝까지 가는지 보세요. 그다음 일부러 깨뜨리세요. 파라미터가 모호한 질문을 던져, 어느 단계에서 멈추고 사용자에게 어떤 피드백을 주는지 보세요. 이 장에서 다룬 Agent 교착 다섯 가지 패턴 중, 적어도 하나는 직접 눈으로 봐야 합니다.