orka.tools.search_tools module

Search Tools Module

This module implements web search tools for the OrKa framework. These tools provide capabilities to search the web using various search engines.

The search tools in this module include: - GoogleSearchTool: Searches the web using Google Custom Search API - DuckDuckGoTool: Searches the web using DuckDuckGo search engine

These tools can be used within workflows to retrieve real-time information from the web, enabling agents to access up-to-date knowledge that might not be present in their training data.

class orka.tools.search_tools.DuckDuckGoTool(tool_id, prompt=None, queue=None, **kwargs)

Bases: BaseTool

A tool that performs web searches using the DuckDuckGo search engine. Returns search result snippets from the top results.

run(input_data: Any) → List[str]

Perform a DuckDuckGo search and return result snippets.

Parameters:

input_data (dict) – Input containing search query.

Returns:

List of search result snippets.

Return type:

list

class orka.tools.search_tools.WebSearchTool(tool_id, prompt=None, queue=None, **kwargs)

Bases: BaseTool

A more robust web search tool that tries multiple search methods. Falls back through different search engines and methods.

run(input_data: Any) → List[str]

Perform web search using multiple fallback methods.

Parameters:

input_data – Input containing search query.

Returns:

List of search result snippets.

Return type:

list

class orka.tools.search_tools.SimpleSearchTool(tool_id, prompt=None, queue=None, **kwargs)

Bases: BaseTool

A simple search tool that provides basic information without external APIs. Useful as a last resort when all other search methods fail.

run(input_data: Any) → List[str]

Provide basic search information without external APIs.

Parameters:

input_data – Input containing search query.

Returns:

List with timestamp and basic information.

Return type:

list