﻿---
title: "01. Web Research Agent: поиск и структурированный отчёт"
description: "LangGraph-агент ищет в вебе через Tavily и собирает отчёт из двух узлов: поиск и синтез."
---

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

## Задача

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

## Архитектура

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

```mermaid
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. Граф завершается, результат печатается в консоль.

## Что в коде

```python
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, а не агент](https://wpcraft.ru/aia/foundations/what-is-an-agent.md) в строгом смысле.
- **Нормализация ответа инструмента.** Один и тот же инструмент может вернуть
  словарь или список; проверка типа — дешёвая страховка.
- **Обрезка фрагментов.** `[:500]` ограничивает контекст и стоимость, но теряет
  конец длинных страниц.
- **Источники в промпте.** URL попадает в текст, поэтому модель может на него
  сослаться.

## Где сломается

- **Нет проверки источников.** Агент пересказывает то, что вернул поиск, включая
  мусор и SEO-страницы.
- **Нет дедупликации.** Пять результатов могут быть перепечатками одного текста.
- **Обрезка по символам** рвёт смысл на середине предложения.
- **Линейный маршрут не уточняет запрос.** Если поиск ничего не дал, агент всё
  равно синтезирует отчёт по пустому результату.

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

## Связь с другими разделами

- [RAG](https://wpcraft.ru/aia/patterns/rag.md) — если источник не веб, а свой корпус.
- [Документы и исследования](https://wpcraft.ru/aia/use-cases/documents-and-research.md) — домен.
- [LangGraph](https://wpcraft.ru/aia/frameworks/langgraph.md) — модель программирования.

## Материалы и источники

- [Tavily](https://tavily.com) — поисковый API, использованный в примере.