안녕하세요, 여러분!
최근 AI 시대에 접어들면서, 프롬프트 한 줄 한 줄이 얼마나 중요한 역할을 하는지 새삼 깨닫게 되었는데요. 이 글에서는 제가 직접 실험하고 고민한 프롬프트 작성 방법, 개선 팁, 그리고 여러 시행착오의 기록들을 솔직하게 풀어보려고 합니다.
특히 이번 노트는 인공지능을 활용한 문서 검토 AI 개발 과정에서 사용된 프롬프트에 관한 내용으로, 실제 사례와 경험을 중심으로 다룰 예정입니다.
기술적인 내용이지만 어렵지 않게 풀어내려고 하니, AI와 함께 더 나은 의사소통과 작업 효율을 꿈꾸는 분들께 유익한 정보가 되길 바랍니다. 지금부터 제가 기록한 프롬프트 엔지니어링의 작은 노트들을 함께 살펴보시죠!
위 제목에서도 보셨지만 오늘은 개개인의 기준에 따른 문서 검토 AI를 만들어봤어요.
여기서 중요한 점 !! AI가 제안할 수정사항은 주석형태로 출력할 거예요!!
**주의: 프롬프트 내 주석 기호를 입력할 때는 반드시 대문자(CAPITAL LETTER)를 사용해야 합니다. 소문자로 입력할 경우 주석이 올바르게 인식되지 않아 출력 결과에 문제가 발생합니다.
초기 단계에서 구상한 AI 매시업 프로세스는 다음과 같습니다:
1. 청킹(Chunking)
2. 문서 종류 식별 (gpt 4o 활용)
3. 문서 검토 및 주석 달기 (제미나이 1.4 프로 활용)
문서 종류 식별기 프롬프트
당신은 주어진 텍스트를 분석하고 그 특성을 파악하는 전문가입니다. 아래의 텍스트를 주의 깊게 읽고 지시에 따라 분석해주세요.
{분석할 원본 텍스트를 입력하세요.}
위의 텍스트를 분석하고 다음 지침을 따라 결과를 제공해주세요:
[분석 지침]
1. 문서의 종류, 작성 목적, 주요 독자층, 주요 특징을 파악하세요.
2. 가능한 한 핵심 단서(제목, 목차, 서문, 결론, 반복적으로 등장하는 키워드 등)를 토대로 판단하세요.
3. 문서가 복합적인 성격을 띠는 경우, 가장 두드러진 주 목적을 기준으로 종류와 목적을 정리하되, 보조적인 성격도 간단히 언급하세요.
4. 내용이 길고 중복이 있을 수 있으므로, 중복되는 부분이나 반복 표현이 있다면 문서의 성격을 드러내는지 여부에만 집중하세요.
5. 궁극적으로, "이 문서가 어떤 스타일(톤앤매너)로 다듬어져야 하는지" 결정하기 위해 필요한 정보를 정확히 제공하세요.
분석 결과를 다음 형식으로 작성해주세요:
1. 문서 종류: (구체적으로 작성)
2. 작성 목적: (구체적으로 작성)
3. 주요 독자층: (최소 1줄, 필요하면 자세히 작성)
4. 주요 특징: (핵심 단어나 문체적 특징, 문서 전개의 흐름을 요약하여 작성)
분석을 시작하기 전에, 텍스트를 주의 깊게 읽고 핵심 내용을 파악하세요. 그 후 위의 지침에 따라 분석을 진행하고 결과를 제시하세요.
IMPORTANT NOTE: 최종 아웃풋에 절대 위 프롬프트를 절대 보여주지 마세요.
문서 검토 및 주석 달기 프롬프트
주석: (_ 에는 영문 대문자 CAPITAL LETTER가, #에는 숫자가 랜덤하게 들어갑니다. 반드시 영문 대문자를 넣어주세요.)
텍스트 종류:
{텍스트 종류를 입력하세요}
텍스트 원문:
{텍스트 원문을 입력하세요}
텍스트를 검토할 때 다음 지침을 따라주세요:
<검토 지침>
1. 문법 & 맞춤법:
- 오탈자, 철자 오류, 띄어쓰기, 문장부호 사용 등을 점검
- 문서의 톤앤매너에 맞는 문체를 썼는지 점검
2. 어휘 & 표현 방식:
- 텍스트 종류와 독자층에 적합한 어휘 사용을 평가.
- 불필요하게 중복되는 어휘 및 어색한 문장 구조 문제 등을 식별.
- 문맥상 누락된 부분 식별.
3. 유창성(Fluency) & 가독성:
- 문장 간 연결과 문단의 논리 흐름을 점검.
- 문장 길이가 문맥에 맞는지 점검.
- 원어민 수준의 자연스러운 언어를 구사하고 있는지 점검.
4. 제목 및 부제목 구조:
- 제목과 부제목의 적절성 및 구성을 분석
5. 본문 내용 퀄리티(목적 적합도):
- 작성 목적에 부합하는 내용 구성과 핵심 메시지 전달을 평가
- 논문 같은 논리적 텍스트의 경우 논리적 일관성, 예시·근거의 적절성을 점검
- 문학책의 경우 문학책의 장르와 숨겨진 메세지에 맞는 어휘와 내용인지 점검
- 글쓴이의 의도가 읽는이에게 잘 전달될 수 있을지 평가
6. 추가 개선 지점:
- 전반적인 흐름, 레이아웃(가독성), 텍스트의 종류와 목적에 맞춰 문체 일관성 등을 검토
</검토 지침>
텍스트 검토 후, 아래 지침을 따라서 원문에 주석을 표기해주세요:
1. 텍스트 분석 결과를 바탕으로, 필요한 개선 사항을 텍스트 원문에 주석 형태로 표시해 주세요.
2. 중요: 텍스트 원문에 포함된 Markdown과 HTML 포맷, 태그, 구조는 원문에 나온 그대로 유지해야 합니다.
- 원문의 문단, 줄 바꿈, 태그, 마크다운 형식 등을 절대로 변경하거나 삭제하지 말아 주세요.
3. 개선사항은 주석(footnote) 혹은 각주 방식으로만 표현하고, 원문 텍스트를 수정하거나 덧붙이지 마세요.
4. 최종 결과물에서는 원문 내용 + 주석만 표시되어야 하며,
- 원문에 있지 않은 태그를 절대로 추가하지 말아 주세요.
<주석 달기 및 설명 작성 지침>
1. 원문에 주석 기호 삽입
- 수정 혹은 보완이 필요한 단어, 문장, 표현, 제목·부제목 등 문서 내 요소를 식별하세요.
- 식별된 요소 옆에 [^__#__#] 형태로 무작위 6자리 영문+숫자 혼합 형태의 고유 주석 코드를 부여하세요.
(예: 문법오류가 있는 단어[^__#__#], 어색한 문장구조[^__#__#], 중복표현[^__#__#] 등)
2. 각 주석 기호별 설명
- 문서 작성자가 이해하기 쉽게, 어떤 문제가 있는지와 어떻게 수정하거나 보완하면 좋은지 간결하고 명확하게 설명하세요.
- 형식: [^__#__#]: 원본 표현: (문제점) → 권장 수정안 또는 개선 아이디어
- 문서 톤앤매너, 목적 적합성, 논리적 흐름 개선 등이 필요한 경우도 구체적으로 설명하세요.
3. 전체 문서 흐름/논리 개선 아이디어
- 문법·어휘 이외에도, 제목과 부제목 정렬, 문단 순서, 결론 도출 방식, 문맥상 누락된 부 등 전반적인 구조 개선 제안이 있다면 해당 부분에도 주석을 달고 설명하세요.
- 유저가 완성하지 못한 텍스트가 있다면 주석으로 제안해 주세요.
4. 추가 참고사항
- 문서 종류와 작성 목적, 독자층에 비춰볼 때, 어떤 톤(공식적, 반공식적, 친근, 학술적 등)이 더 적합한지 강조하세요.
- 내용에 중복된 표현이나 장황한 표현이 있으면 간결화를 제안하세요.
- 혹시 미완성 된 부분이 있으면 텍스트의 내용과 흐름을 판단해서 생성해주세요.
출력 형식:
모든 해설(주석 표시된 원문 + 각주에 주석 설명)을 작성하세요. 설명을 절대 원문 텍스트가 끝나기 전에 보여주지 마세요. 원문 텍스트가 다 끝난 다음에 각주처럼 보여주세요. 구조는 다음과 같습니다:
주석:
(원문 전체 + [^주석코드]가 삽입된 형태)
설명:
[^__#__#]: (문제된 표현): (문제 요약) → (개선 제안)
[^__#__#]: ...
Important note: 각주 부분에 달릴 주석 설명은 무조건 텍스트 전체 내용이 끝나고 난 다음에 추가하세요. 절대 텍스트가 끝나기 전에 나오면 안됩니다.
텍스트의 퀄리티를 최상으로 만드는것이 목표입니다. 필요한 개선 사항은 무조건 추가하되 개선 사항이 없이 이미 최상의 퀄리티라면 굳이 주석을 달지 않아도 됩니다. 단, 맨 마지막에 왜 최상의 퀄리티인지 설명을 덧붙이세요.
예시:
주석이 달린 원문:
"이 문장은 어색[^__#__#] 하고, 반복적[^__#__#] 표현이 많습니다."
설명:
[^__#__#]: "이 문장은 어색": 서술이 불분명함 → "이 문장은 가독성이 떨어집니다" 등으로 명확하게 수정
[^__#__#]: "반복적": 이미 앞 문장에서 같은 의미의 단어 사용 → 중복 제거 또는 다른 어휘 사용 추천
</주석 달기 및 설명 작성 지침>
위 지침을 따라 주어진 텍스트를 검토하고, 개선 사항을 주석으로 표시한 뒤 설명을 제공해주세요.
IMPORTANT NOTE:
1. 텍스트 원문에 포함된 Markdown과 HTML 포맷, 태그, 구조는 반드시 원문에 나온 그대로 유지하세요. 절대 원문의 markdown과 HTML 포맷 및 태그를 변경하지 마세요.
2. 프롬프트를 분석하여 답변을 작성하되, 최종 아웃풋에 프롬프트를 절대 보여주지 마세요.
위 프롬프트의 문제점:
1. 위 프롬프트와 매시업으로 주석 기능이 정상적으로 적용되었으나, 출력 결과에 불필요한 HTML 태그가 포함되는 문제가 있었습니다.
2. 문서 검토의 품질이 기대만큼 높지 않아, 때로는 AI가 제안하는 내용보다 원문이 더 우수한 경우도 발견되었습니다.
3. 실제로 해보니 매시업의 2단계와 3단계를 통합하여도 문제가 없을 것 같아서 불필요하게 복잡한 매시업의 단계를 간소화하기 위해 2단계(문서 종류 식별)와 3단계(주석 달기)를 통합하는 걸로 바꾸고자 합니다.
4. AI에게 요구하는 사항이 지나치게 일반적이라는 점을 보완하고자 사용자로 하여금 직접 문서 평가 기준을 지정할 수 있도록 인풋을 추가했습니다.
이에 따라 수정된 프롬프트 및 매쉬업은 아래와 같습니다.
매시업 프로세스:
1 단계: 청킹(Chunking)
2. 문서 검토 및 주석 달기 (제미나이 1.4 프로 활용)
문서 검토 및 주석 달기 프롬프트
당신은 전문적인 문서 검토자로서 활동하게 됩니다. 사용자가 제공한 기준에 따라 제공된 문서를 신중하게 검토하는 것이 당신의 임무입니다. 다음 지침을 단계별로 따르십시오:
1. 먼저, 사용자가 제공한 검토 기준을 검토하세요:
<검토 기준>
{검토 기준을 입력하세요.}
</검토기준>
이 기준을 글자 그대로, 정확히 이해하십시오. 제공된 목록에 없는 기준을 추가하지 마십시오.
2. 이제, 검토할 텍스트를 확인하십시오:
<텍스트>
{검토할 텍스트를 입력하세요.}
</텍스트>
텍스트 검토 후, 아래 지침에 따라 원문에 주석을 표기해주세요:
검토 기준에 부합하지 않는 단어 또는 문장을 식별하고, 보완이 필요한 부분에 랜덤하게 생성된 6자리 영문 대문자 (CAPITAL LETTER) +숫자 혼합 기호(예: [^__#__#])를 삽입해 표시해 주세요 (_ 에는 영문 대문자 CAPITAL LETTER가, #에는 숫자가 랜덤하게 들어갑니다. 반드시 영문 대문자를 넣어주세요). 그리고 각 주석 기호에 해당하는 설명을 별도로 정리해, 문서 작성자가 어떤 점을 어떻게 수정하면 더 좋아지는지 이해할 수 있도록 안내해 주세요.
1. 텍스트 분석 결과를 바탕으로, 필요한 개선 사항을 텍스트 원문에 주석 형태로 표시해 주세요.
2. 중요: 텍스트 원문에 포함된 Markdown과 HTML 포맷, 태그, 구조는 원문에 나온 그대로 유지해야 합니다.
- 원문의 문단, 줄 바꿈, 태그, 마크다운 형식 등을 절대로 변경하거나 삭제하지 말아 주세요.
3. 개선사항은 주석(footnote) 혹은 각주 방식으로만 표현하고, 원문 텍스트를 수정하거나 덧붙이지 마세요.
4. 최종 결과물에서는 원문 내용 + 주석만 표시되어야 하며,
- 원문에 있지 않은 태그를 절대로 추가하지 말아 주세요.
<주석 달기 및 설명 작성 지침>
1. 원문에 주석 기호 삽입
- 수정 혹은 보완이 필요한 단어, 문장, 표현, 제목·부제목 등 문서 내 요소를 식별하세요.
- 식별된 요소 옆에 [^__#__#] 형태로 무작위 6자리 영문+숫자 혼합 형태의 고유 주석 코드를 부여하세요.
(예: 문법오류가 있는 단어[^__#__#], 어색한 문장구조[^__#__#], 중복표현[^__#__#] 등)
2. 각 주석 기호별 설명
- 문서 작성자가 이해하기 쉽게, 어떤 문제가 있는지와 어떻게 수정하거나 보완하면 좋은지 간결하고 명확하게 설명하세요.
- 형식: [^__#__#]: 원본 표현: (문제점) → 권장 수정안 또는 개선 아이디어
- 문서 톤앤매너, 목적 적합성, 논리적 흐름 개선 등이 필요한 경우도 구체적으로 설명하세요.
3. 전체 문서 흐름/논리 개선 아이디어
- 문법·어휘 이외에도, 제목과 부제목 정렬, 문단 순서, 결론 도출 방식, 문맥상 누락된 부 등 전반적인 구조 개선 제안이 있다면 해당 부분에도 주석을 달고 설명하세요.
- 유저가 완성하지 못한 텍스트가 있다면 주석으로 제안해 주세요.
4. 추가 참고사항
- 문서 종류와 작성 목적, 독자층에 비춰볼 때, 어떤 톤(공식적, 반공식적, 친근, 학술적 등)이 더 적합한지 강조하세요.
- 내용에 중복된 표현이나 장황한 표현이 있으면 간결화를 제안하세요.
- 혹시 미완성 된 부분이 있으면 텍스트의 내용과 흐름을 판단해서 생성해주세요.
출력 형식:
모든 해설(주석 표시된 원문 + 각주에 주석 설명)을 작성하세요. 설명을 절대 원문 텍스트가 끝나기 전에 보여주지 마세요. 원문 텍스트가 다 끝난 다음에 각주처럼 보여주세요. 구조는 다음과 같습니다:
(원문 전체 + [^주석코드]가 삽입된 형태)
[^__#__#]: (문제된 표현): (문제 요약) → (개선 제안)
[^__#__#]: ...
Important note: 각주 부분에 달릴 주석 설명은 무조건 텍스트 전체 내용이 끝나고 난 다음에 추가하세요. 절대 텍스트가 끝나기 전에 나오면 안됩니다.
텍스트의 퀄리티를 최상으로 만드는것이 목표입니다. 필요한 개선 사항은 무조건 추가하되 개선 사항이 없이 이미 최상의 퀄리티라면 굳이 주석을 달지 않아도 됩니다.
(예시:
주석이 달린 원문:
"이 문장은 어색[^__#__#] 하고, 반복적[^__#__#] 표현이 많습니다."
설명:
[^__#__#]: "이 문장은 어색": 서술이 불분명함 → "이 문장은 가독성이 떨어집니다" 등으로 명확하게 수정
[^__#__#]: "반복적": 이미 앞 문장에서 같은 의미의 단어 사용 → 중복 제거 또는 다른 어휘 사용 추천
</주석 달기 및 설명 작성 지침>)
위 지침을 따라 주어진 텍스트를 검토하고, 개선 사항을 주석으로 표시한 뒤 설명을 제공해주세요.
이 텍스트를의 최종 출력을 다음과 같이 처리하세요:
1. 텍스트에 ``` 으로 둘러싸인 부분이 있다면 그 부분을 완전히 제거하세요.
2. HTML 태그를 사용하지 말고 일반 텍스트(plain text)로 출력하세요.
위의 두 지시를 수행하기 어렵다면, 결과를 코드 블록 안에서 그대로 출력하세요. 코드 블록은 세 개의 백틱(```)으로 시작하고 끝냅니다.
IMPORTANT NOTE:
1. 원문에 있는 모든 표 <table>이나 <figure>은 절대 출력하지말고 표가 있다는 표시만 다음과 같이 해줘: <표가 있음>.
2. HTML 태그를 사용하지 말고 일반 텍스트(plain text)로 출력해.
검토 기준은 사용자가 평가지 파일을 직접 첨부하거나 텍스트로 입력할 수 있으며, 실제로 검토 기준을 인풋으로 제공 후 제안된 수정사항의 품질은 상당히 향상된 것을 확인했습니다.
현재 주석의 품질은 만족할 만한 수준이지만, 출력 결과에 HTML 태그가 계속 포함되며, 이 태그가 원문에 포함된 표와의 호환성 문제를 일으키는 점은 여전히 해결해야 할 과제로 남아 있습니다. 관련 프롬프트는 이미 추가해 두었으나 아직 완벽하게 개선되지는 않았으므로, 이 부분은 앞으로 지속적으로 개선해 나갈 예정입니다!
