에이전트 하네스 구조 3편: Python으로 직접 만드는 블로그 자동화 하네스

작성자:

앞선 두 편의 이론과 진단 편을 거치면서 에이전트 하네스 구조가 가진 비즈니스적 가치와 설계 시 주의해야 할 실패 요인에 대해 충분히 깊은 깨달음을 얻었으리라 확신한다. 소프트웨어 엔지니어링의 세계에서 백문은 불여일견이며 직접 타이핑하며 작동하는 코드를 보는 것이 가장 빠른 학습법이다.
이번 3편에서는 실제 현업 마케팅 현장에서 가장 폭발적인 수요를 자랑하는 ‘SEO 최적화 마케팅 블로그 자동 작성’을 무대로 삼아, 파이썬(Python) 언어를 활용해 절대로 규칙이 뚫리지 않는 굳건한 하네스 통제 시스템을 직접 빌드하는 실전 과정을 온전히 다루고자 한다.

네이티브 지능은 조금 떨어지지만 단가가 압도적으로 저렴한 가성비 중소형 오픈소스 모델을 메인 텍스트 생성 엔진으로 자리에 앉혀두고, 하네스 파이프라인의 핵심 코드를 가감 없이 공개 시도를 해본다.

1. 실전 블로그 자동화 하네스 에이전트의 전체 파이썬 소스 코드

아래에 제공되는 프로그램은 메인 모델이 작성해 낸 블로그 콘텐츠를 파이썬 소스 코드 기반의 정량적 하네스와 LLM 기반의 정성적 하네스가 2중으로 겹겹이 쳐진 바리케이드에서 철저히 검수하고, 조건에 미달하면 피드백을 동반하여 최대 3회까지 백그라운드에서 자동 재시도(Retry)하는 구조를 완벽하게 구현한 프로덕션 레벨의 파이썬 스크립트이다.

import os
import openai # 가성비 모델의 API 호출을 위한 기본 라이브러리 연동 적용했음

API 통신을 위한 인증 키 세팅 및 환경 변수 선언 작업을 수행했음

openai.api_key = os.getenv(“RUN_AI_API_KEY”, “your-cost-effective-model-key”)

def call_cheap_llm(prompt_content):
“””Kimi, Hermes 등 가성비 모델의 API 엔드포인트를 호출하는 추상화 함수”””
try:
response = openai.ChatCompletion.create(
model=”hermes-3-open-llama-70b”,
messages=[{“role”: “user”, “content”: prompt_content}],
temperature=0.5
)
return response.choices[0].message.content
except Exception as e:
return f”통신 에러가 발생했음: {str(e)}”

def blog_harness_validator(post_content, main_keyword):
“””
[핵심 하네스 제어 모듈]
메인 모델이 작성한 본문을 전달받아 코드와 LLM을 조합하여 규칙을 상호 검증함.
“””
# ————————————————————-
# 레이어 1: 파이썬 코드를 활용한 정량적 하네스 검증 (Rule-based)
# ————————————————————-

# 규칙 1: 1,700단어 이상인지 엄격히 검사
words = post_content.split()
word_count = len(words)
if word_count < 1700:
    return False, f"단어 수 부족 결함 판정 (현재 {word_count}단어 / 기준 1,700단어 미달했음)"

# 규칙 2: 제목 및 서두 본문 맨 앞에 주요 SEO 키워드가 배치되었는지 검사
intro_text = post_content[:300]
if main_keyword not in intro_text:
    return False, f"SEO 키워드 배치 오류 (서두 본문 300자 이내에 '{main_keyword}'가 누락되었음)"

# 규칙 3: 블로그 태그 규칙 검사 (샵 # 기호는 전면 제외하고 오직 쉼표로만 구분해야 함)
if "태그" in post_content:
    tag_section = post_content.split("태그")[-1]
    if "#" in tag_section:
        return False, "태그 포맷 위반 결함 (태그 영역에 금지된 # 기호가 검출되었음)"

