EGGENT документация
Работа с агентом

Проекты и оркестратор

Зачем делить работу на проекты, как их создавать и переключать, что общего у проектов и оркестратора и как агент сам находит нужный проект.

Один воркспейс — много направлений работы. Чтобы они не смешивались, у каждого направления свой проект, а над всеми стоит оркестратор.

Оркестратор

Когда в боковой панели не выбран ни один проект, отвечает оркестратор. Это «главный» разговор:

  • для задач, которые не относятся ни к одному проекту;
  • для вопросов «что у меня где лежит»;
  • для задач, которые затрагивают несколько проектов сразу.

В контексте оркестратора лежит то, что должно быть известно везде: кто ты, чем занимаешься, как тебе удобно получать ответы. Карточка «Бизнес ИИ система» пишет именно туда.

Проекты

Проект — это папка с файлами и собственные настройки агента: контекст, память, навыки, MCP-серверы и, при желании, модель. Когда проект выбран, агент работает в его папке и видит только то, что относится к нему.

Хорошие проекты — это постоянные направления: «Сайт», «Контент для Telegram-канала», «Договоры», «Аналитика продаж», «Учёба». Плохой проект — разовый вопрос: для него хватит чата у оркестратора.

Создать проект

Есть четыре способа:

  1. Из боковой панели: + рядом с заголовком Проект открывает короткую форму: название, описание, инструкции для агента. Новый проект открывается с пустым чатом, можно сразу писать. Ход агента на это не тратится.
  2. Попросить в чате: «создай проект „Договоры“ для работы с договорами поставки». Агент создаст проект, может сразу написать ему инструкции и переключиться в него.
  3. Запустить карточку быстрого старта. Большинство карточек сами создают проект под свою работу и называют его по названию карточки.
  4. В настройках: Настройки → Проекты, та же форма.

Переключение между проектами

  • Вручную: выбери проект в боковой панели. Новый чат начнётся в нём.
  • Агент сам: оркестратор знает список проектов и, если сообщение явно относится к одному из них, переключается туда и продолжает работу там. Разговор при этом не обрывается: чат остаётся тем же, меняется рабочая папка.

Чтобы оркестратор лучше понимал, куда что относится, в его контексте есть таблица «Проекты в этом пространстве»: проект, его id и для чего он нужен. Новый проект добавляет туда строку сам. Таблицу можно поправить в Настройки → Контекст (оркестратор).

Спросить проект из другого чата

Начни сообщение с @ и названия проекта, затем скажи, что нужно сделать:

@Магазин сколько возвратов было на прошлой неделе?

Проект выполнит работу со своими файлами, навыками, подключёнными сервисами, инструкциями и моделью, в отдельном чате, а ответ вернётся в тот чат, где ты написал. Ты остаёшься на месте: активный проект не меняется, а агент в твоём чате говорит, что ответ пришёл от проекта.

  • В браузере @ в начале поля показывает список других проектов; Tab или Enter выбирает. Сообщение, которое начинается с названия проекта, подсвечивается: видно, что его поняли.
  • В Telegram и через внешний API то же сообщение работает как написано.
  • Работа хранится в отдельном чате проекта с названием Из «…» и значком-стрелкой в списке чатов проекта. В карточке в твоём чате есть ссылка Открыть в … — там всё, что проект сделал. Если снова написать @Магазин из того же разговора, он продолжит тот же чат вместе с историей.
  • Название ищется так, как ты его пишешь: заглавные буквы, дефис вместо пробела и «ё» вместо «е» не важны, поэтому @мой-магазин — это «Мой магазин». Если подходят два проекта, агент спросит, какой ты имел в виду.
  • Начинаешь только ты. Агент сам никогда не обращается к проекту, а проект не может спросить другой проект.

Что полезно знать:

  • Одновременно работают не больше двух проектов, остальные ждут очереди. Одна работа останавливается через десять минут. Стоп в твоём чате останавливает и проект.
  • Проект — это рабочий стол, а не запертая комната: он разделяет инструкции и файлы, но его команды могут дотянуться до других мест воркспейса.
  • Если проект использует подключённый сервис (MCP), который при первом подключении просит разрешения, один раз разреши его в собственном чате проекта: у обращения нет, кого спросить, и неодобренного сервиса там просто нет.
  • Не работает в лёгком чате и в общем публичном чате; сообщение, название в котором не совпало ни с одним проектом, — обычное сообщение.

Настройки проекта

Во всех вкладках настроек, где это имеет смысл (модели, контекст, память, навыки, MCP, расписания), справа вверху есть переключатель: оркестратор или конкретный проект. Выбери проект — и вкладка покажет его настройки.

Что Где хранится Подробнее
Инструкции context.md проекта Контекст
Память memory.md проекта Память
Навыки папка skills/ проекта Навыки
Внешние сервисы .mcp.json проекта MCP
Модель model.json проекта Модели

Удалить проект

Наведи на проект в боковой панели, открой меню и выбери Удалить проект. Удаляются папка проекта со всеми файлами и его настройки. Это необратимо — если файлы нужны, сначала скачай их или включи синхронизацию с компьютером.

Советы

  • Один проект — одна работа. Если в контексте проекта появляются инструкции «для случая А» и «для случая Б», это два проекта.
  • Держи в проекте исходные материалы: образцы, прайсы, примеры хороших текстов. Агент будет на них опираться.
  • Не бойся просить оркестратора: «сделай это в проекте „Сайт“». Он сам переключится.