AI Agent와 Tool 사용 이해하기

1.수업 구성

지금까지는 사람이 모든 길을 미리 만들어 두었습니다. 오늘은 길을 다 정해 두지 않고, AI에게 쓸 수 있는 도구(Tool)를 쥐여 줍니다. 그러면 AI가 요청을 읽고 "지금은 시트를 조회해야겠다", "이번엔 메일을 보내야겠다"를 스스로 고릅니다. 이것이 AI Agent입니다.

2.오늘 배우는 내용 & 전체 흐름

오늘 집중할 내용

3.정해진 길 vs 스스로 고르는 길

1교시 · Workflow에서 Agent로

DAY 05의 문의 분배 Workflow는 이렇게 생겼습니다. 환불이면 이 길, 수업이면 저 길 — 사람이 그려 둔 길 밖으로는 갈 수 없습니다.

그런데 요청이 이렇게 다양하다면 어떨까요?

요청마다 할 일이 다릅니다. Agent는 요청을 읽고 연결된 Tool 중에서 필요한 것을 골라 씁니다.

4.AI Agent의 네 가지 구성

Agent를 새로 들어온 신입 사원이라고 생각하면 쉽습니다.

5.실습: 고객 데이터 시트 준비

새 Google 시트 AI_AGENT_DAY06을 만들고 탭 이름을 customers로 바꿉니다. 아래 내용을 A1 칸에 붙여 넣은 뒤, "내아이디"를 자신의 Gmail 아이디로 바꿉니다.

6.실습: Agent 뼈대 — 채팅으로 대화하기

1. 1새 Workflow DAY06_고객관리Agent → 첫 Node로 Chat Trigger를 검색해 추가합니다
2. 2그 뒤에 AI Agent를 연결합니다
3. 3AI Agent Node 아래쪽에 작은 연결 구멍이 여러 개 있습니다 — Chat Model 아래 +를 눌러 Google Gemini Chat Model을 고릅니다
4. 4Credential은 DAY 04에 만든 Gemini 연결을 고르고, 모델은 이름에 flash가 들어간 가벼운 모델로 고릅니다
5. 5캔버스 아래 Open chat(채팅 열기)을 누르고 "안녕하세요"를 보내 봅니다

* 오래된 영상에는 Agent Type(Tools Agent 등)을 고르는 화면이 나오기도 합니다. 지금 n8n의 AI Agent는 Tool을 쓰는 방식이 기본이라 이 설정이 없을 수 있습니다. 화면 위치보다 Agent + Model + Tool 구조를 기억하세요.

실습 · Tool 없이 물어보기

아직 Tool이 없는 상태에서 아래를 보내 보세요. 어떤 답이 나오나요?

7.실습: Tool ① 고객정보조회

2교시 · Tool을 고르는 Agent 만들기

일반 Workflow의 Google Sheets는 순서가 오면 무조건 실행됩니다. Tool로 붙인 Google Sheets는 Agent가 필요하다고 판단할 때만 실행됩니다.

1. 1AI Agent 아래 Tool의 +를 눌러 Google Sheets Tool을 고릅니다
2. 2Node 이름을 고객정보조회로 바꿉니다
3. 3Operation(작업)은 Get Row(s)(행 가져오기), 문서는 AI_AGENT_DAY06, 시트는 customers
4. 4Filters에 name 열을 고르고, 값 칸은 비워 두는 대신 AI가 정하도록 합니다 — 값 칸 옆의 ✨ 버튼(모델이 정하기)을 누르면 됩니다
5. 5Tool Description(Tool 설명)을 직접 쓰기로 바꾸고 아래 설명을 넣습니다

* ✨ 버튼 모양과 이름은 버전에 따라 다를 수 있습니다. 보이지 않으면 필터 없이 시트 전체를 가져오게 두어도 실습은 됩니다 — Agent가 전체 목록에서 찾습니다.

8.System Message — Agent의 업무 지침서

AI Agent Node를 열고 Options에서 System Message를 찾아 아래 틀로 씁니다. (버전에 따라 처음부터 칸이 보이기도 합니다.)

9.실습: Tool을 쓰는지 안 쓰는지 확인하기

채팅 창에 하나씩 보내고, Tool이 실행됐는지 확인합니다. Agent는 모든 질문에 Tool을 쓸 필요가 없습니다.

결과만 보지 말고 과정을 본다

채팅 창 옆(또는 AI Agent Node 안)의 실행 기록(Logs)을 열면 Agent가 어떤 Tool을 불렀는지 보입니다. 아래 순서로 따라가 보세요.

