[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-1)def search(
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-2)    query: str,
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-3)    source: str = None,
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-4)    document_type: str = None,
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-5)    freshness_score_min: float = None,
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-6)    n_chunks: int = 10
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-7)) -> dict:
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-8)    """
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-9)    Semantic search that automatically returns results with facet information.
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-10)
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-11)    Args:
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-12)        query: Natural language search query
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-13)        source: Optional filter by document source (aligns with source_facet)
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-14)        document_type: Optional filter by document category
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-15)        freshness_score_min: Optional minimum freshness score
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-16)        n_chunks: Number of chunks to return (default: 10)
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-17)
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-18)    Returns:
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-19)        Dict with chunks, facets, and system instructions
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-20)    """
[](https://jxnl.co/writing/2025/08/27/facets-context-engineering/#__codelineno-7-21)    pass