🐨CoalaCoding
Docs▾
JavaScriptReactHTML & CSSBackendAI & LLMDev ToolsCreative
B반1
👾숏츠
🙉B반2
게시판
🐨CoalaCoding

디지털 크리에이터를 위한 한국어 기술 문서

문서

  • JavaScript
  • React
  • HTML & CSS
  • Backend
  • AI & LLM
  • Dev Tools
  • Creative

커뮤니티

  • 게시판
  • 예제 모음

기타

  • 관리자

정책

  • 소개
  • 개인정보처리방침
  • 이용약관
  • 연락처
© 2026 CoalaCoding. All rights reserved.
  • 1. AI 워커(AI Worker)가이드
  • 2. 프롬프트 다섯 가지 기법
  • 3. 생성형 AI와 일하는 방법
  • 4. 원하는 답을 얻는 요청문
  • 5. 독자에 맞는 말투 고르기
  • 6. 표와 목록으로 답변 정리하기
  • 7. 큰 업무를 작은 작업으로 나누기
  • 8. 답변의 사실과 출처 확인하기
  • 9. 개인정보와 저작권 지키기
  • 10. AI로 업무 문서 완성하기
  • 11. 긴 문서에서 핵심 찾기
  • 12. 최신 정보를 찾아 비교하기
  • 13. 표 데이터의 오류 찾기
  • 13. 챗gpt-활용법
  • 14. 이미지와 화면에서 정보 읽기
  • 14. 인공지능-서비스-목록
  • 15. 이미지·영상·음성 콘텐츠 기획하기
  • 16. 여러 대안을 같은 기준으로 비교하기
  • 17. 자주 쓰는 요청을 템플릿으로 만들기
  • 17. GEM등록하기
  • 18. 여러 자료를 묶어 결과물 만들기
  • 19. 반복 업무의 흐름 설계하기
  • 20. AI가 사용할 도구 정하기
  • 21. 대화가 바뀌어도 업무 이어가기
  • 22. AI 결과를 일관되게 검증하기
  • 23. AI의 권한과 보안 통제하기
  • 24. AI 에이전트에게 업무 맡기기
  • 25. 조사·작성·검토 역할 나누기
  • 26. AI 업무 하네스 만들기
  • 30. AI 코딩 에이전트 스킬 사용법
  1. 홈
  2. 문서
  3. AI & LLM
  4. 프롬프트 엔지니어링
  5. 20. AI가 사용할 도구 정하기

20. AI가 사용할 도구 정하기

AI 작업에 필요한 도구와 권한을 구분하는 교안이다.

#ai#프롬프트

목차

  • 1. 도구가 필요한 이유 확인
  • 1.1 도구 목록 만들기
  • 2. 읽기와 쓰기 분리하기
  • 2.1 실제 상태 변경 찾기
  • 3. 최소 도구 선택하기
  • 3.1 업무와 도구 연결하기
  • 3.2 함수 호출의 흐름 이해하기
  • 4. 승인 지점 정하기
  • 4.1 승인표 만들기
  • 5. 도구 사용 요청 작성하기
  • 5.1 실행 범위 명시하기
  • 6. 오류가 생겼을 때
  • 6.1 필요 없는 도구를 요청한 경우
  • 6.2 쓰기 작업이 바로 실행된 경우
  • 7. 직접 설계하기
  • 8. 예상 결과와 맞춰보기
  • 9. 살펴보기
  • 10. 적용 전 확인

1. 도구가 필요한 이유 확인

AI는 글을 생성하는 것과 외부 도구를 사용해 실제 정보를 읽거나 상태를 바꾸는 일을 구분해야 한다.

도구를 많이 연결하면 편해 보이지만 위험도 함께 커진다. 읽기, 쓰기, 삭제, 외부 전송을 나누고 실제 상태를 바꾸는 작업에는 사람의 확인 지점을 둔다.