# -------------------------------------------------------------
# 레이어 2: 지능형 LLM을 활용한 정성적 하네스 검증 (LLM-based Critic)
# -------------------------------------------------------------
critic_prompt = f"""
너는 오직 규칙 준수 여부만 냉정하게 판정하는 검수 전담 하네스 엔진이다.
다음 제공된 블로그 본문이 아래 2가지 톤앤매너 조건을 완벽하게 충족하는지 검사하라.

[준수 가이드라인]
1. 모든 문장의 끝맺음은 반드시 담담하고 객관적인 어조('~이다', '~한다', '~라는 것이다')로 끝나야 한다. (~습니다, ~요 절대 금지)
2. 본문 속에 등장하는 모든 예시나 참조 설명 문장의 끝은 반드시 '~했음'의 약어 형태로 마무리되어야 한다.

위 규칙 중 단 하나라도 위반한 문장이 발견되면 즉시 '결함: [원인 이유]'라고만 답변하라.
모든 규칙을 완벽하게 통과하여 결점이 없다면 오직 '패스'라고만 답변하라.

[검사 대상 블로그 콘텐츠]
{post_content}
"""

critic_result = call_cheap_llm(critic_prompt)

if "결함" in critic_result:
    return False, f"톤앤매너 규격 검증 실패 ({critic_result.strip()})"

return True, "모든 하네스 검문소 최종 통과"

def execute_harness_agent_pipeline(target_seo_keyword):
“””하네스의 피드백 루프를 무한 제어하는 메인 실행 파이프라인 함수”””

# 12가지 규칙을 녹여낸 최초 프롬프트 빌드 작업을 실행했음
generation_prompt = f"""
주요 SEO 키워드인 '{target_seo_keyword}'로 문장을 시작하는 SEO 친화적인 제목을 정하고 마케팅 블로그를 작성하라.
너는 반드시 하단에 명시된 규칙을 단 하나도 누락 없이 완벽히 지켜야만 한다.
- 글의 구조는 시작, 중간, 끝이 논리적으로 명확하게 구분되도록 작성할 것.
- 풍부하고 자세한 아날로그적 예시 설명을 포함하여 1,700개 이상의 단어를 사용하여 장문으로 채울 것.
- 일반 문장의 톤은 무조건 ~이다, ~한다, ~라는 것이다 로 일관되게 끝맺을 것.
- 구체적인 예시 또는 참조 문장을 서술할 때는 문장 끝에 반드시 ~했음의 약어를 적용할 것.
- 블로그는 WordPress 환경에 호환되는 H1, H2, H3, H4 태그 구조를 문장 전에 정확히 지정할 것.
- 주요 SEO 키워드를 H2 제목 영역에 적절하게 섞어 배치할 것.
- 본문 최하단에 쉼표로만 구분된 블로그 태그 5개(# 제외)와 좋은 SEO를 보장하는 쉼표 구분 SEO 키워드 4-5개를 전달할 것.
- 스니펫 작업을 위해 제목 최대 60자, 퍼말링크 최대 75자, 설명 최대 160자를 본문 끝에 규격에 맞춰 전달할 것.
"""

max_attempts = 3
for attempt in range(max_attempts):
    print(f"▶ [{attempt + 1}회차 생성 프로세스] 가성비 모델이 텍스트 생성을 수행 중입니다.")
    raw_blog_post = call_cheap_llm(generation_prompt)

    # 엄격한 하네스 검문소 레이어로 진입
    is_passed, feedback_message = blog_harness_validator(raw_blog_post, target_seo_keyword)

    if is_passed:
        print("🎉 성공: 하네스의 모든 규격 검증을 완벽히 통과한 마스터피스 산출물입니다.")
        return raw_blog_post
    else:
        print(f"❌ 탈락: 하네스 검증 레이어에서 결함 발견. 사유: {feedback_message}")
        # 탈락 사유 피드백을 기존 프롬프트에 엮어서 재지시 컨텍스트를 업데이트 수행했음
        generation_prompt = f"""
        너가 방금 전 제출한 콘텐츠는 하네스 제어 시스템에 의해 규격 미달로 전면 반려되었다.
        하네스가 지적한 결함 사유는 다음과 같다: {feedback_message}

        지적된 결함 부분을 집중적으로 수정하고, 나머지 12가지 블로그 작성 원칙도 철저히 유지하면서 처음부터 다시 완성된 글로 온전하게 작성하여 제출하라.
        """

