AI 도구 · 2026년 7월 7일 · 약 7분

Tencent Hunyuan Hy3 사용법, 오픈 가중치 에이전트 모델을 업무에 테스트하는 방법

Tencent가 Hunyuan Hy3를 Apache 2.0 라이선스의 오픈 가중치 모델로 공개했다. 벤치마크를 그대로 믿기보다 코딩, 문서, 에이전트 업무에서 안전하게 비교 테스트하는 방법을 정리했다.

• Tencent Hunyuan Hy3
• Hy3 사용법
• 오픈 가중치 모델
• AI 에이전트
• vLLM

출처: Tencent Hy

Tencent Hunyuan 팀이 2026년 7월 6일 Hy3를 공개했습니다. Hy3는 295B 전체 파라미터 중 21B를 활성화하는 MoE 모델이며, 256K 컨텍스트를 지원한다고 공식 글과 Hugging Face 모델 카드가 설명합니다. 모델 가중치는 Hugging Face, GitHub, ModelScope 등에 공개됐고 라이선스는 Apache 2.0입니다.

이번 이슈가 흥미로운 이유는 단순한 새 모델 발표가 아니라 “오픈 가중치 모델을 에이전트 업무에 어디까지 쓸 수 있나”라는 질문과 맞닿아 있기 때문입니다. Tencent는 Hy3가 코딩, 사무 업무, 금융 모델링, 프론트엔드, 게임 개발 같은 생산성 작업에서 개선됐다고 주장합니다. X에서도 공식 Hunyuan 계정의 발표가 16만 회 이상 조회되고, 개발자들이 비용과 에이전트 성능을 비교하는 글을 빠르게 올리고 있습니다.

핵심 키워드

• Tencent Hunyuan Hy3
• Hy3 사용법
• 오픈 가중치 AI 모델
• AI 에이전트 모델
• vLLM Hy3
• SGLang Hy3

Hy3는 “작은 모델”이 아니라 활성 파라미터가 적은 MoE 모델이다

Hy3를 볼 때 가장 많이 오해하기 쉬운 부분은 크기입니다. 전체 파라미터는 295B로 작지 않습니다. 다만 MoE 구조라 요청마다 모든 전문가를 다 쓰지 않고 일부만 활성화합니다. 공식 모델 카드 기준으로 활성 파라미터는 21B이고, MTP 레이어 파라미터는 3.8B입니다. 그래서 핵심은 “내 장비에서 쉽게 돈다”가 아니라 “큰 모델급 작업을 더 효율적으로 처리할 수 있는가”입니다.

벤치마크는 출발점이고, 내 업무 테스트가 결론이다

Tencent는 Hy3가 비슷한 크기의 모델을 앞서고, 파라미터가 2~5배 큰 오픈소스 플래그십 모델과 경쟁한다고 설명합니다. 또 270명 전문가의 블라인드 평가에서 Hy3가 2.67/4점을 받아 GLM-5.1의 2.51/4점을 앞섰고, 프론트엔드 개발, 데이터와 스토리지, CI/CD 작업에서 차이가 컸다고 밝혔습니다.

다만 이런 수치는 제품 도입 결론이 아니라 테스트할 이유입니다. 같은 모델도 프롬프트, 도구 호출 구조, 파일 크기, 한국어 입력, 비용 제한에 따라 결과가 달라집니다. 특히 Tencent가 밝힌 환각률 12.5%에서 5.4%로의 개선도 내부 평가 기준입니다. 업무에 넣기 전에는 우리 문서, 우리 코드, 우리 고객 질문으로 다시 확인해야 합니다.

먼저 테스트할 업무

• 코딩: 버그 리포트 5개를 주고 원인 후보, 수정 범위, 테스트 명령을 나누게 한다.
• 문서: 긴 PDF나 회의록을 넣고 결정 사항, 근거, 확인 필요 항목을 분리하게 한다.
• 프론트엔드: 기존 디자인 규칙을 주고 한 화면을 구현하게 한 뒤 수정 횟수를 기록한다.
• 에이전트: 도구 호출이 필요한 작업에서 JSON 형식, 실패 복구, 중단 기준을 확인한다.
• 비용: 같은 입력을 기존 모델과 Hy3에 넣고 토큰 수, 재시도 횟수, 사람이 고친 시간을 비교한다.

초보자는 API 체험과 로컬 배포를 구분해야 한다

Hy3가 오픈 가중치라고 해서 개인 노트북에서 바로 돌릴 수 있다는 뜻은 아닙니다. Hugging Face 모델 카드는 Hy3 서빙에 H20-3e 같은 대용량 메모리 GPU 8장 또는 그에 준하는 장비를 권장합니다. 처음에는 OpenRouter 같은 API 체험 경로, 회사 내부 테스트 서버, 클라우드 GPU 환경을 나눠 생각하는 편이 현실적입니다.

복사해서 쓰는 Hy3 평가 프롬프트

아래 템플릿은 Hy3를 기존 ChatGPT, Claude, Gemini, GLM, DeepSeek와 비교할 때 쓸 수 있습니다. 핵심은 모델에게 좋은 말만 듣는 것이 아니라, 실패와 확인 필요 항목을 강제로 남기게 하는 것입니다.

Hy3 업무 비교 템플릿

• 목표: [코딩 리뷰 / 문서 요약 / 프론트엔드 구현 / 고객 답변] 업무에서 이 모델이 실무에 쓸 만한지 평가한다.
• 입력 자료: 아래 자료만 근거로 삼고, 자료에 없는 내용은 추측하지 말고 “확인 필요”로 표시한다.
• 출력 형식: 결과 요약, 근거, 사람이 확인할 항목, 실패 가능성, 다음 테스트를 표로 작성한다.
• 제약: JSON, 코드, 날짜, 숫자, 링크는 입력과 다르면 안 된다. 확신이 낮으면 낮다고 말한다.
• 비교 기준: 정확성, 재현성, 도구 호출 안정성, 토큰 사용량, 사람이 고친 시간을 각각 1~5점으로 평가한다.

첫날 테스트는 30분이면 충분하다

처음부터 전체 업무를 옮기지 마세요. Hy3가 강하다는 영역 하나를 고르고, 기존에 사람이 이미 정답을 아는 샘플 3~5개로 비교하면 됩니다. 모델 발표 글의 벤치마크보다 중요한 것은 우리 팀이 매주 반복하는 실제 업무에서 오류가 줄고 시간이 줄어드는지입니다.

30분 테스트 순서

• 이미 정답을 아는 업무 샘플 3개를 고른다.
• 같은 프롬프트를 기존 주력 모델과 Hy3에 넣는다.
• 정답률, 누락, 지어낸 내용, 형식 오류를 표로 비교한다.
• 도구 호출이나 코드 생성이 있으면 실패 로그와 재시도 횟수를 기록한다.
• 좋은 결과가 나온 샘플만 보지 말고, 가장 나쁜 결과 하나를 골라 원인을 적는다.

오늘 가져갈 판단 기준

Hy3의 의미는 “모든 팀이 당장 모델을 바꾸자”가 아닙니다. 오픈 가중치 모델이 코딩, 긴 문서, 에이전트 업무에서 점점 실사용 후보가 되고 있다는 신호입니다. 지금 할 일은 발표 수치를 외우는 것이 아니라, 내 업무에서 모델 교체가 품질과 비용을 동시에 줄이는지 작은 평가표로 확인하는 것입니다.