01. Web Research Agent: поиск и структурированный отчёт
Агент принимает тему, ищет в вебе и возвращает отчёт с резюме, ключевыми находками и источниками. Минимальный пример того, как граф из двух узлов заменяет свободный цикл.
Пользователь задаёт исследовательский вопрос. Агент должен найти актуальные материалы и свести их в структурированный текст с указанием источников. Граница применимости: это не глубокое исследование и не проверка фактов — агент пересказывает то, что вернул поиск.
Архитектура
Заголовок раздела «Архитектура»Два узла и линейный маршрут:
flowchart LR Q["Запрос"] --> S["search"] S --> R["synthesize"] R --> O["Отчёт"]
Состояние описано типизированным словарём: messages, query, search_results,
report. Каждый узел обновляет своё поле.
search_webвызываетTavilySearch(max_results=5)и нормализует результат — провайдер может вернуть словарь или список.synthesize_reportсклеивает найденное в текст, обрезая каждый фрагмент до 500 символов, и просит модель собрать отчёт по схеме «Summary → Key Findings → Sources».- Граф завершается, результат печатается в консоль.
Что в коде
Заголовок раздела «Что в коде»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-страницы.
- Нет дедупликации. Пять результатов могут быть перепечатками одного текста.
- Обрезка по символам рвёт смысл на середине предложения.
- Линейный маршрут не уточняет запрос. Если поиск ничего не дал, агент всё равно синтезирует отчёт по пустому результату.
Для продакшена сюда добавляются: фильтр доменов, дедупликация, проверка релевантности и явный отказ при пустом результате.
Связь с другими разделами
Заголовок раздела «Связь с другими разделами»- RAG — если источник не веб, а свой корпус.
- Документы и исследования — домен.
- LangGraph — модель программирования.
Материалы и источники
Заголовок раздела «Материалы и источники»- Tavily — поисковый API, использованный в примере.