Slutprov: bygg ett spårbart RAG-flöde

"""RAG-slutprov. Ändra funktionerna nedan; testerna bedömer beteende på nya dokument."""

ABSTAIN = "Jag hittar inget stöd i underlaget."


def chunk_documents(documents, max_words=30):
    """documents: [{id, text}] -> [{source_id, text}], i ursprunglig ordning."""
    # TODO: dela varje dokuments ord i stycken utan att blanda källor.
    raise NotImplementedError


def retrieve(query, chunks, k=2):
    """Returnera de mest relevanta källmärkta styckena; [] om inget innehållsord matchar."""
    # TODO: rangordna med en reproducerbar lexikal poäng; undvik träffar på bara frågeord.
    raise NotImplementedError


def answer_with_evidence(query, hits):
    """Returnera {answer: str, citations: [{source_id, quote}]} eller ett belagt avstående."""
    # TODO: välj ett relevant meningsutdrag från träffarna och citera exakt den källan.
    raise NotImplementedError


def evaluate_retrieval(cases, chunks, k=2):
    """cases: [{query, source_id}] -> recall@k som flyttal mellan 0 och 1."""
    # TODO: använd retrieve och räkna hur ofta rätt källa finns bland de k första träffarna.
    raise NotImplementedError