10.실습: Tool ② 고객정보등록

같은 시트라도 목적이 다르면 다른 Tool입니다. 찾는 일과 쓰는 일을 나눕니다.

1. 1Tool +를 다시 눌러 Google Sheets Tool을 하나 더 붙이고 이름을 고객정보등록으로 바꿉니다
2. 2Operation은 Append Row(행 추가), 문서·시트는 같게
3. 3name · email · course · status 열의 값을 모두 ✨(모델이 정하기)로 둡니다
4. 4Tool 설명을 넣고, System Message에 "새 고객을 등록할 때는 고객정보등록 Tool을 사용하세요."를 한 줄 더합니다

테스트

시트에 최유진 줄이 생겼는지 직접 확인하세요. Agent는 말 속의 의도(찾기 / 등록하기)를 읽고 Tool을 고릅니다.

11.읽는 Tool과 행동하는 Tool

조회는 정보를 읽기만 합니다. 메일 발송은 실제 사람에게 무언가를 해 버립니다. Agent가 실수했을 때 되돌릴 수 있는지가 다릅니다.

사람의 확인을 넣는 구조

Agent를 만든다는 건 사람을 빼는 것이 아닙니다. 중요한 행동 앞에는 사람이 확인하는 자리를 남길 수 있습니다. n8n 버전에 따라 Tool 실행 전에 사람의 승인을 받는 기능도 있습니다.

12.실습: Tool ③ 테스트이메일발송

1. 1Tool +를 눌러 Gmail Tool을 붙이고 이름을 테스트이메일발송으로 바꿉니다
2. 2Operation은 Send(보내기)
3. 3To(받는 사람)는 ✨로 두지 말고 내 주소를 직접 적어 고정합니다 (예: myname+agent@gmail.com)
4. 4Subject(제목)와 Message(본문)만 ✨(모델이 정하기)로 둡니다
5. 5System Message에 "메일 발송을 요청받았을 때만 테스트이메일발송 Tool을 사용하세요."를 더합니다

실습 · Tool 선택 테스트

이제 Tool이 세 개입니다. 보내기 전에 어떤 Tool을 고를지 먼저 예상해 보세요.

실습 · Tool을 이어서 쓰기

요청 하나에 Tool이 두 개 필요할 때도 있습니다.

13.엉뚱한 Tool을 골랐다면

"조회해줘"라고 했는데 고객정보등록을 실행했다면? Agent를 새로 만들 필요는 없습니다. 아래 순서로 확인합니다.

Agent가 지켜야 할 네 가지 규칙

이 네 가지를 System Message 마지막에 그대로 붙여 넣으세요.

14.실습: 정보가 부족한 요청

좋은 Agent는 바로 행동하지 않고, 일에 필요한 정보가 충분한지 먼저 확인합니다. 아래 요청을 하나씩 보내 보세요.

Agent가 빈 값을 지어내 시트에 등록했다면, 앞 섹션의 규칙 넷째 줄이 System Message에 들어갔는지 확인하세요.

15.Memory 연결해 보기 (선택)

AI Agent 아래 Memory의 +를 눌러 Simple Memory를 붙인 뒤, 두 메시지를 차례로 보내 보세요.

"고객 상태가 뭐야?"는 Memory에서 떠올리지 말고 시트에서 확인해야 합니다. 어떤 정보가 어디에 있어야 하는지 생각합니다.

16.Agent가 잘 작동한다는 것

답이 자연스럽다고 잘 만든 Agent는 아닙니다. 다섯 가지를 봅니다.

같은 뜻을 여러 표현으로 테스트

사람은 같은 말을 여러 방식으로 합니다. 모두 고객정보조회로 가는지 확인하세요.

메시지마다 실행된다 — 비용도 생각하기

채팅 메시지를 10번 보내면 Workflow도 10번 실행되고, 한 번에 Gemini와 Tool이 여러 번 불릴 수 있습니다. Tool을 많이 붙인다고 좋은 게 아니라 필요한 것만, 필요할 때만 쓰게 설계합니다.

17.AI에게 Agent 문제 물어보기

Workflow 전체 화면과 실행 기록(Logs)을 캡처해 함께 보냅니다. 캡처에 API Key가 보이지 않는지 꼭 확인하세요.

18.도전 과제

19.최종 실습: 나만의 고객 관리 Agent 설계

오늘 만든 Agent를 바탕으로, n8n을 열기 전에 먼저 글로 설계해 봅니다. 다음 시간 기획의 연습이기도 합니다.

최종 테스트

20.오늘 내용 정리 & 다음 수업