task3-deep-search-agent/README.md

Задание 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

Установка

pip install -r requirements.txt
cp .env.example .env
# Заполнить OPENAI_API_KEY в .env

Запуск

python main.py

Архитектура

• agent.py — виртуальная файловая система, инструменты агента, сборка ReAct-агента
• main.py — точка входа с примером задания (исследование темы LangGraph)

Как работает

1. Агент получает задачу
2. Ищет информацию через search_web()
3. Сохраняет результаты в виртуальную ФС через write_file()
4. В конце вызывает export_files() для выгрузки на реальный диск