Перейти к содержимому

01. Web Research Agent: поиск и структурированный отчёт

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

Пользователь задаёт исследовательский вопрос. Агент должен найти актуальные материалы и свести их в структурированный текст с указанием источников. Граница применимости: это не глубокое исследование и не проверка фактов — агент пересказывает то, что вернул поиск.

Два узла и линейный маршрут:

flowchart LR
  Q["Запрос"] --> S["search"]
  S --> R["synthesize"]
  R --> O["Отчёт"]

Состояние описано типизированным словарём: messages, query, search_results, report. Каждый узел обновляет своё поле.

  1. search_web вызывает TavilySearch(max_results=5) и нормализует результат — провайдер может вернуть словарь или список.
  2. synthesize_report склеивает найденное в текст, обрезая каждый фрагмент до 500 символов, и просит модель собрать отчёт по схеме «Summary → Key Findings → Sources».
  3. Граф завершается, результат печатается в консоль.
graph = StateGraph(ResearchState)
graph.add_node("search", search_web)
graph.add_node("synthesize", synthesize_report)
graph.set_entry_point("search")
graph.add_edge("search", "synthesize")
graph.add_edge("synthesize", END)
  • Цикл не обязателен. Двух узлов достаточно, если маршрут известен. Это workflow, а не агент в строгом смысле.
  • Нормализация ответа инструмента. Один и тот же инструмент может вернуть словарь или список; проверка типа — дешёвая страховка.
  • Обрезка фрагментов. [:500] ограничивает контекст и стоимость, но теряет конец длинных страниц.
  • Источники в промпте. URL попадает в текст, поэтому модель может на него сослаться.
  • Нет проверки источников. Агент пересказывает то, что вернул поиск, включая мусор и SEO-страницы.
  • Нет дедупликации. Пять результатов могут быть перепечатками одного текста.
  • Обрезка по символам рвёт смысл на середине предложения.
  • Линейный маршрут не уточняет запрос. Если поиск ничего не дал, агент всё равно синтезирует отчёт по пустому результату.

Для продакшена сюда добавляются: фильтр доменов, дедупликация, проверка релевантности и явный отказ при пустом результате.

  • Tavily — поисковый API, использованный в примере.