Tsallake zuwa babban abun ciki
Fassarar na'ura
Wani ɗan asalin yaren bai duba wannan shafin ba tukunna. Tsarin kalmomi na iya zama ba daidai ba kuma kalmomin fasaha na iya zama kuskure. Ana maraba da gyare-gyare ta hanyar menu na Ba da gudummawa.

Abin da wannan jagora yake (da kuma abin da ba shi ba)

Takaitaccen bayani a jimla ɗaya​

AfriPlaybook shi ne tabbataccen tsarin yanke shawara ga duk wanda zai fara aikin Sarrafa Harshen Jama'a (NLP) na harsunan Afirka, wanda ya ginu a kan ainihin kwarewar ayyukan Masakhane na baya.

Duk wani abu da wannan jagora (playbook) ya ƙara ya kamata ya fito da ma'anar wannan jimla. Duk abin da ya cire kuma ya zama an yi shi ne bisa kyakkyawan dalili da ya dace da ita.

Abin da wannan jagora ba shi ba​

  • Ba darasi ba ne kan horaswa (training) ko daidaita samfuri (fine-tuning). Wannan aikin an riga an yi bayaninsa dalla-dalla a Hugging Face NLP Course, da Google Deep Learning Tuning Playbook, da Google Text Classification guide, da kuma Advanced NLP with spaCy. Mun sanya adireshinsu (link); ba za mu sake rubuta su ba.
  • Ba littafin karatu ba ne. Don samun bayanan ka'idoji (rarraba kalmomi (tokenisation), samfuran jeri (sequence models), ma'aunin kimantawa (evaluation metrics), da tushen ilimin lissafi), duba littafin Jurafsky da Martin mai suna Speech and Language Processing. Tabbatacce ne kuma kyauta ne.
  • Ba kundin tsarin lambobin kwamfuta (code) ba ne. Lambobin kwamfuta suna saurin tsufa fiye da yadda za a iya sabunta kowane jagora. Idan muka yi nuni ga lambar kwamfuta, muna nuni ne ga rumbun ajiya mai aiki, mai tsari, wanda ake kula da shi. Idan mu da kanku muka samar da lambar kwamfuta, tana zama ne a wani rumbun ajiya na daban wanda ke da nasa tsarin fitarwa.
  • Ba ya tsaka-tsaki. Muna da matsaya. Muna fifita ma'auni na kowane harafi ga harsuna masu sarƙaƙiyar ƙa'idojin kalmomi (chrF, CER) a kan ma'auni na kowace kalma (BLEU, WER). Muna fifita bayar da sakamako ga kowane harshe da kowane aji a kan bayar da matsakaicin sakamako guda ɗaya. Muna fifita kimantawar ɗan adam ga duk wani abu da ke ƙirƙirar bayanai. Muna buƙatar amincewa daga mutanen da ke cikin bayanan. Muna goyon bayan al'umma su mallaki abubuwan da aka gina. Idan ba ka yarda da waɗannan matsayar ba, wannan jagorar ba naka ba ne.

Abin da wannan jagora yake​

A tsari, wannan jagora ya faɗo ne a rukunin littattafan jagora na rayuwar rumbun bayanai (dataset-lifecycle) da kuma amfani da basirar ɗan adam (AI) ta hanyar da ta dace. Littattafan da suka fi kama da shi su ne Datasheets for Datasets (Gebru et al., 2018), Data Statements for NLP (Bender & Friedman, 2018), Model Cards (Mitchell et al., 2019), da kuma The Turing Way. Abin da muka ƙara a kan wannan tsari shi ne:

  • Babi na musamman kan ma'aikata masu lakabi (annotation-workforce) (yadda ake tsara aiki, ɗaukar ma'aikata, bayar da umarni, dubawa, biyan kuɗi, da riƙe masu lakabi (annotators)), wanda yawancin littattafan jagora na rayuwar rumbun bayanai ba su cika yin bayani a kansa ba.
  • Hanyoyi na musamman kan yanayi (modality) don dacewa da yanayin harsunan Afirka: rubutu, magana (ASR, TTS, S2ST), OCR/AI na takardu, harshen kurame da bidiyo. Yawancin jagororin NLP rubutu kawai suke mayar da hankali a kai.
  • Tattaunawa ta musamman kan ƙarancin bayanai (low-resource) da yanayin Afirka: matsalar rashin kyakkyawar hanyar sadarwa, rubutun haruffa daban-daban, gauraya harsuna (code-switching), ƙarancin kasafin kuɗin na'ura, ayyukan da al'umma ke jagoranta, da damuwar al'umma kan haƙƙin mallaka (IP).

