# Приложение и облачный воркспейс

> Подключи приложение Eggent к облачному воркспейсу, и Mac с облаком станут одним агентом: что синхронизируется, что остаётся на каждой стороне и как чат может работать там и там.

Source: https://eggent.ai/r/docs/desktop-cloud/

Без входа [приложение Eggent для Mac](https://eggent.ai/r/docs/desktop-app.md) работает само по себе, и всё остаётся на твоём компьютере. Когда ты вошёл в облачный воркспейс Eggent Cloud, компьютер и воркспейс — **один агент**: те же файлы, те же чаты, та же память о каждом чате, те же вложения. Переключателя между «локальным» и «облачным» агентом нет. Начал чат в браузере — продолжай в приложении, агент помнит.

## Подключение {#connect}

На первом экране («Подключить облачный Eggent?») или позже через **меню Eggent → «Облако и синхронизация…» → «Подключить аккаунт»** введи:

- **название воркспейса** — часть адреса до `.cloud.eggent.ai` (вставленный адрес приложение само сократит);
- **логин** и **пароль** воркспейса — те же, что в браузере.

Приложение использует их один раз, чтобы связать этот компьютер с воркспейсом, и пароль не хранит. При подключении компьютер добавляется в синхронизацию воркспейса, а приложение получает ключ к ИИ воркспейса. **«У меня ещё нет аккаунта»** открывает страницу регистрации в облаке в браузере; регистрации в самом приложении пока нет.

Программа синхронизации входит в приложение, ставить ничего не нужно. Это отдельная вещь от [Файлов на компьютере](https://eggent.ai/r/docs/file-sync.md), где синхронизируется только папка проектов через программу, которую ставишь сам.

## Один агент {#one-agent}

Синхронизируются в обе стороны, даже когда воркспейс спит:

- **Файлы** — папка проектов.
- **Чаты** — то, что экран показывает по каждому разговору.
- **Память агента** — то, что агент помнит о каждом чате, поэтому он продолжает с того места, где остановился на другой стороне.
- **Вложения.**
- **Доска задач** — для воркспейса, который позволяет чатам идти на любой стороне (см. [Где работает карточка](#board)).

В заголовке окна видно, как идёт синхронизация: *всё синхронизировано*, *синхронизация 40%*, *нет связи с облаком*, *проблема с синхронизацией*. **Меню Eggent → «Облако и синхронизация…»** показывает то же подробнее, с перечнем того, что идёт в одном состоянии. Без сети файлы сохраняются здесь и уходят, как только связь вернётся.

## Что остаётся на каждой стороне {#separate}

Не синхронизируется никогда, так задумано:

- **Ключи и настройки.** У каждой стороны свои ключи провайдеров, вход и предпочтения. Подключение воркспейса никогда не уводит тебя с провайдера, которого ты выбрал.
- **Подключения Telegram.**
- **Настройки MCP-серверов** (`.mcp.json`), потому что в них могут быть токены.
- **Расписания.** Расписание взводится внутри одного работающего агента, а два компьютера, каждый из которых запустит задачу «в 7 утра», опубликовали бы дважды. Облако работает, пока Mac выключен, поэтому важные расписания живут там. **Расписание, созданное в приложении, работает, только пока приложение открыто.** Задачу, которая должна идти строго по времени, создай в облаке.

## Место в тарифе {#room}

Облако останавливает агента, когда место в тарифе кончилось, поэтому приложение не заполнит его без спроса. Файлы отправляются всегда. Чаты, память агента и вложения — только если всё помещается; если нет, приложение один раз спрашивает, прежде чем что-то отправить:

> История чатов не поместится в тариф. … **«Оставить здесь»** или **«Отправить всё равно»**?

Если оставить здесь, файлы синхронизируются, а история остаётся на этом компьютере; **«Облако и синхронизация»** говорит об этом и оставляет кнопку **«Отправить всё равно»** на потом. Без истории в одном состоянии чаты не могут идти и на другой стороне (см. ниже). Освободи место или смени тариф — и отправь.

## Два компьютера {#two-computers}

К одному воркспейсу можно подключить и другой Mac. У каждого своя копия. Если на двух разных компьютерах в один чат пишут, пока они не связаны, копии **объединяются**, а не откладываются в сторону: сохраняется каждое сообщение с обеих сторон, а агент продолжает с той ветки, что была активна последней. Пока какой-нибудь подключённый компьютер не объединил копии, облако может показывать такой чат дважды; это проходит за секунды после того, как любой подключённый компьютер выходит в сеть.

## ИИ воркспейса {#included-model}

Пока ты подключён, ИИ, включённый в воркспейс, доступен и здесь — с тем же балансом и теми же лимитами, в **Настройки → Модели**. Он не заменяет провайдера, которого ты выбрал сам. **«Отключить»** убирает его с этого компьютера.

## Чат может идти на любой стороне {#where-it-runs}

> [!NOTE]
> Это включается воркспейс за воркспейсом. Если в **«Облако и синхронизация»** у пункта **«Задачи из облака»** написано «Для вашего пространства это пока не включено», тебе это пока недоступно.

Когда приложение на компьютере и облачный воркспейс работают вместе, каждый чат может идти на любой из двух сторон, и выбираешь ты. Элемент в строке под полем сообщения показывает, где идёт этот чат: **«Облако»** или **«Этот компьютер»** (в облачной версии компьютер значится под своим именем). Выбери другое место — и чат пойдёт там со следующего сообщения, в каком бы из двух экранов ты ни писал.

Зачем: на компьютере агент работает с файлами и программами, которые на нём лежат. В облаке он продолжает работать, когда компьютер закрыт. Чат, начатый на компьютере, можно отдать облаку на часы работы; чат в облачной версии можно отдать твоему компьютеру.

- **Ты остаёшься там, где был.** Ответ идёт на тот экран, где ты написал, и кнопка остановки, подсказки в ходе работы и вопросы агента работают как всегда. У чата, который идёт на другой стороне, в списке маленький значок облака или ноутбука.
- **Чат записывает одно место.** Место, где чат идёт, — единственное, что его записывает; другая сторона получает его через синхронизацию, а экран ждёт, пока он придёт, обычно несколько секунд.
- **У агента есть всё нужное.** Чат передаётся, только когда разговор, память агента о нём и приложенные файлы дошли до места, где он пойдёт. Сообщение, отправленное через секунду после загрузки файла, ждёт этого файла.
- **Если другой стороны нет,** чат так и скажет, сохранит твоё сообщение и предложит **«Запустить здесь»** (это отправит сообщение сюда) или **«Повторить»**.

Чат можно передать только между твоим компьютером и твоим облаком, но не с одного компьютера на другой. В Telegram команда `/here` запускает чат на той стороне, которая отвечает: у общего бота это облако, так что она возвращает чат, перенесённый на выключенный компьютер.

## Разрешить облаку запускать чаты на твоём компьютере {#computer-allow}

Пока ты не включишь, это выключено: **меню Eggent → «Облако и синхронизация…» → «Задачи из облака»**:

- **«Не разрешать»** (по умолчанию). Твой компьютер ничего не запускает для облака.
- **«Спрашивать про каждый чат».** Когда облако в первый раз хочет запустить чат на твоём компьютере, приложение показывает, какой это чат и начало сообщения, и спрашивает. Разрешённый чат остаётся разрешённым, пока им пользуются, и сутки после этого. Нет ответа в течение минуты — значит, нет.
- **«Разрешить любые чаты».**

Чат, запущенный для облака, работает с файлами и инструментами твоего компьютера — точно так же, как чат, начатый на нём. Разрешай только то, что запустил бы сам. Этот вопрос — единственное, что стоит между облаком и твоим компьютером: агент внутри твоего воркспейса тоже может попросить чат, поэтому читай, что показывает окно, прежде чем соглашаться, и помни, что **«Разрешить любые чаты»** убирает вопрос.

Приложение показывает сообщение таким, каким оно будет запущено (и сколько из него оставлено за скобками), задаёт сразу не больше нескольких вопросов, не спрашивает про запрос, от которого облако уже отказалось, и несколько секунд не переспрашивает про чат, которому ты только что отказал. Разрешение на чат действует и на его следующие сообщения. Если это выключить, компьютер сразу перестаёт принимать запросы облака; чаты, которые ты отдаёшь облаку с компьютера, продолжают работать.

Для проекта, который идёт на твоей программе ([Работа на своей подписке](https://eggent.ai/r/docs/desktop-programs.md)), в режиме «Спрашивать про каждый чат» приложение спрашивает отдельно и называет программу и то, как далеко она достаёт. «Разрешить любые чаты» распространяется и на такие чаты.

## Где работает карточка {#board}

Когда приложение на компьютере связано с твоим воркспейсом, карточка на [доске задач](https://eggent.ai/r/docs/board.md) может выполняться и на компьютере, и в облаке. Поле **«Где выполнять»** в карточке говорит где: **«Облако»** (по умолчанию: работает и при выключенном компьютере) или твой компьютер под его именем — работать с файлами и программами на нём.

- **Каждую карточку запускает облако,** где бы она ни выполнялась. Карточка для твоего компьютера передаётся ему так же, как чат, поэтому приложение сначала спросит, если ты не разрешил любые чаты.
- **Компьютер, которого нет, не проваливает карточку.** Она ждёт в очереди с пометкой «… недоступен» и стартует, когда приложение вернётся и будет принимать задачи от облака.
- **Её чат тоже идёт там.** Сообщение в чате карточки — с любой стороны или из Telegram — выполняется там же, где карточка. Перенос чата на другую сторону переносит и карточку.
- **Вопрос, остановка и отказ** работают как у любой карточки: вопрос ждёт на карточке в обоих местах, «Стоп» работает с любой стороны, а компьютер, который ответил «нет», оставляет карточку ждать тебя, а не спрашивает снова.

## Отключить {#disconnect}

**Меню Eggent → «Облако и синхронизация…» → «Отключить».** Файлы на этом компьютере остаются, но перестают обновляться вместе с облачными; ИИ воркспейса здесь перестаёт работать, а приложение снова работает само по себе.

Отключение убирает связь на этом компьютере. Из списка устройств твоего воркспейса компьютер пока не удаляется; если хочешь убрать запись, напиши в поддержку через кнопку **«Помощь»** в воркспейсе.

## Если не подключается {#troubleshooting}

- **«Логин или пароль не подошли».** Нужен логин самого воркспейса — тот, что ты вводишь в браузере.
- **«Такого пространства нет».** Проверь название: это часть адреса до `.cloud.eggent.ai`.
- **«Синхронизация для этого пространства недоступна».** Она не включена для этого воркспейса; напиши в поддержку.
- **«Не удалось связаться с облаком».** Проверь интернет и попробуй ещё раз. Если после этого в заголовке *нет связи с облаком*, файлы сохраняются здесь и уйдут, как только связь вернётся.
- **«Слишком много попыток».** Подожди минуту.
- **Файлы не приходят.** Посмотри состояние в **«Облако и синхронизация»**. Если там сказано, что история задержана, дело в месте в тарифе ([см. выше](#room)); файлы при этом синхронизируются.

### Чат не идёт на другой стороне {#remote-troubleshooting}

- **«… сейчас недоступен».** Приложение закрыто, нет сети или **«Задачи из облака»** выключены. Открой приложение или выбери **«Запустить здесь»**.
- **«… ещё не получил последние изменения этого чата».** Файлы не дошли. Подожди несколько секунд и отправь снова; состояние синхронизации — в **«Облако и синхронизация»**.
- **«… пока не может принять этот чат».** История чатов на компьютере не синхронизирована с облаком.
- **«… отказался запускать этот чат».** Ты или таймер окна ответили «нет». Отправь снова и разреши.
- **«… сейчас не может запустить этот чат. …»** Проект идёт на программе ([Работа на своей подписке](https://eggent.ai/r/docs/desktop-programs.md)), а на том компьютере она не готова: нет входа, не установлена, исчерпан лимит. Разберись с этим в приложении на том компьютере или запусти чат здесь.
- **«Этот чат только что перенесли на эту сторону…»** Ты перенёс чат на другой стороне и написал здесь, прежде чем синхронизация донесла перенос. Подожди несколько секунд и отправь снова.
- **Перенос чата пишет, что тот ещё не дошёл.** Прежде чем чат переносят, сторона, которая переносит, должна иметь то, что другая записала последней. Подожди несколько секунд и попробуй снова.
- **Ответ остановился, а ход продолжился.** Если связь с другой стороной обрывается посреди хода, ход продолжается там, а его ответ появится здесь, когда его принесёт синхронизация.
- **Компьютер уснул или потерял связь за работой.** Облако замечает это примерно через минуту и сообщает, что связь потеряна. Ход продолжится там, когда компьютер вернётся, а ответ появится здесь через синхронизацию. «Стоп» работает с любой стороны.
