에이전트에 도구 제공하기
인공지능이 웹, 파일 및 코드를 사용하도록 하십시오.
에이전트에 도구 제공하기은(는) CoddyKit의 무료 Vibe Coding 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vibe Coding 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vibe Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.
Tools Turn a Chatbot Into a Doer
An agent is only as capable as the tools it can reach. On its own, an AI just predicts text. Give it tools, and it can search the web, read your files, run code, or call an API.
Think of tools as the agent's hands. The brain decides; the hands act. This lesson shows what those hands are and how you grant them.
What Counts as a Tool
A "tool" is any action the agent can take in the real world. Common ones:
- Web search / fetch — look something up online
- File read/write — open and edit your project
- Run command — start a server, run tests
- Call an API — hit a weather, payment, or data service
In Claude Code these come built in; in custom agents, you wire them up yourself.
Why Tools Matter
Without tools, an agent can only guess from what it already learned. It might say "the latest version is 3.2" when it's actually 5.0.
With a web search tool, it can go check. With a file tool, it sees your actual code instead of imagining it. Tools replace guessing with knowing — that's the whole point.
How a Tool Call Works
When an agent uses a tool, it doesn't run the tool itself — it requests it. The agent says "call getWeather for Paris," your system runs that function, and hands the answer back to the agent.
Here's that handoff as plain JavaScript so you can see the shape of a tool:
// A simple "tool" the agent can ask to use
function getWeather(city) {
const fake = { Paris: "18 C, sunny", Tokyo: "24 C, rain" };
return fake[city] || "unknown";
}
// Agent decides to call it; your code runs it; result goes back
const toolResult = getWeather("Paris");
console.log("Tool returned:", toolResult);Describing a Tool to the AI
For an agent to use a tool, you describe it in plain words: its name, what it does, and what inputs it needs. The AI reads that and decides when to call it.
You rarely write this by hand for beginner tools — Claude Code and v0 handle it — but knowing the shape helps you understand what the agent is choosing between.
A tool description the AI sees (plain language):
name: getWeather
description: Get the current weather for a city.
input: city (string) — the city name, e.g. "Paris"
Given that, the agent knows: "To answer a weather question,
I should call getWeather with the city."The Built-in Tools You'll Use Most
As a vibe coder, you'll lean on a handful of built-in tools your agent already has:
- Read file — so it understands your project
- Edit file — so it can build features
- Run command — so it can test and start things
- Web search — so it stays current
You mostly just allow these when asked. Knowing what each does helps you approve wisely.
Asking the Agent to Use a Tool
You don't have to name the tool — describe the outcome and the agent picks the right one. But you can nudge it when helpful.
Notice how this prompt hints at which tools to use without micromanaging:
Prompt that guides tool use (Claude Code):
"Search the web for the current version of React, then update
the version number in my package.json and README. Read both
files first so you don't break anything, and show me the diff
before saving."MCP: A Universal Tool Plug
You may hear about MCP (Model Context Protocol). It's a standard way to plug extra tools into an agent — like connecting it to your database, your design files, or a service like GitHub.
You don't need to build MCP servers as a beginner. Just know: it's the "USB port" that lets agents safely reach new tools beyond the built-in ones.
Connecting an API as a Tool
One of the most useful tools is a web API — a service your app calls for data (weather, currency, maps). An agent can both write the code that calls it and use it while building.
Here's a real fetch the agent might generate to call an API and use the result:
// Calling an API tool with fetch
async function getRate() {
const res = await fetch("https://api.frankfurter.app/latest?to=EUR");
const data = await res.json();
console.log("1 USD =", data.rates.EUR, "EUR");
}
getRate();More Tools Isn't Always Better
Every tool you give an agent is a power and a risk. A delete-file tool can clean up — or wipe your work. A shell tool can install packages — or run something harmful.
Good rule: grant the fewest tools needed for the task. Start narrow, add more only when the job clearly needs it. You'll go deeper on this in the safety lesson.
You Equip, the Agent Acts
Putting it together: you decide which tools the agent can reach, describe what each does, and approve their use. The agent then chooses the right tool at the right moment to reach your goal.
An agent without tools is just a chatbot. An agent with the right tools is a builder. Equip it thoughtfully and it becomes genuinely useful.
Quick Check
Let's confirm what a tool really is to an agent.
Recap: Hands for the Agent
You learned how agents reach the real world:
- Tools are actions: web search, file read/write, run command, call an API.
- The agent requests a tool; your system runs it and returns the result.
- Each tool is described by name, purpose, inputs.
- MCP is the standard plug for adding extra tools.
- Grant the fewest tools needed — power equals risk.
Next: chaining tools and steps into a multi-step automation.
자주 묻는 질문
“에이전트에 도구 제공하기” 강의는 무료인가요?
네 — “에이전트에 도구 제공하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vibe Coding 강의 전체를 잠금 해제할 수 있습니다. Vibe Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
“에이전트에 도구 제공하기”에서 뭘 배우나요?
인공지능이 웹, 파일 및 코드를 사용하도록 하십시오. 브라우저에서 직접 실행하는 실습 코드로 Vibe Coding을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Vibe Coding을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Vibe Coding은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“에이전트에 도구 제공하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Vibe Coding 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Vibe Coding 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 도우미에서 에이전트로
- 에이전트에 도구 제공하기
- 다단계 작업 자동화
- 에이전트 안전하게 유지하기