add README.md
This commit is contained in:
@@ -1,70 +1,17 @@
|
||||
# Deep Agent — поисковый агент с виртуальной ФС
|
||||
# DeepAgent Search
|
||||
|
||||
Реализация **Deep Agent** на основе фреймворка `deepagents` (deep agents from scratch).
|
||||
This repository contains a simple deep agent that can search the web and create virtual files. The agent is built using the `deepagents` library and follows the "deep agents from scratch" pattern.
|
||||
|
||||
## Что умеет агент
|
||||
## Features
|
||||
|
||||
| Возможность | Инструмент |
|
||||
|-------------|------------|
|
||||
| Поиск в интернете | `web_search` (DuckDuckGo, без API-ключа) |
|
||||
| Создание файлов в виртуальной ФС | `write_file` |
|
||||
| Чтение и редактирование файлов | `read_file`, `edit_file` |
|
||||
| Выгрузка виртуальных файлов в реальную ФС | `export_virtual_files` |
|
||||
- Web search using DuckDuckGo.
|
||||
- Virtual file creation in an in‑memory filesystem.
|
||||
- Export virtual files to the real filesystem at the end of the run.
|
||||
|
||||
## Архитектура
|
||||
|
||||
```
|
||||
main.py
|
||||
├── LLM: ChatOpenAI → BroJS (openai/gpt-oss-20b:free)
|
||||
├── Backend: CompositeBackend
|
||||
│ ├── LocalShellBackend (virtual_mode=True, root=./workspace/)
|
||||
│ └── FilesystemBackend (virtual_mode=True, route=/fs/)
|
||||
└── Tools: web_search, export_virtual_files
|
||||
```
|
||||
|
||||
Агент работает в **виртуальной ФС** (`./workspace/`). По завершении инструмент `export_virtual_files` копирует все созданные файлы в реальную папку `./output/`.
|
||||
|
||||
## Установка
|
||||
## Usage
|
||||
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
python main.py "search query"
|
||||
```
|
||||
|
||||
## Переменные окружения
|
||||
|
||||
| Переменная | Описание |
|
||||
|------------|----------|
|
||||
| `JOURNAL_MCP_PAT` | Токен доступа к BroJS LLM |
|
||||
|
||||
Создай файл `.env`:
|
||||
```
|
||||
JOURNAL_MCP_PAT=jrnl_...
|
||||
```
|
||||
|
||||
## Запуск
|
||||
|
||||
```bash
|
||||
# Запрос по умолчанию (исследование LangGraph)
|
||||
python main.py
|
||||
|
||||
# Свой запрос
|
||||
python main.py "расскажи про LangChain агентов и сохрани в файл"
|
||||
```
|
||||
|
||||
## Пример работы
|
||||
|
||||
```
|
||||
Запрос: Найди информацию о LangGraph...
|
||||
|
||||
=== Ответ агента ===
|
||||
Файл langgraph_research.md сохранён и выгружен в ./output/
|
||||
|
||||
=== Файлы в output/ ===
|
||||
langgraph_research.md (2847 байт)
|
||||
```
|
||||
|
||||
## Источники
|
||||
|
||||
- [deep-agents-from-scratch](https://github.com/langchain-ai/deep-agents-from-scratch)
|
||||
- [deepagents PyPI](https://pypi.org/project/deepagents/)
|
||||
- [LangChain docs](https://python.langchain.com/)
|
||||
The agent will perform the search, create virtual files, and write them to the current directory.
|
||||
|
||||
Reference in New Issue
Block a user