# Устройство воркспейса

> Какие папки и файлы составляют воркспейс Eggent — проекты, оркестратор, чаты, вложения, настройки, расписания — и что из них можно править руками.

Source: https://eggent.ai/r/docs/workspace-layout/

Всё состояние воркспейса — это обычные файлы в папке `data/`. В облаке она лежит на сервере, на своём сервере — рядом с установкой. Агент работает внутри `data/projects/`.

## Общая схема {#overview}

```text
data/
├── projects/            # файлы оркестратора и все проекты
├── chats/               # история чатов
├── chat-files/          # вложения чатов, по папке на чат
├── settings/            # настройки, токен API, секрет входа
├── board/               # доска задач: по файлу на карточку
├── versions/            # версии файлов: что было в каждом до каждой правки
├── memory/              # служебные данные памяти
├── learning/            # служебное: счётчики и журнал того, что агент выучил
├── models/whisper/      # модель распознавания речи
└── pi-agent/            # среда выполнения: ключи, модели, пакеты
```

## Оркестратор и проекты {#projects}

```text
data/projects/
├── context.md           # контекст оркестратора
├── memory.md            # память оркестратора
├── learned.md           # короткие заметки агента о тебе и о работе
├── skills/              # навыки оркестратора, в том числе написанные агентом
│   └── .archive/        # выученные навыки, которыми давно не пользовались
├── .mcp.json            # MCP-серверы оркестратора
├── Переписка/           # в компании: файлы из переписки, по папке на человека
├── .shared/             # в компании: открытые тебе папки компании (без истории)
│
└── <id-проекта>/
    ├── project.json     # название и описание проекта
    ├── context.md       # контекст проекта
    ├── memory.md        # память проекта
    ├── model.json       # своя модель проекта (если задана)
    ├── skills/          # навыки проекта
    ├── .mcp.json        # MCP-серверы проекта
    ├── .pi/             # служебное: расписания и состояние
    ├── generated-images/# нарисованные картинки
    └── …                # файлы проекта
```

Папка проекта — его рабочая папка: агент читает и пишет файлы здесь, панель **Файлы** показывает её же.

## Что можно править руками {#editable}

| Файл | Можно? | Как лучше |
| --- | --- | --- |
| `context.md`, `memory.md` | Да | **Настройки → Контекст / Память** или попросить агента |
| `learned.md` | Да | **Настройки → Память → Что агент выучил**: одна заметка в строке, начинается с `- ` |
| `skills/<имя>/SKILL.md` | Да | Любым редактором, агентом или через панель **Файлы** |
| `.mcp.json` | Да | **Настройки → MCP** |
| `model.json` | Да | **Настройки → Модели**, область — проект |
| `.pi/subagent-schedules/*` | **Нет** | Только через агента: «перенеси задачу…». Ручная правка ломает работающее расписание |
| `data/settings/*`, `data/pi-agent/auth.json` | Нет | Через интерфейс настроек |

## Где лежат секреты {#secrets}

- Ключи провайдеров моделей — `data/pi-agent/auth.json`.
- Токен внешнего API, секрет входа — `data/settings/`.
- Токены MCP-серверов — в `.mcp.json` проекта или оркестратора.
- Токен Telegram-бота — `data/settings/telegram-integration.json`.

Учётные данные, которые вставили в чат или вывел инструмент, скрываются в сохранённых чатах в `data/chats/`; файл `data/secrets-sweep.json` отмечает, что разовая очистка старых чатов прошла. Служебные файлы сессий в `data/pi-sessions/` — память агента, их не меняют.

При резервном копировании и переносе относись ко всей папке `data/` как к секрету.