1.1 도구 목록 만들기

  1. "ai_prompt" 폴더에 "20_tools.md"를 만든다.
  2. 다음 표를 입력한다.
도구 | 하는 일 | 읽기·쓰기 | 필요한 권한 | 잘못 사용했을 때 영향
  1. 다음 예시를 추가한다.
웹 검색 | 공개 정보 찾기 | 읽기 | 인터넷 접근 | 오래되거나 잘못된 자료 사용
파일 읽기 | 문서 내용 확인 | 읽기 | 지정 폴더 읽기 | 기밀 노출
파일 저장 | 결과 파일 만들기 | 쓰기 | 지정 폴더 쓰기 | 기존 파일 덮어쓰기
계산기 | 수치 계산 | 읽기 | 없음 | 잘못된 입력 계산
메일 발송 | 결과 전송 | 쓰기 | 계정과 수신자 | 잘못된 외부 전송

2. 읽기와 쓰기 분리하기

2.1 실제 상태 변경 찾기

  1. 다음 작업을 읽기, 쓰기, 둘 다로 분류한다.
공식 문서 검색
PDF 내용 읽기
보고서 파일 저장
일정 등록
메일 초안 작성
메일 실제 발송
데이터베이스 조회
데이터베이스 행 수정
  1. 초안 작성과 실제 발송을 다른 작업으로 분리한다.
  2. 조회와 수정을 다른 권한으로 분리한다.
  1. 글을 만드는 작업과 외부에 보내는 작업은 다르다.
  2. 외부 상태를 바꾸는 도구는 실행 전에 사람이 확인한다.

3. 최소 도구 선택하기

3.1 업무와 도구 연결하기

  1. 다음 업무를 사용한다.
공식 문서 세 개를 찾아 비교 보고서를 만들고 로컬 폴더에 저장한다.
  1. 필요한 도구만 고른다.
필요:
- 웹 검색
- 웹 문서 읽기
- 파일 저장

불필요:
- 메일 발송
- 일정 등록
- 데이터베이스 수정
  1. "20_tools.md"에 선택 이유를 기록한다.

3.2 함수 호출의 흐름 이해하기

함수 호출은 AI가 도구의 이름과 입력값을 정해 실행을 요청하는 방식이다. AI가 직접 모든 작업을 처리하는 것이 아니라 연결 프로그램이 요청을 검사하고 실제 도구를 실행한다.

  1. 다음 흐름을 "20_tools.md"에 적는다.
1. 사람이 목표를 요청한다.
2. AI가 사용할 도구와 입력값을 고른다.
3. 연결 프로그램이 도구 이름, 입력 형식, 권한을 검사한다.
4. 실제 도구가 작업을 실행한다.
5. 도구 결과를 AI가 받아 설명하거나 다음 작업을 고른다.
  1. 공개 문서 검색 예시를 작성한다.
도구: search_docs
입력:
- 검색어: "생성형 AI 교육 지침"
- 공식 출처만: 예
- 기준일: 2026-06-09
결과: 문서 제목, 주소, 게시일
  1. 일정 등록 예시를 작성한다.
도구: create_event
입력:
- 제목: 실습실 점검
- 날짜: 2026-07-01
- 시각: 16:00
- 참석자: 없음
처리: 실행 전 사람이 날짜와 시각을 확인한다.
  1. 두 예시의 차이를 기록한다.
    1. 검색은 공개 정보를 읽는다.
    2. 일정 등록은 외부 상태를 바꿼다.
    3. 같은 함수 호출이라도 권한과 승인 기준은 다르다.
  1. 함수 호출은 도구를 부르는 실행 방식이다.
  2. MCP는 AI와 외부 도구가 기능 목록, 입력 형식, 결과를 주고받는 연결 규약이다.
  3. MCP 서버가 제공한 도구도 함수 호출과 비슷한 흐름으로 실행할 수 있다.
  4. MCP를 연결했다고 모든 도구를 자동 허용하는 것은 아니다. 각 도구의 권한을 따로 정한다.

