import{s as Ml,o as Ul,n as Ne}from"../chunks/scheduler.6062bdaf.js";import{S as yl,i as cl,g as p,s as a,r as y,A as hl,h as i,f as t,c as n,j as il,u as c,x as U,k as Ge,y as rl,a as s,v as h,d as r,t as d,w}from"../chunks/index.4bca734e.js";import{T as He}from"../chunks/Tip.b9ac1f03.js";import{C as te}from"../chunks/CodeBlock.fa01571c.js";import{H as ee,E as dl}from"../chunks/EditOnGithub.74ab2baa.js";function wl(J){let o,C=`웹훅 서버의 실행 예시를 보려면 <a href="https://huggingface.co/spaces/spaces-ci-bot/webhook" rel="nofollow">Spaces CI Bot</a>을 확인하세요.
이것은 Space의 PR이 열릴 때마다 임시 환경을 실행하는 Space입니다.`;return{c(){o=p("p"),o.innerHTML=C},l(M){o=i(M,"P",{"data-svelte-h":!0}),U(o)!=="svelte-x9rigv"&&(o.innerHTML=C)},m(M,m){s(M,o,m)},p:Ne,d(M){M&&t(o)}}}function Cl(J){let o,C=`이것은 <a href="../package_reference/environment_variables#hfhubdisableexperimentalwarning">실험적 기능</a>입니다.
본 API는 현재 개선 작업 중이며, 향후 사전 통지 없이 주요 변경 사항이 도입될 수 있습니다.
requirements에서 <code>huggingface_hub</code>의 버전을 고정하는 것을 권장합니다.`;return{c(){o=p("p"),o.innerHTML=C},l(M){o=i(M,"P",{"data-svelte-h":!0}),U(o)!=="svelte-10q23mi"&&(o.innerHTML=C)},m(M,m){s(M,o,m)},p:Ne,d(M){M&&t(o)}}}function ml(J){let o,C=`기본적으로 서버는 스크립트 끝에서 시작됩니다.
주피터 노트북에서 실행 중이라면 <code>decorated_function.run()</code>을 호출하여 서버를 수동으로 시작할 수 있습니다.
고유한 서버를 사용하기 때문에 여러 엔드포인트가 있더라도 서버를 한 번만 시작하면 됩니다.`;return{c(){o=p("p"),o.innerHTML=C},l(M){o=i(M,"P",{"data-svelte-h":!0}),U(o)!=="svelte-j9jjbb"&&(o.innerHTML=C)},m(M,m){s(M,o,m)},p:Ne,d(M){M&&t(o)}}}function Jl(J){let o,C,M,m,V,se,u,Ee=`웹훅은 MLOps 관련 기능의 기반이 됩니다. 이를 통해 특정 저장소의 새로운 변경 사항을 수신하거나,
관심 있는 특정 사용자/조직에 속한 모든 저장소의 변경 사항을 받아볼 수 있습니다.
이 가이드에서는 <code>huggingface_hub</code>를 활용하여 웹훅을 수신하는 서버를 만들고 Space에 배포하는 방법을 설명합니다.
이를 위해서는 Huggingface Hub의 웹훅 개념에 대해 익숙해야 합니다.
웹훅 자체에 대해 더 자세히 알아보려면 이 <a href="https://huggingface.co/docs/hub/webhooks" rel="nofollow">가이드</a>를 먼저 읽어보세요.`,ae,g,_e=`이 가이드에서 사용할 기본 클래스는 <code>WebhooksServer()</code>입니다.
이 클래스는 Huggingface Hub에서 웹훅을 받을 수 있는 서버를 쉽게 구성할 수 있습니다. 서버는 <a href="https://gradio.app/" rel="nofollow">Gradio</a> 앱을 기반으로 합니다.
이 서버에는 사용자를 위한 지침을 표시하는 UI와 웹훅을 수신하는 API가 있습니다.`,ne,f,oe,j,pe,Q,ie,k,Ye=`웹훅 엔드포인트를 구현하는 것은 함수에 데코레이터를 추가하는 것만큼 간단합니다.
주요 개념을 설명하기 위해 첫 번째 예시를 살펴보겠습니다:`,Me,$,Ue,S,Oe="이 코드 스니펫을 <code>&#39;app.py&#39;</code>라는 파일에 저장하고 <code>&#39;python app.py&#39;</code>로 실행하면 다음과 같은 메시지가 표시될 것입니다:",ye,I,ce,v,Le="축하합니다! 웹훅 서버를 실행했습니다! 정확히 어떤 일이 일어났는지 살펴보겠습니다:",he,F,Ae=`<li><code>webhook_endpoint()</code>로 함수에 데코레이터를 추가하면 백그라운드에서 <code>WebhooksServer()</code> 객체가 생성됩니다.
볼 수 있듯이 이 서버는 <a href="http://127.0.0.1:7860" rel="nofollow">http://127.0.0.1:7860</a> 에서 실행되는 Gradio 앱입니다.
이 URL을 브라우저에서 열면 등록된 웹훅에 대한 지침이 있는 랜딩 페이지를 볼 수 있습니다.</li> <li>Gradio 앱은 내부적으로 FastAPI 서버입니다. 새로운 POST 경로 <code>/webhooks/trigger_training</code>이 추가되었습니다.
이 경로는 웹훅을 수신하고 트리거될 때 <code>trigger_training</code> 함수를 실행합니다.
FastAPI는 자동으로 페이로드를 구문 분석하고 <code>WebhookPayload</code> 객체로 함수에 전달합니다.
이 <code>pydantic</code> 객체에는 웹훅을 트리거한 이벤트에 대한 모든 정보가 포함되어 있습니다.</li> <li>Gradio 앱은 인터넷에서 요청을 받을 수 있는 터널도 열었습니다.
이것은 흥미로운 부분으로, <a href="https://huggingface.co/settings/webhooks" rel="nofollow">https://huggingface.co/settings/webhooks</a> 에서 로컬 머신을 가리키는 웹훅을 구성할 수 있습니다.
이를 통해 웹훅 서버를 디버깅하고 Space에 배포하기 전에 빠르게 반복할 수 있습니다.</li> <li>마지막으로 로그에는 서버가 현재 비밀로 보호되지 않는다고 알려줍니다.
이것은 로컬 디버깅에는 문제가 되지 않지만 나중에 고려해야 할 사항입니다.</li>`,re,b,de,Z,we,B,Xe=`웹훅 서버를 실행하고 있으므로, 이제 메시지를 수신하기 위해 웹훅을 구성해야 합니다.
<a href="https://huggingface.co/settings/webhooks" rel="nofollow">https://huggingface.co/settings/webhooks</a> 로 이동하여 “Add a new webhook”을 클릭하고 웹훅을 구성하세요.
모니터링할 대상 저장소와 웹훅 URL <code>https://1fadb0f52d8bf825fc.gradio.live/webhooks/trigger_training</code>을 설정하세요.`,Ce,T,xe='<img src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/configure_webhook.png"/>',me,R,ze=`이걸로 끝입니다! 이제 대상 저장소를 업데이트하면 웹훅을 트리거할 수 있습니다. 예를 들면, 커밋 푸시가 그 방법이 될 수 있습니다.
웹훅의 Activity 탭에서 트리거된 이벤트를 확인할 수 있습니다. 이제 작동하는 구성이 있으므로 테스트하고 빠르게 반복할 수 있습니다.
코드를 수정하고 서버를 다시 시작하면 공개 URL이 변경될 수 있습니다.
필요한 경우 Hub에서 웹훅 구성을 업데이트하세요.`,Je,W,fe,G,Pe=`이제 작동하는 웹훅 서버가 마련되었으므로, 다음 목표는 이를 Space에 배포하는 것입니다. <a href="https://huggingface.co/new-space" rel="nofollow">https://huggingface.co/new-space</a> 에 가서 Space를 생성합니다.
이름을 지정하고, Gradio SDK를 선택한 다음 “Create Space”를 클릭합니다. 코드를 <code>app.py</code> 파일로 Space에 업로드합니다.
Space가 자동으로 시작됩니다!
Space에 대한 자세한 내용은 이 <a href="https://huggingface.co/docs/hub/spaces-overview" rel="nofollow">가이드</a>를 참조하세요.`,je,H,De=`웹훅 서버가 이제 공개 Space에서 실행 중입니다. 대부분의 경우 비밀번호로 보안을 설정하고 싶을 것입니다.
Space 설정 &gt; “Repository secrets” 섹션 &gt; “Add a secret” 로 이동합니다. <code>WEBHOOK_SECRET</code> 환경 변수에 원하는 값을 설정합니다.
<a href="https://huggingface.co/settings/webhooks" rel="nofollow">Webhooks 설정</a>으로 돌아가서 웹훅 구성에 비밀번호를 설정합니다.
이제 올바른 비밀번호가 있는 요청만 서버에서 허용됩니다.`,be,N,qe=`이게 전부입니다! Space가 이제 Hub의 웹훅을 수신할 준비가 되었습니다.
무료 하드웨어인 ‘cpu-basic’에서 Space를 실행 시, 48시간 동안 비활성화되면 종료된다는 점을 유념하세요.
영구적인 Space가 필요한 경우 <a href="https://huggingface.co/docs/hub/spaces-gpus#hardware-specs" rel="nofollow">업그레이드된 하드웨어</a>를 설정해야 합니다.`,Te,E,Ve,_,Ke=`위의 가이드에서는 <code>WebhooksServer()</code>를 설정하는 가장 빠른 방법에 대해 설명했습니다.
이 섹션에서는 이를 더욱 사용자 정의하는 방법을 살펴보겠습니다.`,ue,Y,ge,O,el=`동일한 서버에 여러 엔드포인트를 등록할 수 있습니다.
예를 들어, 하나의 엔드포인트는 학습 작업을 트리거하고 다른 엔드포인트는 모델 평가를 트리거하도록 할 수 있습니다.
이를 위해 여러 개의 <code>@webhook_endpoint</code> 데코레이터를 추가하면 됩니다:`,Qe,L,ke,A,ll="이렇게 하면 두 개의 엔드포인트가 생성됩니다:",$e,X,Se,x,Ie,z,tl=`더 많은 유연성을 얻기 위해 <code>WebhooksServer()</code> 객체를 직접 생성할 수도 있습니다.
이것은 서버의 랜딩 페이지를 사용자 정의하고자 할 때 유용합니다.
기본 페이지를 덮어쓸 <a href="https://gradio.app/docs/#blocks" rel="nofollow">Gradio UI</a>를 전달하여 이를 수행할 수 있습니다.
예를 들어, 사용자를 위한 지침을 추가하거나 웹훅을 수동으로 트리거하는 양식을 추가할 수 있습니다.
<code>WebhooksServer()</code>를 생성할 때, <code>add_webhook()</code> 데코레이터를 사용하여 새로운 웹훅을 등록할 수 있습니다.`,ve,P,sl="전체 예제는 다음과 같습니다:",Fe,D,Ze,q,al=`<li>Gradio 블록을 사용하여 사용자 정의 UI를 정의합니다. 이 UI는 서버의 랜딩 페이지에 표시됩니다.</li> <li>사용자 정의 UI와 시크릿으로 <code>WebhooksServer()</code> 객체를 생성합니다.
시크릿은 선택 사항이며 <code>WEBHOOK_SECRET</code> 환경 변수로 설정할 수 있습니다.</li> <li>명시적 이름으로 웹훅을 등록합니다. 이렇게 하면 <code>/webhooks/say_hello</code> 엔드포인트가 생성됩니다.</li> <li>암시적 이름으로 웹훅을 등록합니다. 이렇게 하면 <code>/webhooks/goodbye</code> 엔드포인트가 생성됩니다.</li> <li>서버를 시작합니다. 이것은 선택 사항이며 스크립트 끝에서 자동으로 서버가 시작됩니다.</li>`,Be,K,Re,le,We;return V=new ee({props:{title:"웹훅 서버",local:"webhooks-server",headingTag:"h1"}}),f=new He({props:{$$slots:{default:[wl]},$$scope:{ctx:J}}}),j=new He({props:{warning:!0,$$slots:{default:[Cl]},$$scope:{ctx:J}}}),Q=new ee({props:{title:"엔드포인트 생성",local:"create-an-endpoint",headingTag:"h2"}}),$=new te({props:{code:"JTIzJTIwYXBwLnB5JTBBZnJvbSUyMGh1Z2dpbmdmYWNlX2h1YiUyMGltcG9ydCUyMHdlYmhvb2tfZW5kcG9pbnQlMkMlMjBXZWJob29rUGF5bG9hZCUwQSUwQSU0MHdlYmhvb2tfZW5kcG9pbnQlMEFhc3luYyUyMGRlZiUyMHRyaWdnZXJfdHJhaW5pbmcocGF5bG9hZCUzQSUyMFdlYmhvb2tQYXlsb2FkKSUyMC0lM0UlMjBOb25lJTNBJTBBJTIwJTIwJTIwJTIwaWYlMjBwYXlsb2FkLnJlcG8udHlwZSUyMCUzRCUzRCUyMCUyMmRhdGFzZXQlMjIlMjBhbmQlMjBwYXlsb2FkLmV2ZW50LmFjdGlvbiUyMCUzRCUzRCUyMCUyMnVwZGF0ZSUyMiUzQSUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMyUyMCVFQiU4RCVCMCVFQyU5RCVCNCVFRCU4NCVCMCUyMCVFQyU4NCVCOCVFRCU4QSVCOCVFQSVCMCU4MCUyMCVFQyU5NyU4NSVFQiU4RCVCMCVFQyU5RCVCNCVFRCU4QSVCOCVFQiU5MCU5OCVFQiVBOSVCNCUyMCVFRCU5NSU5OSVFQyU4QSVCNSUyMCVFQyU5RSU5MSVFQyU5NyU4NSVFQyU5RCU4NCUyMCVFRCU4QSVCOCVFQiVBNiVBQyVFQSVCMSVCMCVFRCU5NSVBOSVFQiU4QiU4OCVFQiU4QiVBNC4lMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAuLi4=",highlighted:`<span class="hljs-comment"># app.py</span>
<span class="hljs-keyword">from</span> huggingface_hub <span class="hljs-keyword">import</span> webhook_endpoint, WebhookPayload

<span class="hljs-meta">@webhook_endpoint</span>
<span class="hljs-keyword">async</span> <span class="hljs-keyword">def</span> <span class="hljs-title function_">trigger_training</span>(<span class="hljs-params">payload: WebhookPayload</span>) -&gt; <span class="hljs-literal">None</span>:
    <span class="hljs-keyword">if</span> payload.repo.<span class="hljs-built_in">type</span> == <span class="hljs-string">&quot;dataset&quot;</span> <span class="hljs-keyword">and</span> payload.event.action == <span class="hljs-string">&quot;update&quot;</span>:
        <span class="hljs-comment"># 데이터 세트가 업데이트되면 학습 작업을 트리거합니다.</span>
        ...`,wrap:!1}}),I=new te({props:{code:"V2ViaG9vayUyMHNlY3JldCUyMGlzJTIwbm90JTIwZGVmaW5lZC4lMjBUaGlzJTIwbWVhbnMlMjB5b3VyJTIwd2ViaG9vayUyMGVuZHBvaW50cyUyMHdpbGwlMjBiZSUyMG9wZW4lMjB0byUyMGV2ZXJ5b25lLiUwQVRvJTIwYWRkJTIwYSUyMHNlY3JldCUyQyUyMHNldCUyMCU2MFdFQkhPT0tfU0VDUkVUJTYwJTIwYXMlMjBlbnZpcm9ubWVudCUyMHZhcmlhYmxlJTIwb3IlMjBwYXNzJTIwaXQlMjBhdCUyMGluaXRpYWxpemF0aW9uJTNBJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTYwYXBwJTIwJTNEJTIwV2ViaG9va3NTZXJ2ZXIod2ViaG9va19zZWNyZXQlM0QnbXlfc2VjcmV0JyUyQyUyMC4uLiklNjAlMEFGb3IlMjBtb3JlJTIwZGV0YWlscyUyMGFib3V0JTIwd2ViaG9vayUyMHNlY3JldHMlMkMlMjBwbGVhc2UlMjByZWZlciUyMHRvJTIwaHR0cHMlM0ElMkYlMkZodWdnaW5nZmFjZS5jbyUyRmRvY3MlMkZodWIlMkZ3ZWJob29rcyUyM3dlYmhvb2stc2VjcmV0LiUwQVJ1bm5pbmclMjBvbiUyMGxvY2FsJTIwVVJMJTNBJTIwJTIwaHR0cCUzQSUyRiUyRjEyNy4wLjAuMSUzQTc4NjAlMEFSdW5uaW5nJTIwb24lMjBwdWJsaWMlMjBVUkwlM0ElMjBodHRwcyUzQSUyRiUyRjFmYWRiMGY1MmQ4YmY4MjVmYy5ncmFkaW8ubGl2ZSUwQSUwQVRoaXMlMjBzaGFyZSUyMGxpbmslMjBleHBpcmVzJTIwaW4lMjA3MiUyMGhvdXJzLiUyMEZvciUyMGZyZWUlMjBwZXJtYW5lbnQlMjBob3N0aW5nJTIwYW5kJTIwR1BVJTIwdXBncmFkZXMlMjAoTkVXISklMkMlMjBjaGVjayUyMG91dCUyMFNwYWNlcyUzQSUyMGh0dHBzJTNBJTJGJTJGaHVnZ2luZ2ZhY2UuY28lMkZzcGFjZXMlMEElMEFXZWJob29rcyUyMGFyZSUyMGNvcnJlY3RseSUyMHNldHVwJTIwYW5kJTIwcmVhZHklMjB0byUyMHVzZSUzQSUwQSUyMCUyMC0lMjBQT1NUJTIwaHR0cHMlM0ElMkYlMkYxZmFkYjBmNTJkOGJmODI1ZmMuZ3JhZGlvLmxpdmUlMkZ3ZWJob29rcyUyRnRyaWdnZXJfdHJhaW5pbmclMEFHbyUyMHRvJTIwaHR0cHMlM0ElMkYlMkZodWdnaW5nZmFjZS5jbyUyRnNldHRpbmdzJTJGd2ViaG9va3MlMjB0byUyMHNldHVwJTIweW91ciUyMHdlYmhvb2tzLg==",highlighted:`Webhook secret is not defined. This means your webhook endpoints will be open to everyone.
To add a secret, set \`WEBHOOK_SECRET\` as environment variable or pass it at initialization:
        \`app = WebhooksServer(webhook_secret=&#x27;my_secret&#x27;, ...)\`
For more details about webhook secrets, please refer to https://huggingface.co/docs/hub/webhooks#webhook-secret.
Running on local URL:  http://127.0.0.1:7860
Running on public URL: https://1fadb0f52d8bf825fc.gradio.live

This share link expires in 72 hours. For free permanent hosting and GPU upgrades (NEW!), check out Spaces: https://huggingface.co/spaces

Webhooks are correctly setup and ready to use:
  - POST https://1fadb0f52d8bf825fc.gradio.live/webhooks/trigger_training
Go to https://huggingface.co/settings/webhooks to setup your webhooks.`,wrap:!1}}),b=new He({props:{warning:!0,$$slots:{default:[ml]},$$scope:{ctx:J}}}),Z=new ee({props:{title:"웹훅 설정하기",local:"configure-a-webhook",headingTag:"h2"}}),W=new ee({props:{title:"Space에 배포하기",local:"deploy-to-a-space",headingTag:"h2"}}),E=new ee({props:{title:"고급 사용법",local:"advanced-usage",headingTag:"h2"}}),Y=new ee({props:{title:"다중 엔드포인트",local:"multiple-endpoints",headingTag:"h3"}}),L=new te({props:{code:"JTIzJTIwYXBwLnB5JTBBZnJvbSUyMGh1Z2dpbmdmYWNlX2h1YiUyMGltcG9ydCUyMHdlYmhvb2tfZW5kcG9pbnQlMkMlMjBXZWJob29rUGF5bG9hZCUwQSUwQSU0MHdlYmhvb2tfZW5kcG9pbnQlMEFhc3luYyUyMGRlZiUyMHRyaWdnZXJfdHJhaW5pbmcocGF5bG9hZCUzQSUyMFdlYmhvb2tQYXlsb2FkKSUyMC0lM0UlMjBOb25lJTNBJTBBJTIwJTIwJTIwJTIwaWYlMjBwYXlsb2FkLnJlcG8udHlwZSUyMCUzRCUzRCUyMCUyMmRhdGFzZXQlMjIlMjBhbmQlMjBwYXlsb2FkLmV2ZW50LmFjdGlvbiUyMCUzRCUzRCUyMCUyMnVwZGF0ZSUyMiUzQSUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMyUyMCVFQiU4RCVCMCVFQyU5RCVCNCVFRCU4NCVCMCUyMCVFQyU4NCVCOCVFRCU4QSVCOCVFQSVCMCU4MCUyMCVFQyU5NyU4NSVFQiU4RCVCMCVFQyU5RCVCNCVFRCU4QSVCOCVFQiU5MCU5OCVFQiVBOSVCNCUyMCVFRCU5NSU5OSVFQyU4QSVCNSUyMCVFQyU5RSU5MSVFQyU5NyU4NSVFQyU5RCU4NCUyMCVFRCU4QSVCOCVFQiVBNiVBQyVFQSVCMSVCMCVFRCU5NSVBOSVFQiU4QiU4OCVFQiU4QiVBNC4lMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAuLi4lMEElMEElNDB3ZWJob29rX2VuZHBvaW50JTBBYXN5bmMlMjBkZWYlMjB0cmlnZ2VyX2V2YWx1YXRpb24ocGF5bG9hZCUzQSUyMFdlYmhvb2tQYXlsb2FkKSUyMC0lM0UlMjBOb25lJTNBJTBBJTIwJTIwJTIwJTIwaWYlMjBwYXlsb2FkLnJlcG8udHlwZSUyMCUzRCUzRCUyMCUyMm1vZGVsJTIyJTIwYW5kJTIwcGF5bG9hZC5ldmVudC5hY3Rpb24lMjAlM0QlM0QlMjAlMjJ1cGRhdGUlMjIlM0ElMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjMlMjAlRUIlQUElQTglRUIlOEQlQjglRUMlOUQlQjQlMjAlRUMlOTclODUlRUIlOEQlQjAlRUMlOUQlQjQlRUQlOEElQjglRUIlOTAlOTglRUIlQTklQjQlMjAlRUQlOEYlODklRUElQjAlODAlMjAlRUMlOUUlOTElRUMlOTclODUlRUMlOUQlODQlMjAlRUQlOEElQjglRUIlQTYlQUMlRUElQjElQjAlRUQlOTUlQTklRUIlOEIlODglRUIlOEIlQTQuJTIwJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwLi4u",highlighted:`<span class="hljs-comment"># app.py</span>
<span class="hljs-keyword">from</span> huggingface_hub <span class="hljs-keyword">import</span> webhook_endpoint, WebhookPayload

<span class="hljs-meta">@webhook_endpoint</span>
<span class="hljs-keyword">async</span> <span class="hljs-keyword">def</span> <span class="hljs-title function_">trigger_training</span>(<span class="hljs-params">payload: WebhookPayload</span>) -&gt; <span class="hljs-literal">None</span>:
    <span class="hljs-keyword">if</span> payload.repo.<span class="hljs-built_in">type</span> == <span class="hljs-string">&quot;dataset&quot;</span> <span class="hljs-keyword">and</span> payload.event.action == <span class="hljs-string">&quot;update&quot;</span>:
        <span class="hljs-comment"># 데이터 세트가 업데이트되면 학습 작업을 트리거합니다.</span>
        ...

<span class="hljs-meta">@webhook_endpoint</span>
<span class="hljs-keyword">async</span> <span class="hljs-keyword">def</span> <span class="hljs-title function_">trigger_evaluation</span>(<span class="hljs-params">payload: WebhookPayload</span>) -&gt; <span class="hljs-literal">None</span>:
    <span class="hljs-keyword">if</span> payload.repo.<span class="hljs-built_in">type</span> == <span class="hljs-string">&quot;model&quot;</span> <span class="hljs-keyword">and</span> payload.event.action == <span class="hljs-string">&quot;update&quot;</span>:
        <span class="hljs-comment"># 모델이 업데이트되면 평가 작업을 트리거합니다. </span>
        ...`,wrap:!1}}),X=new te({props:{code:"KC4uLiklMEFXZWJob29rcyUyMGFyZSUyMGNvcnJlY3RseSUyMHNldHVwJTIwYW5kJTIwcmVhZHklMjB0byUyMHVzZSUzQSUwQSUyMCUyMC0lMjBQT1NUJTIwaHR0cHMlM0ElMkYlMkYxZmFkYjBmNTJkOGJmODI1ZmMuZ3JhZGlvLmxpdmUlMkZ3ZWJob29rcyUyRnRyaWdnZXJfdHJhaW5pbmclMEElMjAlMjAtJTIwUE9TVCUyMGh0dHBzJTNBJTJGJTJGMWZhZGIwZjUyZDhiZjgyNWZjLmdyYWRpby5saXZlJTJGd2ViaG9va3MlMkZ0cmlnZ2VyX2V2YWx1YXRpb24=",highlighted:`(...)
Webhooks are correctly setup and ready to use:
  - POST https://1fadb0f52d8bf825fc.gradio.live/webhooks/trigger_training
  - POST https://1fadb0f52d8bf825fc.gradio.live/webhooks/trigger_evaluation`,wrap:!1}}),x=new ee({props:{title:"사용자 정의 서버",local:"custom-server",headingTag:"h3"}}),D=new te({props:{code:"aW1wb3J0JTIwZ3JhZGlvJTIwYXMlMjBnciUwQWZyb20lMjBmYXN0YXBpJTIwaW1wb3J0JTIwUmVxdWVzdCUwQWZyb20lMjBodWdnaW5nZmFjZV9odWIlMjBpbXBvcnQlMjBXZWJob29rc1NlcnZlciUyQyUyMFdlYmhvb2tQYXlsb2FkJTBBJTBBJTIzJTIwMS4lMjBVSSUyMCVFQyVBMCU5NSVFQyU5RCU5OCUwQXdpdGglMjBnci5CbG9ja3MoKSUyMGFzJTIwdWklM0ElMEElMjAlMjAlMjAlMjAuLi4lMEElMEElMjMlMjAyLiUyMCVFQyU4MiVBQyVFQyU5QSVBOSVFQyU5RSU5MCUyMCVFQyVBMCU5NSVFQyU5RCU5OCUyMFVJJUVDJTk5JTgwJTIwJUVDJThCJTlDJUVEJTgxJUFDJUVCJUE2JUJGJUVDJTlDJUJDJUVCJUExJTlDJTIwV2ViaG9va3NTZXJ2ZXIlMjAlRUMlODMlOUQlRUMlODQlQjElMEFhcHAlMjAlM0QlMjBXZWJob29rc1NlcnZlcih1aSUzRHVpJTJDJTIwd2ViaG9va19zZWNyZXQlM0QlMjJteV9zZWNyZXRfa2V5JTIyKSUwQSUwQSUyMyUyMDMuJTIwJUVCJUFBJTg1JUVDJThCJTlDJUVDJUEwJTgxJTIwJUVDJTlEJUI0JUVCJUE2JTg0JUVDJTlDJUJDJUVCJUExJTlDJTIwJUVDJTlCJUI5JUVEJTlCJTg1JTIwJUVCJTkzJUIxJUVCJUExJTlEJTBBJTQwYXBwLmFkZF93ZWJob29rKCUyMiUyRnNheV9oZWxsbyUyMiklMEFhc3luYyUyMGRlZiUyMGhlbGxvKHBheWxvYWQlM0ElMjBXZWJob29rUGF5bG9hZCklM0ElMEElMjAlMjAlMjAlMjByZXR1cm4lMjAlN0IlMjJtZXNzYWdlJTIyJTNBJTIwJTIyaGVsbG8lMjIlN0QlMEElMEElMjMlMjA0LiUyMCVFQyU5NSU5NCVFQyU4QiU5QyVFQyVBMCU4MSUyMCVFQyU5RCVCNCVFQiVBNiU4NCVFQyU5QyVCQyVFQiVBMSU5QyUyMCVFQyU5QiVCOSVFRCU5QiU4NSUyMCVFQiU5MyVCMSVFQiVBMSU5RCUwQSU0MGFwcC5hZGRfd2ViaG9vayUwQWFzeW5jJTIwZGVmJTIwZ29vZGJ5ZShwYXlsb2FkJTNBJTIwV2ViaG9va1BheWxvYWQpJTNBJTBBJTIwJTIwJTIwJTIwcmV0dXJuJTIwJTdCJTIybWVzc2FnZSUyMiUzQSUyMCUyMmdvb2RieWUlMjIlN0QlMEElMEElMjMlMjA1LiUyMCVFQyU4NCU5QyVFQiVCMiU4NCUyMCVFQyU4QiU5QyVFQyU5RSU5MSUyMCglRUMlODQlQTAlRUQlODMlOUQlMjAlRUMlODIlQUMlRUQlOTUlQUQpJTBBYXBwLnJ1bigp",highlighted:`<span class="hljs-keyword">import</span> gradio <span class="hljs-keyword">as</span> gr
<span class="hljs-keyword">from</span> fastapi <span class="hljs-keyword">import</span> Request
<span class="hljs-keyword">from</span> huggingface_hub <span class="hljs-keyword">import</span> WebhooksServer, WebhookPayload

<span class="hljs-comment"># 1. UI 정의</span>
<span class="hljs-keyword">with</span> gr.Blocks() <span class="hljs-keyword">as</span> ui:
    ...

<span class="hljs-comment"># 2. 사용자 정의 UI와 시크릿으로 WebhooksServer 생성</span>
app = WebhooksServer(ui=ui, webhook_secret=<span class="hljs-string">&quot;my_secret_key&quot;</span>)

<span class="hljs-comment"># 3. 명시적 이름으로 웹훅 등록</span>
<span class="hljs-meta">@app.add_webhook(<span class="hljs-params"><span class="hljs-string">&quot;/say_hello&quot;</span></span>)</span>
<span class="hljs-keyword">async</span> <span class="hljs-keyword">def</span> <span class="hljs-title function_">hello</span>(<span class="hljs-params">payload: WebhookPayload</span>):
    <span class="hljs-keyword">return</span> {<span class="hljs-string">&quot;message&quot;</span>: <span class="hljs-string">&quot;hello&quot;</span>}

<span class="hljs-comment"># 4. 암시적 이름으로 웹훅 등록</span>
<span class="hljs-meta">@app.add_webhook</span>
<span class="hljs-keyword">async</span> <span class="hljs-keyword">def</span> <span class="hljs-title function_">goodbye</span>(<span class="hljs-params">payload: WebhookPayload</span>):
    <span class="hljs-keyword">return</span> {<span class="hljs-string">&quot;message&quot;</span>: <span class="hljs-string">&quot;goodbye&quot;</span>}

<span class="hljs-comment"># 5. 서버 시작 (선택 사항)</span>
app.run()`,wrap:!1}}),K=new dl({props:{source:"https://github.com/huggingface/huggingface_hub/blob/main/docs/source/ko/guides/webhooks_server.md"}}),{c(){o=p("meta"),C=a(),M=p("p"),m=a(),y(V.$$.fragment),se=a(),u=p("p"),u.innerHTML=Ee,ae=a(),g=p("p"),g.innerHTML=_e,ne=a(),y(f.$$.fragment),oe=a(),y(j.$$.fragment),pe=a(),y(Q.$$.fragment),ie=a(),k=p("p"),k.textContent=Ye,Me=a(),y($.$$.fragment),Ue=a(),S=p("p"),S.innerHTML=Oe,ye=a(),y(I.$$.fragment),ce=a(),v=p("p"),v.textContent=Le,he=a(),F=p("ol"),F.innerHTML=Ae,re=a(),y(b.$$.fragment),de=a(),y(Z.$$.fragment),we=a(),B=p("p"),B.innerHTML=Xe,Ce=a(),T=p("div"),T.innerHTML=xe,me=a(),R=p("p"),R.textContent=ze,Je=a(),y(W.$$.fragment),fe=a(),G=p("p"),G.innerHTML=Pe,je=a(),H=p("p"),H.innerHTML=De,be=a(),N=p("p"),N.innerHTML=qe,Te=a(),y(E.$$.fragment),Ve=a(),_=p("p"),_.innerHTML=Ke,ue=a(),y(Y.$$.fragment),ge=a(),O=p("p"),O.innerHTML=el,Qe=a(),y(L.$$.fragment),ke=a(),A=p("p"),A.textContent=ll,$e=a(),y(X.$$.fragment),Se=a(),y(x.$$.fragment),Ie=a(),z=p("p"),z.innerHTML=tl,ve=a(),P=p("p"),P.textContent=sl,Fe=a(),y(D.$$.fragment),Ze=a(),q=p("ol"),q.innerHTML=al,Be=a(),y(K.$$.fragment),Re=a(),le=p("p"),this.h()},l(e){const l=hl("svelte-u9bgzb",document.head);o=i(l,"META",{name:!0,content:!0}),l.forEach(t),C=n(e),M=i(e,"P",{}),il(M).forEach(t),m=n(e),c(V.$$.fragment,e),se=n(e),u=i(e,"P",{"data-svelte-h":!0}),U(u)!=="svelte-4gg1j0"&&(u.innerHTML=Ee),ae=n(e),g=i(e,"P",{"data-svelte-h":!0}),U(g)!=="svelte-1e5fzk"&&(g.innerHTML=_e),ne=n(e),c(f.$$.fragment,e),oe=n(e),c(j.$$.fragment,e),pe=n(e),c(Q.$$.fragment,e),ie=n(e),k=i(e,"P",{"data-svelte-h":!0}),U(k)!=="svelte-127cxas"&&(k.textContent=Ye),Me=n(e),c($.$$.fragment,e),Ue=n(e),S=i(e,"P",{"data-svelte-h":!0}),U(S)!=="svelte-1tktkge"&&(S.innerHTML=Oe),ye=n(e),c(I.$$.fragment,e),ce=n(e),v=i(e,"P",{"data-svelte-h":!0}),U(v)!=="svelte-115owcb"&&(v.textContent=Le),he=n(e),F=i(e,"OL",{"data-svelte-h":!0}),U(F)!=="svelte-gmm4jq"&&(F.innerHTML=Ae),re=n(e),c(b.$$.fragment,e),de=n(e),c(Z.$$.fragment,e),we=n(e),B=i(e,"P",{"data-svelte-h":!0}),U(B)!=="svelte-1470z52"&&(B.innerHTML=Xe),Ce=n(e),T=i(e,"DIV",{class:!0,"data-svelte-h":!0}),U(T)!=="svelte-9ld38f"&&(T.innerHTML=xe),me=n(e),R=i(e,"P",{"data-svelte-h":!0}),U(R)!=="svelte-wva2c8"&&(R.textContent=ze),Je=n(e),c(W.$$.fragment,e),fe=n(e),G=i(e,"P",{"data-svelte-h":!0}),U(G)!=="svelte-139ad60"&&(G.innerHTML=Pe),je=n(e),H=i(e,"P",{"data-svelte-h":!0}),U(H)!=="svelte-hd20iz"&&(H.innerHTML=De),be=n(e),N=i(e,"P",{"data-svelte-h":!0}),U(N)!=="svelte-1qk017i"&&(N.innerHTML=qe),Te=n(e),c(E.$$.fragment,e),Ve=n(e),_=i(e,"P",{"data-svelte-h":!0}),U(_)!=="svelte-ml2hu2"&&(_.innerHTML=Ke),ue=n(e),c(Y.$$.fragment,e),ge=n(e),O=i(e,"P",{"data-svelte-h":!0}),U(O)!=="svelte-1o0nvdm"&&(O.innerHTML=el),Qe=n(e),c(L.$$.fragment,e),ke=n(e),A=i(e,"P",{"data-svelte-h":!0}),U(A)!=="svelte-1vtbzwm"&&(A.textContent=ll),$e=n(e),c(X.$$.fragment,e),Se=n(e),c(x.$$.fragment,e),Ie=n(e),z=i(e,"P",{"data-svelte-h":!0}),U(z)!=="svelte-nka9bn"&&(z.innerHTML=tl),ve=n(e),P=i(e,"P",{"data-svelte-h":!0}),U(P)!=="svelte-1sqiojg"&&(P.textContent=sl),Fe=n(e),c(D.$$.fragment,e),Ze=n(e),q=i(e,"OL",{"data-svelte-h":!0}),U(q)!=="svelte-14by2py"&&(q.innerHTML=al),Be=n(e),c(K.$$.fragment,e),Re=n(e),le=i(e,"P",{}),il(le).forEach(t),this.h()},h(){Ge(o,"name","hf:doc:metadata"),Ge(o,"content",fl),Ge(T,"class","flex justify-center")},m(e,l){rl(document.head,o),s(e,C,l),s(e,M,l),s(e,m,l),h(V,e,l),s(e,se,l),s(e,u,l),s(e,ae,l),s(e,g,l),s(e,ne,l),h(f,e,l),s(e,oe,l),h(j,e,l),s(e,pe,l),h(Q,e,l),s(e,ie,l),s(e,k,l),s(e,Me,l),h($,e,l),s(e,Ue,l),s(e,S,l),s(e,ye,l),h(I,e,l),s(e,ce,l),s(e,v,l),s(e,he,l),s(e,F,l),s(e,re,l),h(b,e,l),s(e,de,l),h(Z,e,l),s(e,we,l),s(e,B,l),s(e,Ce,l),s(e,T,l),s(e,me,l),s(e,R,l),s(e,Je,l),h(W,e,l),s(e,fe,l),s(e,G,l),s(e,je,l),s(e,H,l),s(e,be,l),s(e,N,l),s(e,Te,l),h(E,e,l),s(e,Ve,l),s(e,_,l),s(e,ue,l),h(Y,e,l),s(e,ge,l),s(e,O,l),s(e,Qe,l),h(L,e,l),s(e,ke,l),s(e,A,l),s(e,$e,l),h(X,e,l),s(e,Se,l),h(x,e,l),s(e,Ie,l),s(e,z,l),s(e,ve,l),s(e,P,l),s(e,Fe,l),h(D,e,l),s(e,Ze,l),s(e,q,l),s(e,Be,l),h(K,e,l),s(e,Re,l),s(e,le,l),We=!0},p(e,[l]){const nl={};l&2&&(nl.$$scope={dirty:l,ctx:e}),f.$set(nl);const ol={};l&2&&(ol.$$scope={dirty:l,ctx:e}),j.$set(ol);const pl={};l&2&&(pl.$$scope={dirty:l,ctx:e}),b.$set(pl)},i(e){We||(r(V.$$.fragment,e),r(f.$$.fragment,e),r(j.$$.fragment,e),r(Q.$$.fragment,e),r($.$$.fragment,e),r(I.$$.fragment,e),r(b.$$.fragment,e),r(Z.$$.fragment,e),r(W.$$.fragment,e),r(E.$$.fragment,e),r(Y.$$.fragment,e),r(L.$$.fragment,e),r(X.$$.fragment,e),r(x.$$.fragment,e),r(D.$$.fragment,e),r(K.$$.fragment,e),We=!0)},o(e){d(V.$$.fragment,e),d(f.$$.fragment,e),d(j.$$.fragment,e),d(Q.$$.fragment,e),d($.$$.fragment,e),d(I.$$.fragment,e),d(b.$$.fragment,e),d(Z.$$.fragment,e),d(W.$$.fragment,e),d(E.$$.fragment,e),d(Y.$$.fragment,e),d(L.$$.fragment,e),d(X.$$.fragment,e),d(x.$$.fragment,e),d(D.$$.fragment,e),d(K.$$.fragment,e),We=!1},d(e){e&&(t(C),t(M),t(m),t(se),t(u),t(ae),t(g),t(ne),t(oe),t(pe),t(ie),t(k),t(Me),t(Ue),t(S),t(ye),t(ce),t(v),t(he),t(F),t(re),t(de),t(we),t(B),t(Ce),t(T),t(me),t(R),t(Je),t(fe),t(G),t(je),t(H),t(be),t(N),t(Te),t(Ve),t(_),t(ue),t(ge),t(O),t(Qe),t(ke),t(A),t($e),t(Se),t(Ie),t(z),t(ve),t(P),t(Fe),t(Ze),t(q),t(Be),t(Re),t(le)),t(o),w(V,e),w(f,e),w(j,e),w(Q,e),w($,e),w(I,e),w(b,e),w(Z,e),w(W,e),w(E,e),w(Y,e),w(L,e),w(X,e),w(x,e),w(D,e),w(K,e)}}}const fl='{"title":"웹훅 서버","local":"webhooks-server","sections":[{"title":"엔드포인트 생성","local":"create-an-endpoint","sections":[],"depth":2},{"title":"웹훅 설정하기","local":"configure-a-webhook","sections":[],"depth":2},{"title":"Space에 배포하기","local":"deploy-to-a-space","sections":[],"depth":2},{"title":"고급 사용법","local":"advanced-usage","sections":[{"title":"다중 엔드포인트","local":"multiple-endpoints","sections":[],"depth":3},{"title":"사용자 정의 서버","local":"custom-server","sections":[],"depth":3}],"depth":2}],"depth":1}';function jl(J){return Ul(()=>{new URLSearchParams(window.location.search).get("fw")}),[]}class Ql extends yl{constructor(o){super(),cl(this,o,jl,Jl,Ml,{})}}export{Ql as component};