A zahiri, aikinmu shi ne mu zama takarda ɗaya tilo da sabon aiki zai iya karantawa wanda zai kiyaye shi daga maimaita kashi ɗaya bisa huɗu na aikin da aka riga aka yi.

Me ya sa muka zaɓi wannan fage: hujjoji​

A watan Yulin 2026 mun gudanar da wani bincike mai zaman kansa wanda ya kwatanta AfriPlaybook da wasu "jagorori" guda ashirin a rukuni uku: tabbatattun jagororin NLP na samfuri da horaswa (Google DL Tuning, Google Text Classification, Hugging Face NLP Course, spaCy), littattafan jagora na bayanai / AI ta hanyar da ta dace (Datasheets, Data Statements, Model Cards, Turing Way, PAIR, BigScience ROOTS, Deon), da kuma ayyukan ƙarancin bayanai da AfriPlaybook ya riga ya kasance tare da su (MasakhaneMT, MasakhaNER 1 and 2, AfriSenti, AfriQA, LAFAND-MT, FLORES, NLLB). Sakamakon ya fito ƙarara:

Takwas daga cikin babi goma masu lamba sun mayar da hankali ne kan tattara bayanai, ma'aikata masu lakabi, tabbatar da inganci, gudanarwa, tattara bayanai a rubuce, da al'umma. Babi na gina samfuri ne kawai ya taɓa batun ƙirƙirar samfuri, kuma babi ne gajere. Tabbatattun jagororin NLP na Rukuni na A an tsara su ne a kan zaɓin samfuri, daidaita samfuri, daidaita ma'aunin samfuri (hyperparameter tuning), da ƙaddamarwa (deployment), kuma sun cire batun lakabi, harsuna masu ƙarancin bayanai, da la'akari da al'adu gaba ɗaya. A tsari, AfriPlaybook littafin jagora ne na bayanai/lakabi, ba jagorar daidaita samfuri ba ne.

Wannan ba suka ba ne. Wuri ne da muka zaɓa. Wannan jagora shi ne abin da waɗancan jagororin na Rukuni na A suke ɗauka cewa an riga an yi. Ƙoƙarin yin gogayya da su a fagensu zai sa AfriPlaybook ya rasa tasirinsa kuma ya samar da abubuwan da za su tsufa a cikin shekara guda. Mallakar fagen lakabi, ingancin bayanai, kimantawa, al'umma, da ƙaddamarwa a yanayin Afirka abu ne mai ƙarfi, mai dorewa, kuma, ga al'ummar da jagorar ke yi wa aiki, abu ne mai matuƙar amfani.

Abin da zai biyo baya: tsarin mataki-mataki​

Wannan jagora na yanzu kyakkyawan daftari ne na tsarin rayuwar rumbun bayanai. Faɗaɗawa ta gaba ita ce mayar da jagorar ya zama hanya mafi guntuwa zuwa ga aiki mai gudana ga mai karatu wanda ke da aiki da kuma harshe amma bai san ta inda zai fara ba. A tsarin girmamawa:

