Empfehlungs-API
 | This page is outdated, but if it was updated, it might still be useful. Please help by correcting, augmenting and revising the text into an up-to-date form. |
Die Wikimedia-Empfehlungs-API ist eine öffentlich zugängliche HTTP-API, die derzeit noch entwickelt wird und die persönliche Empfehlungen für unterschiedliche Anwendungsfälle bieten wird. Der ursprüngliche Anwendungsfall für diese API ist die Inhaltsübersetzung, bei der sie Artikel aus einer Sprache zur Übersetzung in eine andere anhand der Entwicklung der Zugriffszahlen, Aktivitäts-Logbüchern und anderen Anzeichen, die auf Lücken in der Themenabdeckung hindeuten, empfiehlt und die Interessen der Autoren berücksichtigt. Die API soll so flexibel sein, dass sie als Grundlage für neue Funktionen von dritten Entwicklern oder Forschern dienen kann.
Kontaktiere uns
Am besten kann man uns über den IRC-Kanal #wikimedia-research auf Freenode kontaktieren.
Nutzer
Der Übersetzungsempfehlungstyp wird von der Inhaltsübersetzung als Teil ihrer "Vorschlags"-Funktion genutzt.
Typen-Endpunkte
| Typ | RESTBase | Production | Cloud VPS | Experimentell | ||||
|---|---|---|---|---|---|---|---|---|
| API | GapFinder | API | GapFinder | API | GapFinder | API | GapFinder | |
| Übersetzung | 
|
|
|
|
|
| ||
| Fehlende Abschnitte |
|
| ||||||
| Verwandte Artikel |
|
| ||||||
Überblick über den Dienst
Empfehlungs-API
Der Dienst, den wir anbieten wollen
- Bietet Endpunkte für alle Empfehlungstypen und das Empfehlungswerkzeug
- Diese können unabhängig voneinander genutzt werden
Empfehlungstyp
Ein Endpunkt der Empfehlungs-API, der einen Empfehlungstyp anbietet
Übersetzung
- Empfiehlt Artikel zur Übersetzung, die im Wiki einer bestimmten Sprache existieren, jedoch im Wiki der Zielsprache finden
- Spez: https://recommend.wmflabs.org/types/translation/spec
- Abfrage ausführen: /types/translation/v1/articles?source=en&target=de&seed=Apple
- Gibt Artikel aus, die in enwiki existieren, aber in dewiki fehlen und die mit dem Artikel "Apple" verwandt sind
- Nutzt derzeit die Suche nach ähnlichen Inhalten, die Abrufzahlen-API und Wikidata-Abfragen, um Empfehlungen zu bieten
- Erstellt Listen potentieller Kandidaten
- Nutzt die Suche nach ähnlichen Inhalten, sofern ein Ausgangspunkt angegeben wird und ansonsten anhand der Abrufzahlen-API die am häufigsten aufgerufenen Artikel
- Wendet Filter an, um die Kandidaten für Artikel zu reduzieren
- Erstellt Listen potentieller Kandidaten
- Kann derzeit den experimentellen Verwandte-Artikel-Empfehlungstyp zur Erstellung der Liste von Kandidaten für Artikel statt der Suche nach ähnlichen Inhalten nutzen
Verwandte Artikel
- experimentell
- Auf Ergebnisse der Studie warten
- Empfiehlt Artikel, die mit einem bestimmten Artikel in einer angegebenen Sprache verwandt sind
- Spez: https://recommend-related-articles.wmflabs.org/types/related_articles/spec
- Abfrage ausführen: /types/related_articles/v1/articles?source=en&seed=Apple
- Gibt Artikel aus, die mit "Apple" in enwiki verwandt sind
- Abfrage ausführen: /types/related_articles/v1/items?seed=Q89
- Gibt Wikidata-Datenobjekte aus, die mit Q89 verwandt sind
- Nutzt Wikidata-Abfragen
- Nutzt eine errechnete Matrix-Datei
- Größe: Gemessen in Gigabyte
- Offline etwa monatlich berechnet
- Wird in weniger als einem Tag aufgebaut
Fehlende Abschnitte
- experimentell
- Empfiehlt Artikel und Abschnitte, die zu diesen hinzugefügt werden können
- Code: https://github.com/schana/recommendation-missing-sections
- Spez: https://recommend-experimental.wmflabs.org/types/missing_sections/spec
- Abfrage ausführen: /types/missing_sections/v1/articles
- Gibt Artikel und Abschnitte aus, die zu diesen hinzugefügt werden können
- Abfrage ausführen: /types/missing_sections/v1/articles?seed=Apple
- Gibt Artikel aus, die mit "Apple" verwandt sind und Abschnitte, die zu diesen hinzugefügt werden können
Empfehlungswerkzeug
Der Teil der Benutzeroberfläche, der die API anrufen kann
- GapFinder
- Werkzeug, das Autoren dabei hilft, thematische Lücken in Wikipedia zu füllen
- Nutzt derzeit den Übersetzungsempfehlungstyp
- Der Code befindet sich im Haupt-Empfehlungs-API-Repositorium
- Es befindet sich eine andere Version in der Entwicklung, um unterschiedliche Empfehlungstypen zu unterstützen
Aktueller Dienst
- Befindet sich auf Cloud VPS
- Python 3.4
Zukünftiger Dienst
- Basiert auf ServiceTemplateNode
- https://github.com/wikimedia/mediawiki-services-recommendation-api
- Entwicklungstask: phab:T165760
- Sequenzdiagramm
Unsere Beweggründe für die Entwicklung
Um den aktuellen Anwendungsfall der Inhaltsübersetzung zu unterstützen, wollen wir derzeit bei der Empfehlungs-API nur den Übersetzungsempfehlungstyp-Endpunkt anbieten, ohne uns auf experimentelle Funktionen zu verlassen (das bedeutet, nicht den Verwandte-Artikel-Empfehlungstyp statt der Suche nach ähnlichen Themen zu nutzen). Da wir den Verwandte-Artikel-Empfehlungstyp nicht benötigen, besteht die Empfehlungs-API hauptsächlich aus gebundenen I/O Anrufen an die Endpunkte mw/pageview/wikidata. Die Empfehlungs-API sollte einen öffentlich zugänglichen Endpunkt haben.
Über diesen ursprünglichen Anwendungsfall hinaus können weitere Empfehlungstypen zur Empfehlungs-API hinzugefügt 6, wenn sie überprüft wurden. Diese können unterschiedliche technische Anforderungen haben und werden voraussichtlich weitere zukünftige Zusammenarbeit erfordern, bevor sie von der Infrastruktur unterstützt werden können. Beispielsweise benötigt der Verwandte-Artikel-Empfehlungstyp eine große errechnete Matrix-Datei.