4. 승인 지점 정하기

4.1 승인표 만들기

  1. 다음 표를 작성한다.
행동 | 자동 허용 | 실행 전 확인 | 금지
공개 웹 문서 읽기 |
지정 폴더 파일 읽기 |
새 파일 저장 |
기존 파일 덮어쓰기 |
외부 메일 발송 |
개인정보 포함 파일 열기 |
  1. 다음 원칙을 적용한다.
    1. 공개 정보 읽기는 자동 허용할 수 있다.
    2. 새 파일 저장은 지정 폴더에서만 허용한다.
    3. 기존 파일 덮어쓰기는 실행 전 확인한다.
    4. 외부 발송은 실행 전 확인한다.
    5. 개인정보 파일은 기본 금지한다.

5. 도구 사용 요청 작성하기

5.1 실행 범위 명시하기

  1. 다음 요청문을 작성한다.
목표:
공식 문서 세 개를 비교한 보고서를 작성한다.

허용 도구:
- 공개 웹 문서 검색과 읽기
- "ai_prompt/20_output" 폴더에 새 파일 저장

금지:
- 다른 폴더 읽기
- 기존 파일 수정
- 로그인 계정 사용
- 외부 서비스로 결과 전송

승인 필요:
- 유료 자료 열기
- 파일 덮어쓰기
- 공식 문서가 아닌 자료 사용

작업 전 사용할 도구와 순서를 먼저 제시한다.
  1. 에이전트 기능이 있는 도구에 입력한다.
  2. 도구가 없는 대화형 AI에서는 실행 계획만 받는다.
  3. 계획이 허용 범위를 넘으면 실행하지 않는다.

6. 오류가 생겼을 때

6.1 필요 없는 도구를 요청한 경우

  1. 해당 도구를 제거한다.
  2. 목표를 바꾸지 않고 더 작은 권한으로 가능한지 확인한다.

6.2 쓰기 작업이 바로 실행된 경우

  1. 작업을 중단한다.
  2. 자동 실행 설정을 끈다.
  3. 읽기 전용 또는 계획 전용 모드로 다시 시작한다.

7. 직접 설계하기

  1. 자동화할 업무 한 개를 고른다.
  2. 필요한 도구와 불필요한 도구를 나눈다.
  3. 읽기와 쓰기 권한을 분리한다.
  4. 승인표를 만든다.
  5. 작은 예제에서 읽기 작업만 먼저 확인한다.

8. 예상 결과와 맞춰보기

행동 | 처리
공개 웹 문서 읽기 | 허용
지정 폴더의 가상 자료 읽기 | 허용
새 결과 파일 만들기 | 실행 전 확인
기존 파일 덮어쓰기 | 실행 전 확인
메일 발송 | 실행 전 확인
인증 정보 읽기 | 금지

업무에 필요하지 않은 도구가 제외되고 외부 상태를 바꾸는 행동에 사람 확인이 있으면 정상이다.

9. 살펴보기

  • 글 생성과 실제 실행을 구분했는가
  • AI의 도구 선택과 실제 프로그램의 실행을 구분했는가
  • 함수 호출의 입력값과 실행 전 검사 항목을 정했는가
  • MCP 연결과 도구 권한을 같은 것으로 오해하지 않았는가
  • 읽기와 쓰기 권한을 분리했는가
  • 업무에 필요하지 않은 도구를 제거했는가
  • 삭제·덮어쓰기·외부 전송에 승인 지점을 두었는가
  • 일반 웹 AI에서는 사람이 직접 실행하는 대안을 정했는가

10. 적용 전 확인

  • 도구마다 읽기, 쓰기, 삭제 권한을 따로 구분한다.
  • 실제 상태를 바꾸는 작업에는 사람 승인 지점을 둔다.
  • 사용하는 AI 서비스가 해당 도구와 권한 설정을 제공하는지 확인한다.