Mataki na 1: ƙari guda biyu mafi tasiri​

  • Kafin Ka Fara. Hanyar matakai huɗu don duba aikin da aka yi a baya kafin gina rumbun bayanai: bincika abin da ke akwai, auna shi da jerin abubuwan dubawa, yanke shawara ko za a sake amfani da shi, a faɗaɗa shi, ko a gina sabo, sannan a koya daga mutanen da suka gina shi. Misalai uku da aka yi aiki a kansu (NER, ra'ayi, da kalaman ƙiyayya) sun yi amfani da wannan hanya a kan sanannun rumbun bayanai. Misalai ne kawai, ba cikakken jeri ba ne, saboda babu wani jeri da aka rubuta da hannu da zai iya tafiya daidai da ci gaban wannan fage.
  • Nazarin Ayyuka: ainihin waiwaye daga ayyukan Masakhane: MasakhaNER 1 and 2, AfriSenti, AfroBench, LAFAND-MT, AfriQA. Kowane ɗaya yana amsa jerin tambayoyi iri ɗaya (yawan mutanen ƙungiya, lokaci, kasafin kuɗi, matsala mafi wahala, kuskure mafi girma, abin da ya ba ƙungiyar mamaki) daga mutanen da suka yi aikin. Nazarin ayyuka guda biyu masu irin wannan inganci sun fi babi goma na rubutu na gaba ɗaya daraja.

Mataki na 2: ainihin yanayin da ya shafi kowa​

  • Ƙaddamarwa a yanayin Afirka. NLP ba tare da intanet ba da kuma inda hanyar sadarwa ba ta da kyau. Na'urori masu ƙanƙanta (Edge devices). SMS/USSD/WhatsApp a matsayin hanyoyin amfani da NLP. Sauya harsuna da yawa a cikin tattaunawa ɗaya. Rubutun da ba na yau da kullum ba (Ajami, Ge'ez, N'Ko) a cikin ainihin fuskokin manhaja (UIs).
  • Tsarin canja wuri tsakanin harsuna. Tabbataccen jagora, wanda aka ciro daga takardun binciken Masakhane, kan waɗanne harsunan Afirka ne ke amfana daga waɗanne tushen canja wuri. Daga Bantu zuwa Bantu, daga Cushitic zuwa Cushitic, da canja wurin rubutu a inda ya dace.

Mataki na 3: gudanarwa mai dorewa​

  • Shari'a, amincewa, da haƙƙin mallaka na al'umma (IP). Dokokin bayanai na matakin ƙasa (Nigeria NDPA, Kenya DPA, South Africa PoPIA, Ghana DPA, Rwanda) da tasirinsu a aikace. Tsarin amincewa da ke aiki da masu magana da ba su iya karatu da rubutu ba. Tsarin haƙƙin mallaka na al'umma. Hanyoyin fitarwa da ke hana kwashe bayanai ba bisa ƙa'ida ba.
  • Shigar da harsuna masu ƙarancin masu magana. Ga harshen da ke da al'ummar da ke magana da shi amma ba shi da rumbun bayanai na dijital, menene mataki na ɗaya? Ƙa'idojin rubutu, fara tattara bayanai, wayar da kan al'umma, da abubuwan da ya kamata a guje wa.

Mataki na 4: ayyuka a yanayin ƙarancin na'ura​

  • Horaswa da kimantawa a yanayin ƙarancin na'ura. Tsarin Community-GPU, Colab, Kaggle. LoRA da QLoRA (an haɗa su da ainihin tushensu, ba a sake ƙirƙiro su ba). Tacewa (Distillation) don ƙaddamarwa a na'urori masu ƙanƙanta. Yaushe ne canja wuri tsakanin harsuna ke zama dabarar rage aikin na'ura.

Mataki na 5: nemo albarkatun da ke akwai (wanda aka sake tsara shi)​

Ainihin Mataki na 5 ya kasance kundin adireshi ne mai gudana da aka tsara: kowane rumbun bayanai na harshen Afirka, samfuri, kayan aiki, da ma'auni, tare da ra'ayin edita na layi ɗaya a kan kowane abu, wanda ake sabuntawa a duk bayan wata shida. A gaskiya, tsarin sabuntawar shi ne aiki mafi girma, kuma babu wata ƙungiya da ke da ƙarfin duba abubuwa sama da 200 a duk bayan wata shida don bayar da sabon ra'ayin edita a kan kowannensu. Tsohon kundin adireshi da ke cewa "SOTA as of 2026-Q3" a shekarar 2027 ya fi rashin kundin adireshi muni.

Mataki na 5 da aka sake tsarawa ya zo a matsayin Mataki na 1 na Kafin Ka Fara, wanda ya ambaci ƴan wuraren da za a fara bincike (ACL Anthology, Lanfrica, Hugging Face, takardun taron AfricaNLP, Google Scholar, da arXiv) kuma yana koyar da hanyoyin bincike da ke gano rumbun bayanan harsunan Afirka na yanzu. Ba ya lissafa rumbun bayanai; majiyoyin ne ke lissafa kansu.

Mun amince da sauyin: mun haƙura da bayar da ra'ayin edita a kan kowane rumbun bayanai da samfuri (masu karatu za su koyi yadda za su tantance abubuwan da kansu ta amfani da jerin abubuwan dubawa a Kafin Ka Fara). Mun sami babi wanda zai ci gaba da kasancewa mai amfani na tsawon shekaru ba tare da an taɓa shi ba kuma ba ya buƙatar wani takamaiman mai kula don ci gaba da aiki.

Abin da muka rage wa fifiko​

  • Hanyoyin daidaita ma'aunin samfuri (hyperparameter tuning). Wannan aikin Google's DL Tuning Playbook ne. Mun sanya adireshinsa (link).
  • Hanyoyin zaɓar tsarin samfuri. Wannan aikin Hugging Face NLP Course ne da kuma katin samfuri (model cards) da ke kan HF Hub. Mun sanya adireshinsu.
  • Hanyoyin daidaita samfuri (fine-tuning) ga takamaiman samfuran asali. Haka nan. Mun sanya adireshinsu.
  • Kundin tsara umarni (prompt engineering). Yana saurin canzawa. Wannan aikin littattafan jagora na masu samar da samfuran ne. Mun sanya adireshinsu.
  • Bayar da sabis, jinkiri, da rage tsadar ƙaddamarwa a intanet (cloud). Wannan aikin jagororin MLOps ne da masu samar da sabis na intanet. Za mu iya tattauna ɓangarorin da suka shafi yanayin Afirka (na'urori masu ƙanƙanta, ba tare da intanet ba) amma ba za mu yi gogayya a kan yanayin gaba ɗaya ba.

Ƙa'ida ɗaya da ke tabbatar da ingancin wannan jagora​

Ana auna kowane babi da tambaya ɗaya: shin mai karatu wanda ke da takamaiman aiki da harshe zai fita da mataki na gaba da zai iya aiwatarwa a cikin mintuna goma sha biyar ko ƙasa da haka?

Idan eh, babin ya cancanci gurbinsa. Idan a'a, ko dai a sake rubuta shi don ya amsa wannan tambayar, ko kuma a cire shi. Kasancewa mai ɗauke da komai amma ba shi da amfani shi ne irin gazawar da muka fi tsoro.


Za a sake duba wannan bayanin yanke shawara a duk lokacin da aka fitar da wani babban sabon tsari na jagorar. Duba kundin sauye-sauye don ganin bayanin abin da ya canza da kuma lokacin da ya canza.

Join the discussion

Spotted an error, have a question, or want to share what worked on a real project? Sign in with GitHub to add your voice. Every thread lives in the open, powered by GitHub Discussions.

Loading discussion…
Masakhane African Languages Hub logo

Supported by

Masakhane African Languages Hub

The AfriPlaybook is supported by the Masakhane African Languages Hub, a pan-African initiative building open, culturally grounded datasets for African languages. We are grateful for its support.

About the Hub

In collaboration with

  • Bayero University, Kano
  • Bahir Dar University
  • HausaNLP
  • EthioNLP