AI 에이전트 스킬

작성: Ai Flowi · 게시일 2026-10-11

AI 에이전트 스킬은 특정 유형의 작업을 수행하기 위한 재사용 가능한 지침과 보조 자료입니다. 스킬에는 적용 상황, 필요한 입력, 허용되는 도구와 만족할 만한 결과의 기준을 설명할 수 있습니다. 시스템마다 이 용어를 다르게 사용하므로, 용어 자체가 표준 파일 형식이나 실행 가능한 기능을 뜻하지는 않습니다.

예를 들어 출처 검토 스킬은 근거가 있는 주장을 추출하고, 충돌을 찾아내고, 알 수 없는 사항을 표시하도록 에이전트에게 지시할 수 있습니다. 이런 지침이 문서 저장소 접근 권한을 만들어 주지는 않습니다. 모든 조회에는 자체 권한과 입력 계약을 가진 도구가 여전히 필요합니다.

스킬, 프롬프트, 도구와 워크플로는 어떻게 다른가요?

스킬은 프롬프트 텍스트를 포함하고 도구를 참조할 수 있지만, 각 부분의 책임은 구분됩니다. 명확한 지침은 에이전트가 절차를 선택하는 데 도움이 됩니다. 신뢰할 수 있는 실행 통제는 그 절차가 실제로 접근할 수 있는 대상을 결정합니다. 기반 도구의 구현이 바뀌어도 재사용 절차를 이해할 수 있어야 합니다.

유용한 스킬 설명에 담을 내용

“조사를 처리한다” 같은 포괄적인 약속 대신 좁은 작업 유형부터 정합니다. 적용 계기를 쉬운 말로 적습니다. 예를 들면 제공된 원본 자료 묶음과 주장을 대조하여 검토하는 것입니다. 그런 다음 입력, 허용된 작업, 원하는 출력과 중단 사유를 명시합니다. 독자는 절차를 실행하기 전에 적합하지 않은 요청을 알아볼 수 있어야 합니다.

출처 검토 스킬의 입력은 질문과 표식이 붙은 원본 발췌문일 수 있습니다. 출력은 근거가 있는 주장, 상충하는 발췌문과 미해결 질문의 목록일 수 있습니다. 중단 조건은 근거 부족, 접근 거부 또는 원본 변경 요청입니다. 이는 편집상의 요건이며, 측정된 성능에 대한 주장이 아닙니다.

Skill concept: source-packet review
Applies when: a question can be checked against supplied extracts.
Needs: the question, labelled extracts and an expected answer format.
May do: compare text and request an approved read-only lookup.
Must return: supported claims, source references and unknowns.
Must stop: the question requires an unsupported external action.

이 묶음은 설계를 설명하는 문서입니다. 다운로드 가능한 기본 스킬 패키지나 카탈로그 스키마가 아니며, 제품이 스킬을 자동으로 찾아낸다는 약속도 아닙니다. 의존하는 도구 계약과 함께 검토할 수 있도록 간결하게 유지합니다.

지원하는 요청의 간단한 예시

사용자가 절차 초안과 정책 발췌문 두 개를 제공한 뒤, 초안의 어떤 진술에 근거가 있는지 묻습니다. 스킬은 관련 진술을 각각 발췌문과 비교하도록 에이전트에게 지시합니다. 발췌문이 진술의 일부만 뒷받침한다면, 전체 진술에 근거가 있다고 보고하지 말고 해당 조건을 출력에 유지해야 합니다.

실제 정책을 교체하라는 요청은 이 스킬의 범위를 벗어납니다. 기대하는 응답은 이 절차가 검토만을 다룬다고 설명하고, 별도 변경에 필요한 승인을 명시하는 것입니다. 에이전트는 “검토하고 수정해 달라”를 외부 시스템 편집 권한으로 받아들여서는 안 됩니다.

스킬을 테스트하려면 두 종류의 요청을 모두 확인해야 합니다. 지원하는 예시는 절차를 테스트하고, 지원하지 않는 예시는 범위 경계를 테스트합니다. 불완전한 발췌문과 상충하는 출처도 제공합니다. 이런 사례를 통해 지침이 항상 완성된 것처럼 보이는 답을 만드는 대신 불확실성을 유지하는지 확인할 수 있습니다.

비슷한 요청에도 다른 절차가 필요할 수 있습니다

“이 초안이 발췌문 C의 예외를 유지하는지 확인해 달라”는 요청은 출처 검토 스킬에 맞습니다. 요청, 초안과 지정된 근거가 있기 때문입니다. “발췌문을 제공하지 않고 현재 정책을 알려 달라”는 요청은 별도로 권한이 부여된 검색 경로에서 빠진 자료를 제공하지 않는 한 맞지 않습니다. 비교 절차를 시도하기 전에 스킬이 입력 누락을 확인해야 합니다.

“예외를 유지하면서 초안을 더 명확하게 다시 써 달라”도 검토 전용 절차의 범위를 넘습니다. 수정이 필요한 문장과 유지할 조건을 반환한 뒤, 작성 작업을 적합한 절차에 넘길 수 있습니다. 검토와 재작성을 결합하면 더 이상 존재하지 않는 텍스트에 검토 판정이 붙을 수 있습니다. 스킬이 주석, 수정된 초안 또는 둘 다를 반환할지 결정하고 그 선택을 명시합니다.

