agents.memory.search.pro_search.agent

Pro Search Agent implementation.

Provides deep, contextual search with user preferences and advanced reasoning. Similar to Perplexity’s Pro Search feature that goes deeper and considers user context.

Classes

ProSearchAgent

Agent for deep, contextual search with user preferences.

Functions

extract_contextual_insights(content, context)

Extract contextual insights from search content.

generate_follow_up_questions(query, insights)

Generate follow-up questions based on insights.

generate_reasoning_steps(query, refinement)

Generate reasoning steps for complex queries.

get_response_model()

Get the response model for pro search operations.

get_search_instructions()

Get specific search instructions for pro search operations.

get_system_prompt()

Get the system prompt for pro search operations.

refine_query(query, context)

Refine a query based on context and preferences.

Module Contents

class agents.memory.search.pro_search.agent.ProSearchAgent(name='pro_search_agent', engine=None, search_tools=None, **kwargs)

Bases: haive.agents.memory.search.base.BaseSearchAgent

Agent for deep, contextual search with user preferences.

Provides comprehensive search responses that consider user context, preferences, and search history. Performs query refinement and multi-step reasoning for more accurate results.

Features: - Query refinement and expansion - User preference integration - Contextual insights from memory - Multi-step reasoning process - Follow-up question generation - Depth-based search levels

Examples

Basic usage:

agent = ProSearchAgent(
    name="pro_search",
    engine=AugLLMConfig(temperature=0.3)
)

response = await agent.process_search(
    "How can I improve my productivity?",
    context={"domain": "software_development"}
)

With custom depth level:

response = await agent.process_pro_search(
    "What are the best practices for ML deployment?",
    depth_level=4,
    use_preferences=True
)

Initialize the Pro Search Agent.

Parameters:

  • name (str) – Agent identifier

  • engine (haive.core.engine.aug_llm.AugLLMConfig | None) – LLM configuration (defaults to optimized settings)

  • search_tools (list[langchain_core.tools.Tool] | None) – Optional search tools

  • **kwargs – Additional arguments passed to parent

extract_contextual_insights(query, context)

Extract contextual insights from available context.

Parameters:

  • query (str) – Search query

  • context (dict[str, Any]) – Available context

Returns:

List of contextual insights

Return type:

list[haive.agents.memory.search.pro_search.models.ContextualInsight]

generate_follow_up_questions(query, response, context)

Generate relevant follow-up questions.

Parameters:

  • query (str) – Original search query

  • response (str) – Search response

  • context (dict[str, Any]) – Available context

Returns:

List of follow-up questions

Return type:

list[str]

generate_reasoning_steps(query, context)

Generate reasoning steps for the search process.

Parameters:

  • query (str) – Search query

  • context (dict[str, Any]) – Available context

Returns:

List of reasoning steps

Return type:

list[str]

get_response_model()

Get the response model for pro search.

Return type:

type[haive.agents.memory.search.base.SearchResponse]

get_search_instructions()

Get specific search instructions for pro search.

Return type:

str

get_system_prompt()

Get the system prompt for pro search operations.

Return type:

str

Process a pro search query with advanced features.

Parameters:

  • query (str) – Search query

  • context (dict[str, Any] | None) – Optional context

  • depth_level (int) – Search depth (1-5)

  • use_preferences (bool) – Whether to use user preferences

  • generate_follow_ups (bool) – Whether to generate follow-up questions

  • include_reasoning (bool) – Whether to include reasoning steps

  • save_to_memory (bool) – Whether to save to memory

Returns:

Pro search response

Return type:

haive.agents.memory.search.pro_search.models.ProSearchResponse

Process a search query with default pro search settings.

Parameters:

  • query (str) – Search query

  • context (dict[str, Any] | None) – Optional context

  • save_to_memory (bool) – Whether to save to memory

Returns:

Pro search response

Return type:

haive.agents.memory.search.pro_search.models.ProSearchResponse

refine_query(query, context)

Refine the search query based on context and preferences.

Parameters:

  • query (str) – Original search query

  • context (dict[str, Any]) – Context including user preferences and history

Returns:

Search refinement with improved query

Return type:

haive.agents.memory.search.pro_search.models.SearchRefinement

agents.memory.search.pro_search.agent.extract_contextual_insights(content, context)

Extract contextual insights from search content.

Parameters:
Return type:

list[haive.agents.memory.search.pro_search.models.ContextualInsight]

agents.memory.search.pro_search.agent.generate_follow_up_questions(query, insights)

Generate follow-up questions based on insights.

Parameters:

  • query (str)

  • insights (list[haive.agents.memory.search.pro_search.models.ContextualInsight])

Return type:

list[str]

agents.memory.search.pro_search.agent.generate_reasoning_steps(query, refinement)

Generate reasoning steps for complex queries.

Parameters:

  • query (str)

  • refinement (haive.agents.memory.search.pro_search.models.SearchRefinement)

Return type:

list[str]

agents.memory.search.pro_search.agent.get_response_model()

Get the response model for pro search operations.

Return type:

type[haive.agents.memory.search.base.SearchResponse]

agents.memory.search.pro_search.agent.get_search_instructions()

Get specific search instructions for pro search operations.

Return type:

str

agents.memory.search.pro_search.agent.get_system_prompt()

Get the system prompt for pro search operations.

Return type:

str

agents.memory.search.pro_search.agent.refine_query(query, context)

Refine a query based on context and preferences.

Parameters:
Return type:

haive.agents.memory.search.pro_search.models.SearchRefinement