Hermes 에이전트 웹훅이 이벤트를 받지 못하면, 먼저 외부 서비스가 콜백 주소에 접근할 수 있는지 확인한 후 서명, 경로, 포트, 게이트웨이 로그를 확인하세요. 웹훅 문제 에이전트의 지능을 먼저 의심하지 마세요. 첫 번째 단계는 보통 HTTP 요청이 Hermes에 도달하지 못하는 것입니다.
요청이 먼저 들어오지 않는지 확인하세요
hermes logs 또는 게이트웨이 로그를 사용해 요청 로그가 있는지 확인하세요. 없다면 문제가 도메인, 포트, 방화벽, 리버스 프록시, 인트라넷 침투 경로임을 표시하세요. 먼저 Hermes가 노출한 웹훅 엔드포인트에 외부 플랫폼에 접근 권한을 부여해야 합니다.
플랫폼 설정을 다시 확인해 보세요
- 콜백 URL이 프로토콜, 경로, 포트 등 완전히 작성되었는지 여부.
- 플랫폼이 HTTPS를 요구하는지, 그리고 인증서가 유효한지 여부.
- 서명 비밀이 헤르메스 구성과 일치하는지 여부.
- 이벤트 유형이 확인되는지, 예를 들어 푸시, 이슈, 댓글, 릴리스 등이 있습니다.
요청을 받았는데 아무런 조치가 없을 때 어떻게 해야 하나요
로그에서 요청을 볼 수 있지만 Hermes가 답장을 하거나 작업을 트리거하지 않는다면, 구독 규칙, 대상 플랫폼, 대상 세션, 권한 등을 확인하세요. 웹훅은 단지 '웨이크업' 입구일 뿐이며, 어떤 에이전트, 어떤 세션, 어떤 도구에 이벤트를 처리할지 알아야 합니다.
Hermes가 "수신됨"만 답장하도록 테스트 페이로드를 보내는 등 최소한의 이벤트로 테스트하는 것이 권장됩니다. 링크가 열려 있는지 확인한 후 복잡한 자동화를 수행하게 하세요. 이렇게 하면 네트워크 문제, 서명 문제, 에이전트 로직 문제를 분리할 수 있습니다.
