Spaces:
Sleeping
Sleeping
File size: 3,657 Bytes
b3b0ccd | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 | from langchain_core.tools import tool
import config
from db.parent_store_manager import ParentStoreManager
from core.execution_logger import log_error, log_tool_end, log_tool_start
class ToolFactory:
def __init__(self, collection):
self.collection = collection
self.parent_store_manager = ParentStoreManager()
def _search_child_chunks(self, query: str, limit: int = config.DEFAULT_RETRIEVAL_K) -> str:
"""Search document excerpts for evidence related to the user question.
Use this as the first retrieval step. Results include parent IDs, file
names, and short child-chunk excerpts. If excerpts are relevant but too
fragmented to answer confidently, call retrieve_parent_chunks with the
returned parent_id.
Args:
query: Focused search query with concrete keywords from the question.
limit: Maximum number of child chunks to return.
"""
log_tool_start("search_child_chunks", {"query": query, "limit": limit})
try:
results = self.collection.similarity_search(
query,
k=limit,
score_threshold=config.RETRIEVAL_SCORE_THRESHOLD,
)
if not results:
output = "NO_RELEVANT_CHUNKS"
log_tool_end("search_child_chunks", output)
return output
output = config.CHILD_CHUNK_SEPARATOR.join([
f"Parent ID: {doc.metadata.get('parent_id', '')}\n"
f"File Name: {doc.metadata.get('source', '')}\n"
f"Content: {doc.page_content.strip()}"
for doc in results
])
log_tool_end("search_child_chunks", output)
return output
except Exception as e:
log_error("search_child_chunks", e)
output = f"RETRIEVAL_ERROR: {str(e)}"
log_tool_end("search_child_chunks", output)
return output
def _retrieve_parent_chunks(self, parent_id: str) -> str:
"""Retrieve the full parent chunk for a relevant child search result.
Use this only after search_child_chunks returns a relevant parent_id and
the child excerpt needs more surrounding context. Do not call this for
parent IDs already available in compressed context.
Args:
parent_id: Parent chunk ID returned by search_child_chunks.
"""
log_tool_start("retrieve_parent_chunks", {"parent_id": parent_id})
try:
parent = self.parent_store_manager.load_content(parent_id)
if not parent:
output = "NO_PARENT_DOCUMENT"
log_tool_end("retrieve_parent_chunks", output)
return output
output = (
f"Parent ID: {parent.get('parent_id', 'n/a')}\n"
f"File Name: {parent.get('metadata', {}).get('source', 'unknown')}\n"
f"Content: {parent.get('content', '').strip()}"
)
log_tool_end("retrieve_parent_chunks", output)
return output
except Exception as e:
log_error("retrieve_parent_chunks", e)
output = f"PARENT_RETRIEVAL_ERROR: {str(e)}"
log_tool_end("retrieve_parent_chunks", output)
return output
def create_tools(self) -> list:
"""Create and return the list of tools."""
search_tool = tool("search_child_chunks")(self._search_child_chunks)
retrieve_tool = tool("retrieve_parent_chunks")(self._retrieve_parent_chunks)
return [search_tool, retrieve_tool]
|