Hermes Agent는 Open WebUI에 연결한 후 파일 업로드에 응답하지 않으니, 프론트엔드를 먼저 버리지 마세요. 공식 API 서버 문서는 매우 직설적으로 작성되어 있습니다: 현재 API를 통한 파일 업로드는 지원되지 않습니다. 즉, 프론트엔드에 업로드 버튼이 있더라도, Hermes Agent 백엔드는 업로드된 문서나 이미지를 API 파일 입력으로 처리할 수 없습니다.
이게 무슨 뜻일까요?
문서 분석, 이미지 이해, 첨부 Q&A를 하고 싶다면, 가장 신뢰할 수 있는 방법은 Open WebUI를 계속 변경하는 것이 아니라 경로를 바꾸는 것입니다:
- 파일을 Hermes 에이전트가 접근할 수 있는 로컬 디렉터리에 넣고, 파일/터미널 도구를 사용해 읽게 하세요.
- 또는 CLI / 게이트웨이 시나리오를 사용하고, 플랫폼의 네이티브 연결 기능을 이용해 세션에 진입할 수도 있습니다.
- 또는 파일 내용을 텍스트로 추출한 후 API를 통해 문자 메시지를 보낼 수도 있습니다.
문제가 되지 않는 때가
Telegram, Discord, Slack, Email 등 게이트웨이에 첨부파일을 업로드한다면, Hermes 자체가 고장 난 것이 아니며, 제한은 API 서버 수준에만 존재한다는 뜻입니다. "게이트웨이 지원 파일"과 "OpenAI 호환 API 지원 파일"을 같은 것으로 생각하지 마세요.
이 질문에 대한 답은 사실 매우 간단합니다: Open WebUI가 맞지 않는 것이 아니라, Hermes Agent API 서버가 아직 파일을 업로드하지 않았기 때문입니다. 단기적으로는 로컬 파일 경로나 텍스트 추출로 가는 것이 프론트엔드 업로드 버튼을 계속 자르는 것보다 시간을 절약할 수 있습니다.
공식 오픈 소스 주소: https://github.com/NousResearch/hermes-agent; 공식 문서 기록: https://hermes-agent.nousresearch.com/.
