Web search tool

WebSearchTool

Тип: Вспомогательный тул Исходный код: sgr_agent_core/tools/web_search_tool.py

Выполняет поиск в интернете для получения актуальной информации с использованием Tavily Search API.

Параметры

reasoning (str) - почему нужен этот поиск и что ожидается найти
query (str) - поисковый запрос на том же языке, что и запрос пользователя
max_results (int, по умолчанию 5, диапазон 1-10) - максимальное количество результатов

Поведение

Выполняет поиск через TavilySearchService
Добавляет найденные источники в словарь context.sources
Создает SearchResult и добавляет его в context.searches
Увеличивает context.searches_used
Возвращает форматированную строку с поисковым запросом и результатами (заголовки, ссылки, сниппеты)

Использование

Используется для поиска актуальной информации, проверки фактов, исследования текущих событий, технологических обновлений или любой темы, требующей свежей информации.

Лучшие практики

Используйте конкретные термины и контекст в запросах
Для аббревиатур добавляйте контекст: "SGR Schema-Guided Reasoning"
Используйте кавычки для точных фраз: "Structured Output OpenAI"
Формулируйте поисковые запросы на том же языке, что и запрос пользователя
Для вопросов о датах или числах включайте конкретный год или контекст в запрос
Сниппеты поиска часто содержат прямые ответы, проверяйте их внимательно

Конфигурация

search:
  tavily_api_key: "your-tavily-api-key"  # Обязательно: API-ключ Tavily
  tavily_api_base_url: "https://api.tavily.com"  # URL API Tavily
  max_searches: 4  # Максимальное количество поисковых операций
  max_results: 10  # Максимум результатов в поисковом запросе (переопределяет max_results тула, если меньше)

После достижения max_searches тул автоматически удаляется из доступных тулов.

Пример

agents:
  research_agent:
    search:
      max_searches: 6
      max_results: 15
    tools:
      - "web_search_tool"