Hermes 에이전트의 지능을 높이는 플래닝 및 소스 확인 팁

이미지 출처: https://hermes-agent.nousresearch.com/docs

X(트위터)의 AI 자동화 전문가 @EXM7777이 Hermes 에이전트의 수행 능력을 극대화할 수 있는 실전 프롬프트 엔지니어링 팁을 공유했습니다. 단순히 작업을 지시하는 방식에서 벗어나, 에이전트가 실행 전에 작업 경로를 스스로 설계하고 로컬 시스템의 실제 소스를 먼저 조회하도록 규칙을 부여함으로써 실행 오류와 추측을 획기적으로 줄이는 방법입니다.

복잡한 시스템 운영, 코드 리팩토링, 다단계 자동화 업무에서 에이전트가 겪는 대표적인 문제는 '불완전한 전제 조건에서의 섣부른 실행'과 '기억(학습 데이터)에 의존한 잘못된 상태 추론'입니다. 이번에 공개된 프롬프트 가이드는 이러한 문제를 원천 차단하기 위해 플래닝과 소스 확인이라는 두 가지 핵심 규율을 에이전트에게 강제합니다.

1. 실행 전 플래닝과 전제 조건 검증의 의무화

사소하지 않은(Non-trivial) 모든 작업에 대해, 에이전트가 첫 번째 액션을 실행하기 전 반드시 정형화된 계획을 먼저 출력하도록 시스템 프롬프트를 구성해야 합니다. 이 계획은 네 가지 핵심 구성 요소를 포함해야 합니다.

• 목표(Goal): 수행하려는 작업의 최종 결과물과 의도에 대한 명확한 정의
• 단계(Steps): 목표에 도달하기 위해 거쳐야 하는 구체적이고 순차적인 실행 절차
• 필요 요소(Needs): 각 단계별로 요구되는 도구, 파일 경로, API, 인증 토큰 등의 리소스
• 완료 조건(Definition of Done): 작업이 완벽하게 완료되었음을 검증할 수 있는 객관적인 기준

계획 수립과 더불어 가장 중요한 것은 '사전 검증(Prerequisites Check)'입니다. 에이전트가 실제 행동을 개시하기 전에 필요한 API 키가 정상적으로 로드되는지, 대상 디렉토리와 파일이 유효한 절대 경로로 존재하는지, 모델 ID에 올바른 벤더 접두사(vendor prefix)가 붙어 있는지, 작업 디렉토리가 의도한 위치와 정확히 일치하는지 점검해야 합니다. 만약 이 중 하나라도 충족되지 않는다면 에이전트는 작업을 임의로 강행해서는 안 되며, 누락된 항목을 명시하고 '차단됨(Blocked)' 상태를 즉시 보고해야 합니다.

2. 소스 우선 조회(Source-First Lookup) 원칙의 적용

에이전트가 시스템 설정을 다루거나 프로젝트 구조를 파악할 때 모델 내부의 메모리나 추측에 의존하지 않도록 '소스 우선 조회' 원칙을 엄격하게 적용해야 합니다.

• 실제 파일 직접 읽기: 설정값은 설정 파일(config)에서 직접 읽어오며, 프로젝트 규칙은 런타임에 실제로 로드되는 규칙 파일(상위 우선순위 파일에 의해 덮어씌워지지 않았는지 확인 포함)을 직접 확인해야 합니다.
• 실시간 라이브 시스템 상태 확인: 시스템 구성이나 현재 상태에 대한 질의가 들어왔을 때, 과거 기억이나 일반적인 지식으로 답하지 않고 관련 파일이나 CLI 명령어를 통해 라이브 상태를 실측한 후 답변하도록 강제합니다.

이러한 규율을 적용하면 에이전트가 존재하지 않는 경로를 조작하거나, 오래된 환경 변수 값을 참조하여 발생하는 파괴적인 실수를 사전에 차단할 수 있습니다. Hermes 에이전트를 시스템 프롬프트 레벨에서 제어할 때 이 두 가지 규칙을 최상단에 배치하면 고난도 엔지니어링 작업에서도 안정적인 성능을 확보할 수 있습니다.

원문 출처

• @EXM7777 X 포스트