AI 에이전트 작업 지시(프롬프트)는 한 건, 업무 지식은 반복 기준
AI 에이전트에게 주는 작업 지시(프롬프트)는 이번 작업 한 건의 목표·입력·완료 조건을 정하는 요청입니다. 업무 지식은 여러 작업에 되풀이해 적용할 사실·기준·결정을 적용 조건·출처와 함께 모은 자료입니다. 공식 문서는 에이전트가 세션(에이전트와 한 번 이어지는 작업 대화)마다 빈 상태에서 시작한다고 설명합니다. 그래서 운영에서는 이번 작업에만 쓸 내용은 작업 지시에 두고, 다음 작업에서 다시 불러올 내용은 업무 지식으로 관리합니다.
작업 지시만으로는 왜 다음 작업에 이어지지 않나요?
에이전트는 별도 장치가 없으면 지난 작업의 지시를 다음 작업에 가져가지 못합니다. OpenAI Agents SDK 문서는 모델이 볼 수 있는 데이터가 대화 기록에서 온 것뿐이라고 설명합니다.
Anthropic의 Claude Code 문서도 세션마다 빈 컨텍스트 창(모델이 한 번에 읽는 입력 범위)에서 시작한다고 밝힙니다. 이 문서가 드는 세션 간 연결 장치는 두 가지입니다. 사람이 쓰는 지식 파일과 에이전트가 스스로 적는 자동 메모리입니다.
Anthropic은 지시문을 쓰고 정리하는 방법을 프롬프트 엔지니어링이라고 부릅니다. 모델이 보는 정보 전체를 고르고 유지하는 전략은 컨텍스트 엔지니어링으로 구분합니다. 실무로 옮기면 작업 지시는 무엇을 할지를 정하고, 업무 지식은 에이전트가 늘 알고 있어야 할 내용을 담습니다.
운영에서는 두 가지를 다음과 같이 나누어 관리합니다.
| 구분 | 작업 지시 | 업무 지식 |
|---|---|---|
| 담는 내용 | 목표, 입력 자료, 산출 형식, 완료 조건 | 확정된 사실, 판단 기준, 과거 결정과 그 이유 |
| 작성 계기 | 작업을 맡길 때마다 | 같은 정정이 반복되거나 기준이 확정될 때 |
| 함께 남기는 정보 | 대상, 마감일, 보고 방식 | 적용 조건, 출처, 결정자, 유효 기한 |
| 고치는 사람 | 지시를 쓰는 담당자가 다음 지시에서 수정 | 정해진 승인자가 검토해 개정 |
어떤 내용은 지시에 쓰고, 어떤 내용은 지식으로 옮기나요?
Claude Code 문서는 지식 파일에 내용을 더할 때를 네 가지로 듭니다. 같은 실수가 두 번째로 나올 때, 검토에서 에이전트가 알았어야 할 내용이 지적될 때입니다. 지난 세션과 같은 정정을 다시 입력할 때, 새 팀원에게도 같은 설명이 필요할 때도 해당합니다.
지식 파일에는 매 세션 지켜야 할 사실과 규칙만 남깁니다. 여러 단계로 된 절차나 일부 작업에만 필요한 내용은 별도 묶음(스킬)이나 경로별 규칙으로 옮기라는 것이 같은 문서의 안내입니다.
SEO·GEO 업무에서는 지시문의 문장마다 다음 순서로 분류하면 관리가 쉽습니다.
- 이번 작업에만 해당하는지 봅니다. 대상 주소, 마감일, 이번 회차 주제는 작업 지시에 둡니다.
- 다음 작업에서도 같은 말을 다시 하게 될지 봅니다. 그렇다면 업무 지식 후보로 적습니다.
- 근거가 확인됐는지 봅니다. 출처와 기준일이 없으면 지식으로 확정하지 않고 확인 요청으로 넘깁니다.
- 모든 작업에 필요한지, 특정 작업에만 필요한지 나눕니다. 앞의 것은 항상 불러오는 지식으로, 뒤의 것은 그 작업 때만 불러오는 지식으로 분류합니다.
- 어겼을 때 되돌리기 어려운 금지 사항인지 봅니다. 그런 항목은 문장 규칙이 아니라 권한 설정으로 막습니다.
지식 문장은 확인할 수 있게 씁니다
같은 문서는 「코드를 잘 정리한다」 대신 「2칸 들여쓰기를 쓴다」처럼 확인할 수 있게 쓰라고 권합니다. SEO·GEO 업무 지식에 옮기면 다음과 같습니다. 아래 기준값은 설명을 위한 가상의 예입니다.
| 모호한 지식 | 확인할 수 있는 지식 |
|---|---|
| 메타 설명을 적절한 길이로 쓴다 | 메타 설명은 120자 이내로 쓴다 |
| 브랜드명을 정확히 쓴다 | 브랜드명은 한글 표기 뒤 괄호에 영문을 한 번만 쓴다 |
| 근거 있는 내용만 쓴다 | 수치에는 출처 문서 이름과 확인일을 붙인다 |
오른쪽처럼 쓰면 검수자도 같은 기준으로 통과 여부를 판단할 수 있습니다.
업무 지식은 에이전트에게 어떻게 전달되나요?
지식을 저장하는 일과 에이전트가 그 지식을 읽는 일은 별개입니다. OpenAI Agents SDK 문서에 따르면 로컬 컨텍스트(애플리케이션 코드 안에서만 쓰는 데이터)는 모델에 전달되지 않습니다. 실행 때 넣는 입력 메시지는 지시문보다 지시 체계에서 낮은 위치에 놓입니다.
SEO·GEO 업무에서는 모든 작업에 걸리는 기준을 지시문 쪽에, 이번 작업의 자료를 입력 쪽에 나누어 넣습니다. 공식 문서에 나오는 전달 방식은 세 가지로 묶을 수 있습니다.
| 전달 방식 | 공식 문서의 설명 | 알맞은 업무 지식 |
|---|---|---|
| 항상 불러오기 | Claude Code는 실행 위치와 그 상위 폴더의 지식 파일을 세션 시작 때 불러옵니다. | 브랜드 표기, 금지 표현, 승인 절차처럼 모든 작업에 걸리는 기준 |
| 필요할 때 불러오기 | 스킬은 설명만 미리 올리고 본문은 쓸 때 불러옵니다. 하위 폴더의 지식 파일과 경로별 규칙도 해당 파일을 다룰 때 불러옵니다. | 보도자료 작성 순서, 구조화 데이터 점검 순서처럼 특정 작업에만 쓰는 긴 절차 |
| 도구로 조회하기 | OpenAI Agents SDK는 함수 도구와 검색 도구로 필요한 데이터를 가져오게 합니다. | 제품 목록, 과거 게시 글 목록처럼 양이 많고 자주 바뀌는 자료 |
Anthropic은 컨텍스트가 길어질수록 모델이 정보를 정확히 떠올리는 능력이 떨어진다고 설명합니다. 그래서 컨텍스트를 한정된 자원으로 다루라고 권합니다. 일부 자료만 미리 넣고, 나머지는 파일 경로 같은 가벼운 참조로 남겨 실행 중에 불러오는 혼합 방식도 소개합니다.
업무 지식에 옮기면 브랜드 표기 기준은 항상 불러오고, 과거 게시 글 목록은 저장 위치만 적어 필요할 때 조회하게 합니다.
지식의 적용 범위를 층으로 나눕니다
Claude Code 문서는 지식 파일 범위를 조직 정책·사용자·프로젝트·로컬로 나눕니다. 여러 범위의 파일은 서로 덮어쓰지 않고, 넓은 범위부터 좁은 범위 순서로 이어 붙어 읽힙니다.
SEO·GEO 업무에서는 회사 공통 금지 표현을 조직 층, 고객사별 브랜드 표기를 프로젝트 층, 담당자의 보고 형식 선호를 개인 층에 둡니다. 특정 고객사의 지식은 회사 공통 층에 올리지 않습니다. 올리면 다른 고객 작업에서도 함께 읽히기 때문입니다.
SEO·GEO 업무에서는 지시와 지식을 어떻게 나누어 쓰나요?
같은 업무 안에서도 회차마다 바뀌는 것은 작업 지시로, 반복해 지킬 것은 업무 지식으로 둡니다.
| 업무 | 작업 지시에 둘 내용 | 업무 지식에 둘 내용 |
|---|---|---|
| 메타 설명 작성 | 이번 주 대상 글, 글별 핵심 검색어 | 글자 수 기준, 금지 표현, 브랜드 표기 |
| AI 검색 답변 점검 | 이번 주 점검할 질문, 대상 AI 서비스 | 브랜드명 표기 기준, 고정 점검 질문 목록, 기록 양식 |
| 기술 점검 보고 | 점검할 페이지 묶음, 보고 마감일 | 보고 형식, 사람 승인이 필요한 변경 유형 |
예를 들어 가상의 ○○ 기업이 에이전트에게 블로그 글 메타 설명을 맡긴다면 다음과 같이 씁니다. 글자 수는 자사 기준값으로 바꿉니다.
작업 지시 문안
- 작업: 이번 주 게시할 글 2편의 메타 설명 초안을 작성합니다.
- 입력: 원고 파일 2건과 각 글의 핵심 검색어입니다.
- 산출: 글마다 자사 기준 글자 수 이내 후보 2개와 선택 이유 한 줄입니다.
- 적용 지식: 「메타 설명 기준」「브랜드 표기」를 따릅니다.
- 완료 조건: 2편 모두 후보 2개와 선택 이유가 있고 기준 글자 수 이내일 때 완료로 봅니다.
- 보고 방식: 후보가 적용 지식과 충돌하면 충돌한 지식 제목과 해당 문장을 함께 보고합니다.
업무 지식 기록 양식
| 항목 | 기록 예시(가상의 예) |
|---|---|
| 제목 | 메타 설명에 가격과 할인율을 쓰지 않는다 |
| 적용 조건 | 자사 블로그와 제품 페이지의 메타 설명을 작성할 때 |
| 적용 층 | 프로젝트(○○ 기업) |
| 사실 | 가격 정책이 분기마다 바뀐다 |
| 조치 | 가격과 할인율 대신 제품 특징과 대상 고객을 씁니다 |
| 출처·결정자 | 마케팅팀장 결정, 회의록과 결정 날짜 |
| 유효 기한 | 다음 가격 정책 개편 때 재검토 |
작업 지시에는 지식의 제목만 적고 본문을 되풀이하지 않습니다. 이 방식은 해당 지식이 항상 불러오기나 필요할 때 불러오기로 에이전트에 연결되어 있을 때 통합니다. 연결되지 않은 환경이라면 지식 본문을 입력 자료로 함께 넣습니다. 지시마다 기준을 다시 쓰면 표현이 조금씩 달라져 어느 것이 최신 기준인지 알기 어려워집니다.
Claude Code 문서는 두 지시가 서로 어긋나면 모델이 임의로 하나를 고를 수 있다고 설명합니다. 그래서 오래됐거나 충돌하는 지시를 주기적으로 정리하라고 권합니다. 검색 정책 변경, 브랜드 개편, 담당자 교체 시점을 지식 점검 일정에 넣으면 놓치는 항목이 줄어듭니다.
작업 지시와 업무 지식에 대한 흔한 오해는 무엇인가요?
오해 1. 업무 지식에 적으면 에이전트가 반드시 지킨다
Claude Code 문서는 지식 파일을 강제 설정이 아니라 참고 맥락으로 다룬다고 밝힙니다. 반면 권한 설정은 모델의 판단과 관계없이 실행 환경이 적용합니다. 정해진 시점에 반드시 돌아야 할 검사는 훅(정해진 시점에 자동 실행되는 명령)으로 만들라는 안내도 있습니다. SEO·GEO 업무에서는 게시·삭제·외부 발송처럼 되돌리기 어려운 동작을 권한 설정으로 막습니다.
오해 2. 지식은 많이 넣을수록 정확해진다
같은 문서는 지식 파일 하나를 200줄 이내로 유지하라고 권합니다. 길수록 컨텍스트를 더 차지하고 지시를 따르는 정도도 떨어진다는 이유입니다. 항상 불러오는 지식에는 모든 작업에 필요한 기준만 남깁니다.
오해 3. 대화에서 한 번 고쳐 주면 다음 작업에도 반영된다
대화 중에만 준 지시는 대화를 압축하는 과정에서 사라질 수 있습니다. 계속 지켜야 할 지시는 지식 파일로 옮기라는 것이 같은 문서의 안내입니다. 같은 정정을 두 번 했다면 지식 후보로 올립니다.
오해 4. 예외 상황을 모두 규칙으로 적어야 한다
Anthropic은 복잡하고 깨지기 쉬운 조건을 지시문에 하나하나 써넣는 방식을 실패 유형으로 꼽습니다. 구체적인 신호 없이 막연한 원칙만 주는 방식은 반대쪽 실패 유형입니다. 예외를 일일이 나열하기보다 대표 예시를 골라 보여 주라는 것이 같은 글의 권고입니다.
업무 지식도 같은 방식으로 다룹니다. 규칙을 계속 늘리기보다 판단 기준과 대표 사례를 함께 적으면 개정할 때 부담이 적습니다.
오해 5. 에이전트가 스스로 기억하면 지식을 따로 관리하지 않아도 된다
자동 메모는 사람이 열어 고칠 수 있는 파일이므로 정기 검토 대상에 넣습니다. Claude Code의 자동 메모리는 에이전트가 사용자의 정정과 선호를 바탕으로 스스로 적는 메모입니다. 메모마다 사용자·피드백 같은 종류가 붙습니다. 파일은 일반 마크다운(서식 기호를 쓰는 텍스트) 파일이라 언제든 고치거나 지울 수 있습니다.
실무에서는 자동으로 쌓인 메모를 확정 지식이 아니라 후보로 봅니다. 사용자 정정이 담긴 메모부터 검토하고, 출처와 적용 조건을 붙여 승인한 뒤 업무 지식으로 옮깁니다.
정리
- 최근 작업 지시 3~5건을 모아 되풀이해 쓴 문장에 표시합니다.
- 되풀이한 문장은 제목·적용 조건·적용 층·사실·조치·출처·유효 기한 양식으로 업무 지식 후보를 만들고, 기준은 확인할 수 있는 문장으로 씁니다.
- 후보를 조직·프로젝트·개인 층과 모든 작업용·특정 작업용으로 나누고, 되돌리기 어려운 금지 사항은 권한 설정으로 옮깁니다.
- 지식이 에이전트에 연결됐는지 확인한 뒤, 다음 작업 지시에는 목표·입력·완료 조건·보고 방식과 적용할 지식의 제목만 적습니다.
- 분기마다 지식 목록과 자동 메모를 검토해 충돌하거나 기한이 지난 항목을 개정하거나 철회합니다.
참고 자료
- Effective context engineering for AI agents (Anthropic, 확인일 2026-10-22)
- How Claude remembers your project (Anthropic Claude Code 문서, 확인일 2026-10-22)
- Extend Claude with skills (Anthropic Claude Code 문서, 확인일 2026-10-22)
- Context management (OpenAI Agents SDK 문서, 확인일 2026-10-22)