return "🚨 [최종 시스템 실패] 3회 연속 시도했으나 하네스의 엄격한 통제 기준을 만족하지 못했습니다."

if name == “main“:
# 실제 에이전트 파이프라인 작동 테스트를 개시했음
final_sanctified_post = execute_harness_agent_pipeline(“에이전트 하네스 구조”)
print(“\n[하네스 최종 통과 산출물]\n”, final_sanctified_post)

2. 구현된 실전 소스 코드 속 하네스 핵심 장치 분석

파이썬 실전 코드 내부에는 값비싼 상용 모델에 대한 금전적 의존성을 완벽하게 지워버리면서도 대기업 서비스 수준의 품질을 보장하기 위한 세 가지 핵심 아키텍처 장치가 긴밀하게 작동하고 있다.

ㄱ. 완벽히 격리된 외부 검증 레이어

많은 이들이 범하는 가장 큰 실수는 글을 쓰는 LLM의 단일 프롬프트 안에다가 “너가 쓴 글을 너가 스스로 잘 검사해봐”라고 텍스트로 적어두는 방식이다. 그것은 하네스가 아니라 단순한 프롬프트 엔지니어링에 불과하다. 위 코드처럼 아예 blog_harness_validator라는 물리적으로 분리된 파이썬 함수를 만들어 LLM의 통제권을 완전히 빼앗은 상태로 외부 공간에서 칼날을 들이대야 그것이 진짜 하네스 구조이다.

ㄴ. 피드백 루프 체인 구조

하네스가 결함을 발견했을 때 단순히 프로그램 실행을 에러로 종료시키는 무책임한 방식을 취하지 않는다. 탈락하게 된 명확한 사유(feedback_message)를 코드가 가공하여 모델의 다음 라운드 입력값으로 다시 주입하는 선순환 피드백 체인을 구축했음. 이 구조 덕분에 가성비 모델의 만성적인 질병인 ‘장문 작성 시 지침 누락’ 현상이 라운드를 거듭할수록 완벽하게 보완 및 치유된다.

ㄷ. 이진분류 판정의 엄격성

검증을 담당하는 서브 LLM(critic_prompt)에게 이 글의 소감이 어떤지 묻지 않고, 오직 규칙 위반 시 ‘결함’, 통과 시 ‘패스’라는 극단적인 단어 체계만 뱉도록 가두어 두었음. 검증 모델이 혼자 감상평을 늘어놓으며 하네스 시스템 자체가 먹통이 되는 버그 현상을 코드로 원천 차단한 고도의 설계 기법이다.

이와 같이 파이썬이 가진 논리적 통제력과 LLM이 가진 텍스트 맥락 이해 능력을 하네스라는 하나의 용광로 속에서 유기적으로 결합하면,
그 어떤 오픈소스 모델을 현장에 가져다 놓아도 훌륭한 비즈니스 성과를 내는 고품질 업무 자동화 에이전트를 완성할 수 있다. 이어지는 시리즈의 마지막 4편에서는 이 단일 하네스 체인을 넘어, 대규모 비즈니스를 처리하기 위해 복잡한 다수의 에이전트와 하네스들이 그물망처럼 엮여 구동되는 ‘멀티 에이전트 시스템과 하네스의 미래’에 대해 장엄하게 조망해 보도록 한다.

댓글 남기기