feat: deep search agent with virtual filesystem and web search

2026-05-08 16:11:45 +03:00
commit 85d4ae32a8
5 changed files with 299 additions and 0 deletions
@@ -0,0 +1,40 @@
+# Задание 3: Самописный поисковый агент (Deep Agent)
+
+## Описание
+
+Deep search agent на основе курса "deep agents from scratch".
+Агент умеет:
+1. Искать информацию в интернете (DuckDuckGo)
+2. Создавать и управлять виртуальными файлами в памяти
+3. Выгружать виртуальные файлы в реальную файловую систему
+
+## Стек
+
+- Python 3.10+
+- langchain-core, langchain-openai, langgraph, duckduckgo-search, pydantic
+
+## Установка
+
+```bash
+pip install -r requirements.txt
+cp .env.example .env
+# Заполнить OPENAI_API_KEY в .env
+```
+
+## Запуск
+
+```bash
+python main.py
+```
+
+## Архитектура
+
+- `agent.py` — виртуальная файловая система, инструменты агента, сборка ReAct-агента
+- `main.py` — точка входа с примером задания (исследование темы LangGraph)
+
+## Как работает
+
+1. Агент получает задачу
+2. Ищет информацию через `search_web()`
+3. Сохраняет результаты в виртуальную ФС через `write_file()`
+4. В конце вызывает `export_files()` для выгрузки на реальный диск