“보관된 기록에만 적용된다”라는 문구를 담은 유지보수 사례를 사용합니다. 스킬 지침을 편집한 뒤 반환된 주석이 해당 조건을 주장에 계속 연결하는지 확인합니다. 문장 전체에 근거가 있다고만 표시하는 결과는 절차의 핵심 수용 기준을 잃은 것입니다. 발췌문이 빠진 요청도 다시 실행합니다. 표현 개선을 위한 수정이 스킬의 적용 범위를 넓혀서는 안 됩니다. 요청 예시를 지침 버전과 함께 저장하여 이후 변경에서도 같은 작업 경계를 확인할 수 있게 합니다.

AI Flowi Workflow에서 스킬을 표현하는 방법

아래 구성에서 재사용 지침을 표현할 때는 Prompt Template 문서를 사용합니다.

Agent 인터페이스와 함수 호출 도구 계약은 실행 가능한 연결을 다룹니다. 스킬은 적용 조건과 절차를 제공합니다.

카탈로그는 자동 스킬 설치 프로그램이나 버전 등록부를 입증하지 않으므로, 지침 묶음을 자신의 문서에서 검토할 수 있게 유지합니다.

제안하는 재사용 지침 구성

구성 예시이며, 기록된 테스트가 아닙니다

Prompt Template.template:
Review the supplied source packet. Keep source references beside claims.
Mark contradictions and unknowns. Do not edit or publish any source.

Agent.system_prompt: connect Prompt Template.prompt
Agent.input_value: provide the synthetic question and source packet
Agent.model: select your configured model
Agent.tools: add only a separately checked read-only tool if required

첫 구성안은 임의의 동적 변수 문법을 만들지 않고 정적인 지침 텍스트를 사용합니다. Message 출력과 수용되는 Message 입력은 카탈로그상 호환됩니다. 그러나 통합 실행이 이루어졌다는 증거는 아닙니다. 이 구성 요소는 카탈로그에 문서화되어 있지만, Ai Flowi가 운영 환경에서 테스트한 것은 아닙니다.

스킬에 도구를 추가하기 전에 조회 계약을 검토합니다.

조회가 필요 없는 발췌문 제공 사례와, 조회 없이는 진행할 수 없는 발췌문 누락 사례를 함께 유지합니다. 이를 통해 스킬의 비교 절차 실패와 입력 확보 실패를 구분합니다. 모델 실행에는 자신의 제공업체 계정과 API 키가 필요하며, 해당 제공업체 요금은 별도로 부과됩니다.

입력이 바뀌어도 유용한 스킬 유지하기

절차와 원본의 사실을 분리합니다. 정책 검토 스킬은 정책 자료 묶음이 바뀌어도 그대로 유지할 수 있습니다. 재사용 지침에 정책 결론을 고정하면 절차와 오래된 지식을 구분하기 어려워집니다.

자신의 문서에서 지침 묶음에 검토된 식별 정보를 부여하고 테스트에 사용한 버전을 기록합니다. 이는 유지보수 권고이며, 제품의 기본 제공 기능이 아닙니다. 도구 인수, 권한이나 원본 형식이 바뀌면 예시를 다시 확인합니다. 이전 사례의 성공이 수정된 도구와의 호환성을 입증하지는 않습니다.

다른 에이전트가 스킬의 출력을 받는다면 인계를 명시합니다. 문안을 작성해도 되는지, 추가 근거를 요청해도 되는지, 반환된 주장만 확인해야 하는지 적습니다. 작업 위임이 도구 범위를 알리지 않은 채 넓혀서는 안 됩니다. 멀티 에이전트 아키텍처 가이드는 이런 계약상의 결정을 설명합니다.

흔한 실수와 관련 용어

긴 프롬프트가 반드시 유용한 스킬인 것은 아닙니다. 길이보다 범위와 수용 기준이 중요합니다. 이름이 명확한 도구도 작업 절차가 없으므로 완전한 스킬이 아닙니다. 검토되지 않은 지침을 재사용하면 같은 오류가 여러 작업에 퍼질 수 있습니다.

함수 호출은 작업 요청을 다룹니다. 에이전트 가드레일은 통제 경계를 다룹니다. 에이전트 메모리는 보관된 정보를 다룹니다. 또 다른 재사용 절차를 작성하기 전에 기존 활용 사례에서 시작 설계를 살펴볼 수 있습니다.

워크플로 사용 요금

요금제: Go 연간 결제 시 월 USD8부터(월간 USD10), Plus 월 USD16부터(월간 USD20), Pro 100 월 USD80부터(월간 USD100), Pro 200 월 USD160부터(월간 USD200), Pro 500 월 USD400부터(월간 USD500). 매월 5,000~250,000 Flowi Tokens가 제공되며 충전도 가능합니다. 노드 실행 1회당 1토큰, 타사 API 및 모델 사용 요금은 포함되지 않습니다.