AI 에이전트 만드는 법: 지침부터 업무 연결까지

4분 읽기수정 유튜브 「메이커 에반」을 만드는 스킬샵 운영자

나만의 AI 에이전트는 기존 도구에 작업 지침과 필요한 자료를 연결하는 방식으로 시작할 수 있어요. 예를 들어 주간 보고서의 입력 자료, 작성 순서, 검수 항목을 정해 두는 거예요. 자동 실행이나 외부 서비스 연동이 필요해지면 워크플로 도구나 코드를 추가하는 방법도 살펴볼 수 있어요.

스킬샵의 자동화 AI 스킬 카테고리 화면. 업무와 채널 자동화를 다루는 스킬 카드가 격자로 놓여 있다.
스킬샵에서 관련 작업의 스킬과 사용 예시를 살펴볼 수 있어요.

에이전트에 맡길 일을 구체적으로 정해요

AI 모델을 처음부터 학습시키지 않아도 기존 도구로 작업을 구성할 수 있어요. 무엇을 읽고, 어떤 순서로 처리하고, 결과를 어디에 남길지 정하는 것부터 시작해요.

예를 들어 보고서 에이전트라면 원본 자료의 위치, 집계 기준, 보고서 형식, 검수 방법이 필요해요. 도구가 지원하는 기능과 권한 안에서 실행할 수 있는지 확인해 주세요.

지시서와 연결과 기록작업 절차, 필요한 자료, 저장할 결과를 정해요
에이전트지원하는 도구와 권한으로 파일을 처리해요
모델입력을 해석하고 응답과 작업을 제안해요
AI 모델을 처음부터 학습시키지 않아도 기존 도구로 작업을 구성할 수 있어요.

지침·워크플로·코드 중 필요한 방식을 골라요

기존 AI 도구에 지침이나 스킬을 추가하면 반복하는 작업 방식을 전달할 수 있어요. 파일 처리처럼 이미 지원하는 기능을 조합하는 작업부터 시도하기 좋아요.

일정에 맞춘 실행이나 분기 처리가 필요하면 워크플로 도구를 검토해요. 제공되는 기능으로 부족한 연동이나 제어가 필요하면 코드로 구현할 수 있어요. 각 방식의 내보내기, 운영, 유지보수 조건도 확인해 주세요.

방식구성하는 것검토할 점
지침·스킬반복 작업의 순서와 기준을 적어요.기존 도구가 필요한 기능을 지원하는지 확인해요.
워크플로 도구일정과 조건에 따른 흐름을 구성해요.지원 기능과 내보내기·운영 조건을 살펴봐요.
코드 구현필요한 연동과 세부 제어를 구현해요.실행 환경과 유지보수 방법을 준비해요.
작게 실행해 본 뒤 지침만으로 되는 부분과 추가 기능이 필요한 부분을 구분해요.
지시서를 붙여요기존 도구 활용지원되는 기능을 지침으로 조합해요
블록을 연결해요눈에 보여요흐름을 화면에서 구성해요. 내보내기는 서비스마다 달라요
코드로 작성해요세부 제어필요한 기능을 구현하고 유지보수해요
기존 AI 도구에 지침이나 스킬을 추가하면 반복하는 작업 방식을 전달할 수 있어요.
한국어 문서의 '빠른 시작: 첫 번째 subagent 만들기' 페이지다. 1단계에 code-improver subagent 생성을 요청하는 프롬프트 코드 블록이, 2단계에 파일 검토가 온다.
공식 문서의 화면 예시예요. 현재 설정은 연결된 공식 안내에서 확인해 주세요.출처: 클로드 코드 공식 문서 · subagent

설명 가능한 작업 하나부터 시작해요

입력 자료와 기대 결과를 예시로 보여 줄 수 있는 일을 골라 보세요. 작업 순서를 적어 실제 도구로 실행해 보면 지침만으로 되는 부분과 추가 기능이 필요한 부분을 구분할 수 있어요.

지침이 있다고 모든 작업이 가능해지는 것은 아니에요. 파일 접근, 프로그램 설치, 외부 연결이 필요한지 확인하고 막힌 단계에 맞춰 다음 방법을 선택해요.

지시서로 되는 일
  • 사람에게 말로 설명해 시킬 수 있어요
  • 순서가 대체로 일정해요
  • 결과가 맞는지 확인할 수 있어요
아직 안 되는 일
  • 설명하다 보면 예외부터 나와요
  • 매번 판단이 크게 달라져요
  • 결과를 확인해 본 적이 없어요
입력 자료와 기대 결과를 예시로 보여 줄 수 있는 일을 골라 보세요.

지침과 자료, 이전 기록을 준비해요

우리 팀의 보고서 순서나 금지 표현을 지침으로 전달할 수 있어요. 필요한 사내 자료는 허용된 연결이나 파일로 제공하고 어떤 범위까지 읽을지 정해 주세요.

