Recommendation API
 | Tato stránka je zastaralá, ale pokud bude aktualizována, může být stále užitečná. Prosím, pomozte s opravením, rozšířením a přepracováním textu do aktualizované podoby. |
Wikimedia Recommendation API je v současné době vyvíjené rozhraní HTTP s otevřeným přístupem, které bude poskytovat personalizovaná doporučení pro různé případy použití. Prvotním případem použití tohoto API je Překlad obsahu, kdy doporučuje články k překladu z jednoho jazyka do druhého na základě trendů návštěvnosti, záznamů aktivity a dalších signálů, aby identifikovalo mezery v pokrytí a přiřadilo je editorům na základě zájmu. Rozhraní API má být dostatečně flexibilní, aby mohlo sloužit jako základ pro nové funkce vývojářů třetích stran nebo výzkumných pracovníků.
Kontaktujte nás
Nejlépe nás můžete kontaktovat prostřednictvím kanálu IRC #wikimedia-research na freenode.
Uživatelé
Typ Doporučení překladu používá ContentTranslation jako součást své funkce "Návrhy".
Koncový bod
| Typ | RESTBase | Production | Cloud VPS | Experimentální | ||||
|---|---|---|---|---|---|---|---|---|
| API | GapFinder | API | GapFinder | API | GapFinder | API | GapFinder | |
| Překlady | 
|
|
|
|
|
| ||
| Chybějící sekce |
|
| ||||||
| Související články |
|
| ||||||
Základní přehled
Recommendation API
službu, kterou se snažíme produkovat
- Poskytuje koncové body pro všechny typy Doporučení a nástroj Doporučení.
- Ty mohou žít nezávisle na sobě
Typy doporučení
koncový bod rozhraní Recommendation API, který poskytuje typ doporučení
Překlady
- Doporučování článků k překladu, které existují ve zdrojovém jazyce wiki, ale chybí v cílovém jazyce wiki.
- Specifikace: https://recommend.wmflabs.org/types/translation/spec
- Ex query: /types/translation/v1/articles?source=en&target=de&seed=Apple
- Vrátí články, které existují v enwiki, ale chybí v dewiki, a které souvisejí s článkem "Apple".
- V současné době používá k poskytování doporučení vyhledávání morelike, rozhraní Pageview API a dotazy na Wikidata.
- Vytvoření seznamu kandidátských článků
- Použít morelike, pokud je zadán seed, jinak nejoblíbenější články na základě Pageview API
- Použití filtrů k vyřazení kandidátských článků
- Vytvoření seznamu kandidátských článků
- V současné době lze použít experimentální typ doporučení Related Articles Recommendation Type pro sestavení seznamu kandidátských článků místo morelike.
Související články
- experimentální
- Čeká se na výsledky studie
- Doporučené články, které souvisejí se základním článkem v daném jazyce.
- Specifikace: https://recommend-related-articles.wmflabs.org/types/related_articles/spec
- Ex query: /types/related_articles/v1/articles?source=en&seed=Apple
- Vrací články, které souvisejí s tématem "Apple" a které existují na enwiki.
- Ex query: /types/related_articles/v1/items?seed=Q89
- Vrátí položky wikidat, které se vztahují k Q89
- Používá dotazy na Wikidata
- Používá vypočtený maticový soubor
- Velikost: měří se v gigabajtech
- Vypočítáno offline přibližně každý měsíc
- Sestavení trvá méně než jeden den
Chybějící sekce
- experimentální
- Doporučení článků a sekcí, které do nich chcete přidat.
- Kód: https://github.com/schana/recommendation-missing-sections
- Specifikace: https://recommend-experimental.wmflabs.org/types/missing_sections/spec
- Ex query: /types/missing_sections/v1/articles
- Doporučení článků a sekcí, které do nich chcete přidat.
- Ex query: /types/missing_sections/v1/articles?seed=Apple
- Vyhledá články související s tématem "Apple" a sekce, které k nim lze přidat.
Nástroj Recommendation
komponenta uživatelského rozhraní, která může využívat rozhraní API
- GapFinder
- Nástroj, který pomáhá editorům vyplnit mezery v obsahu Wikipedie
- V současné době používá typ Doporučení překladu
- Kód je umístěn v hlavním repozitáři Recommendation API
- Ve vývoji jsou různé verze pro podporu různých typů doporučení.
Současné projekty
- Žije v Cloud VPS
- Python 3.4
Budoucí projekty
- Na základě ServiceTemplateNode
- https://github.com/wikimedia/mediawiki-services-recommendation-api
- Deployment: phab:T165760
- Sekvenční diagram
Naše záměry v oblasti produktivizace
Abychom podpořili současný případ použití ContentTranslation, chceme v tuto chvíli produkovat rozhraní Recommendation API, které poskytuje pouze koncový bod Translation Recommendation Type, aniž bychom se spoléhali na jakoukoli experimentální funkci (tj. nepoužívejte typ Related Articles Recommendation Type místo morelike). Bez potřeby Related Articles Recommendation Type bude Recommendation API sestávat převážně z volání vázaných na I/O na koncové body mw/pageview/wikidata. API Recommendation API by mělo mít veřejně přístupný koncový bod.
Kromě tohoto počátečního případu použití mohou být do rozhraní Recommendation API přidávány další typy Recommendation Types, jakmile budou prověřeny. Ty mohou mít různé technické požadavky a pravděpodobně budou vyžadovat další spolupráci, než je bude moci podporovat produkční infrastruktura. Například typ Doporučení souvisejícího článku potřebuje velký soubor vypočtené matice.