일괄 처리 — 한 번에 여러 작업 처리하기
일괄 처리 — 한 번에 여러 작업 처리하기 — 공식 문서 기반 이해하기 쉬운 가이드
한 번에 수천 개의 이메일에 하나씩 답장하는 대신, 모든 답변을 작성하고 모든 결정을 기록하고 끝나면 깔끔한 보고서를 건네주는 지칠 줄 모르는 비서에게 받은 편지함 전체를 맡길 수 있다면 얼마나 좋을까요? Hermes Agent의 배치 처리는 바로 그런 일을 해줍니다.
어떤 기능인가요?
배치 처리를 사용하면 수백, 수천 개의 질문을 한 번에 Hermes Agent에 던질 수 있습니다. 에이전트는 각 항목을 새로운 세션에서 처리하며, 필요할 때 검색이나 계산기 같은 도구를 사용하고, 모든 과정(모든 생각, 모든 도구 호출, 모든 최종 답변)을 자동으로 기록합니다. 마치 공장 바닥에 작업 지시서 더미를 보내고 각 작업이 어떻게 처리되었는지에 대한 상세한 로그를 받는 것과 같습니다.
핵심 아이디어
- 입력:
.jsonl파일 — 각 줄은 프롬프트나 지시사항을 포함하는 하나의 JSON 객체입니다. - 처리: 각 프롬프트는 별도의 AI 세션을 시작합니다. 에이전트는 일반 대화에서처럼 문제를 해결하기 위해 도구를 호출할 수 있습니다.
- 출력: 에이전트의 추론 단계, 도구 사용, 최종 응답 및 유용한 통계(예: 작업당 호출된 도구 수)를 담은 구조화된 “궤적(trajectory)” 파일입니다.
시작하는 세 가지 단계
1단계: 질문 준비하기
각 줄이 하나의 질문인 .jsonl 파일을 만듭니다. 예를 들어:
{"prompt": "25 * 4를 계산해줘"}
{"prompt": "가을에 대한 짧은 시를 써줘"}
{"prompt": "양자 컴퓨팅의 기초를 요약해줘"}
추가 쉼표나 대괄호가 없는지 확인하세요. 각 줄은 그 자체로 유효한 JSON 객체여야 합니다.
2단계: 배치 명령 실행하기
터미널을 열고 다음을 실행합니다:
python batch_runner.py --input my_questions.jsonl --output results.jsonl
끝입니다. Hermes가 파일의 모든 줄을 자동으로 처리합니다.
3단계: 결과 확인하기
완료되면 results.jsonl 파일이 생성됩니다. 각 줄은 원래 프롬프트 중 하나에 해당하며 다음을 포함합니다:
- 전체 대화 기록
- 모든 도구 호출에 대한 세부 정보 (어떤 도구, 무엇을 반환했는지)
- 추론 단계 적용 범위 및 도구 사용 빈도와 같은 통계
왜 유용한가요?
- 시간 절약: 더 이상 작업을 하나씩 실행할 필요가 없습니다. 한 번에 100개든 1000개든 실행하세요.
- 데이터 금광 구축: 출력은 AI 모델을 미세 조정하거나 에이전트 성능을 평가하는 데 완벽합니다.
- 재현 가능성: 모든 실행은 완전한 기록을 남기므로 다양한 구성을 비교하고 시간이 지남에 따라 개선할 수 있습니다.
실용적인 팁
작게 시작하세요. 출력 형식이 예상과 일치하는지 확인하기 위해 10개의 질문으로 테스트 배치를 실행해 보세요. 그런 다음 1000개로 확장하세요. 문제가 발생하면 오류 로그를 확인하세요. 거의 항상 입력 파일의 형식 문제입니다.
마무리
배치 처리는 반복적인 작업을 단일 명령으로 바꾸고, 원시 결과를 가치 있는 데이터로 변환합니다. 맞춤형 AI를 훈련시키든 대규모로 에이전트를 스트레스 테스트하든, 이 기능은 몇 시간을 절약해 줍니다. 다음에 처리할 작업이 산더미처럼 쌓여 있어도 걱정하지 마세요. 그냥 배치로 처리하면 됩니다.
📖 공식 문서
この記事は Hermes Agent の공식 문서に基づいています:공식 문서 › user-guide/features/overview