<!-- .github/pull_request_template.md --> This PR introduces wide vector and graph structure filtering capabilities. With these changes, the graph completion retriever and all retrievers that inherit from it will now filter relevant vector elements and subgraphs based on the query. This improvement significantly increases search speed for large graphs while maintaining—and in some cases slightly improving—accuracy. Changes in This PR: -Introduced new wide_search_top_k parameter: Controls the initial search space size -Added graph adapter level filtering method: Enables relevant subgraph filtering while maintaining backward compatibility. For community or custom graph adapters that don't implement this method, the system gracefully falls back to the original search behavior. -Updated modal dashboard and evaluation framework: Fixed compatibility issues. Added comprehensive unit tests: Introduced unit tests for brute_force_triplet_search (previously untested) and expanded the CogneeGraph test suite. Integration tests: Existing integration tests verify end-to-end search functionality (no changes required). Acceptance Criteria and Testing To verify the new search behavior, run search queries with different wide_search_top_k parameters while logging is enabled: None: Triggers a full graph search (default behavior) 1: Projects a minimal subgraph (demonstrates maximum filtering) Custom values: Test intermediate levels of filtering Internal Testing and results: Performance and accuracy benchmarks are available upon request. The implementation demonstrates measurable improvements in query latency for large graphs without sacrificing result quality. ## Type of Change <!-- Please check the relevant option --> - [ ] Bug fix (non-breaking change that fixes an issue) - [ ] New feature (non-breaking change that adds functionality) - [ ] Breaking change (fix or feature that would cause existing functionality to change) - [ ] Documentation update - [x] Code refactoring - [x] Performance improvement - [ ] Other (please specify): ## Screenshots/Videos (if applicable) None ## Pre-submission Checklist <!-- Please check all boxes that apply before submitting your PR --> - [x] **I have tested my changes thoroughly before submitting this PR** - [x] **This PR contains minimal changes necessary to address the issue/feature** - [x] My code follows the project's coding standards and style guidelines - [x] I have added tests that prove my fix is effective or that my feature works - [x] I have added necessary documentation (if applicable) - [x] All new and existing tests pass - [x] I have searched existing PRs to ensure this change hasn't been submitted already - [x] I have linked any relevant issues in the description - [x] My commits have clear and descriptive messages ## DCO Affirmation I affirm that all code in every commit of this pull request conforms to the terms of the Topoteretes Developer Certificate of Origin. --------- Co-authored-by: Pavel Zorin <pazonec@yandex.ru>
131 lines
4.3 KiB
Python
131 lines
4.3 KiB
Python
import modal
|
|
import os
|
|
import asyncio
|
|
import datetime
|
|
import json
|
|
from cognee.shared.logging_utils import get_logger
|
|
from cognee.eval_framework.eval_config import EvalConfig
|
|
from cognee.eval_framework.corpus_builder.run_corpus_builder import run_corpus_builder
|
|
from cognee.eval_framework.answer_generation.run_question_answering_module import (
|
|
run_question_answering,
|
|
)
|
|
import pathlib
|
|
from os import path
|
|
from modal import Image
|
|
from cognee.eval_framework.evaluation.run_evaluation_module import run_evaluation
|
|
from cognee.eval_framework.metrics_dashboard import create_dashboard
|
|
|
|
logger = get_logger()
|
|
vol = modal.Volume.from_name("evaluation_dashboard_results", create_if_missing=True)
|
|
|
|
|
|
def read_and_combine_metrics(eval_params: dict) -> dict:
|
|
"""Read and combine metrics files into a single result dictionary."""
|
|
try:
|
|
with open(eval_params["metrics_path"], "r") as f:
|
|
metrics = json.load(f)
|
|
with open(eval_params["aggregate_metrics_path"], "r") as f:
|
|
aggregate_metrics = json.load(f)
|
|
|
|
return {
|
|
"task_getter_type": eval_params["task_getter_type"],
|
|
"number_of_samples": eval_params["number_of_samples_in_corpus"],
|
|
"metrics": metrics,
|
|
"aggregate_metrics": aggregate_metrics,
|
|
}
|
|
except (FileNotFoundError, json.JSONDecodeError) as e:
|
|
logger.error(f"Error reading metrics files: {e}")
|
|
return None
|
|
|
|
|
|
app = modal.App("modal-run-eval")
|
|
|
|
image = Image.from_dockerfile(
|
|
path=pathlib.Path(path.join(path.dirname(__file__), "Dockerfile")).resolve(),
|
|
force_build=False,
|
|
).add_local_python_source("cognee")
|
|
|
|
|
|
@app.function(
|
|
image=image,
|
|
max_containers=10,
|
|
timeout=86400,
|
|
volumes={"/data": vol},
|
|
secrets=[modal.Secret.from_name("eval_secrets")],
|
|
)
|
|
async def modal_run_eval(eval_params=None):
|
|
"""Runs evaluation pipeline and returns combined metrics results."""
|
|
if eval_params is None:
|
|
eval_params = EvalConfig().to_dict()
|
|
|
|
version_name = "baseline"
|
|
benchmark_name = os.environ.get("BENCHMARK", eval_params.get("benchmark", "benchmark"))
|
|
timestamp = datetime.datetime.utcnow().strftime("%Y%m%dT%H%M%SZ")
|
|
|
|
answers_filename = (
|
|
f"{version_name}_{benchmark_name}_{timestamp}_{eval_params.get('answers_path')}"
|
|
)
|
|
html_filename = (
|
|
f"{version_name}_{benchmark_name}_{timestamp}_{eval_params.get('dashboard_path')}"
|
|
)
|
|
|
|
logger.info(f"Running evaluation with params: {eval_params}")
|
|
|
|
# Run the evaluation pipeline
|
|
await run_corpus_builder(eval_params, instance_filter=eval_params.get("instance_filter"))
|
|
await run_question_answering(eval_params)
|
|
answers = await run_evaluation(eval_params)
|
|
|
|
with open("/data/" + answers_filename, "w") as f:
|
|
json.dump(answers, f, ensure_ascii=False, indent=4)
|
|
vol.commit()
|
|
|
|
if eval_params.get("dashboard"):
|
|
logger.info("Generating dashboard...")
|
|
html_output = create_dashboard(
|
|
metrics_path=eval_params["metrics_path"],
|
|
aggregate_metrics_path=eval_params["aggregate_metrics_path"],
|
|
output_file=eval_params["dashboard_path"],
|
|
benchmark=eval_params["benchmark"],
|
|
)
|
|
|
|
with open("/data/" + html_filename, "w") as f:
|
|
f.write(html_output)
|
|
vol.commit()
|
|
|
|
logger.info("Evaluation set finished...")
|
|
|
|
return True
|
|
|
|
|
|
@app.local_entrypoint()
|
|
async def main():
|
|
# List of configurations to run
|
|
configs = [
|
|
EvalConfig(
|
|
task_getter_type="Default",
|
|
number_of_samples_in_corpus=25,
|
|
benchmark="TwoWikiMultiHop",
|
|
qa_engine="cognee_graph_completion",
|
|
building_corpus_from_scratch=True,
|
|
answering_questions=True,
|
|
evaluating_answers=True,
|
|
calculate_metrics=True,
|
|
dashboard=True,
|
|
),
|
|
EvalConfig(
|
|
task_getter_type="Default",
|
|
number_of_samples_in_corpus=25,
|
|
benchmark="Musique",
|
|
qa_engine="cognee_graph_completion",
|
|
building_corpus_from_scratch=True,
|
|
answering_questions=True,
|
|
evaluating_answers=True,
|
|
calculate_metrics=True,
|
|
dashboard=True,
|
|
),
|
|
]
|
|
|
|
# Run evaluations in parallel with different configurations
|
|
modal_tasks = [modal_run_eval.remote.aio(config.to_dict()) for config in configs]
|
|
await asyncio.gather(*modal_tasks)
|