EGGENT документация
English github Открыть Eggent Cloud ▸
Содержание
Справочник

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

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

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

Общая схема

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

Оркестратор и проекты

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/# нарисованные картинки
    └── …                # файлы проекта

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

Что можно править руками

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

Где лежат секреты

  • Ключи провайдеров моделей — 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/ как к секрету.

Эта страница в Markdown