이전 결정과 결과를 다음 작업에서 참고해야 한다면 파일이나 저장 기능으로 남겨요. 기록이 실제로 불러와지는지와 오래된 정보가 섞이지 않는지도 확인해요.

읽은 것지시서. 우리 순서와 금지 사항
닿는 곳연결. 사내 자료와 바깥 서비스
기억지난 결정과 결과를 파일로 남기는가
우리 팀의 보고서 순서나 금지 표현을 지침으로 전달할 수 있어요.

첫 작업을 실행하고 차이를 기록해요

준비물, 작업 순서, 완료 조건을 적고 작은 자료로 실행해 보세요. 요청한 결과와 실제 결과를 비교해 빠진 단계를 찾으면 돼요.

지침이 모호했다면 예시를 추가하고, 도구나 권한이 부족했다면 그 원인을 따로 해결해요. 잘된 입력과 결과를 남기면 다음 수정에서도 같은 기준으로 확인할 수 있어요.

일 하나 골라요이번 주에 세 번 이상 한 것
순서를 적어요무엇을 보고 무엇을 확인하고 어디서 멈추는지
한 번 시켜 봐요지침과 실행 환경 중 원인을 확인해요
원인에 맞춰 수정해요수정 뒤 같은 입력으로 다시 확인해요
준비물, 작업 순서, 완료 조건을 적고 작은 자료로 실행해 보세요.

지침을 읽었는지와 실행 환경을 함께 확인해요

스킬이 선택되지 않았다면 설명과 호출 방법, 설치 위치를 확인해요. 읽었는데 누락이 생겼다면 중요한 규칙이 분명한지, 다른 지침과 충돌하지 않는지 살펴봐 주세요.

긴 참고 자료는 필요할 때 읽도록 나누고 기대 결과에는 예시를 붙여요. 인증 실패나 프로그램 오류처럼 문서만으로 해결되지 않는 문제도 있으니 실제 실패 메시지를 함께 확인해요.

안 선택해요설명문언제 쓰는지가 맨 위에 실제 쓰는 말로 적혀 있는가
길어요줄여요핵심 규칙과 상세 자료를 나눠요
애매해요숫자로적당히에는 값이 없고 해석만 남아요
확인이 없어요추가무엇이 맞는 결과인지 적어 둬요
스킬이 선택되지 않았다면 설명과 호출 방법, 설치 위치를 확인해요.

팀원도 따라 할 수 있게 공유해요

지침 파일만 보내기보다 필요한 도구, 입력 예시, 실행 방법, 확인할 결과를 함께 알려 주세요. 팀원이 새 환경에서 따라 해 보면 빠진 설정을 찾을 수 있어요.

수정한 내용과 날짜를 기록하고 공통 원본을 정해 두면 서로 다른 버전을 쓰는 일을 줄일 수 있어요. 공개 스킬을 참고할 때도 사용 조건과 실행 범위를 확인한 뒤 팀의 작업에 맞게 바꿔 주세요.

지시서 파일내가 적은 순서가 파일 한 장에 들어 있어요
한곳에 올려 둬요팀이 파일을 같이 두는 곳
팀에서 함께 사용같은 순서로 일해요
고치면 반영돼요그다음 작업부터 바뀐 대로 실행돼요
지침 파일만 보내기보다 필요한 도구, 입력 예시, 실행 방법, 확인할 결과를 함께 알려 주세요.

자주 묻는 질문

AI 에이전트를 만들려면 코딩을 할 줄 알아야 하나요?

기존 도구가 지원하는 작업은 지침이나 스킬로 조합해 시작할 수 있어요. 자동 실행이나 분기 처리가 필요하면 워크플로 도구를, 추가 연동이나 세부 제어가 필요하면 코드 구현을 검토해요. 필요한 기능에 따라 코딩 여부가 달라져요.

첫 AI 에이전트는 무엇부터 만들어 보면 되나요?

입력과 기대 결과를 예시로 보여 줄 수 있는 반복 작업 하나를 골라요. 준비물, 순서, 완료 조건을 적고 작은 자료로 실행해 보세요. 결과가 다르면 지침이 부족했는지, 도구나 권한이 부족했는지 원인을 나눠 확인하고 수정해요.

지시서를 써 두었는데 에이전트가 그대로 따르지 않으면 어떻게 하나요?

파일이 실제로 선택되고 읽혔는지 먼저 확인해요. 중요한 규칙이 분명한지, 다른 지침과 충돌하는지 살펴보고 기대 결과의 예시를 더해 주세요. 인증이나 프로그램 오류처럼 문서만으로 해결되지 않는 문제도 있으니 실제 실패 메시지도 함께 확인해요.

참고 자료