A question solver plugin for OVOS
Project description
FlashRankMultipleChoiceSolver for OVOS
The FlashRankMultipleChoiceSolver
plugin is designed for the Open Voice OS (OVOS) platform to help select the best
answer to a question from a list of options. This plugin utilizes the FlashRank library to evaluate and rank
multiple-choice answers based on their relevance to the given query.
Features
- Rerank Options: Reranks a list of options based on their relevance to the query.
- Customizable Model: Allows the use of different ranking models.
- Seamless Integration: Designed to work with OVOS plugin manager.
ReRanking is a technique used to refine a list of potential answers by evaluating their relevance to a given query. This process is crucial in scenarios where multiple options or responses need to be assessed to determine the most appropriate one.
In retrieval chatbots, ReRanking helps in selecting the best answer from a set of retrieved documents or options, enhancing the accuracy of the response provided to the user.
Configuration
MultipleChoiceSolver
are integrated into the OVOS Common Query framework, where they are used to select the most
relevant answer from a set of multiple skill responses.
"common_query": {
"reranker": "ovos-flashrank-reranker-plugin",
"ignore_skill_scores": true,
"ovos-flashrank-reranker-plugin": {"model": "ms-marco-TinyBERT-L-2-v2"}
}
NOTE: enabling this on a raspberry pi will introduce up to 1 second of extra latency in common query pipeline
Available Models
Below is the list of models supported as of now, by default ms-marco-MultiBERT-L-12
is used due to being multilingual:
Model Name | Description |
---|---|
ms-marco-TinyBERT-L-2-v2 |
Model card Trained on the MS Marco Passage Ranking task. This model encodes queries and ranks passages retrieved from large-scale datasets like MS MARCO, focusing on machine reading comprehension and passage ranking. |
ms-marco-MiniLM-L-12-v2 |
Model card Trained on MS MARCO Passage Ranking, it performs well for Information Retrieval tasks, encoding queries and sorting passages. It offers high performance with a lower documents per second rate compared to other versions. |
ms-marco-MultiBERT-L-12 (default) |
Multi-lingual, supports 100+ languages |
ce-esci-MiniLM-L12-v2 |
FT on Amazon ESCI dataset Fine-tuned on the Amazon ESCI dataset, which includes queries in English, Japanese, and Spanish. Designed for semantic search and ranking, this model maps sentences and paragraphs to a 384-dimensional vector space, useful for tasks like clustering and product search in a multilingual context. |
rank-T5-flan |
Model card Best non cross-encoder reranker |
rank_zephyr_7b_v1_full (4-bit-quantised GGUF) |
A 7B parameter GPT-like model fine-tuned on task-specific listwise reranking data. It is the state-of-the-art open-source reranking model for several datasets |
Standalone Usage
FlashRankMultipleChoiceSolver
FlashRankMultipleChoiceSolver is designed to select the best answer to a question from a list of options.
In the context of retrieval chatbots, FlashRankMultipleChoiceSolver is useful for scenarios where a user query results in a list of predefined answers or options. The solver ranks these options based on their relevance to the query and selects the most suitable one.
from ovos_flashrank_solver import FlashRankMultipleChoiceSolver
solver = FlashRankMultipleChoiceSolver()
a = solver.rerank("what is the speed of light", [
"very fast", "10m/s", "the speed of light is C"
])
print(a)
# 2024-07-22 15:03:10.295 - OVOS - __main__:load_corpus:61 - DEBUG - indexed 3 documents
# 2024-07-22 15:03:10.297 - OVOS - __main__:retrieve_from_corpus:70 - DEBUG - Rank 1 (score: 0.7198746800422668): the speed of light is C
# 2024-07-22 15:03:10.297 - OVOS - __main__:retrieve_from_corpus:70 - DEBUG - Rank 2 (score: 0.0): 10m/s
# 2024-07-22 15:03:10.297 - OVOS - __main__:retrieve_from_corpus:70 - DEBUG - Rank 3 (score: 0.0): very fast
# [(0.7198747, 'the speed of light is C'), (0.0, '10m/s'), (0.0, 'very fast')]
# NOTE: select_answer is part of the MultipleChoiceSolver base class and uses rerank internally
a = solver.select_answer("what is the speed of light", [
"very fast", "10m/s", "the speed of light is C"
])
print(a) # the speed of light is C
FlashRankEvidenceSolverPlugin
FlashRankEvidenceSolverPlugin is designed to extract the most relevant sentence from a text passage that answers a given question. This plugin uses the FlashRank algorithm to evaluate and rank sentences based on their relevance to the query.
In text extraction and machine comprehension tasks, FlashRankEvidenceSolverPlugin enables the identification of specific sentences within a larger body of text that directly address a user's query.
For example, in a scenario where a user queries about the number of rovers exploring Mars, FlashRankEvidenceSolverPlugin scans the provided text passage, ranks sentences based on their relevance, and extracts the most informative sentence.
from ovos_flashrank_solver import FlashRankEvidenceSolverPlugin
config = {
"lang": "en-us",
"min_conf": 0.4,
"n_answer": 1
}
solver = FlashRankEvidenceSolverPlugin(config)
text = """Mars is the fourth planet from the Sun. It is a dusty, cold, desert world with a very thin atmosphere.
Mars is also a dynamic planet with seasons, polar ice caps, canyons, extinct volcanoes, and evidence that it was even more active in the past.
Mars is one of the most explored bodies in our solar system, and it's the only planet where we've sent rovers to roam the alien landscape.
NASA currently has two rovers (Curiosity and Perseverance), one lander (InSight), and one helicopter (Ingenuity) exploring the surface of Mars.
"""
query = "how many rovers are currently exploring Mars"
answer = solver.get_best_passage(evidence=text, question=query)
print("Query:", query)
print("Answer:", answer)
# 2024-07-22 15:05:14.209 - OVOS - __main__:load_corpus:61 - DEBUG - indexed 5 documents
# 2024-07-22 15:05:14.209 - OVOS - __main__:retrieve_from_corpus:70 - DEBUG - Rank 1 (score: 1.39238703250885): NASA currently has two rovers (Curiosity and Perseverance), one lander (InSight), and one helicopter (Ingenuity) exploring the surface of Mars.
# 2024-07-22 15:05:14.210 - OVOS - __main__:retrieve_from_corpus:70 - DEBUG - Rank 2 (score: 0.38667747378349304): Mars is one of the most explored bodies in our solar system, and it's the only planet where we've sent rovers to roam the alien landscape.
# 2024-07-22 15:05:14.210 - OVOS - __main__:retrieve_from_corpus:70 - DEBUG - Rank 3 (score: 0.15732118487358093): Mars is the fourth planet from the Sun.
# 2024-07-22 15:05:14.210 - OVOS - __main__:retrieve_from_corpus:70 - DEBUG - Rank 4 (score: 0.10177625715732574): Mars is also a dynamic planet with seasons, polar ice caps, canyons, extinct volcanoes, and evidence that it was even more active in the past.
# 2024-07-22 15:05:14.210 - OVOS - __main__:retrieve_from_corpus:70 - DEBUG - Rank 5 (score: 0.0): It is a dusty, cold, desert world with a very thin atmosphere.
# Query: how many rovers are currently exploring Mars
# Answer: NASA currently has two rovers (Curiosity and Perseverance), one lander (InSight), and one helicopter (Ingenuity) exploring the surface of Mars.
In this example, FlashRankEvidenceSolverPlugin
effectively identifies and retrieves the most relevant sentence from
the provided text that answers the query about the number of rovers exploring Mars.
This capability is essential for applications requiring information extraction from extensive textual content, such as
automated research assistants or content summarizers.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file ovos-flashrank-reranker-plugin-0.0.0.tar.gz
.
File metadata
- Download URL: ovos-flashrank-reranker-plugin-0.0.0.tar.gz
- Upload date:
- Size: 8.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.9.20
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 04cf48dd7a0f5f2af9168590f36d4bad0a7be98c1a32a76b980fdbbe21d77d1c |
|
MD5 | 71830925ced342ea7023d95a5f1382e5 |
|
BLAKE2b-256 | ae02fb97a63d06ca34777649d292a327a760c94b493af4f348ba6f68dbeb2d6b |
File details
Details for the file ovos_flashrank_reranker_plugin-0.0.0-py3-none-any.whl
.
File metadata
- Download URL: ovos_flashrank_reranker_plugin-0.0.0-py3-none-any.whl
- Upload date:
- Size: 8.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.9.20
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e7ce3ff5a2f9b85026c42d7d059af4d3810f474e9c8145e19759e0a11a3255d8 |
|
MD5 | d5c44bdddb144b1a0ccc70d9ab298f7d |
|
BLAKE2b-256 | 38c17e9c3b597895bbb0a22cf947f8ba1cdd83e3c60b81f095312c491cae5b0c |