추천 API

위키미디어 추천 API는 현재 개발 중인 개방형 접근 HTTP API로 다양한 사용 사례에 대한 개인화된 권장 사항을 제공합니다. 이 API의 초기 사용 사례는 콘텐츠번역입니다. 여기서 트래픽 추세, 활동 로그 및 기타 신호를 사용하여 기사를 한 언어에서 다른 언어로 번역하여 적용 범위의 격차를 식별하고 관심사에 따라 편집자와 일치시킵니다. API는 제3자 개발자 또는 연구원이 새로운 기능의 기반으로 사용할 수 있을 만큼 충분히 유연합니다.

문의하기

리베라 채팅 IRC의 #wikimedia-research 채널에서 저희에게 연락하는 가장 좋은 방법입니다.

소비자

번역 추천 유형은 콘텐츠번역에서 "제안" 기능의 일부로 사용되고 있습니다.

끝점 유형

유형	RESTBase		Production		Cloud VPS		실험적
	API	GapFinder	API	GapFinder	API	GapFinder	API	GapFinder
번역
누락된 섹션
관련 문서

서비스 개요

추천 API

우리가 생산하려는 서비스

• 모든 권장 유형 및 권장 도구에 대한 끝점 제공
  • 이들은 서로 독립적으로 살 수 있습니다.

추천 유형

추천 유형을 제공하는 추천 API의 끝점

번역

• 소스 언어 위키에는 있지만 대상 언어 위키에는 없는 번역 문서 추천
• 사양: https://recommend.wmflabs.org/types/translation/spec
• 예 쿼리: /types/translation/v1/articles?source=en&target=de&seed=Apple
  • 영어 위키백과에 있지만 "Apple" 문서와 관련된 독일어 위키백과에서 누락된 문서를 반환합니다.
• 현재 검색, 페이지뷰 API 및 위키데이터 쿼리와 같은 기능을 사용하여 권장 사항을 제공합니다.
  • 후보 문서 목록 작성
    • 시드가 제공되면 morelike를 사용하고 그렇지 않으면 페이지뷰 API를 기반으로 하는 가장 인기 있는 문서를 사용합니다.
  • 후보 문서 정리에 필터 적용
    • https://github.com/wikimedia/research-recommendation-api/blob/master/recommendation/api/types/translation/filters.py
• 현재 실험적인 관련 문서 추천 유형을 사용하여 morelike 대신 후보 문서 목록을 작성할 수 있습니다.

관련 문서

• 실험
• 연구 결과를 기다리는 중
  • https://phabricator.wikimedia.org/T142009
• 특정 언어로 된 시드 문서와 관련된 문서 추천
• 사양: https://recommend-related-articles.wmflabs.org/types/related_articles/spec
• 예 쿼리: /types/related_articles/v1/articles?source=en&seed=Apple
  • 영어 위키백과에 존재하는 "Apple"과 관련된 문서를 반환합니다.
• 예 쿼리: /types/related_articles/v1/items?seed=Q89
  • Q89와 관련된 위키데이터 항목을 반환합니다.
• 위키데이터 쿼리 사용
• 계산된 행렬 파일 사용
  • 크기: 기가바이트 단위로 측정
  • 오프라인으로 계산됨 매 달
    • 구축하는 데 하루도 채 걸리지 않음

누락된 섹션

• 실험
• 추가할 문서 및 섹션 추천
• 코드: https://github.com/schana/recommendation-missing-sections
• 사양: https://recommend-experimental.wmflabs.org/types/missing_sections/spec
• 예 쿼리: /types/missing_sections/v1/articles
  • 추가할 수 있는 문서 및 섹션을 반환합니다.
• 예 쿼리: /types/missing_sections/v1/articles?seed=Apple
  • "Apple" 관련 문서 및 추가할 수 있는 섹션을 반환합니다.

추천 도구

API를 실행할 수 있는 UI 구성요소

• GapFinder
  • 편집자가 위키백과의 콘텐츠 공백을 채우는 데 도움이 되는 도구
  • 현재 번역 권장 유형을 사용합니다.
    • Research:Increasing_article_coverage/Tool
  • 코드는 기본 추천 API 저장소에 있습니다.
• 다양한 추천 유형을 지원하기 위해 개발 중인 다른 버전이 있습니다.
  • https://github.com/schana/recommendation-tool

현재 서비스

• 클라우드 VPS에 상주
  • nginx/uwsgi
  • https://github.com/wikimedia/research-recommendation-api/blob/master/recommendation/data/labs_setup.sh
  • https://recommend-related-articles.wmflabs.org/
  • https://recommend.wmflabs.org/
• Python 3.4

향후 서비스

• ServiceTemplateNode에 기반
• https://github.com/wikimedia/mediawiki-services-recommendation-api
• 배포 작업: phab:T165760
• 시퀀스 다이어그램

제품화를 위한 우리의 의도

콘텐츠번역의 현재 사용 사례를 지원하기 위해 실험 기능에 의존하지 않고 현재 번역 권장 사항 유형 엔드포인트만 제공하는 추천 API를 생산하려고 합니다(즉, morelike 대신 관련 문서 추천 유형을 사용하지 마십시오). 관련 문서 추천 유형이 필요하지 않으면 추천 API는 대부분 mw/페이지뷰/위키데이터 엔드포인트에 대한 I/O 바운드 호출로 구성됩니다. 추천 API에는 공개적으로 접근할 수 있는 엔드포인트가 있어야 합니다.

이 초기 사용 사례 외에도 더 많은 추천 유형이 심사되는 대로 추천 API에 추가될 수 있습니다. 여기에는 다양한 기술 요구 사항이 있을 수 있으며 프로덕션 인프라가 지원하기 전에 추가 협업이 필요할 수 있습니다. 예를 들어 관련 문서 추천 유형에는 대용량 계산 매트릭스 파일이 필요합니다.

같이 보기

• 게릿의 저장소
• 파브리케이터의 워크보드
• 문서 추천 서비스 비하인드 리서치
• 연구 프로젝트
• 갭파인더 문서
• 블로그 게시물
• 클라우드 VPS 프로젝트