hf webhooks în Hugging Face Hub & Transformers

hf webhooks ls | info ID
hf webhooks create --watch TIP:NUME (--url URL | --job-id JOB_ID) [--domain repo|discussions] [--secret S]
hf webhooks update | enable | disable | delete ID ...

Ce face hf webhooks

Un webhook ascultă evenimente (push-uri, discuții etc.) pe repository-uri, buckets, utilizatori sau organizații și reacționează fie trimițând date la un URL, fie pornind un Job pe infrastructura Hugging Face. ls (alias list) le listează, iar info afișează detaliile complete ca JSON.

create primește --watch în forma tip:nume (tip: model, dataset, space, bucket, org, user), repetabil, și fie --url, fie --job-id. --domain limitează evenimentele la repo sau discussions, iar --secret setează secretul de semnare. Secretele Job-ului sursă nu sunt copiate; le dai din nou cu --secrets.

update schimbă doar opțiunile date; --watch înlocuiește toată lista urmărită. enable și disable pornesc și opresc un webhook, iar delete îl șterge definitiv (cu confirmare, sau --yes).

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
create --watch TEXT	Elementul urmărit, tip:nume; repetabil (obligatoriu).
--url TEXT	URL-ul care primește datele. Exclusiv cu --job-id.
--job-id TEXT	Job-ul pornit la eveniment. Exclusiv cu --url.
--domain [repo|discussions]	Domeniul evenimentelor; repetabil. Implicit toate.
--secret TEXT	Secretul cu care se semnează datele trimise.
-s, --secrets / --secrets-file	Secretele transmise Job-ului pornit.
update WEBHOOK_ID ...	Aceleași opțiuni; --watch înlocuiește lista, --secrets cere --job-id.
enable / disable / info WEBHOOK_ID	Activare, dezactivare, detalii.
delete WEBHOOK_ID [-y]	Ștergere definitivă.
--token TEXT	Token de acces (User Access Token) creat în huggingface.co/settings/tokens. Implicit se folosește tokenul salvat de hf auth login.

Exemple practice

Exemplul 1: Lista webhook-urilor

hf webhooks ls

Rezultat

ID           URL                                DISABLED  DOMAINS  WATCHED
wh-abc123    https://example.com/hook            False     repo     model:bert-base-uncased
wh-def456    https://example.com/other-hook      False     repo     org:HuggingFace

Exemplul 2: Webhook către un URL

hf webhooks create --url https://example.com/hook --watch org:HuggingFace --watch model:gpt2 --domain repo

Exemplul 3: Webhook care pornește un Job, cu tokenul tău

hf webhooks create --job-id 687f911eaea852de79c4a50a --watch bucket:my-org/my-bucket --secrets HF_TOKEN

Exemplul 4: Dezactivare temporară

hf webhooks disable wh-abc123

Greșeli frecvente și bune practici

• Dai la update un singur --watch nou crezând că se adaugă. Lista urmărită este înlocuită complet.
• Aștepți ca Job-ul declanșat să aibă secretele Job-ului sursă. Nu sunt copiate; transmite-le cu --secrets.

Comenzi înrudite

• hf-jobs-run
• hf-discussions
• hf-repos