# Документация Eggent # Документация Eggent > Eggent — ИИ-сотрудник со своим компьютером. Здесь описано всё, что он умеет, и как им пользоваться: в облаке, в Telegram и на своём сервере. Source: https://eggent.ai/r/docs/ Eggent — это рабочее пространство для ИИ-агента. У агента есть свой компьютер: файлы, терминал, память, расписание, навыки и подключённые сервисы. Ты пишешь задачу обычными словами, и он делает работу у себя, а результат остаётся в файлах и в чате. Пользоваться Eggent можно двумя способами: - **Eggent Cloud** — готовое пространство на `cloud.eggent.ai`. Ничего не нужно ставить, модель ИИ уже подключена, пробный период — 7 дней. - **Свой сервер** — открытое ядро с [GitHub](https://github.com/eggent-ai/eggent), ставится одной командой. Все данные лежат в папке `./data` на твоей машине. ## С чего начать {#start} - [Основные понятия](https://eggent.ai/r/docs/concepts.md): Что такое воркспейс, оркестратор, проект, навык и память — за пять минут. - [Регистрация в облаке](https://eggent.ai/r/docs/cloud-signup.md): Как создать пространство через сайт или Telegram-бота. - [Первые шаги](https://eggent.ai/r/docs/first-steps.md): Первая задача, быстрые карточки и пара привычек, которые экономят время. - [Свой сервер](https://eggent.ai/r/docs/self-host-install.md): Установка одной командой, Docker и готовый образ. ## Как устроена документация {#structure} Документация разбита на восемь разделов, от простого к сложному: 1. **Начало работы** — что такое Eggent и как в нём начать. 2. **Работа с агентом** — чаты, проекты, доска задач, файлы, голос и картинки: всё, чем пользуешься каждый день. 3. **Настройка агента** — модели, контекст, память, навыки и MCP: как сделать агента своим. 4. **Автоматизация и интеграции** — расписания, Telegram и HTTP API. 5. **Eggent Cloud** — тарифы, синхронизация файлов с компьютером, сон пространства, вход и поддержка. 6. **Приложение для Mac** — приложение Eggent для твоего компьютера: установка, подключение облачного воркспейса и работа на своей подписке. 7. **Свой сервер** — установка, настройка и обслуживание открытого ядра. 8. **Справочник** — инструменты агента, HTTP API, устройство папок и решения частых проблем. Если нужен ответ на конкретный вопрос, начни с поиска вверху страницы (клавиша `/`) или со [страницы частых проблем](https://eggent.ai/r/docs/troubleshooting.md). ## Для агентов и разработчиков {#agents} Каждая страница есть и в виде обычного Markdown: добавь `.md` к адресу без завершающей косой черты, например [`/r/docs/chats.md`](/r/docs/chats.md). Список всех страниц для языковых моделей лежит в [`/r/docs/llms.txt`](/r/docs/llms.txt), а вся документация одним файлом — в [`/r/docs/llms-full.txt`](/r/docs/llms-full.txt). Подробнее — на странице [«Для агентов»](https://eggent.ai/r/docs/for-agents.md). Английская версия каждой страницы лежит по тому же адресу без `/r`: [`/docs/`](/docs/). --- # Основные понятия > Из чего состоит Eggent — воркспейс, оркестратор, проекты, чаты, навыки, память, контекст, расписания и модели — и как эти части связаны между собой. Source: https://eggent.ai/r/docs/concepts/ Eggent устроен как рабочее место сотрудника. Ниже — все понятия, которые встречаются в интерфейсе и в этой документации. Если прочитать одну страницу целиком, то эта. ## Воркспейс {#workspace} **Воркспейс** (рабочее пространство) — это твой Eggent целиком: один компьютер агента со всеми его проектами, файлами, чатами и настройками. В облаке у каждого воркспейса свой адрес вида `имя.cloud.eggent.ai`. На своём сервере воркспейс — это папка `./data`. Всё, что делает агент, происходит внутри воркспейса. Он не видит чужих воркспейсов, а другие не видят твой. ## Оркестратор {#orchestrator} **Оркестратор** — агент, который отвечает, когда не выбран ни один проект. Это «главный» разговор воркспейса: с ним удобно обсуждать всё подряд, и он знает, какие проекты есть, поэтому может сам переключиться в нужный. У оркестратора есть свой контекст, своя память, свои навыки и свои MCP-серверы, отдельно от проектов. Модель у него всегда модель воркспейса. ## Проект {#project} **Проект** — отдельное рабочее место для одной задачи или направления: «Сайт», «Отдел продаж», «Контент для канала». У каждого проекта свои: - файлы (папка проекта); - контекст — постоянные инструкции для агента; - память; - навыки; - MCP-серверы; - при желании своя модель. Когда проект выбран, агент работает в его папке и видит только его настройки. Так инструкции для сайта не мешают разговору про бухгалтерию. Из любого чата можно поручить задачу проекту, написав `@` и его название. Подробнее — в разделе [«Проекты и оркестратор»](https://eggent.ai/r/docs/projects.md). ## Чат {#chat} **Чат** — один разговор с агентом. Чат принадлежит проекту, в котором его начали, или оркестратору. У каждого чата свой адрес, его можно открыть по ссылке, в другой вкладке или с телефона. Работа в чате не прерывается, если закрыть вкладку. См. [«Чаты»](https://eggent.ai/r/docs/chats.md). ## Контекст {#context} **Контекст** — постоянные инструкции агенту, которые он получает в каждом сообщении: кто ты, как отвечать, что важно в этом проекте. Хранится в файле `context.md` — отдельном для оркестратора и для каждого проекта. См. [«Контекст»](https://eggent.ai/r/docs/context.md). ## Память {#memory} **Память** — то, что агент записал, чтобы помнить между чатами: факты, решения, предпочтения. Хранится в `memory.md`. Агент сам ищет в ней нужное, а ты можешь попросить его что-то запомнить или забыть. Кроме того, агент сам ведёт несколько коротких заметок о тебе и о работе и читает их в каждом чате. См. [«Память»](https://eggent.ai/r/docs/memory.md). ## Навык {#skill} **Навык** — готовая инструкция для определённого вида работы: как вести базу знаний, как писать статьи для сайта, как собирать документы по шаблону. Навык — это папка с файлом `SKILL.md` и, при необходимости, скриптами. Агент сам подключает подходящий навык, когда видит задачу, для которой он написан. См. [«Навыки»](https://eggent.ai/r/docs/skills.md) и [«Готовые навыки»](https://eggent.ai/r/docs/skill-catalog.md). ## MCP {#mcp} **MCP** (Model Context Protocol) — стандартный способ подключить к агенту внешний сервис: таблицы, CRM, соцсети, базы данных. Подключённый MCP-сервер даёт агенту новые инструменты. См. [«MCP»](https://eggent.ai/r/docs/mcp.md). ## Модель {#model} **Модель** — языковая модель, которая думает и пишет за агента. В облаке сразу подключён **Eggent AI** — набор моделей разных семейств, оплачиваемый из баланса воркспейса. Можно подключить и свой ключ любого провайдера. Модель выбирается для всего воркспейса и отдельно для проекта. См. [«Модели»](https://eggent.ai/r/docs/models.md). ## Расписание {#schedule} **Расписание** — задача, которую агент выполняет сам в заданное время: каждый день в 9:00, раз в час, через 10 минут. Создаётся просьбой в чате, результат приходит в тот же чат или в Telegram. См. [«Расписания»](https://eggent.ai/r/docs/schedules.md). ## Доска {#board} **Доска** — место, где агенту отдают работу **карточками**. Каждая карточка — задача, которую агент выполняет сам, в отдельном разговоре, одну за другой; карточка может ждать другие и начинать с того, к чему они пришли: «собрать → сравнить → подвести итог». См. [«Доска задач»](https://eggent.ai/r/docs/board.md). ## Как это связано {#how-it-fits} ```text Воркспейс (имя.cloud.eggent.ai или ./data) ├── Оркестратор ─ контекст, память, навыки, MCP │ └── чаты без проекта ├── Проект «Сайт» ─ файлы, контекст, память, навыки, MCP, модель │ └── чаты проекта ├── Проект «Продажи» ─ … ├── Расписания ─ живут в чатах, где их создали └── Настройки ─ модели, Telegram, API ``` Простое правило: **всё, что относится к одной работе, держи в одном проекте.** Агент в проекте видит его файлы, инструкции и память, и ему не нужно каждый раз объяснять заново. --- # Регистрация в Eggent Cloud > Как создать своё пространство в Eggent Cloud через сайт или через Telegram-бота, что входит в пробный период и где потом найти свой Eggent. Source: https://eggent.ai/r/docs/cloud-signup/ Eggent Cloud — это Eggent, который уже развёрнут для тебя: без сервера, без Docker и без ключей от моделей. Каждое пространство работает в своём отдельном контейнере. ## Через сайт {#web} 1. Открой [cloud.eggent.ai](https://cloud.eggent.ai/?lang=ru). 2. Выбери язык, на котором будет говорить твой Eggent. От него зависят язык интерфейса, язык ответов агента и набор готовых навыков. Потом язык можно сменить в настройках. 3. Заполни форму: - **Название пространства** — станет адресом, например `acme.cloud.eggent.ai`. Не короче трёх символов; русские буквы превратятся в латиницу. - **Email** — он же логин для входа. - **Пароль** — не короче 8 символов. 4. Нажми кнопку создания. Обычно пространство готово меньше чем за 30 секунд. Пока оно запускается, страница спрашивает, что сделать первым: документ, утреннюю сводку в Telegram, сравнение конкурентов или файл у тебя на Google Диске — с одной необязательной строкой о задаче, — или «Сам разберусь». 5. Eggent откроется уже с выполненным входом, второй раз вводить пароль не нужно. Если ты выбрал задачу, агент уже работает над ней в отдельном проекте. Пока пространство запускается, на почту приходит письмо с кодом из 6 цифр: введи его на странице, чтобы подтвердить адрес, или нажми кнопку в письме позже. Если пароль когда-нибудь потеряется, **«Забыли пароль?»** на странице входа пришлёт ссылку для сброса на эту почту — см. [Забыл пароль](https://eggent.ai/r/docs/account.md#reset). ## Через Telegram {#telegram} 1. Открой бота [@eggentai_bot](https://t.me/eggentai_bot) и нажми **Start**. 2. Бот спросит название пространства и твою почту и создаст пространство — придумывать пароль не нужно. Он ответит кнопкой, которая открывает пространство уже с выполненным входом, и пришлёт на почту код из 6 цифр: отправь код боту, чтобы подтвердить адрес, или `/skip`. 3. Дальше просто пиши этому же боту: он передаёт сообщения твоему агенту и присылает ответы, пока ответ пишется, ты видишь черновик и то, чем агент сейчас занят. Пространство, созданное через Telegram, — такое же, как созданное через сайт. Чтобы потом открыть его в браузере, отправь боту **`/login`**: он ответит кнопкой, которая впускает в пространство. Свой пароль можно задать в **Настройки → Основное** или через **«Забыли пароль?»** на странице входа. ## Что входит в пробный период {#trial} - **7 дней** — дальше пространство работает на [тарифе](https://eggent.ai/r/docs/plans.md#plans). - **Свой диск** для файлов — на пробном периоде 100 МБ. - **Кредиты Eggent AI** — модель уже подключена, ключи не нужны. На пробном периоде доступны все модели из списка. Остаток кредитов видно на странице оплаты и в боковой панели, а ещё можно просто спросить агента: «сколько у меня осталось?». Подробнее — в разделе [«Тарифы и баланс»](https://eggent.ai/r/docs/plans.md). ## Где потом найти свой Eggent {#address} - **Адрес пространства**: `https://имя.cloud.eggent.ai`. Добавь в закладки. - **Оплата и тариф**: `https://cloud.eggent.ai/billing/имя`. - **Синхронизация файлов с компьютером**: `https://cloud.eggent.ai/sync/имя` — см. [«Файлы на компьютере»](https://eggent.ai/r/docs/file-sync.md). ## Лимит на регистрации {#limits} С одного адреса можно создать не больше двух пространств. Если нужно больше (например, для команды из одного офиса), напиши в [поддержку](https://eggent.ai/r/docs/account.md#support). --- # Первые шаги > Что сделать в первые полчаса — запустить готовый навык, дать первую настоящую задачу — и несколько привычек, с которыми Eggent работает лучше. Source: https://eggent.ai/r/docs/first-steps/ После входа ты попадаешь на экран нового чата. Слева — боковая панель с проектами и чатами, в центре — поле ввода, справа по кнопке **Файлы** открывается дерево файлов. ## Экран в двух словах {#screen} - **Новый чат** — начать новый разговор. - **Проекты** — список проектов. Выбранный проект определяет, в какой папке и с какими инструкциями работает агент. Когда проект не выбран, отвечает **оркестратор**. - **Чаты** — история разговоров текущего проекта. Точка у чата значит, что агент ещё над ним работает. - **Доска** — доска задач: работа, отданная агенту карточками. - **Настройки** — модели, контекст, память, навыки, MCP, расписания, мессенджеры и API. - **Файлы** (кнопка в шапке) — файлы текущего проекта: загрузить, открыть, скачать. - **Поле ввода** — сообщение, вложения, голос и выбор модели. Под ним — строка режима чата. ## Шаг 1. Начни с карточки {#about-you} Если при регистрации ты выбрал первую задачу, агент уже над ней работает. Если нет — на экране нового чата есть карточки быстрого старта, и первые три сразу дают результат: **«Сделать документ»**, **«Утренняя сводка в Telegram»** и **«Собрать таблицу с чужих сайтов»**. Все карточки описаны в [«Готовых навыках»](https://eggent.ai/r/docs/skill-catalog.md). Если у тебя свой бизнес, попробуй карточку **«Бизнес ИИ система»**: агент разложит по файлам всё о твоём деле, и дальше каждый чат работает со знанием дела. ## Шаг 2. Дай настоящую задачу {#first-task} Пиши так же, как написал бы сотруднику, — обычными словами и с деталями: - «Найди пять конкурентов нашей кофейни в Казани, сравни цены на капучино и сделай таблицу Excel со ссылками». - «Вот договор (прикрепил). Выпиши все сроки и штрафы списком». - «Напиши три варианта поста про открытие нового филиала, коротко и без восклицательных знаков». Агент сам решит, что ему нужно: поискать в интернете, прочитать файл, запустить код, сделать документ. Результаты-файлы появляются в панели **Файлы**, а пути к ним в ответе становятся ссылками. ## Шаг 3. Заведи проект под постоянную работу {#project} Если работа будет повторяться, создай для неё проект: попроси в чате «создай проект „Контент для канала“» или воспользуйся готовой карточкой — многие карточки сами создают проект под себя. Всё, что относится к этой работе, дальше держи там: файлы, инструкции, память, расписания. См. [«Проекты и оркестратор»](https://eggent.ai/r/docs/projects.md). ## Шаг 4. Подключи Telegram {#telegram} Если регистрировался через [@eggentai_bot](https://t.me/eggentai_bot), Telegram уже подключён. Если через сайт — попроси агента подключить Telegram: он даст ссылку на общего бота. Или подключи своего бота карточкой **«Свой Telegram-бот»** или в **Настройки → Мессенджеры**. Тогда агенту можно писать с телефона текстом, голосом и файлами, а он сможет присылать туда результаты по расписанию. См. [«Telegram»](https://eggent.ai/r/docs/telegram.md). ## Привычки, с которыми работать проще {#habits} - **Одна тема — один чат.** Длинный чат про всё сразу дороже и путанее. Новая задача — новый чат. - **Постоянное — в контекст, разовое — в сообщение.** Если приходится повторять одно и то же, попроси агента записать это в контекст проекта. - **Проси запоминать.** «Запомни, что отчёты я жду по понедельникам» — и агент сохранит это в память. - **Не жди у экрана.** Можно закрыть вкладку или переключиться на другой чат: работа продолжится, а результат будет ждать в чате. - **Останавливай и уточняй на ходу.** Кнопка остановки прерывает работу, а новое сообщение во время работы агент учтёт прямо в текущей задаче. - **Для простых вопросов — лёгкий режим.** Если нужен просто разговор без файлов и инструментов, выбери режим «просто диалог» в новом чате, это во много раз дешевле. См. [«Чаты»](https://eggent.ai/r/docs/chats.md#modes). --- # Чаты > Как вести разговор с агентом — начать чат, прикрепить файлы, остановить работу или поправить её на ходу, ответить на вопрос агента и выбрать режим, который экономит токены. Source: https://eggent.ai/r/docs/chats/ Чат — основной способ работать с Eggent. Ты пишешь задачу, агент делает её и показывает по ходу, что именно делает: ищет, читает, запускает команды, пишет файлы. ## Новый чат {#new} Нажми **Новый чат** в боковой панели. Чат начнётся в текущем проекте, а если проект не выбран — у оркестратора. После первого сообщения у чата появляется название и свой адрес вида `…/dashboard/`: его можно добавить в закладки, открыть в другой вкладке или отправить себе на телефон. Все чаты текущего проекта — в боковой панели в разделе **Чаты**. Чтобы удалить чат, наведи на него курсор и нажми на значок удаления. ## Вложения и картинки {#attachments} - Прикрепи файл кнопкой со скрепкой в поле ввода или перетащи его в окно. - Скриншот можно просто вставить из буфера обмена (`Ctrl+V` / `Cmd+V`). - Вложения хранятся вместе с чатом, агент получает путь к ним и может их прочитать: текст, PDF, Word, Excel, картинки, аудио. Если файл нужен не одному чату, а всей работе, загрузи его в проект через панель **Файлы**. См. [«Файлы»](https://eggent.ai/r/docs/files.md). ## Файл рядом с чатом {#open-file} Когда в панели **Файлы** рядом с чатом открыт файл, агент вместе с сообщением узнаёт, какой именно, так что «поправь здесь второй абзац» относится к нему. Строки, которые ты выделил, тоже передаются, как и блок, выбранный на [странице](https://eggent.ai/r/docs/files.md#pages) кнопкой **Выбрать**. Строка над полем ввода показывает, что видит агент; крестик в ней отключает это для этого файла, пока не откроешь другой. Если в файле есть несохранённые правки, агент узнаёт и это, и его просят не менять файл у тебя под руками. Если агент, восстановление версии или синхронизация изменили файл, пока ты его правишь, панель предложит новую версию, а не заменит твои правки; что бы ты ни выбрал, второе останется в [истории файла](https://eggent.ai/r/docs/files.md#history). ## Пока агент работает {#while-working} Работа принадлежит чату, а не открытой вкладке: - **Можно уйти.** Закрой вкладку, открой другой чат, выключи ноутбук — агент продолжит. Чат, над которым ещё идёт работа, отмечен точкой в списке. - **Можно вернуться.** Открой чат снова, и ответ продолжит появляться с того места, где он сейчас, а не с начала. - **Можно дописать.** Пиши, пока агент работает, и отправляй: сообщение попадёт в текущую задачу, и агент прочтёт его перед следующим шагом. Так удобно уточнять («только по Москве»), не останавливая работу. Пока агент его не прочёл, оно ждёт под ответом с пометкой; прочитанное встаёт в чат туда, где агент его прочёл. Несколько быстрых сообщений агент читает вместе. Файл, приложенный во время работы, уходит со следующим сообщением, и агент узнаёт, где он лежит. Команду (сообщение со `/` в начале) можно отправить, когда работа закончится. - **Можно остановить.** Кнопка остановки рядом с полем ввода прерывает работу. Всё, что агент успел сделать и написать, сохраняется. Сообщение, которое он не успел прочитать, остаётся в чате с кнопкой **«Отправить»**. Остановить работу можно и словом: одно сообщение «стоп», «хватит» или «отмена» (в том числе из Telegram). ## Когда агент спрашивает {#questions} Иногда агенту нужно твоё решение: какой вариант выбрать, подтвердить действие, ввести значение. Тогда в чате появляется карточка с вопросом, кнопками готовых ответов и полем, куда можно написать свой ответ. Агент ждёт ответа и продолжает с того же места. Ждёт он до суток: если ответа так и нет, работа останавливается, вопрос остаётся в чате, и когда ты ответишь на него позже, агент продолжит с этого места. ## Режимы чата {#modes} Под полем ввода есть строка режима. Режим определяет, сколько воркспейса уходит в каждое сообщение, и выбирается **один раз, когда чат начинается** — потом он не меняется. Нужен другой режим — открой новый чат. | Режим | Что умеет агент | Примерно токенов на сообщение | | --- | --- | --- | | **полный контекст** (по умолчанию) | Всё: файлы, веб, команды, картинки, Telegram, расписания, навыки и инструкции воркспейса | ~12 000 | | **диалог и файлы** | Читать файлы и переключаться между проектами. Без записи, команд и интернета | ~700 | | **просто диалог** | Только твой вопрос и история чата. Никаких инструментов | ~250 | Лёгкие режимы подходят для вопросов, переводов, обсуждения идей и разбора текста: они в десятки раз дешевле. Для настоящей работы с файлами, интернетом и документами нужен полный режим. > [!NOTE] > Режим остаётся за чатом, откуда бы ни пришло следующее сообщение, в том числе из Telegram. Расписания, карточки доски и HTTP API всегда работают в полном режиме. ## Выбор модели в чате {#model} Слева от кнопки отправки — название модели, которая ответит на следующее сообщение. Нажми на него, чтобы сменить модель: в проекте выбор сохранится для проекта, у оркестратора — для всего воркспейса. Подробнее — в разделе [«Модели»](https://eggent.ai/r/docs/models.md). ## Ссылки и файлы в ответах {#links} Если агент в ответе упоминает файл, который существует, путь становится ссылкой: веб-страницы, PDF и картинки открываются в новой вкладке, остальное — на экране файла. Аудиофайлы проигрываются прямо в ответе. Картинки, которые агент вставляет в ответ, показываются сразу. ## Ключи и пароли {#secrets} Всё, что ты отправляешь, остаётся в истории чата, и агент это видит. Если сообщение похоже на ключ, токен, пароль или закрытый ключ, чат скажет об этом до отправки и предложит **Всё равно отправить** или **Изменить**. У токена Telegram-бота и ключа провайдера моделей есть свои места — **Настройки → Мессенджеры** и **Настройки → Модели**, — и подсказка ведёт туда. Ещё учётные данные **скрываются в сохранённых чатах**: после перезагрузки страницы, в списке чатов, в том, что агент читает, заглядывая в другие чаты, и в файлах, которые синхронизируются на твой компьютер, ключ выглядит как `[hidden key]`. Собственная рабочая память агента о разговоре не меняется, поэтому ключ, который ты ему дал для задачи, продолжает работать. Скрываются только известные формы (ключи провайдеров и облаков, токены ботов, заголовки Bearer, закрытые ключи, ссылки с паролем и значение под именем вроде `api_key` или `password` в том, что агент отправил инструменту); пароль внутри обычного текста не скрывается. Имя, написанное в коде, например `api_key = settings.client_key`, остаётся как есть — это пример, а не ключ. Чаты, написанные раньше, очищаются один раз — при первом запуске воркспейса после обновления. ## Другие чаты {#other-chats} Агент умеет заглядывать в другие твои чаты: показывать список, искать и читать. Спроси «что мы решили про цены на прошлой неделе?» или «что было в утреннем отчёте?» — он найдёт нужное место. Ещё он умеет переводить разговор: в Telegram «вернись в чат про прайс» переключит туда, в браузере агент даст ссылку на чат. Чаты со значком часов написала [задача по расписанию](https://eggent.ai/r/docs/schedules.md#results): по одному чату на задачу в день. Чаты со стрелкой — работа проекта для другого чата, начатая через `@проект`: см. [Спросить проект](https://eggent.ai/r/docs/projects.md#ask). ## Советы {#tips} - Новая задача — новый чат. Длинная история делает каждое следующее сообщение дороже и медленнее. - Если агент ушёл не туда, остановись и напиши, что не так, — это быстрее, чем ждать до конца. - Долгие задачи (обойти 50 сайтов, обработать папку документов) спокойно оставляй работать: результат будет в чате, а файлы — в панели **Файлы**. --- # Проекты и оркестратор > Зачем делить работу на проекты, как их создавать и переключать, что общего у проектов и оркестратора и как агент сам находит нужный проект. Source: https://eggent.ai/r/docs/projects/ Один воркспейс — много направлений работы. Чтобы они не смешивались, у каждого направления свой **проект**, а над всеми стоит **оркестратор**. ## Оркестратор {#orchestrator} Когда в боковой панели не выбран ни один проект, отвечает оркестратор. Это «главный» разговор: - для задач, которые не относятся ни к одному проекту; - для вопросов «что у меня где лежит»; - для задач, которые затрагивают несколько проектов сразу. В контексте оркестратора лежит то, что должно быть известно везде: кто ты, чем занимаешься, как тебе удобно получать ответы. Карточка **«Бизнес ИИ система»** пишет именно туда. ## Проекты {#projects} Проект — это папка с файлами и собственные настройки агента: контекст, память, навыки, MCP-серверы и, при желании, модель. Когда проект выбран, агент работает в его папке и видит только то, что относится к нему. Хорошие проекты — это постоянные направления: «Сайт», «Контент для Telegram-канала», «Договоры», «Аналитика продаж», «Учёба». Плохой проект — разовый вопрос: для него хватит чата у оркестратора. ## Создать проект {#create} Есть четыре способа: 1. **Из боковой панели**: **+** рядом с заголовком **Проект** открывает короткую форму: название, описание, инструкции для агента. Новый проект открывается с пустым чатом, можно сразу писать. Ход агента на это не тратится. 2. **Попросить в чате**: «создай проект „Договоры“ для работы с договорами поставки». Агент создаст проект, может сразу написать ему инструкции и переключиться в него. 3. **Запустить карточку быстрого старта.** Большинство карточек сами создают проект под свою работу и называют его по названию карточки. 4. **В настройках**: **Настройки → Проекты**, та же форма. ## Переключение между проектами {#switch} - **Вручную**: выбери проект в боковой панели. Новый чат начнётся в нём. - **Агент сам**: оркестратор знает список проектов и, если сообщение явно относится к одному из них, переключается туда и продолжает работу там. Разговор при этом не обрывается: чат остаётся тем же, меняется рабочая папка. Чтобы оркестратор лучше понимал, куда что относится, в его контексте есть таблица **«Проекты в этом пространстве»**: проект, его id и для чего он нужен. Новый проект добавляет туда строку сам. Таблицу можно поправить в **Настройки → Контекст** (оркестратор). ## Спросить проект из другого чата {#ask} Начни сообщение с `@` и названия проекта, затем скажи, что нужно сделать: > @Магазин сколько возвратов было на прошлой неделе? Проект выполнит работу **со своими** файлами, навыками, подключёнными сервисами, инструкциями и моделью, в отдельном чате, а ответ вернётся в тот чат, где ты написал. Ты остаёшься на месте: активный проект не меняется, а агент в твоём чате говорит, что ответ пришёл от проекта. - **В браузере** `@` в начале поля показывает список других проектов; **Tab** или **Enter** выбирает. Сообщение, которое начинается с названия проекта, подсвечивается: видно, что его поняли. - **В Telegram и через [внешний API](https://eggent.ai/r/docs/external-api.md)** то же сообщение работает как написано. - Работа хранится в **отдельном чате проекта** с названием *Из «…»* и значком-стрелкой в списке чатов проекта. В карточке в твоём чате есть ссылка **Открыть в …** — там всё, что проект сделал. Если снова написать `@Магазин` из того же разговора, он **продолжит** тот же чат вместе с историей. - Название ищется так, как ты его пишешь: заглавные буквы, дефис вместо пробела и «ё» вместо «е» не важны, поэтому `@мой-магазин` — это «Мой магазин». Если подходят два проекта, агент спросит, какой ты имел в виду. - **Начинаешь только ты.** Агент сам никогда не обращается к проекту, а проект не может спросить другой проект. Что полезно знать: - Одновременно работают не больше двух проектов, остальные ждут очереди. Одна работа останавливается через десять минут. **Стоп** в твоём чате останавливает и проект. - Проект — это рабочий стол, а не запертая комната: он разделяет инструкции и файлы, но его команды могут дотянуться до других мест воркспейса. - Если проект использует подключённый сервис ([MCP](https://eggent.ai/r/docs/mcp.md)), который при первом подключении просит разрешения, один раз разреши его в собственном чате проекта: у обращения нет, кого спросить, и неодобренного сервиса там просто нет. - Не работает в [лёгком чате](https://eggent.ai/r/docs/chats.md#modes) и в общем публичном чате; сообщение, название в котором не совпало ни с одним проектом, — обычное сообщение. ## Настройки проекта {#settings} Во всех вкладках настроек, где это имеет смысл (модели, контекст, память, навыки, MCP, расписания), справа вверху есть переключатель: **оркестратор** или конкретный проект. Выбери проект — и вкладка покажет его настройки. | Что | Где хранится | Подробнее | | --- | --- | --- | | Инструкции | `context.md` проекта | [Контекст](https://eggent.ai/r/docs/context.md) | | Память | `memory.md` проекта | [Память](https://eggent.ai/r/docs/memory.md) | | Навыки | папка `skills/` проекта | [Навыки](https://eggent.ai/r/docs/skills.md) | | Внешние сервисы | `.mcp.json` проекта | [MCP](https://eggent.ai/r/docs/mcp.md) | | Модель | `model.json` проекта | [Модели](https://eggent.ai/r/docs/models.md#project-model) | ## Удалить проект {#delete} Наведи на проект в боковой панели, открой меню и выбери **Удалить проект**. Удаляются папка проекта со всеми файлами и его настройки. Это необратимо — если файлы нужны, сначала скачай их или включи [синхронизацию с компьютером](https://eggent.ai/r/docs/file-sync.md). ## Советы {#tips} - Один проект — одна работа. Если в контексте проекта появляются инструкции «для случая А» и «для случая Б», это два проекта. - Держи в проекте исходные материалы: образцы, прайсы, примеры хороших текстов. Агент будет на них опираться. - Не бойся просить оркестратора: «сделай это в проекте „Сайт“». Он сам переключится. --- # Доска задач > Отдавай агенту работу карточками. Каждая карточка выполняется в своём разговоре, одна за другой; карточки могут ждать друг друга, а доска говорит, когда какая-то ждёт тебя. Source: https://eggent.ai/r/docs/board/ **Доска** — место, где ты отдаёшь агенту работу и можешь отойти. Каждая часть работы — **карточка**: задача, которую агент выполняет сам, в отдельном разговоре, пока ты занят другим. Доска показывает, что ждёт старта, что сейчас в работе и какие карточки ждут тебя. Открывается кнопкой **Доска** в боковой панели, под «Новым чатом». Число рядом — сколько карточек ждут тебя; точка — какие-то карточки сейчас в работе. ## Колонки {#columns} | Колонка | Что в ней | | --- | --- | | Входящие | Записанные, но не начатые карточки. Всё, что предлагает агент, попадает сюда и ждёт тебя | | Очередь | Карточки, которые начнутся сами, как только освободится место, сверху вниз | | В работе | Карточки, над которыми агент работает прямо сейчас | | Ждёт тебя | Карточки, остановленные ради тебя: агент задал вопрос, запуск упал, ты его остановил или результат ждёт твоей проверки | | Готово | Законченные карточки. Последний ответ каждой — её результат | ## Как написать карточку {#create} **Новая карточка**, дальше: 1. **Название** — коротко. 2. **Задача** — что сделать, так, чтобы это можно было сделать без тебя: откуда брать данные, каким должен быть результат, куда его сохранить. 3. **Проект** — карточка выполняется в этом проекте, с его инструкциями, навыками, памятью и файлами, или у оркестратора. 4. **Начать после** — карточки, которых эта ждёт (см. ниже). Необязательно. 5. **Дать мне проверить результат** — закончив, карточка остановится в «Ждёт тебя», а не уйдёт сразу в «Готово». Необязательно. **Начать сейчас** ставит её в очередь, **Сохранить во входящие** откладывает на потом. ## Попросить агента составить план {#from-chat} В любом чате: > «Разбей исследование конкурентов на задачи и положи на доску». Агент запишет карточки во «Входящие», связав их в цепочку там, где следующему шагу нужен предыдущий. Запустить их он не может: посмотри, поправь что нужно и нажми **Запустить все** над «Входящими» или **Запустить** на одной карточке. ## Карточки, которые ждут друг друга {#after} Карточка с **Начать после** стартует, только когда готовы все карточки, которых она ждёт, а в её первом сообщении есть то, к чему они пришли: их итоговые ответы и сделанные файлы. Так выполняется цепочка вроде «собрать → сравнить → подвести итог», в том числе через проекты: первая карточка в одном проекте, следующая в другом. ## Каждая карточка — разговор {#chat} Всё, что агент сделал по карточке, — в её разговоре: это обычный чат, в списке чатов он помечен значком доски. Открывается с карточки кнопкой **Открыть разговор**. В него можно писать: ответ, уточнение, поправку. Карточка следит за этим ходом — пока он идёт, она в работе, а когда закончится, берёт новый результат. Строка вверху чата говорит, что это за карточка и где она сейчас. ## Когда карточка ждёт тебя {#waiting} - **Вопрос.** Когда никто не смотрит, агент кладёт вопрос на карточку и останавливается. Ответь на карточке — кнопкой или своими словами: карточка встанет в начало очереди и продолжит с твоим ответом. **Пусть решит агент** — продолжить без ответа. - **Ошибка.** Запуск, закончившийся ошибкой, сам повторяется один раз через минуту. Если и он упадёт, карточка ждёт с текстом ошибки; **Запустить ещё раз** — когда причина устранена. - **Замолчала.** Запуск, который слишком долго ничего не говорит, останавливается, как в обычном [чате](https://eggent.ai/r/docs/chats.md#while-working). - **Остановлена.** Ты нажал **Стоп**. **Продолжить** — с того места, где остановилась. - **Проверь результат.** Карточку попросили проверить. **Принять как готовое** или **Запустить ещё раз**. - **Прервана.** Пространство перезапустилось посреди работы. Доска сама подхватывает такую карточку, не больше двух раз подряд; дальше она ждёт тебя. ## Когда сервис моделей отказывает {#paused} Если сервис моделей отказал в запуске карточки — закончился баланс, пространство закрыто, — встаёт вся доска: иначе каждая карточка из очереди получила бы тот же отказ. Разберись с причиной и нажми **Продолжить** на доске. ## Сколько одновременно {#limits} Одновременно работают до трёх карточек, и не больше одной на проект: карточки одного проекта работают в одной его папке и могли бы перезаписать файлы друг друга. Карточки разных проектов идут параллельно. На своём сервере это задают `EGGENT_BOARD_MAX_RUNNING` и `EGGENT_BOARD_MAX_PER_PROJECT` (см. [«Настройки сервера»](https://eggent.ai/r/docs/self-host-config.md)). ## Перемещение карточек {#moving} Перетаскивай карточки между «Входящими» и «Очередью» или вверх-вниз внутри них: очередь начинается сверху. Те же действия есть кнопками в открытой карточке — Запустить, Вернуть во входящие, Выше, Ниже, Убрать, Удалить. Карточку, которая в работе, не перемещают, её только останавливают. **Убрать** прячет законченную карточку из «Готово»; **Показать убранные** под доской возвращает их на вид. **Удалить** удаляет карточку и её разговор; сделанные ею файлы остаются на месте. ## Что агент может делать с доской {#agent} Агент читает доску и записывает новые карточки инструментом `eggent_board`. Запускаешь работу только ты: карточка, которую написал агент, всегда ждёт во «Входящих», а у запущенной карточки агент больше не может поменять задачу. Так задумано: агент читает страницы, файлы и сообщения извне, и строчка в любом из них не должна ставить в очередь задачу, у которой есть доступ к командной строке. ## Пайплайны {#pipelines} Доска заменила пайплайны: цепочка шагов теперь — это карточки, которые ждут друг друга. Старая страница пайплайнов открывает доску. --- # Что умеет агент > Какие инструменты есть у агента Eggent — терминал, Python с библиотеками для документов, интернет, файлы, помощники, картинки, Telegram, расписания — и чего он не умеет. Source: https://eggent.ai/r/docs/capabilities/ Агент Eggent — не просто собеседник. У него есть свой компьютер (Linux-контейнер), и почти всё, что можно сделать на компьютере без мышки, он делает сам. ## Файлы и терминал {#files-terminal} - **Читать, писать и править файлы** в папке проекта: тексты, таблицы, код, конфиги. - **Запускать команды** в терминале: `bash`, `git`, `curl`, `jq`, `zip`, `ripgrep` и другие. - **Писать и выполнять программы** на Python и Node.js — для расчётов, обработки данных, конвертации. Всё, что агент создаёт, сразу появляется в панели **Файлы**, откуда это можно открыть или скачать. ## Документы {#documents} В образ заранее установлены библиотеки, которые чаще всего нужны для работы с документами, поэтому агенту не нужно ничего доустанавливать: | Что | Чем | | --- | --- | | Excel (`.xlsx`) — читать и создавать | `openpyxl`, `pandas` | | Word (`.docx`) | `python-docx` | | PowerPoint (`.pptx`) | `python-pptx` | | PDF — текст и таблицы | `pypdf`, `PyPDF2`, `pdfplumber`, `poppler-utils` | | Картинки — обрезать, сжать, конвертировать | `Pillow` | | HTML и XML | `beautifulsoup4`, `lxml` | | Аудио и видео | `ffmpeg` | | Базы данных Postgres | `psycopg2` | Сканы и фотографии документов агент читает «глазами» модели, если модель умеет смотреть на картинки. ## Интернет {#web} - **Поиск** в интернете по запросу. - **Чтение страниц** по ссылке, включая извлечение текста из статей и документации. - **Запросы к API** сервисов через `curl` или код. Страницы агент читает как текст. Браузера с экраном у него нет: он не может нажимать кнопки на сайте, входить в личные кабинеты или смотреть на страницу глазами. ## Помощники {#subagents} Большую задачу агент может разделить между **помощниками** — отдельными агентами, каждый из которых берёт свою часть, и работают они одновременно. Например: «сделай трёх агентов: один читает новости ИТ, второй — медицины, третий — про машины» или обойти двадцать сайтов по нескольку за раз. Одновременно работает до шести помощников. Агент ждёт своих помощников: каждый возвращает результат, агент продолжает со всеми результатами и пишет ответ в том же сообщении. Пока они работают, в чате у каждого помощника своя строка — что он делает прямо сейчас, сколько шагов сделал и сколько времени работает. Строку можно раскрыть: там задание, которое он получил, каждый поиск, страница и файл, через которые он прошёл, и что он нашёл. Кнопка «Стоп» останавливает и помощников. Помощник живёт только в рамках текущей задачи. Для агента, который постоянно работает над темой, нужен [проект](https://eggent.ai/r/docs/projects.md) с [расписанием](https://eggent.ai/r/docs/schedules.md). Расписания создаются тем же механизмом, что и помощники. Чтобы поручить кусок работы проекту, который у тебя уже есть, напиши в начале сообщения `@` и его название: он работает со своими файлами, навыками и инструкциями, а ответ вернётся в твой чат ([как это сделать](https://eggent.ai/r/docs/projects.md#ask)). ## Картинки {#images} Агент умеет **рисовать** картинки по описанию и **редактировать** существующие: сменить фон, сделать вариант, собрать обложку по образцу. См. [«Картинки»](https://eggent.ai/r/docs/images.md). ## Связь с тобой {#communication} - **Задать вопрос** карточкой с вариантами ответа и полем для своего — когда нужно твоё решение. - **Написать в Telegram** — сообщение или файл в твой чат с ботом или в канал, где бот администратор. См. [«Telegram»](https://eggent.ai/r/docs/telegram.md). - **Запомнить** важное в [память](https://eggent.ai/r/docs/memory.md) и найти его потом. ## Управление воркспейсом {#workspace} По просьбе в чате агент может сам: - создать проект, переключиться в другой проект; - написать новый [навык](https://eggent.ai/r/docs/skills.md); - подключить [MCP-сервер](https://eggent.ai/r/docs/mcp.md); - создать, изменить или удалить [расписание](https://eggent.ai/r/docs/schedules.md); - положить работу на [доску задач](https://eggent.ai/r/docs/board.md) — цепочкой, если следующему шагу нужен предыдущий; - подключить своего провайдера моделей или Telegram-бота; - сказать, сколько осталось баланса и дней тарифа. Полный список инструментов с параметрами — в [справочнике инструментов](https://eggent.ai/r/docs/agent-tools.md). ## Чего агент не умеет {#limits} - **Нажимать кнопки на сайтах** и входить в личные кабинеты: браузера с экраном нет. - **Видеть твой компьютер**: он работает только в своём воркспейсе. Файлы можно загрузить в него или [синхронизировать с компьютером](https://eggent.ai/r/docs/file-sync.md). - **Работать без модели**: каждый шаг стоит токенов. Лёгкие задачи дешевле делать в [лёгком режиме чата](https://eggent.ai/r/docs/chats.md#modes). - **Гарантировать правду**: агент может ошибаться, как и человек. Проверяй цифры, которые идут в договоры и отчёты, и проси указывать источники. --- # Браузер агента > В Eggent Cloud у агента есть настоящий браузер на отдельной машине. Агент открывает сайты, нажимает, заполняет формы и листает, а вы смотрите на это в панели «Браузер» и в любой момент берёте управление — например, чтобы самому войти в аккаунт. Source: https://eggent.ai/r/docs/browser/ Обычно агент читает страницы сам: скачивает и вынимает текст. Когда этого мало — странице нужны клики, форма, вход в аккаунт или несколько шагов подряд, — у агента есть **настоящий браузер**. Он работает на отдельной машине Eggent, а не в вашем воркспейсе, и агент управляет им так же, как человек: открывает адрес, нажимает на кнопки, вводит текст, листает. > [!NOTE] > Браузер есть в Eggent Cloud. В бесплатной установке на свой сервер его нет. ## Когда агент берёт браузер {#when} - Страница пустая без JavaScript или открывается только после клика. - Нужно заполнить форму, выбрать фильтры, пройти по шагам. - Нужно войти в личный кабинет и что-то там посмотреть или сделать. Попросить можно и прямо: «открой в браузере и посмотри…». Страницы, которые агент не смог прочитать обычным способом, он дочитывает через тот же сервер — они идут в счёт [сложных страниц](https://eggent.ai/r/docs/plans.md#tools) тарифа, а не браузерных минут. ## Панель «Браузер» {#panel} Кнопка с глобусом справа вверху открывает панель «Браузер». В ней видна страница, на которой сейчас работает агент, — вживую. Над картинкой — кто управляет браузером, под ней — сколько браузерных минут осталось в этом месяце. Если браузер не открыт, его можно открыть самому кнопкой **Открыть браузер** — например, чтобы заранее войти на сайт, с которым агент будет работать. ## Взять управление {#control} **Взять управление** — и браузер ваш: кликайте, листайте и печатайте прямо на картинке, в том числе с телефона. Агент в это время ждёт и ничего не делает. Когда закончите, нажмите **Вернуть агенту**. Пока управление у вас, над картинкой есть адресная строка и кнопки **Назад**, **Вперёд** и **Обновить**: введите адрес и нажмите Enter, чтобы открыть страницу самому. Открываются только веб-страницы; адрес без `https://` тоже подойдёт. Если вы открыли браузер сами кнопкой **Открыть браузер**, управление сразу у вас, а курсор — в адресной строке. Так проходят шаги, которые должен сделать человек: - **Вход в аккаунт.** Пароль вы вводите сами, в панели. В чат пароль не пишите никогда — агент и не попросит. - **Код из СМС или письма.** - **Капча.** ## Входы сохраняются {#sign-ins} Браузер помнит, на какие сайты вы вошли, и в следующий раз агент попадает туда уже под вашим входом. Входы хранятся на машине браузера, отдельно для каждого воркспейса. **Забыть входы** (кнопка со стрелкой в шапке панели) закрывает браузер и стирает все сохранённые входы. ## Минуты {#minutes} Браузер считается по минутам, пока он открыт. Сколько минут в месяц, зависит от тарифа: они перечислены на странице оплаты, а на пробном периоде их немного — чтобы попробовать. Сколько осталось в этом месяце, видно в панели; с первого числа минуты начинаются заново. Агент закрывает браузер, когда задача сделана; если браузером никто не пользуется несколько минут, он закрывается сам. Закрыть его можно и кнопкой **Закрыть браузер**. В компании все пользуются минутами администратора, а каждое купленное сверх тарифа место добавляет ещё. ## Стоит знать {#good-to-know} - Браузер работает не из России. Часть российских сайтов, закрытых для заграничных адресов, его не пустит. - Сайты с сильной защитой от роботов могут показать капчу — её проходите вы, взяв управление. - Агент не видит значения полей с паролями. - Скриншот страницы агент сохраняет файлом в проект, его видно в [панели «Файлы»](https://eggent.ai/r/docs/files.md#panel). --- # Файлы > Где лежат файлы воркспейса, как их загружать (в том числе целыми папками), открывать, скачивать и удалять, как увидеть веб-страницу в готовом виде и поменять в ней слова, как сохранить файл в PDF, как каждое изменение сохраняется версией, которую можно сравнить и восстановить, какие есть ограничения и как агент показывает файлы в ответах. Source: https://eggent.ai/r/docs/files/ У каждого проекта своя папка с файлами. Агент работает прямо в ней: читает то, что ты загрузил, и кладёт туда то, что сделал. ## Панель «Файлы» {#panel} Кнопка **Файлы** в шапке открывает дерево файлов справа от чата. Оно показывает папку текущего проекта (или оркестратора) и остаётся открытым при переходах между экранами. На телефоне панель открывается поверх чата. В дереве: - **выделен открытый файл** и текущая папка; - **папки** раскрываются по клику и остаются раскрытыми, когда ты переходишь в другой чат или на другой экран; - у каждой папки есть кнопки: **загрузить файлы**, **загрузить папку**, **скачать архивом .zip**, **новый файл**, **новая папка**; верхняя строка (`/`) скачивает всю папку воркспейса; - у каждого файла — **открыть**, **скачать** и **удалить**. Клик по файлу открывает его **в этой же панели, рядом с чатом**, так что разговор остаётся перед глазами: текст и код можно прочитать и отредактировать в редакторе с номерами строк и подсветкой (**Сохранить** или Cmd/Ctrl+S), веб-страницу — увидеть в готовом виде (см. [Страницы](#pages)), картинку — посмотреть, аудио — прослушать. Панель расширяется под файл — ширину меняет перетаскивание её левого края, она запоминается. Стрелка возвращает к дереву, а **Открыть на всю страницу** показывает файл на отдельном экране. Так же открываются путь к файлу, который агент назвал в ответе, и файл из списка под ответом; Cmd/Ctrl-клик открывает полную страницу в новой вкладке. ## Загрузка {#upload} - **Файлы** — кнопкой у нужной папки или перетаскиванием на папку. - **Папка целиком** — кнопкой «загрузить папку»: переносится вся структура вложенных папок, как на компьютере. Выбор папки есть в браузерах на компьютере; на iPhone кнопка выбирает файлы. - **В чат** — вложения сообщения хранятся вместе с чатом. Если файл нужен для всей работы, а не одного разговора, загрузи его в проект. Если файл с таким именем уже есть, Eggent спросит, заменить ли его. > [!NOTE] > Одна загрузка — не больше **100 МБ**. Большие папки загружаются несколькими частями автоматически, так что ограничение касается только размера одного файла. ## Открыть и скачать {#open} - **Открыть** — веб-страницы (`.html`), PDF и картинки открываются в новой вкладке уже в готовом виде. Это удобно, когда агент собрал сайт или отчёт: его можно сразу посмотреть. Страница открывается в изолированном режиме и не имеет доступа к твоему воркспейсу. - **Скачать** — любой файл скачивается кнопкой скачивания. Имена на русском и других языках сохраняются. ## Страницы {#pages} Веб-страница (`.html`) открывается **в готовом виде**, со стилями и картинками из папки рядом с ней; кнопка **Код** переключает на исходник. Страница показывается изолированно: её скрипты работают, но не могут добраться до твоего воркспейса или что-то куда-то отправить. - **Выбрать** позволяет указать на часть страницы: щелчок выбирает блок, и агент рядом с чатом видит именно этот кусок файла — так что «сделай этот заголовок короче» относится к нему. **Показать в коде** находит его в исходнике. - **Двойной щелчок меняет слова** блока прямо на странице; Enter сохраняет, Esc отменяет. В файле меняются только эти слова — всё остальное остаётся как было, байт в байт, — а правка становится версией в [истории файла](#history). Всё остальное (новый блок, стиль) — через агента или в коде. - Если файл изменился, пока страница была открыта, она показывается заново и ничего не записывается. ## Сохранить в PDF {#pdf} Кнопка с принтером рядом с файлом открывает копию для печати и диалог печати браузера: выбери **Сохранить как PDF**. Веб-страница печатается такой, как выглядит на экране: всё, что появляется при прокрутке, показано, анимации остановлены, шапка, которая держится на экране, отпущена, чтобы не закрывать каждую страницу, фон сохранён, а блок по возможности не разрезается между двумя страницами. Markdown печатается как документ, остальной текст — как есть. ## Общий доступ и согласование {#company} В воркспейсе, который входит в [компанию](https://eggent.ai/r/docs/company.md), у панели и страницы файла ещё две кнопки: **Поделиться** открывает файл коллегам для просмотра, комментариев или правки ([Общие файлы](https://eggent.ai/r/docs/company.md#shares)), а **Согласование** отправляет коллегам по порядку на согласование версию, которая в файле сейчас ([Согласования](https://eggent.ai/r/docs/company.md#approvals)). Строка над файлом говорит, когда он открыт коллегам или на согласовании. ## Папка одним архивом {#zip} Кнопка архива у папки (и у верхней строки, которая означает весь проект) скачивает её одним файлом `.zip`: структура, имена на русском и других языках и признак исполняемого файла сохраняются. Архив собирается по мере отправки, поэтому большая папка не нагружает воркспейс. - Файлы с секретами в архив **не попадают**: файлы `.env`, `.mcp.json`, `auth.json`, файлы ключей и сертификатов (`.pem`, `.key`, `.p12`), облачные учётные данные (`credentials.json`, ключи сервисных аккаунтов, `kubeconfig`, `*.tfvars`) и папки, созданные для их хранения (`.ssh`, `.aws`, `.kube`), — в том числе когда ты сам указываешь такую папку. После скачивания из карточки ответа страница говорит, сколько файлов осталось за бортом. - Не попадают и зависимости с рабочим состоянием агента (`node_modules`, `.git`, `.venv`, `.pi`). Ссылки за пределы папки никогда не раскрываются, файл, у которого есть и другое имя в другом месте, пропускается, а файл, который исчез или был подменён ссылкой, пока архив отправлялся, пропускается, а не обрывает скачивание. - Предел — **1 ГБ и 10 000 файлов** на архив; если больше, кнопка скажет об этом, и скачать нужно по частям. За раз готовится один архив: второй попросит повторить через минуту. ## Файлы в ответах агента {#in-answers} Когда агент в ответе упоминает файл, который существует, путь становится ссылкой — не нужно искать его в дереве. Аудиофайлы (`mp3`, `ogg`, `wav`, `m4a` и другие) проигрываются прямо в ответе: кнопка воспроизведения, длительность и прогресс. Картинки, которые агент вставил в ответ, показываются в чате. ### Файлы, которые сделал ответ {#produced} Если ответ сделал файлы, под ним появляется их список: файлы, которые он назвал, файлы, которые записали его инструменты, и — когда он запускал команды и больше ничто не указывает на результат — то, что появилось в папке нового. У каждой строки есть **открыть** (для страниц, PDF и картинок), **скачать** и, если подключён Telegram, **отправить в Telegram**: файл придёт в твой чат. Если файлов больше пяти, остальные считаются, а **Скачать все архивом .zip** забирает всё сразу. Список намеренно осторожный: только обычные файлы, записанные во время этого ответа, внутри папки, где шла работа; никогда — заметки, навыки и инструменты самого агента и никогда — файлы с секретами. Если файл потом удалили, его строка пропадает. Правки уже существовавших файлов попадают в список, только если ответ их называет. То, что проект сделал по [запросу `@проект`](https://eggent.ai/r/docs/projects.md#ask), показывается под ответом того чата, который спрашивал. ## История файла {#history} Каждое изменение документа или текстового файла в проекте сохраняется версией, кто бы его ни сделал: ты, когда сохраняешь файл в редакторе, агент, когда пишет его или запускает команду, которая его переписывает, загрузка, которая его заменяет, или синхронизация, которая принесла копию, исправленную на компьютере. История начинается с первой правки файла, и то, что в нём было прямо перед ней, тоже сохраняется; у файла, который только создали или загрузили, возвращаться пока не к чему, и места он лишнего не занимает. Кнопка с часами в шапке открытого файла (**История** на отдельной странице файла) показывает версии, новые сверху, и у каждой — кто её сделал: *Вы*, *Агент* с чатом, в котором он работал, *Загружен*, *Изменён вне редактора* (синхронизация, терминал или другая программа). - **Сравнить.** Выбери версию, и увидишь, что изменилось по сравнению с предыдущей; можно сравнить её и с файлом как он есть сейчас, и с любой другой версией. **Текст** показывает новую формулировку, а старые слова зачёркнуты прямо в ней — так читается отредактированный документ; **Строки** показывают старые строки над новыми, с номерами, — так удобнее для кода. Неизменённые части свёрнуты, а стрелки (или Alt+↑ / Alt+↓) переходят от одного изменения к следующему. - **Восстановить.** **Восстановить** возвращает версию. То, что было в файле до этого, тоже сохраняется, так что и восстановление можно отменить. Исключение — файл, который с тех пор вырос больше 10 МБ или не читается: над списком версий об этом сказано, и восстановление сначала спрашивает, потому что заменённое сохранить нельзя. - **Скачать** сохраняет любую версию отдельным файлом с её номером, например `договор (v3).docx`. Документы (`.docx`, `.xlsx`, `.pptx`, `.odt`) сравниваются по тексту внутри: абзацы, строки таблиц, слайды, строки листа. Оформление не сравнивается. У картинок, записей, архивов и PDF истории нет, как и у заметок и навыков самого агента, папок с зависимостями, файлов с секретами и общих папок компании (это файлы компании, а не воркспейса). Каждая версия хранится 30 дней после того, как её заменила более новая, потом по одной в день до 90 дней, и не больше 200 на файл. История учитывается в месте на диске воркспейса и никогда не занимает больше его четверти: сверх этого первыми уходят версии, заменённые раньше всех, а когда диск почти заполнен, история сжимается, чтобы освободить место самим файлам. **Настройки → Общие → История версий файлов** показывает, сколько она занимает, удаляет версии старше недели или всю историю и выключает её. Историю одного файла можно удалить прямо из её списка. Агент тоже читает историю: спроси, что поменялось в документе со вчерашнего дня, или попроси вернуть прежнюю версию. Когда файл открыт рядом с чатом, агент понимает, о каком файле речь, — см. [«Чаты»](https://eggent.ai/r/docs/chats.md#open-file). ## Удаление {#delete} Кнопка удаления у файла или папки удаляет их после подтверждения. Удаление папки удаляет всё внутри. Файл, удалённый здесь, уходит вместе со [своей историей](#history). Если включена [синхронизация с компьютером](https://eggent.ai/r/docs/file-sync.md), удалённые файлы 30 дней хранятся в корзине синхронизации. ## Место на диске {#storage} В облаке у воркспейса ограниченный диск: на пробном периоде 100 МБ, на тарифах больше. [История файлов](#history) тоже в нём учитывается. Когда диск заполнен на три четверти, в боковой панели появляется предупреждение. Если диск заполнен полностью, агент перестаёт отвечать, но панель **Файлы** работает — удали лишнее, и работа продолжится со следующего сообщения. Подробнее — в [«Тарифы и баланс»](https://eggent.ai/r/docs/plans.md#storage). На своём сервере место ограничено только диском машины. ## Где физически лежат файлы {#layout} | Что | Путь внутри воркспейса | | --- | --- | | Файлы проекта | `data/projects//` | | Файлы оркестратора | `data/projects/` (рядом с папками проектов) | | Вложения чатов | `data/chat-files//` | | Версии файлов | `data/versions/` | Полное устройство — в [«Устройство воркспейса»](https://eggent.ai/r/docs/workspace-layout.md). --- # Работа в компании > Компания — это группа воркспейсов, по одному на человека, которой управляет администратор. Её люди пишут друг другу, открывают друг другу файлы для просмотра, комментариев или правки и отправляют версии файлов на согласование по очереди — с помощью своих агентов. Source: https://eggent.ai/r/docs/company/ В Eggent Cloud воркспейс может стать **компанией**: воркспейс администратора и по воркспейсу на каждого человека в ней. У каждого остаются свой агент, свои файлы и чаты. Компания добавляет к этому совместную работу: переписку между людьми, общие файлы и согласование документов. > [!NOTE] > Компании открываются постепенно. Чтобы сделать свой воркспейс компанией, напиши в поддержку. Что входит, как платится и как подключить — на странице [Eggent Business](https://eggent.ai/r/docs/business.md). ## Администратор и люди {#people} Администратор управляет компанией из пункта **Компания** плавающей кнопки в углу экрана: - **Люди.** Каждый человек получает свой воркспейс и одноразовую ссылку для входа (действует 72 часа и срабатывает один раз). Администратор может выслать новую ссылку или задать новый пароль. - **Деньги.** Работа людей с агентом оплачивается с баланса компании. Можно задать месячные лимиты для каждого человека и для каждой команды; когда лимит исчерпан, агент этого человека останавливается до следующего месяца или пока лимит не поднимут. Диск тоже общий: файлы людей считаются в место тарифа администратора. Сколько людей входит в тариф — на странице [Eggent Business](https://eggent.ai/r/docs/business.md#price). - **Команды** объединяют людей — для лимитов и для папок. - **Папки компании** — общие диски: папку дают одному человеку, команде или всем, на чтение или на чтение и запись, и она появляется в их воркспейсе как `.shared/<имя>`. Это файлы компании, и [истории](https://eggent.ai/r/docs/files.md#history) у них нет. Агент администратора умеет то же по просьбе — завести человека, выслать ссылку для входа, сбросить пароль — и может читать чаты людей, чтобы подготовить отчёт. Каждое такое чтение записывается, а агент каждого человека знает, что так бывает. Удалить человека, папку или всю компанию можно только в консоли. ## Сообщения {#messages} Раздел **Сообщения** в боковой панели — переписка с каждым человеком: администратор пишет каждому, каждый — администратору. - Пиши и прикладывай файлы. Файлы из переписки копируются в папку **Переписка** обоих воркспейсов, под именем собеседника, чтобы агент мог их прочитать. - **Ответить** — ответ на сообщение с цитатой. - **Поручить агенту** открывает чат с твоим агентом об этом сообщении: агент читает его как материал, готовит ответ, а кнопка **Отправить: …** под ответом отправляет его — если нужно, вместе с файлами ответа. Пока не нажмёшь, ничего не уходит. - О новом сообщении приходит уведомление в Telegram через бота Eggent, если ты к нему подключён. Ответ на это уведомление в Telegram попадает в переписку. Агент тоже пишет коллегам: «передай Петру, что совещание перенесли на 10» уйдёт Петру с пометкой, что написал агент. ## Общие файлы {#shares} Любым файлом своего воркспейса можно поделиться с людьми компании. Файл остаётся на месте: они видят его таким, какой он у тебя, со всеми сохранёнными изменениями. Кнопка **Поделиться** рядом с файлом — в [панели «Файлы»](https://eggent.ai/r/docs/files.md#panel) или на странице файла — показывает, кому он открыт и что каждому можно: - **Читатель** — смотреть и скачивать; - **Комментатор** — ещё и оставлять комментарии; - **Редактор** — ещё и менять файл. Добавь людей их кнопками, выбери роль и нажми **Поделиться** (потом — **Сохранить**); каждый новый человек получит уведомление в Telegram. Строка над общим файлом говорит, кто его видит. **Закрыть доступ** забирает файл у всех и удаляет комментарии к нему. ### Файлы, открытые тебе {#shared-with-you} Раздел **Общие файлы** в боковой панели показывает файлы, которые тебе открыли коллеги (**Новое** — что-то изменилось или появился комментарий с тех пор, как ты открывал файл), и файлы, которые открыл ты. Общий файл открывается на своей странице: - веб-страница — в готовом виде или как код ([Страницы](https://eggent.ai/r/docs/files.md#pages)); текст и код; текст документа (`.docx`, `.xlsx`, `.pptx`); картинка; - **Скачать** и **Сохранить в PDF** ([PDF](https://eggent.ai/r/docs/files.md#pdf)); - комментарии рядом. ### Комментарии {#comments} Комментарий относится ко всему файлу или к его фрагменту: выбери блок на странице кнопкой **Выбрать** или выдели строки в коде — комментарий сохранит этот фрагмент таким, каким он был. На комментарии отвечают. Автор ветки или владелец файла отмечает её решённой (**Решено**) и может удалить. Владелец получает в Telegram уведомление о каждом комментарии, автор ветки — о каждом ответе в ней. ### Правка чужого файла {#edit} Если ты **Редактор**, меняй слова прямо на странице (двойной щелчок по блоку, Enter сохраняет) или код, затем **Сохранить**. Изменение записывается в файл владельца — и только поверх той версии, которую ты открыл: если файл тем временем изменился, ничего не записывается, и тебе предлагают загрузить новую версию и внести правку в неё. У владельца ничего не теряется. Прежде чем кому-то можно будет менять файл, его содержимое сохраняется в истории, а каждая правка коллеги становится версией с его именем — «Пётр, через общий доступ», — её можно сравнить и восстановить, как любую другую ([История файла](https://eggent.ai/r/docs/files.md#history)). Правка, как и любое изменение, снимает согласование файла. Файлами с ключами доступа (`.env`, ключи и тому подобное) не делятся никогда. Общий файл может быть до 20 МБ, правка с экрана — до 5 МБ. ## Согласования {#approvals} Согласование — это строгое «да» **одной версии** файла. 1. **Согласование** рядом с файлом: выбери, кто согласует, **по порядку**, добавь пояснение и нажми **Отправить на согласование**. Уходит версия, которая в файле сейчас, и она сохраняется в его истории под своим номером. 2. Первый человек решает: **Согласовать** или **Вернуть на доработку** с комментарием, что изменить. Следующего спрашивают, только когда предыдущий согласовал. 3. Когда согласовали все, версия согласована. **Любое изменение файла снимает согласование** — и пока оно идёт, и после того как версию согласовали. Измени файл и отправь новую версию: цепочка начнётся заново с первого человека. Согласования никогда не переносятся с одной версии на другую. В разделе **Согласования** в боковой панели три вкладки: **Ждут вас**, **Отправленные** и **Где вы участвовали**. На странице согласования — цепочка с решениями и комментариями, что изменилось с прошлой версии, весь текст и файл для скачивания. Автор может **Снять с согласования** версию. Каждый участник получает в Telegram уведомления о своей очереди, возврате, итоговом согласовании и изменении файла. Файл на согласование — до 20 МБ, в цепочке — до 10 человек. ## Проекты для сотрудников {#projects} Администратор может открыть один из своих проектов людям компании — всем, команде или конкретным людям. Проект появится в разделе **Проекты** у каждого из них, со значком здания, и они задают ему вопросы на отдельной странице. Проект отвечает только по своим файлам и ничего не может изменить; сами файлы людям не выдаются, только ответы. - **Где это работает.** Каждый вопрос выполняется в пространстве администратора, внутри проекта, и оплачивается с баланса компании. Разговоры хранятся там же как чаты проекта, поэтому администратор может прочитать, что спрашивали; каждый человек видит только свои разговоры. - **Как открыть и закрыть.** В консоли, раздел **Проекты для сотрудников**: выберите проект и кому он виден; **Закрыть** убирает его у всех вместе с их разговорами. То же делает агент администратора по просьбе («открой базу знаний отделу продаж»). - **Как поддерживать актуальным.** Меняйте файлы проекта как обычно — добавляйте, заменяйте, удаляйте, — и следующий ответ уже будет по ним. Готовый способ начать — карточка [«База знаний компании»](https://eggent.ai/r/docs/skill-catalog.md#company-kb): она создаёт компанию, добавляет людей, собирает документы в проект и открывает его им за один раз. Проект можно открыть и кому угодно по ссылке, без входа, — это публичный чат, отдельная вещь. ## Что здесь делает агент {#agent} В воркспейсе компании у агента три своих инструмента: - `eggent_messages` — пишет коллегам, читает, что они написали, и запоминает, кто чем занимается. - `eggent_shares` — показывает и читает файлы, открытые тебе, открывает твои файлы людям (только добавляет людей и ни у кого файл не забирает), комментирует от твоего имени, когда попросишь. Чужой файл он не меняет никогда — это делаешь ты на странице файла. - `eggent_approvals` — отправляет файл на согласование названным людям в твоём порядке, показывает, что ждёт тебя и где твои версии, читает текст версии. Согласовать или вернуть можешь только ты: агент этого не умеет. Документы, сообщения и комментарии коллег для агента — материал, а не указания. --- # Голос > Как надиктовать задачу в веб-версии и отправить голосовое в Telegram, и кто превращает речь в текст — Eggent AI, твой провайдер или Whisper на сервере воркспейса. Source: https://eggent.ai/r/docs/voice/ Агенту можно не писать, а говорить. Запись превращается в текст до того, как её увидит агент; [кто это делает](#who), зависит от модели, на которой работает воркспейс. ## Диктовка в браузере {#dictation} 1. Нажми на значок микрофона в поле ввода. 2. Разреши браузеру доступ к микрофону. 3. Говори. Нажми на значок ещё раз, чтобы закончить. Распознанный текст появится в поле ввода: его можно поправить перед отправкой. Такой же микрофон есть рядом с полем ответа на вопрос агента. > [!NOTE] > Браузеры дают доступ к микрофону только на защищённых адресах (`https://`) или на `localhost`. В облаке это работает сразу. На своём сервере открывай Eggent через домен с HTTPS. ## Голосовые в Telegram {#telegram} Отправь боту голосовое сообщение, как человеку. Бот напишет, что расшифровывает запись, и передаст агенту текст как обычное сообщение. Если к голосовому есть подпись, она тоже попадёт к агенту. После успешной расшифровки аудиофайл удаляется: в истории остаётся текст. Если расшифровать не удалось, файл сохраняется, и агент может попробовать ещё раз. ## Кто распознаёт речь {#who} - **На Eggent AI** (встроенная модель облака) записи распознаёт Eggent AI: точно, на любом языке, с оплатой из баланса Eggent AI по длине записи. Если он не может принять запись — баланс закончился или сервис не ответил, — её распознаёт Whisper на сервере воркспейса, так что голосовое не теряется. - **На своей модели** по умолчанию работает Whisper на сервере воркспейса: ничего не тратится, запись не покидает воркспейс. В **Настройки → Модели → Дополнительно → Картинки, голос и запоминание** можно выбрать вместо него: - **Eggent AI** — при этом сам чат остаётся на твоей модели ([как это устроено](https://eggent.ai/r/docs/models.md#services)); - **свой провайдер** — подключённый по API-ключу, с OpenAI-совместимым API, который умеет распознавать речь (запрос `/audio/transcriptions`), и идентификатор модели у этого провайдера. У входа по подписке ключа нет, поэтому его здесь не предлагают. Если провайдер откажет, запись распознает Whisper. - **На своём сервере** Eggent AI нет: Whisper или свой провайдер, как выше. ## Whisper на сервере {#how} - Запись нормализуется через `ffmpeg`. - Текст распознаёт `whisper.cpp` — локальная модель распознавания речи. Язык определяется автоматически. - Модель скачивается один раз при первом распознавании и дальше лежит в `data/models/whisper/`. Whisper работает внутри воркспейса и ничего не стоит. Модель по умолчанию маленькая и быстрая; на своём сервере модель побольше распознаёт точнее (`EGGENT_STT_MODEL` ниже). ## Настройки на своём сервере {#self-host} | Переменная | По умолчанию | Что делает | | --- | --- | --- | | `EGGENT_STT_ENABLED` | `1` | Включает распознавание речи | | `EGGENT_STT_MODEL` | `base` | Модель: `tiny`, `base`, `small`, `medium`. Больше — точнее и медленнее | | `EGGENT_STT_LANGUAGE` | `auto` | Язык речи или автоопределение | | `EGGENT_STT_AUTO_DOWNLOAD_MODEL` | `1` | Скачать модель при первом использовании | Подробнее — в [«Настройка своего сервера»](https://eggent.ai/r/docs/self-host-config.md). --- # Картинки > Как попросить агента нарисовать картинку или отредактировать свою — по образцу, с нужным соотношением сторон и качеством — и сколько это стоит. Source: https://eggent.ai/r/docs/images/ Агент умеет создавать новые картинки по описанию и менять существующие: убрать или заменить фон, сделать вариант в другом стиле, собрать обложку по образцу. ## Как попросить {#ask} Опиши, что нужно, как дизайнеру: - «Нарисуй обложку для поста про осенние скидки: кофейня, тёплый свет, место для заголовка сверху, формат 4:5». - «Вот фото товара (прикрепил). Замени фон на белый и сделай квадрат 1:1». - «Сделай три варианта логотипа в стиле пиксель-арт, прозрачный фон». Чем точнее описание (что изображено, стиль, цвета, формат, что оставить с образца), тем меньше попыток понадобится. ## Картинка-образец {#references} Прикрепи к сообщению одну или несколько картинок или укажи файл из проекта. Агент передаст их как образец: можно попросить сохранить композицию, цвета, лицо, товар и поменять остальное. ## Параметры {#options} | Параметр | Значения | Заметка | | --- | --- | --- | | Соотношение сторон | `1:1`, `16:9`, `9:16`, `4:3`, `4:5` и другие | Для постов, сторис, обложек | | Размер | `1K`, `2K`, `4K` или точный, например `1024x1024` | | | Качество | `low`, `medium` (по умолчанию), `high` | `high` в несколько раз дороже | | Формат | `png`, `jpeg`, `webp` | | | Фон | обычный или прозрачный | Прозрачный — для логотипов и иконок | | Количество | сколько вариантов сразу | Каждый вариант оплачивается отдельно | Говорить параметры словами можно и нужно: «вертикально для сторис», «в хорошем качестве», «с прозрачным фоном». ## Где результат {#result} Готовые картинки сохраняются в папку `generated-images/` текущего проекта и сразу видны в панели **Файлы**. Агент покажет пути к ним в ответе, и их можно открыть или скачать. Попроси — и он отправит картинку в Telegram или опубликует в канале. ## Стоимость {#cost} - В облаке картинки рисует **Eggent Images**. В каждый тариф [входит несколько картинок в месяц](https://eggent.ai/r/docs/plans.md#tools), они не списываются с баланса; сколько — написано на странице оплаты. Сверх них картинка оплачивается с баланса Eggent AI: цена зависит в основном от качества, агент видит стоимость каждой картинки и может её назвать. - На пробном периоде можно нарисовать **две** картинки, дальше — с тарифом. - Если воркспейс работает на [своём ключе](https://eggent.ai/r/docs/models.md#own-provider), картинки выключены, пока ты не выберешь в **Настройки → Модели → Дополнительно → Картинки, голос и запоминание**: Eggent AI — с оплатой из его баланса, как выше, — или своего провайдера, подключённого по API-ключу ([подробнее](https://eggent.ai/r/docs/models.md#services)). --- # Модели > Какая модель отвечает агенту, как её сменить для всего воркспейса или одного проекта, что такое Eggent AI, как подключить свой ключ любого провайдера и как вернуться обратно. Source: https://eggent.ai/r/docs/models/ Модель — это «мозг» агента: она читает твою задачу, решает, какие инструменты вызвать, и пишет ответ. От модели зависят качество, скорость и цена работы. ## Eggent AI {#eggent-ai} В облаке сразу подключён **Eggent AI** — каталог моделей разных семейств: GPT, Claude, Gemini, DeepSeek, GLM, Kimi. Ключи не нужны: все модели оплачиваются из одного баланса воркспейса. - Цены указаны за миллион токенов отдельно для входа, кешированного входа и выхода. Таблица цен есть на странице оплаты и в **Настройки → Модели**. - Цены берутся от опубликованных цен разработчиков моделей, поэтому их можно сверить. - Дешёвые модели растягивают баланс, сильные лучше справляются со сложной работой. Одну и ту же задачу можно делать разными моделями в разных проектах. Доступны все модели из списка, в том числе на пробном периоде. Если в установке часть списка ограничена, остальные видны, но неактивны, рядом указано, как их открыть. См. [«Тарифы и баланс»](https://eggent.ai/r/docs/plans.md). ## Сменить модель {#change} **Быстро, прямо в чате.** Слева от кнопки отправки — название модели. Нажми на него, найди модель поиском и выбери. Модели сгруппированы по семействам. - В проекте выбор сохраняется **для этого проекта**. - У оркестратора — **для всего воркспейса** и для всех проектов без своей модели. Строка показывает, какая модель ответит **на следующее** сообщение. **В настройках.** **Настройки → Модели** → **Модель воркспейса**: провайдер и модель. Под **Дополнительно** — глубина рассуждений (сколько модель думает перед ответом), генерация изображений и ручное редактирование `models.json`. ## Модель проекта {#project-model} Проекту можно дать свою модель: дешёвую для массовой работы, сильную — там, где это окупается. В **Настройки → Модели** переключи сверху справа область на нужный проект и выбери: - **модель воркспейса** — проект отвечает той же моделью, что и оркестратор; - **свою модель** — из провайдеров, которые сейчас могут отвечать. Пока воркспейс работает на Eggent AI, проект выбирает среди моделей Eggent AI. Если сохранённую модель проекта использовать нельзя (например, провайдер отключён), проект молча отвечает моделью воркспейса. ## Свой провайдер {#own-provider} Можно работать на своём ключе — OpenAI, Anthropic, Google, OpenRouter, DeepSeek или любого сервиса с OpenAI-совместимым API, в том числе своей локальной модели на своём сервере. Тогда запросы идут напрямую провайдеру и оплачиваются по его тарифу, а баланс Eggent AI не тратится. 1. **Настройки → Модели → Подключить своего провайдера.** 2. Выбери провайдера. 3. Вставь ключ API и нажми **Сохранить ключ**. У некоторых провайдеров вместо ключа есть вход по подписке. 4. Выбери модель. Eggent сразу скажет, на какой модели теперь отвечает воркспейс. > [!WARNING] > Вставляй ключи в настройки, а не в чат. Ключ из настроек хранится в защищённом файле и не попадает в историю переписки. **Провайдера, которого нет в списке,** проще всего подключить через агента: напиши «подключи провайдера с адресом `https://…/v1` и моделью `…`». Агент зарегистрирует его, а ключ ты вставишь в настройках. Второй способ — **Дополнительно → Кастомные провайдеры и модели**, где редактируется `models.json`. Если ключ не подходит или адрес недоступен, Eggent скажет, что именно не так: адрес не отвечает, ключ отклонён или у провайдера нет такой модели. ## На этом компьютере {#on-this-computer} В [приложении Eggent для Mac](https://eggent.ai/r/docs/desktop-app.md) проект может работать и на **Claude Code** или **Codex**, уже установленных на компьютере, — по твоей подписке вместо модели: см. [Работа на своей подписке](https://eggent.ai/r/docs/desktop-programs.md). ## Картинки, голос и запоминание {#services} Пока воркспейс работает на Eggent AI, тот же Eggent AI рисует [картинки](https://eggent.ai/r/docs/images.md), превращает [голос](https://eggent.ai/r/docs/voice.md) в текст и делает короткий разбор после ответа, из которого агент берёт [то, что выучивает](https://eggent.ai/r/docs/memory.md#learned). Когда ты переходишь на своего провайдера, все три перестают использовать Eggent AI, и с его баланса больше ничего не списывается: - картинки выключены, пока ты не выберешь, кто их рисует; - голос распознаёт Whisper на сервере воркспейса; - разбор после ответа идёт на модели самого чата. В **Настройки → Модели → Дополнительно → Картинки, голос и запоминание** Eggent AI можно включить обратно для любого из трёх по отдельности — например, чат оставить на своей модели, а голос отдать Eggent AI, — или направить картинки и голос к своему провайдеру. Это должен быть провайдер, подключённый по API-ключу: у входа по подписке ключа нет. При следующем уходе с Eggent AI он снова выключается для всех трёх, а проект, у которого была выбрана модель Eggent AI, переходит на твою новую модель. Прежний выбор запоминается в настройках модели проекта, так что вернуть его — два клика. ## Вернуться на Eggent AI {#back} В **Настройки → Модели** нажми **Снова использовать Eggent AI**. Ключ не нужен, переключение в один клик, и картинки, голос и разбор после ответа снова идут через него. Ключи своих провайдеров при этом сохраняются: к ним тоже можно вернуться. ## Свой сервер {#self-host} В открытом ядре Eggent AI нет: при первом запуске подключи провайдера в настройках или задай ключ переменной окружения (`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GOOGLE_API_KEY`, `OPENROUTER_API_KEY`). См. [«Настройка своего сервера»](https://eggent.ai/r/docs/self-host-config.md). --- # Контекст > Постоянные инструкции, которые агент получает в каждом сообщении, — что в них писать, где их редактировать и почему их стоит держать короткими. Source: https://eggent.ai/r/docs/context/ **Контекст** — это то, что агент знает всегда, не спрашивая: кто ты, что это за проект, как отвечать. Он хранится в файле `context.md` и добавляется к каждому сообщению. ## Где редактировать {#where} **Настройки → Контекст.** Справа вверху выбери оркестратора или проект: у каждого свой `context.md`. Изменения работают со следующего сообщения, в том числе в уже открытых чатах. Можно и не открывать настройки: попроси агента в чате — «добавь в контекст проекта, что тексты пишем без канцелярита и на „ты“». ## Что писать в контекст оркестратора {#orchestrator} То, что должно быть известно в любом чате: - кто ты и чем занимаешься; - как тебе удобнее получать ответы (коротко или подробно, списком или текстом, на каком языке); - таблица проектов — какой проект за что отвечает, чтобы оркестратор сам переключался в нужный. Карточка **«Бизнес ИИ система»** заполняет этот контекст сама. ## Что писать в контекст проекта {#project} То, что нужно для этой работы и больше ни для какой: - цель проекта и для кого результат; - правила и стиль: тон текстов, формат отчётов, обязательные разделы; - где что лежит в папке проекта: «образцы — в `samples/`, готовое — в `out/`»; - чего делать нельзя. Пример: ```markdown # Контент для канала «Кофе на районе» Пишем посты для Telegram-канала сети кофеен в Казани. Аудитория — жители района, 25–45 лет. - Тон дружеский, на «вы», без восклицательных знаков. - Пост — до 600 знаков, в конце один вопрос к читателю. - Фото берём из `photos/`, готовые посты кладём в `posts/ГГГГ-ММ-ДД.md`. - Никогда не называем цены: они меняются. ``` ## Держи контекст коротким {#keep-short} Контекст уходит **в каждое сообщение** каждого чата, где он действует, и оплачивается каждый раз. Поэтому: - пиши правила и указатели, а не сами материалы. Не «вот весь прайс», а «прайс — в `price.xlsx`»; - большие справочные данные клади файлами в проект: агент прочитает их, когда они понадобятся; - то, что агент узнал по ходу, пусть живёт в [памяти](https://eggent.ai/r/docs/memory.md), а не в контексте. ## Контекст, память и навыки: что куда {#what-where} | Что | Куда | | --- | --- | | Правило, которое действует всегда | Контекст | | Факт, который пригодится когда-нибудь | [Память](https://eggent.ai/r/docs/memory.md) | | Инструкция для определённого вида работы | [Навык](https://eggent.ai/r/docs/skills.md) | | Большой справочный материал | Файл в проекте | --- # Память > Как агент запоминает факты между чатами — записная книжка, в которой он ищет, короткие заметки и навыки, которые он выучивает сам, как попросить запомнить или забыть и где всё это посмотреть и поправить. Source: https://eggent.ai/r/docs/memory/ **Память** — это записная книжка агента. В отличие от [контекста](https://eggent.ai/r/docs/context.md), она не отправляется целиком в каждое сообщение: агент ищет в ней, когда нужно, поэтому туда можно складывать много мелких фактов. ## Как это работает {#how} - Агент **сохраняет** в память то, что пригодится позже: твои решения, предпочтения, договорённости, найденные факты. - Когда задача может быть связана с прошлым, агент **ищет** в памяти по смыслу запроса. - Устаревшее агент **удаляет** сам или по твоей просьбе. Память хранится в файле `memory.md`: у оркестратора своя, у каждого проекта своя. Записи из памяти проекта агент видит, только когда работает в этом проекте. ## Что агент выучивает сам {#learned} Кроме записной книжки, у Eggent есть два коротких списка, которые агент **читает в начале каждого чата**: - **О тебе** — кто ты и как с тобой лучше работать: чем занимаешься, на каком языке, в каком тоне и формате отвечать. - **О работе** — договорённости и уроки, которые пригодятся снова: куда класть отчёты, чего не делать после того, как ты поправил. После некоторых разговоров — когда ты просишь что-то запомнить, поправляешь агента, когда он справился с ошибкой или проделал большую работу, а в долгом чате ещё и время от времени — агент в фоне оглядывается на разговор и решает, стоит ли что-то сохранить. Чаще всего не стоит. Если он что-то сохранил, заметка появляется под его ответом («Записал о тебе: …»), а в Telegram — одним коротким сообщением. Этот взгляд назад никогда не задерживает ответ. Он идёт на модели самого чата — на Eggent AI, пока воркспейс на нём; на своей модели — на ней же, если ты не [включил Eggent AI для запоминания](https://eggent.ai/r/docs/models.md#services). Ещё он может написать **навык** — повторяемый порядок действий для задачи, которую только что разобрал. Такие навыки помечены «Написано агентом» в **Настройки → Навыки**, доступны во всех проектах, и агент меняет только те, что написал сам, — никогда не те, что сделал или установил ты. Навык, которым долго не пользовались, получает отметку, а много позже переносится в `skills/.archive/`. Ничего не удаляется. Ограничения: - Списки маленькие (около 1400 и 2200 знаков), поэтому агенту приходится выбирать, что стоит строки. - Он никогда не хранит пароли, ключи и токены и отказывается от всего, что написано как приказ самому себе. - Он не учится на лёгких чатах и на публичных ссылках на проект. - Заметка — это фон, а не команда: что ты говоришь в чате, всегда важнее. **Настройки → Память → Что агент выучил** показывает всё: убери заметку крестиком, добавь свою, посмотри навыки, которые он написал, или выключи обучение (то, что уже сохранено, продолжает использоваться). Заметки лежат в файле `learned.md` в папке оркестратора — это обычный текст, его можно править руками. Чтобы убрать одну прямо в чате, скажи «забудь, что у меня пекарня». ## Попросить запомнить или забыть {#ask} Просто скажи: - «Запомни: отчёты я жду по понедельникам к 10 утра». - «Запомни, что наш основной поставщик теперь „Альфа“, а не „Бета“». - «Что ты помнишь про наших поставщиков?» - «Забудь всё про старый адрес склада». ## Посмотреть и поправить {#edit} **Настройки → Память.** Справа вверху выбери оркестратора или проект. Это обычный текстовый файл: можно дописать, исправить или удалить записи руками и сохранить. ## Память или контекст {#memory-or-context} - **Контекст** — короткие правила, которые нужны в каждом сообщении. Их агент получает всегда. - **Выученные заметки** — несколько коротких фактов о тебе и работе, которые агент записал сам и тоже получает каждый раз. - **Память** — много фактов, каждый из которых нужен иногда. Агент достаёт их по запросу. Если агент постоянно забывает какое-то правило, перенеси его из памяти в контекст. --- # Навыки > Что такое навык, как агент выбирает нужный, как установить готовый, загрузить навык из файла, удалить навык, запустить вручную, написать свой — и из чего навык состоит. Source: https://eggent.ai/r/docs/skills/ **Навык** — готовая инструкция для определённого вида работы. Он превращает «сделай мне базу знаний» из импровизации в отлаженный процесс: какие вопросы задать, в каком порядке работать, какие файлы создать, как проверить результат. ## Как агент пользуется навыками {#how} У каждого навыка есть короткое описание: что он делает и когда нужен. Агент видит описания всех навыков текущего проекта (или оркестратора) и, когда задача подходит, открывает полную инструкцию и работает по ней. Специально звать навык не нужно. Если хочешь запустить навык явно, напиши в чате `/skill:имя-навыка`, например `/skill:doc-templates`. ## Готовые навыки и карточки {#bundled} На экране нового чата есть **карточки быстрого старта**. Каждая карточка — готовый навык: нажми, и агент сразу начнёт работу, при необходимости задаст пару вопросов. Большинство карточек создают себе отдельный проект; «Бизнес ИИ система» и «Свой Telegram-бот» работают у оркестратора. Все готовые навыки есть в **Настройки → Навыки → Каталог встроенных навыков**: их можно установить в оркестратор или в любой проект кнопкой **Установить**. Описание каждого — в [«Готовые навыки»](https://eggent.ai/r/docs/skill-catalog.md). Установленные готовые навыки обновляются сами, когда мы их улучшаем, — если ты не менял их вручную. Изменённую копию Eggent не трогает. ## Загрузить навык из файла {#upload} Если навык у тебя уже есть файлом — написанный самим, полученный от коллеги или скачанный, — положи его в рабочее пространство без участия агента: **Настройки → Навыки → Загрузить навык**. Вверху справа выбери оркестратор или проект (навык установится туда, куда указывает переключатель), затем перетащи файлы в пунктирную область или нажми на неё и выбери их. Можно сразу несколько файлов; на каждый приходит свой ответ. Что можно загрузить: - **файл `.md`** — `SKILL.md`, который начинается с YAML-заголовка с `name` и `description`; - **архив `.zip` или `.skill`** — папка навыка, где `SKILL.md` лежит в корне архива или внутри одной папки, и всё остальное, что навыку нужно: `scripts/`, `references/`, `assets/` или любые другие папки. (Файл `.skill` — тот же ZIP-архив под другим именем.) Файл проверяется до того, как что-то сохранено. Если проверка не пройдена, ничего не устанавливается и на диске ничего не остаётся, а в ответе сказано, что не так и где: что `SKILL.md` не найден (и где он нашёлся вместо этого), что заголовок — некорректный YAML в строке 3, что имя недопустимо, что запись в архиве — ссылка или выходит за пределы папки навыка. Что проверяется: - `SKILL.md` есть, это текст в UTF-8, и он начинается с YAML-заголовка; `name` — строчные латинские буквы, цифры и одиночные дефисы (до 64 символов), `description` не пустое (до 1024); - имена файлов не выходят за папку навыка, нет ссылок и специальных файлов, у архива нет пароля; - загрузка не больше 30 МБ, а навык — не больше 600 файлов и 30 МБ в распакованном виде. Проверяется структура. Что делает скрипт, не проверяется, а агент может запускать скрипты навыка, поэтому загружай только навыки, которым доверяешь. Если навык с таким именем уже установлен, он не перезаписывается: в ответе об этом сказано и предложена кнопка **Заменить**. При замене новый навык встаёт на место, а старая папка уходит в `skills/.replaced/`, а не удаляется, так что то, что ты добавил в неё руками, не пропадёт. Чтобы вместо этого избавиться от старого, сначала удали его (см. [«Установленные навыки»](#installed)). Навык, который агент написал сам, несёт в заголовке строку `origin: learned`. Когда ты загружаешь такой навык — скажем, скачанный из другого рабочего пространства, — строка убирается, и тебе об этом сообщают: с этого момента навык твой, и агент его не меняет. ## Установленные навыки {#installed} **Настройки → Навыки** показывает навыки, установленные в выбранной области (оркестратор или проект). Нажми на навык, чтобы прочитать его инструкцию. Навык действует только там, куда он установлен. Навык оркестратора не виден в проектах, и наоборот — кроме навыков, которые агент написал сам: они доступны везде (см. [«Навыки, которые агент пишет сам»](#learned)). Чтобы убрать навык, нажми на значок корзины в конце его строки и подтверди. Папка навыка удаляется со всем, что в ней лежит, вместе с прежними версиями, которые остались после замены (`skills/.replaced/`). Отменить это нельзя: навык, который есть только здесь, исчезнет насовсем. Навык из каталога можно установить снова, а загруженный — загрузить ещё раз. Удаление заодно освобождает имя: это выход, когда при загрузке сказано, что навык с таким именем уже установлен, а заменять его не хочется. ## Навыки, которые агент пишет сам {#learned} После работы, которая потребовала усилий, — ошибки, из которой он выбрался, порядка действий, который ты поправил, — агент может сам, без просьбы, сохранить этот порядок как навык. Он покажется под ответом («Выучил новый навык: …»), в **Настройки → Навыки** будет с пометкой «Написано агентом» и лежит в `skills/` оркестратора, как любой другой. Подробности и ограничения — в [«Памяти»](https://eggent.ai/r/docs/memory.md#learned). Улучшает агент только навыки, которые написал сам. Навык, который ты сделал или установил, он не меняет никогда. Чтобы оставить навык агента себе, поправь его руками и удали из заголовка строку `origin: learned` — после этого агент его не трогает. Выученный навык, которым долго не пользовались, получает отметку «Давно не использовался», а потом переносится в `skills/.archive/`; чтобы вернуть, перенеси папку обратно. Выученный навык можно и удалить из списка, как любой другой; агент может написать его снова, если такая работа повторится. ## Написать свой навык {#create} Проще всего — попросить агента: > «Сделай навык для еженедельного отчёта по продажам: берёшь выгрузку из `sales/`, считаешь выручку по категориям, сравниваешь с прошлой неделей и пишешь итог в три абзаца плюс таблицу». Агент создаст навык в текущем проекте. Хороший момент для этого — сразу после того, как вы вместе один раз сделали работу как надо: попроси «оформи то, что мы сейчас сделали, в навык». ## Из чего состоит навык {#structure} Навык — это папка в `skills/` проекта (или оркестратора): ```text skills/ └── weekly-sales-report/ ├── SKILL.md # инструкция ├── scripts/ # скрипты, если нужны └── references/ # образцы и справочные материалы ``` `SKILL.md` начинается с заголовка в формате YAML: ```markdown --- name: weekly-sales-report description: Еженедельный отчёт по продажам из выгрузки в sales/. Используй, когда просят отчёт по продажам за неделю. --- # Еженедельный отчёт по продажам 1. Найди самую свежую выгрузку в `sales/`. 2. … ``` - `name` — имя навыка латиницей через дефис, совпадает с именем папки. - `description` — что навык делает и **когда** его использовать. По этому описанию агент решает, подходит ли навык, так что пиши его конкретно. ## Советы {#tips} - Один навык — один вид работы. Навык «на все случаи» агент будет применять не к месту. - Пиши в навыке шаги и критерии готовности, а не общие пожелания. - Если навык опирается на образцы, положи их в папку навыка, а не в контекст. --- # Готовые навыки > Все карточки быстрого старта Eggent Cloud — что делает каждая, с чем к ней приходить, где она работает и что получится на выходе. Source: https://eggent.ai/r/docs/skill-catalog/ Карточки быстрого старта — это готовые навыки, которые мы собрали из того, с чем люди чаще всего приходят в Eggent. Нажми карточку на экране нового чата, и агент начнёт работу. Ниже — все карточки в том порядке, в каком они стоят на экране. > [!NOTE] > Карточки есть в Eggent Cloud. В открытом ядре механизм тот же, но набор навыков не входит в поставку: свои навыки кладутся в папку `bundled-skills/`. ## Твой Google: документы, таблицы, презентации {#your-google} **Где работает:** отдельный проект. **Где есть:** Eggent Cloud. Скажи, что нужно, — «бюджет ремонта», «презентация о нашем продукте», «план на неделю». Агент подключит твой Google (одна кнопка, доступ только к файлам, которые делает Eggent), сделает настоящий Google Документ, Таблицу или Презентацию у тебя на Диске, пришлёт ссылку и поправит, как скажешь. Подробнее — в [«Google»](https://eggent.ai/r/docs/google.md). ## Следить за объявлениями, ценами и тендерами {#site-monitor} **Где работает:** отдельный проект. Пришли ссылку на поиск — квартиры, машины, вакансии, цены, госзакупки — или опиши, что искать. Агент напишет небольшой скрипт для этого сайта, сразу запустит его и покажет, что есть сейчас, подключит Telegram и поставит скрипт на расписание. Дальше приходит только новое; проверка без новинок молчит. Если сайт изменится и скрипт перестанет находить объявления, агент скажет об этом и предложит починить. Подробнее — в [«Расписаниях»](https://eggent.ai/r/docs/schedules.md#quiet). ## Сделать документ {#first-document} **Где работает:** отдельный проект. Хватит одной фразы: «презентация моей студии на 8 слайдов», «отчёт по конкурентам на страницу», «коммерческое предложение на ремонт офиса». Агент сначала собирает файл целиком — презентацию PowerPoint или документ Word — и только потом спрашивает, что поправить. Чего он не знает, например твоих цен или имён клиентов, оставляет заметной пометкой в квадратных скобках, а не выдумывает. Новые версии сохраняются рядом со старыми. ## База знаний компании {#company-kb} **Где работает:** в оркестраторе и в отдельном проекте с документами. Для команды, которая задаёт одни и те же вопросы. Агент спросит, кому дать доступ и где лежат документы, а дальше сделает всё сам: создаст компанию, если её нет, заведёт каждому человеку пространство и ссылку для входа, сложит документы в проект «База знаний компании» и откроет его им. Каждый спрашивает базу из своего пространства и получает ответы только по файлам. Чтобы обновить базу, меняй файлы проекта. Подробнее — в [«Работе в компании»](https://eggent.ai/r/docs/company.md#projects). ## Утренняя сводка в Telegram {#daily-digest} **Где работает:** отдельный проект. Назови тему и время — «новости рынка недвижимости Москвы, в 9:00», «курс рубля, нефть и биткоин, в 8:00». Агент сначала подключает Telegram (если ты регистрировался на сайте, он даст ссылку на бота: открой её и нажми **Start**), сразу присылает один настоящий выпуск, чтобы его можно было поправить, и только потом ставит сводку на ежедневное расписание. В выпуске 5–7 коротких пунктов со ссылками, и ничего не повторяется из прошлых дней. Подробнее — в [«Telegram»](https://eggent.ai/r/docs/telegram.md#shared-bot). ## Письмо от агента на почту {#email-digest} **Где работает:** отдельный проект. Назови тему — «ИИ для малого бизнеса», «недвижимость моего города» или «факт, книга и идея на неделю». Агент пишет тебе на почту со своего адреса: сразу одно настоящее письмо, чтобы его можно было поправить, а следующие — по расписанию, без повторов из прошлых писем. На пробном периоде он предложит раз или два в неделю, потому что письма тарифа считаются. Подробнее — в [«Почте агента»](https://eggent.ai/r/docs/email.md#to-you). ## Собрать таблицу с чужих сайтов {#rival-table} **Где работает:** отдельный проект. Дай список: товары, конкуренты, объявления, каналы. Агент обходит источники, собирает по каждой позиции одни и те же поля и отдаёт таблицу Excel со ссылкой на источник в каждой строке. Сначала делает **три строки на согласование** колонок. Если данных не нашёл, ячейка остаётся пустой: правдоподобная выдуманная цена хуже пропуска. ## Статьи для сайта {#site-articles} **Где работает:** отдельный проект. Агент изучает твой сайт — тон, структуру, формат ссылок — и записывает это в профиль сайта. Потом составляет список ключевых запросов и план статей и пишет **сначала одну статью на согласование**, а после одобрения — остальные. Каждая статья сразу в вёрстке для CMS, с мета-описанием, анонсом и описаниями для картинок. Фактов, которых ему не дали, агент не выдумывает: помечает места «уточнить». ## Документы по шаблону {#doc-templates} **Где работает:** отдельный проект. Дай образец документа, который приходится делать снова и снова: договор, счёт, акт, протокол, анкету. Агент находит, что в нём меняется, делает шаблон и дальше собирает новые документы по твоим ответам или сразу пачкой из таблицы. Форматирование образца сохраняется полностью: шрифты, таблицы, колонтитулы. Суммы прописью, даты вида «01» октября 2026 г. и строки таблиц товаров заполняются автоматически. Документ с незаполненным обязательным полем агент не отдаст. Результат — Word или Excel; PDF сохраняется из Word. ## Свой Telegram-бот {#telegram-bot} **Где работает:** у оркестратора. Подключает твоего собственного бота, чтобы писать воркспейсу из Telegram текстом, голосом и файлами. Агент объяснит, как создать бота в @BotFather, попросит вставить токен на странице **Мессенджеры** (не в чат), проверит подключение и выдаст одноразовые коды доступа для тебя и коллег. Бот отвечает только в личных сообщениях и только тем, кого ты впустил. Подробнее — в [«Telegram»](https://eggent.ai/r/docs/telegram.md#own-bot). ## Бизнес ИИ система {#business-system} **Где работает:** у оркестратора. Один раз расскажи о своём деле — продукты, клиенты, процессы, команда, — и агент разложит это по файлам в папке `system/`, по одному на каждую область. В контекст оркестратора попадает только короткая таблица «что где лежит», поэтому каждое сообщение не дорожает, а любой чат может обратиться к нужному файлу. Можно дать до пяти источников сразу: сайт, презентацию, документы. ## RAG по своим файлам {#rag} **Где работает:** отдельный проект. Строит векторную базу по твоим документам, чтобы агент отвечал по ним со ссылками на источники. Векторы хранятся в **твоей** базе Postgres с расширением pgvector: агент попросит строку подключения, сам создаст таблицу и индекс и будет обновлять базу, когда файлы в папке меняются. Модель для эмбеддингов предоставляет Eggent, отдельный ключ не нужен. ## Wiki LLM знаний и заметок {#wiki} **Где работает:** отдельный проект. Разбирает кучу заметок, выгрузок и документов в связанную базу знаний: отдельные страницы по темам, ссылки между ними, оглавление и журнал изменений. Дальше новые материалы складываются в папку, а агент встраивает их в вики и поддерживает её в актуальном виде. ## Контент-завод для ВК и Телеграм {#social-daily} **Где работает:** отдельный проект. Только в русском наборе. Подключает твоё сообщество ВКонтакте и Telegram-канал и дальше каждый день пишет пост с картинкой и публикует его. Порядок строгий: сначала подключить канал и опубликовать один настоящий пост, потом писать контент, и только потом ставить расписание. Для ВК понадобится ключ доступа сообщества с правами на стену и фото; агент объяснит, где его взять. ## Дизайн сайта и интерфейса {#designer} **Где работает:** отдельный проект. Три вопроса — что это, что должен сделать посетитель, какое ощущение нужно — и агент собирает бриф, дизайн-систему и настоящую страницу в папке `site/`. Перед тем как показать результат, страница проходит проверку по шести областям: доступность, раскладка, тексты, типографика, цвет, движение. Для просмотра агент собирает страницу в один файл `preview.html`, который открывается кнопкой **Открыть** в панели файлов. Дальше можно просить доработки, пасс за пассом. ## Событие в календарь {#add-to-calendar} **Где работает:** отдельный проект. Встреча, бронь, дедлайн или напоминание — в твой календарь одним нажатием: агент сделает файл календаря для Apple Календаря, Google Календаря или Outlook и ссылку, которая добавит событие в Google Календарь. Подключать ничего не нужно. Подробнее — в [«Google»](https://eggent.ai/r/docs/google.md#calendar). --- # MCP > Как подключить к агенту внешние сервисы через Model Context Protocol — попросить агента, отредактировать .mcp.json вручную, какие бывают серверы и как хранить их ключи. Source: https://eggent.ai/r/docs/mcp/ **MCP** (Model Context Protocol) — открытый стандарт, по которому внешние сервисы дают агенту свои инструменты: таблицы, CRM, трекеры задач, базы данных, соцсети, биржи. Подключил MCP-сервер — и у агента появились новые действия, например «создай задачу в трекере» или «прочитай строки из таблицы». ## Где действует {#scope} MCP-серверы, как и навыки, подключаются к оркестратору или к конкретному проекту. Сервер проекта доступен агенту только в этом проекте. Настройки хранятся в файле `.mcp.json` в папке проекта (или оркестратора). ## Подключить через агента {#via-agent} Самый простой путь — попросить в чате, указав, что это за сервер: > «Подключи MCP-сервер Notion. Запуск: `npx -y @notionhq/notion-mcp-server`, токен я вставлю сам». > «Подключи MCP по адресу `https://mcp.example.com/mcp` с заголовком `Authorization: Bearer …`». Агент добавит сервер в `.mcp.json` текущего проекта, и его инструменты станут доступны сразу, в том же разговоре. > [!WARNING] > Токены и ключи сервисов попадают в `.mcp.json`. Этот файл не синхронизируется с компьютером, но если вставить ключ прямо в сообщение, он останется в истории чата. Лучше вписать секрет в **Настройки → MCP** вручную. ## Подключить вручную {#manual} **Настройки → MCP.** Справа вверху выбери оркестратора или проект. Экран показывает подключённые серверы, а внизу — сам файл `.mcp.json` для редактирования. После правки нажми **Сохранить .mcp.json**. Формат — такой же, как у Cursor и Claude Desktop: ```json { "mcpServers": { "notion": { "command": "npx", "args": ["-y", "@notionhq/notion-mcp-server"], "env": { "NOTION_TOKEN": "secret_…" } }, "tracker": { "url": "https://mcp.example.com/mcp", "headers": { "Authorization": "Bearer …" } } } } ``` ## Два вида серверов {#types} | Вид | Как задаётся | Где работает | | --- | --- | --- | | **Локальный (stdio)** | `command`, `args`, `env` | Запускается внутри воркспейса как программа. Обычно через `npx` или `uvx` | | **Удалённый (HTTP)** | `url`, `headers` | Работает у поставщика сервиса, агент обращается к нему по сети | Если у сервиса есть оба варианта, удалённый обычно проще: ничего не нужно устанавливать. ## Как агент пользуется MCP {#usage} Агент видит список подключённых серверов и их инструментов и вызывает их, когда задача этого требует. Можно направить явно: «через MCP трекера посмотри мои задачи на сегодня». ## Если не работает {#troubleshooting} - Попроси агента: «проверь MCP-сервер tracker» — он покажет ошибку запуска или ответа. - Для локального сервера проверь, что команда запускается: пакет существует, версия Node или Python подходит. - Для удалённого проверь адрес и заголовок авторизации. - Если воркспейс в облаке был во [сне](https://eggent.ai/r/docs/sleep.md), первый запрос к локальному серверу может занять лишние секунды, пока он запускается. --- # Расписания > Как поручить агенту регулярную работу — ежедневные сводки, публикации, проверки — как изменить или отменить задачу, где результат и что важно знать о времени и надёжности. Source: https://eggent.ai/r/docs/schedules/ **Расписание** — задача, которую агент выполняет сам, без тебя: каждое утро, раз в час, в определённый день или один раз через какое-то время. ## Создать {#create} Попроси в чате — обычными словами, с ответами на три вопроса: **что делать, когда и куда прислать результат**. - «Каждый будний день в 9:00 по Москве собирай новости про наш рынок из этих пяти источников и присылай мне в Telegram пять главных в виде списка». - «Каждый понедельник в 10:00 делай отчёт по продажам из свежей выгрузки в `sales/` и сохраняй его в `reports/`». - «Через 20 минут напомни мне позвонить поставщику». Агент переведёт это в расписание, подтвердит, когда будет первый запуск, и дальше каждый запуск будет выполняться в том же проекте, в котором ты попросил. ## Где результат {#results} - Каждый запуск пишет **в свой чат** с названием задачи и датой: `Утренний обзор · 1 окт`. Запуски одной задачи за один день попадают в один чат. В боковой панели у таких чатов значок часов; чат, где ты поставил задачу, остаётся обычным разговором. - Если просил — ещё и **в Telegram** (подключённый бот) или в канал. Отчёт говорит, из какого он чата, и ответ на него — или просто следующее сообщение — продолжит этот чат, где отчёт уже есть. См. [«Telegram»](https://eggent.ai/r/docs/telegram.md#which-chat). - Файлы, которые делает задача, лежат в проекте, в панели **Файлы**. ## Проверки, которые молчат {#quiet} Задача, которая что-то часто проверяет — новые объявления, цену, поиск закупок, — чаще всего ничего нового не находит. Такая задача может молчать: если запуску нечего сообщить, в Telegram ничего не приходит, а в её чате появляется одна строка о том, что нового нет. Карточка **Следить за объявлениями, ценами и тендерами** ставит задачу именно так. Сколько задач по расписанию держать — не ограничено. ## Посмотреть, изменить, отменить {#manage} **Настройки → Расписания** показывает все задачи выбранной области: что делает, по какому расписанию, когда следующий и прошлый запуск, сколько раз выполнялась и включена ли. Здесь же задачу можно **поставить на паузу** и **возобновить**, **удалить** или **изменить время**. Проще всего управлять через чат: - «Покажи мои расписания». - «Перенеси утреннюю сводку на 8:30». - «Пусть сводка теперь включает ещё курс доллара» — меняется не только время, но и то, что задача делает. - «Отмени напоминание про поставщика». - «Поставь сводку на паузу, пока я в отпуске» и позже «возобнови сводку» — задача на паузе остаётся в списке и не запускается. Если задача живёт в другом проекте или чате, агент найдёт её сам. ## Задача, которая не может выполниться {#paused} Иногда запуск не удаётся выполнить: исчерпан лимит модели для воркспейса или заполнен диск. Если ничего не делать, такую задачу отклоняли бы при каждом срабатывании и каждый раз сообщали бы тебе об этом. Поэтому Eggent считает: - **Первый отказ** приходит тебе как отчёт запуска — с причиной и тем, что делать. - **Следующие** сохраняются в чате задачи за этот день и в Telegram повторно не отправляются. - **На третьем подряд** задача **ставится на паузу**: ты получаешь одно сообщение об этом с причиной, а в **Настройки → Расписания** у задачи появляется отметка **остановлено Eggent**. Запуск, закончившийся ошибкой, считается так же, но терпеливее: о нём сообщают один раз, а после пяти подряд задача тоже встаёт на паузу. Удачный запуск обнуляет счёт. Когда причина устранена, **возобнови** задачу в **Настройки → Расписания** или попроси агента: «возобнови утреннюю сводку». Пауза ничего не удаляет, а после возобновления счёт начинается заново. Отчёт запуска по расписанию сам не может создавать, менять и удалять задачи: там некого спросить, поэтому это можешь только ты — в своём чате или в **Настройки → Расписания**. ## Как записывается время {#format} Агент понимает время словами, а хранит его в одном из форматов: | Формат | Пример | Значит | | --- | --- | --- | | cron | `0 9 * * 1-5` | в 9:00 по будням | | интервал | `30m`, `1h` | каждые 30 минут, каждый час | | через сколько | `+20m` | один раз через 20 минут | | дата и время | `2026-10-01T09:00` | один раз в указанный момент | > [!WARNING] > Время считается по часам сервера, в облаке это обычно UTC. Указывай свой часовой пояс («в 9:00 по Москве») или один раз запиши его в [контекст](https://eggent.ai/r/docs/context.md) и сверяй время следующего запуска в **Настройки → Расписания**. ## Надёжность {#reliability} - **Облако будит воркспейс к запуску.** Даже если пространство уснуло, оно проснётся за пару минут до задачи. См. [«Сон и пробуждение»](https://eggent.ai/r/docs/sleep.md). - **Пропущенные запуски не повторяются.** Если в нужный момент воркспейс был выключен (например, свой сервер перезагружался), задача выполнится в следующий раз по расписанию. - **Задача тратит баланс**, как обычное сообщение. Частые задачи на сильной модели заметно расходуют кредиты: для регулярной рутины выбирай модель попроще в [настройках проекта](https://eggent.ai/r/docs/models.md#project-model). - **Задача работает одна.** Во время запуска некому ответить на вопрос, поэтому формулируй задание так, чтобы агенту ничего не нужно было уточнять. --- # Telegram > Как работать с Eggent из Telegram — через общий бот облака или своего бота, как пустить коллег, что можно отправлять, как агент пишет в чат и публикует в каналы. Source: https://eggent.ai/r/docs/telegram/ С Eggent можно работать из Telegram так же, как из браузера: писать задачи текстом и голосом, присылать файлы, получать ответы и результаты расписаний. Чаты из Telegram видны и в веб-версии. ## Два способа подключения {#ways} | | Общий бот облака | Свой бот | | --- | --- | --- | | Что это | [@eggentai_bot](https://t.me/eggentai_bot) | Бот, которого ты создал в @BotFather | | Где есть | Только Eggent Cloud | Облако и свой сервер | | Настройка | Регистрация через бота или ссылка, которую даст агент | Токен в **Настройки → Мессенджеры** | | Кто может писать | Ты | Ты и те, кого ты впустил | | Публикация в каналы | Нет | Да, если бот — администратор канала | ## Общий бот облака {#shared-bot} Если ты зарегистрировался через [@eggentai_bot](https://t.me/eggentai_bot), он уже связан с твоим пространством. Просто пиши ему. **`/login`** там отвечает кнопкой, которая открывает пространство в браузере уже с выполненным входом. Если ты регистрировался на сайте, попроси агента подключить Telegram (карточка **«Утренняя сводка в Telegram»** делает это первым шагом). Он даст ссылку на бота: открой её в Telegram и нажми **Start** — чат привяжется к твоему пространству. Ссылка работает один раз и 30 минут. Если этот Telegram уже привязан к другому пространству, бот попросит открыть ссылку ещё раз, чтобы перенести его. Пока агент работает, в чате виден черновик: сначала — чем агент занят («Думаю…», «Ищу в интернете», «Читаю файл»), потом — текст ответа по мере написания. Готовый ответ приходит обычным сообщением. ## Свой бот {#own-bot} Самый простой путь — карточка **«Свой Telegram-бот»** на экране нового чата: агент проведёт по шагам. Вручную: 1. В Telegram открой [@BotFather](https://t.me/BotFather), отправь `/newbot`, придумай имя и адрес бота и скопируй токен. 2. В Eggent открой **Настройки → Мессенджеры**. 3. В блоке **1. Токен бота** вставь токен и нажми **Активировать бота**. 4. Режим подключения Eggent выберет сам. В облаке всё работает сразу; на своём сервере без публичного HTTPS-адреса используется **Long Polling**. 5. Открой своего бота в Telegram и нажми **Start**. > [!WARNING] > Вставляй токен в настройках, а не в чат с агентом. Токен даёт полный доступ к боту, а сообщение остаётся в истории. ## Кто может писать своему боту {#access} Бот отвечает только людям из списка разрешённых. Чтобы пустить человека (в том числе себя в первый раз): 1. В **Настройки → Мессенджеры → Контроль доступа** нажми **Сгенерировать код доступа**. Или попроси агента: «дай код доступа для коллеги». 2. Человек открывает бота и отправляет `/code <код>`. 3. Код одноразовый. После него человек попадает в список разрешённых. Список `user_id` можно поправить руками в том же блоке. > [!WARNING] > Каждый, кого ты впустил, работает с **тем же воркспейсом**: видит его файлы и может давать агенту любые задачи. Пускай только тех, кому доверяешь. Бот не предназначен для общения с клиентами. ## Что можно отправлять {#messages} - **Текст** — как в веб-чате. - **Голосовые** — расшифровываются внутри воркспейса и уходят агенту текстом. См. [«Голос»](https://eggent.ai/r/docs/voice.md). - **Файлы и фото** — сохраняются во вложения чата, агент их видит. Подпись к файлу уходит как сообщение. - **Файлы** — ответ, сделавший файлы, говорит об этом в конце. Отправь `/files`, чтобы получить их в этот чат: до трёх приходят по одному, больше — одним архивом. - **`@проект задача`** — сообщение, которое начинается с `@` и названия проекта, поручает задачу этому проекту; ответ вернётся сюда, а ты останешься в том же чате. См. [Проекты](https://eggent.ai/r/docs/projects.md#ask). - **«Стоп»**, «хватит», «отмена» — отдельным сообщением останавливают текущую работу. Любое другое сообщение во время работы агент учтёт в текущей задаче. Они доходят до работы сразу, даже если она идёт давно: ждать её конца не нужно. Команды бота: | Команда | Что делает | | --- | --- | | `/start`, `/help` | Справка и статус подключения | | `/code <код>` | Получить доступ по коду | | `/new` | Начать новый разговор с чистого листа | | `/chats` | Последние чаты, у каждого — команда, которая его продолжит | | `/reset` | Останавливает ответ, который, кажется, завис. Разговор сохраняется: напиши снова, чтобы продолжить | | `/files` | Присылает файлы, которые сделал последний ответ | Бот работает **только в личных сообщениях**. В группах он не отвечает. ## В какой чат уходит сообщение {#which-chat} Telegram — одна переписка, а чатов в воркспейсе много. Куда попадает твоё сообщение: - **Ответ** (Reply на сообщение бота) продолжает чат, из которого пришло это сообщение: утренний отчёт или ответ недельной давности. Telegram показывает цитату, агент её тоже получает. - **Любое другое сообщение** продолжает чат, который написал тебе последним. Пришёл отчёт по расписанию — следующее сообщение уйдёт в чат отчёта. - **Когда разговор переезжает**, сообщение говорит куда: последняя строка — `💬` и название чата. - **`/chats`** показывает последние чаты. Нажми на команду `/c_…` под нужным, чтобы продолжить его. `/new` начинает новый чат. Работа, которую проект сделал для другого чата, помечена ↪️. - **Или попроси агента**: «вернись в чат про прайс», «что было во вчерашнем отчёте?». Он умеет искать, читать чаты и переключаться между ними. Чат помнит свой проект: если разговор переехал в чат из проекта, следующие сообщения работают в этом проекте. ## Агент пишет сам {#outbound} Попроси — и агент отправит в Telegram сообщение или файл: результат долгой задачи, напоминание, отчёт по расписанию. Картинки уходят как фото с подписью, остальное — документами. Отчёт по расписанию приходит из собственного чата задачи и говорит об этом последней строкой — ответ на него продолжит отчёт. См. [«Расписания»](https://eggent.ai/r/docs/schedules.md#results). ## Публикация в канал {#channels} Свой бот может публиковать посты в канал: 1. Добавь бота в канал **администратором** с правом публиковать сообщения. 2. Попроси агента: «опубликуй этот пост с картинкой в @mychannel». Это же работает в расписании: «каждый день в 10:00 публикуй в @mychannel пост по контент-плану». Для регулярных постов удобна карточка [«Контент-завод»](https://eggent.ai/r/docs/skill-catalog.md#social-daily). ## Ответ, который завис {#stuck} Пока агент работает, черновик показывает, что он делает. Если полторы минуты ничего не происходит, черновик говорит, что работа идёт, и как её остановить: отправь **`/reset`**. Это останавливает работу, снимает вопрос, на который она ждала ответа, и сохраняет разговор и всё, что уже сделано; напиши снова, чтобы продолжить. Замечать самому не обязательно: Eggent сам останавливает ход, который совсем замолчал, — примерно через 3 минуты, пока он готовится, 6 минут ожидания модели или 20 минут внутри одной команды, которая ничего не печатает. Он скажет, что случилось, а твои сообщения сохранятся. Команда, которая ждёт ответа там, где отвечать некому — например, в Telegram, — получает пустой ответ и не ждёт вечно. ## Если бот молчит {#troubleshooting} - Проверь **Настройки → Мессенджеры**: бот активен, статус «Running» или webhook настроен. - Убедись, что пишешь в личные сообщения и твой `user_id` в списке разрешённых (или отправь `/code`). - Если токен менялся в @BotFather, вставь новый и снова нажми **Активировать бота**. - Долгие задачи бот не бросает: черновик показывает, что агент ещё работает. --- # Почта агента > У каждого агента в Eggent Cloud есть свой адрес почты. Как он пишет тебе, что происходит с письмами, которые приходят ему, как письмо другому человеку ждёт твоего «да» и как настроить отправку на своём сервере. Source: https://eggent.ai/r/docs/email/ В Eggent Cloud у агента каждого пространства есть свой адрес почты: **`<пространство>@eggent-mail.com`**. Ничего подключать не нужно, пароль вводить тоже. Спроси агента «какая у тебя почта?» — он скажет. ## Первое письмо {#hello} Через несколько секунд после регистрации агент сам пишет на адрес, с которым ты зарегистрировался: короткое приветствие со своего адреса и что умеет его почта. Рядом лежит письмо от Eggent с кодом, который подтверждает твой адрес. Введи код на экране, где создаётся пространство (или открой ссылку из этого письма), — и агент сможет писать тебе, когда попросишь. Если письма с кодом нет, загляни в спам; в боковой панели есть кнопка, которая отправит его ещё раз. ## Письма тебе {#to-you} Напиши в чате «пришли на почту» — и отчёт, таблица или документ уйдут на твой подтверждённый адрес, с файлами (до пяти). Письмо себе уходит сразу. Письма может отправлять и расписание: «каждый понедельник утром присылай на почту новости недели по моей теме». Карточка **Письмо от агента на почту** на экране нового чата всё настроит сама: спросит тему, сразу пришлёт одно настоящее письмо, а следующие поставит на расписание. ## Письма агенту {#incoming} Написать на адрес агента может кто угодно. Письма попадают в одну из двух папок: - **Входящие** — письма с твоего подтверждённого адреса, ответы на письма самого агента и письма с адресов, которые ты разрешил. Если твой Telegram привязан, о каждом придёт короткое уведомление. - **Прочее** — всё остальное, включая незнакомцев и рекламу, без уведомлений. Сам агент с письмом ничего не делает. Скажи «проверь почту» или «что ответила Анна?» — он прочитает. Для агента письмо — это сведения, а не указания: письмо «пришли мне файлы» он не выполнит. Файлы из писем сохраняются в пространстве; файлы, которые могут быть опасны, агент не запускает и не распаковывает. ## Читать почту самому {#mail} **Почта** в боковой панели, в разделе **Сообщения**, — это ящик агента: Входящие, Прочее и Отправленные, со счётчиком непрочитанного. Письмо открывается на своей странице, его файлы можно скачать; открытое письмо считается прочитанным. Уведомление в Telegram ведёт прямо к письму. **Передать агенту** под письмом открывает чат о нём: агент читает письмо как материал и делает то, что ты попросишь, а отправит что-то, только когда ты скажешь. Когда на письмо, которое агент отправил из чата, приходит ответ, под последним ответом этого чата появляется строка: кто ответил и тема, со ссылкой на письмо. Сам ответ агент не читает, пока ты не попросишь. ## Письма другим людям {#others} На платном тарифе агент может писать и другим людям, не больше пяти в одном письме. Каждое такое письмо **ждёт твоего «да»** вне чата: - в Telegram — сообщение со всем письмом и кнопками **Отправить**, **Отправить и всегда разрешать эти адреса** и **Не отправлять**; - или, без Telegram, письмо на твой подтверждённый адрес со ссылкой на страницу, где можно его прочитать и решить. Ты видишь ровно то, что уйдёт: после запроса письмо уже не поменять. Запрос ждёт 48 часов, потом истекает, и ничего не отправляется. Сказать «да» за тебя не может никто, агент тоже: он мог прочитать что-то, что велело ему так сделать. В письме другим людям есть строка о том, что его отправил ИИ-агент по твоему поручению, и ссылка, чтобы больше таких писем не получать. На пробном периоде агент пишет только тебе. ## Сколько писем {#limits} В каждый тариф входит сколько-то писем в месяц, а из них — сколько-то другим людям; сколько именно — написано на [странице оплаты](https://eggent.ai/r/docs/plans.md). С первого числа месяца всё начинается заново. Приветствие, коды и подтверждения не считаются. Когда письма закончатся, агент скажет об этом и о том, когда они вернутся. ## На своём сервере {#self-host} У Eggent на своём сервере нет своего почтового ящика, но агент может отправлять письма через твой почтовый сервер: | Переменная | Что это | | --- | --- | | `EGGENT_SMTP_URL` | `smtp://user:password@host:587` или `smtps://…` | | `EGGENT_EMAIL_FROM` | Адрес, с которого уходят письма | | `EGGENT_EMAIL_OWNER` | Твой собственный адрес — для «пришли мне» | Письмо кому угодно, кроме тебя, ждёт твоего «да» в чате. Принимать письма там нельзя. Агент может прочитать эти переменные, поэтому такое «да» удерживает честного агента, но не остановит враждебного; дай ему почтовый ящик, которому доверил бы. --- # Google > Подключи свой Google в Eggent Cloud — и агент сделает настоящие Google Документы, Таблицы и Презентации у тебя на Диске. Что ему доступно, что ждёт твоего «да» и как поставить событие в календарь. Source: https://eggent.ai/r/docs/google/ В Eggent Cloud агент может работать в твоём аккаунте Google: он делает настоящие Google Документы, Таблицы и Презентации у тебя на Диске и присылает ссылку. ## Подключить {#connect} Быстрее всего — карточка **Твой Google: документы, таблицы, презентации** на экране нового чата: скажи, что нужно («бюджет ремонта», «презентация о нашем продукте»), агент попросит подключить Google и сделает файл. Подключить можно и в любой момент: - в чате попроси агента сделать что-нибудь в Google — под ответом появится кнопка **Подключить Google**; - или в **Настройки → Общие**, карточка Google. Google попросит войти и разрешить доступ **к файлам, которые создаёт Eggent**. Это всё разрешение: остальной Диск, почту и контакты агент не видит. Когда аккаунт подключён, приходит уведомление в Telegram (если он привязан) и письмо на подтверждённый адрес со ссылкой, чтобы отключить, если это был не ты. Отключить можно в любой момент в **Настройки → Общие**. ## Что умеет агент {#what} - **Документы**: написать новый (заголовки, списки, таблицы, жирный), прочитать, дописать в конец, заменить слова. - **Таблицы**: сделать таблицу с формулами, прочитать, поменять ячейки, добавить строки. - **Презентации**: сделать презентацию из списка слайдов, прочитать. - **Диск**: показать файлы, которые он сделал, положить файл из пространства на Диск (как есть или превратив в Документ, Таблицу или Презентацию), забрать файл с Диска в проект (PDF, DOCX, XLSX и т. п.), сделать папки и разложить по ним файлы. В каждом ответе о файле есть ссылка на него. Агент никогда не удаляет файлы, не даёт доступ людям или группам и не меняет владельца. ## Что ждёт твоего «да» {#yes} **Открыть файл всем, у кого есть ссылка,** можно только с твоего согласия — так же, как [письма другим людям](https://eggent.ai/r/docs/email.md#others): сообщение в Telegram с кнопками **Разрешить** и **Отклонить** или, без Telegram, письмо на подтверждённый адрес со ссылкой на страницу, где ты решаешь. Запрос ждёт 48 часов. Сказать «да» за тебя не может никто, агент тоже. ## Календарь {#calendar} Любое пространство, с Google или без, может поставить событие в твой календарь: попроси «добавь завтрашнюю встречу в 15:00 в календарь» — агент сделает файл календаря (`.ics`), который открывается в Apple Календаре, Google Календаре и Outlook, и ссылку, которая добавит событие в Google Календарь одним нажатием. Карточка **Событие в календарь** делает то же самое. Файл придёт в чат, в Telegram или [на почту](https://eggent.ai/r/docs/email.md#to-you). ## На своём сервере {#self-host} Подключение Google — часть Eggent Cloud. Eggent на своём сервере делает файлы календаря так же, а до Google может дотянуться через [MCP-сервер](https://eggent.ai/r/docs/mcp.md) на твой выбор. --- # HTTP API для интеграций > Как подключить Eggent к своему сайту, CRM, боту или автоматизации — получить токен, отправить сообщение, передать файл, получать ответ потоком и сохранять разговор между запросами. Source: https://eggent.ai/r/docs/external-api/ **Внешний API** — способ дать задачу агенту из другой программы: бэкенда сайта, CRM, n8n или Make, своего бота, фоновой задачи. Ты отправляешь сообщение, Eggent выполняет его как обычный чат и возвращает ответ. ## Адрес {#base-url} | Где Eggent | Базовый адрес | | --- | --- | | Облако | `https://имя.cloud.eggent.ai` | | Свой сервер | адрес, по которому открывается Eggent, например `https://eggent.example.com` | ## Получить токен {#token} 1. Открой **Настройки → API**. 2. Сгенерируй токен внешнего API. 3. Сохрани его в своей системе как секрет. Токен передаётся в заголовке `Authorization: Bearer <токен>`. Не вставляй его в код, который выполняется в браузере: с ним можно давать агенту любые задачи. На своём сервере вместо генерации можно задать переменную `EXTERNAL_API_TOKEN`; токен из настроек главнее. ## Отправить сообщение {#message} ```http POST /api/external/message Authorization: Bearer <токен> Content-Type: application/json ``` ```bash curl -X POST https://имя.cloud.eggent.ai/api/external/message \ -H "Authorization: Bearer $EGGENT_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "crm:client-42", "projectName": "Продажи", "message": "Напиши короткое письмо клиенту по последним заметкам" }' ``` ### Поля запроса {#request} | Поле | Обязательно | Что это | | --- | --- | --- | | `sessionId` | да | Постоянный ключ разговора. Один на пользователя, тред, клиента или задачу | | `message` | да | Текст задачи, непустой | | `projectId` | нет | id проекта (или точное имя, если оно одно) | | `projectName` | нет | Точное имя проекта | | `chatId` | нет | Существующий чат. Обычно не нужен | | `currentPath` | нет | Подсказка рабочей папки для задач с файлами | Без проекта сообщение уходит оркестратору. ### Ответ {#response} ```json { "success": true, "sessionId": "crm:client-42", "reply": "Здравствуйте, Анна! …", "context": { "activeProjectId": "sales", "activeProjectName": "Продажи", "activeChatId": "0a2f…", "activeChatTitle": "Звонок с Анной", "currentPath": "" }, "chatChanged": false, "switchedProject": null, "createdProject": null } ``` Если агент во время работы переключил или создал проект, это видно в `switchedProject` и `createdProject`. `chatChanged` равно `true`, когда разговор теперь в другом чате, чем до этого сообщения — агент его перевёл, — а `activeChatTitle` называет этот чат. ## Как работает sessionId {#session} Eggent помнит для каждого `sessionId` текущий проект, текущий чат и рабочую папку. Повторяй тот же `sessionId` — и агент продолжит тот же разговор, с историей. Новый `sessionId` — новый разговор. Хорошие ключи: `telegram:`, `crm:`, `slack::`, `job:daily-report`. ## Ответ потоком {#streaming} Если добавить заголовок `Accept: text/event-stream`, ответ придёт потоком событий (SSE) — удобно, чтобы показывать текст по мере написания. Каждое событие — JSON в строке `data:`: | Событие | Что значит | | --- | --- | | `{"type":"text","delta":"…"}` | Очередной кусок ответа | | `{"type":"tool","name":"…","phase":"start"}` | Агент начал или закончил (`"end"`) использовать инструмент | | `{"type":"done","result":{…}}` | Готово; `result` — тот же JSON, что и без потока | | `{"type":"error","status":500,"payload":{…}}` | Ошибка с тем кодом, который вернулся бы без потока | Если клиент отключился посреди ответа, работа не прерывается: агент доделает её, и результат сохранится в чате. ## Отправить файл {#files} ```http POST /api/external/media-message Authorization: Bearer <токен> Content-Type: multipart/form-data ``` Поля те же, что у `/message`, плюс `file` и `kind` (`document`, `photo`, `audio`, `video`, `voice`, `file`). Файл сохраняется во вложения чата, агент его видит. Голосовое (`kind=voice`) сначала расшифровывается в текст. ```bash curl -X POST https://имя.cloud.eggent.ai/api/external/media-message \ -H "Authorization: Bearer $EGGENT_API_TOKEN" \ -F "sessionId=crm:client-42" \ -F "message=Выпиши из договора все сроки" \ -F "kind=document" \ -F "file=@./contract.pdf" ``` ## Ошибки {#errors} | Код | Причина | Что сделать | | --- | --- | --- | | `400` | Нет `sessionId` или `message` | Передай оба непустыми строками | | `401` | Нет токена или он неверный | Проверь заголовок `Authorization: Bearer …` | | `404` | Проект или чат не найден | Проверь id и имена проектов | | `409` | Имя проекта неоднозначно или чат из другого проекта | Используй `projectId` или убери `chatId` | | `503` | Токен не настроен | Сгенерируй его в **Настройки → API** | ## Советы {#tips} - Вызывай API только с сервера и только по HTTPS. - Ставь большой таймаут: сложная задача может выполняться несколько минут. Или используй поток. - Один реальный разговор — один `sessionId`. - Сообщение, которое начинается с `@` и названия проекта, поручает задачу этому проекту, как в приложении: проект работает в своём чате, а его ответ входит в ответ API. См. [Проекты](https://eggent.ai/r/docs/projects.md#ask). - Ответы через API тратят баланс так же, как чат, и всегда работают в полном режиме. --- # Тарифы и баланс > Как устроена оплата Eggent Cloud — пробный период, тарифы, кредиты Eggent AI, место на диске, что происходит, когда что-то заканчивается, и где всё это посмотреть. Source: https://eggent.ai/r/docs/plans/ В облаке ты платишь за две вещи: **пространство** (тариф — месяц работы воркспейса и место на диске) и **модель** (кредиты Eggent AI на запросы к моделям). Если работаешь на [своём ключе](https://eggent.ai/r/docs/models.md#own-provider), вторая часть не нужна. Актуальные цены всегда на странице оплаты своего воркспейса: `https://cloud.eggent.ai/billing/имя`. ## Пробный период {#trial} - 7 дней. Дата окончания видна на странице оплаты. - 100 МБ на диске. - Кредиты Eggent AI на знакомство; доступны все модели из списка. - Две картинки бесплатно. Когда заканчивается пробный период или тариф, воркспейс закрывается: вместо него открывается страница с выбором тарифа. **Файлы, чаты и настройки сохраняются**, и после оплаты всё продолжается с того же места. ## Тарифы {#plans} Тариф — это ежемесячная подписка. Он продлевает работу воркспейса, увеличивает место на диске и (кроме базового) каждый месяц добавляет кредиты Eggent AI. - **Базовый тариф** — для тех, кто работает на своём ключе модели: без кредитов, но с нормальным диском. - **Тарифы с кредитами** — чем выше, тем больше кредитов в месяц и места на диске. Средний тариф отмечен как самый популярный. - **Сотрудники.** Если твой воркспейс — [компания](https://eggent.ai/r/docs/business.md), в «Про» входит ещё 1 человек кроме тебя, в «Макс» — 2, в «Супер» — 3. Все они тратят кредиты тарифа и его диск. «Основа» и «Старт» — тарифы для одного человека. - **Мощность «Супера».** «Супер» — это база и шаги сверху. Каждый шаг добавляет всё, что есть в «Про»: кредиты, диск, браузер, сложные страницы, картинки, письма и ещё одного сотрудника. Шаги выбираются слайдером на карточке тарифа или добавляются потом на странице оплаты; убрать шаг можно со следующего периода. Шаги нужны не только компании: их берут и ради кредитов или диска. До 50 сотрудников; больше — напиши нам, предложим Enterprise. На странице оплаты у каждого тарифа написано, что в него входит. Оплата — через ЮKassa: картой российского банка, по СБП, через SberPay или ЮMoney. Подписка, оформленная раньше через Tribute, продлевается там же; когда она закончится, следующая оформляется через ЮKassa. Подписка продлевается сама раз в месяц — или раз в год, если оплатить сразу год: так на 15% дешевле. Отменить можно в любой момент, доступ остаётся до конца оплаченного периода. Смена тарифа: выбери другой на странице оплаты. Новый заменит текущий, дважды платить не придётся. ## Кредиты {#credits} Кредиты — баланс, из которого оплачиваются запросы к моделям Eggent AI и картинки. - **Кредиты тарифа** приходят каждый месяц; при оплате за год — сразу на весь год. Неиспользованный остаток сгорает при продлении. - **Купленные кредиты** можно докупить на странице оплаты, когда есть активный тариф. Они не сгорают никогда. - Сначала тратятся кредиты тарифа, потом купленные. Стоимость каждого запроса зависит от модели и числа токенов. Таблица цен моделей — на той же странице. Растянуть баланс помогают [модели попроще](https://eggent.ai/r/docs/models.md) и [лёгкие режимы чата](https://eggent.ai/r/docs/chats.md#modes). ## Что ещё входит в тариф {#tools} Кроме кредитов и диска, в каждый тариф каждый месяц входят четыре вещи. Сколько каждой — написано у тарифа на странице оплаты; на пробном периоде их немного, чтобы попробовать. - **Минуты браузера агента** — [браузера](https://eggent.ai/r/docs/browser.md), которым агент управляет на нашем сервере. - **Сложные страницы** — страницы, которые агент не смог открыть сам; их для него читает наш сервер. - **Картинки**, которые не списываются с баланса; сверх них картинка оплачивается кредитами ([подробнее](https://eggent.ai/r/docs/images.md#cost)). - **Письма** с [почты агента](https://eggent.ai/r/docs/email.md#limits), а на платном тарифе — часть из них другим людям. С первого числа каждого месяца всё начинается заново, остаток не переносится. В [компании](https://eggent.ai/r/docs/company.md) все пользуются запасом администратора, а каждое купленное сверх тарифа место добавляет ещё. Агент знает, сколько осталось, а в боковой панели счётчик появляется, когда израсходована половина. ## Когда кредиты заканчиваются {#out-of-credits} - На половине и на трёх четвертях баланса в боковой панели появляется предупреждение. - Когда кредиты закончились, агент на Eggent AI перестаёт отвечать и присылает ссылку на страницу оплаты. Начатый ответ при этом успевает закончиться. - Сам воркспейс остаётся открытым: файлы, чаты, настройки доступны. Работа на своём ключе продолжается как обычно. ## Место на диске {#storage} - Заполнение диска проверяется регулярно; на трёх четвертях появляется предупреждение. - Когда диск заполнен полностью, агент перестаёт отвечать, но **воркспейс остаётся открытым**: удали лишнее в панели **Файлы** — и со следующего сообщения всё снова работает. Второй выход — тариф с большим диском. - В [компании](https://eggent.ai/r/docs/company.md) диск общий: в него считаются файлы воркспейсов всех людей. ## Где посмотреть {#where} - **Страница оплаты** `https://cloud.eggent.ai/billing/имя` — сколько дней осталось, сколько места занято, сколько кредитов осталось, тарифы и цены моделей. Вход — тем же email и паролем, что и в воркспейс. - **Боковая панель** воркспейса — предупреждения, когда что-то подходит к концу. - **Агент** — спроси «сколько у меня осталось?», он ответит точными цифрами. --- # Eggent Business > Eggent Business — компания в Eggent Cloud. У каждого человека свой агент в своём воркспейсе, а общий баланс с месячными лимитами, команды, папки, переписка, общие файлы и согласования — у администратора. Что входит, как платится и как подключить. Source: https://eggent.ai/r/docs/business/ **Eggent Business** — это компания в Eggent Cloud, на наших серверах. У каждого человека свой агент в своём воркспейсе. Общее — деньги, доступы, папки и документы — сходится у администратора, в одной консоли. Как этим пользоваться каждый день, описано на странице [Работа в компании](https://eggent.ai/r/docs/company.md). Здесь — что входит, как устроены деньги и как подключиться. > [!NOTE] > Компании открываются по запросу. Напиши на aiiszdes@gmail.com или в поддержку в Telegram: сделаем твой воркспейс воркспейсом администратора. ## Кому подходит {#who} - Команде, где каждому нужен свой агент, а платить и следить за расходами удобнее из одного места. - Отделу, который обменивается документами и согласует их. - Тем, кто хочет дать сотрудникам агента, но держать лимиты и доступы у себя. Если всё должно работать на ваших собственных серверах, это [Eggent Enterprise](https://eggent.ai/r/docs/enterprise.md). ## Что входит {#included} | Что | Как устроено | Подробно | |---|---|---| | Воркспейс каждому | Свой агент, проекты, файлы, чаты и память. Вход по одноразовой ссылке: она действует 72 часа и срабатывает один раз. | [Люди](https://eggent.ai/r/docs/company.md#people) | | Консоль администратора | Пункт **Компания** в плавающей кнопке: люди, команды, лимиты, папки и расходы за месяц. | [Люди](https://eggent.ai/r/docs/company.md#people) | | Команды | Объединяют людей — для лимитов и для общих папок. | [Люди](https://eggent.ai/r/docs/company.md#people) | | Папки компании | Общий диск одному человеку, команде или всем, на чтение или на чтение и запись. | [Люди](https://eggent.ai/r/docs/company.md#people) | | Сообщения | Переписка администратора с каждым человеком, с файлами и уведомлениями в Telegram. | [Сообщения](https://eggent.ai/r/docs/company.md#messages) | | Общие файлы | Файл открывается коллегам на просмотр, комментарии или правку. | [Общие файлы](https://eggent.ai/r/docs/company.md#shares) | | Согласования | Версия файла уходит людям по очереди; любое изменение снимает согласование. | [Согласования](https://eggent.ai/r/docs/company.md#approvals) | | Агент администратора | Заводит людей, высылает ссылки для входа, сбрасывает пароли, готовит отчёты по чатам. | [Люди](https://eggent.ai/r/docs/company.md#people) | ## Деньги и лимиты {#money} - **Общий баланс.** Работа людей с агентом оплачивается с баланса компании — это баланс воркспейса администратора: кредиты его тарифа и докупленные. Он пополняется так же, как обычный: [тарифы и кредиты](https://eggent.ai/r/docs/plans.md). - **Общий диск.** Файлы всех воркспейсов компании считаются в место на диске тарифа администратора. Когда оно заполнено, агенты всей компании останавливаются, пока кто-нибудь не удалит лишнее, а сами воркспейсы остаются открыты. - **Месячные лимиты.** Лимит задаётся каждому человеку и каждой команде. Когда лимит исчерпан, агент человека останавливается до следующего месяца или пока лимит не поднимут. - **Свой ключ компании.** В консоли можно подключить ключ OpenAI или OpenRouter. Запросы людей к моделям этого провайдера идут по ключу и оплачиваются по его тарифу, а не с баланса, и считаются в тех же месячных лимитах. Подписку ChatGPT или Codex для этого использовать нельзя: она принадлежит одному человеку. - **Человек ничего не покупает сам.** На его странице оплаты видно, сколько он потратил за месяц из денег компании; платит за всё компания. - **Без пробного периода.** У воркспейсов людей нет пробного периода и даты окончания: они работают, пока работает компания. - **Расходы на виду.** В консоли видно, сколько за месяц потратил каждый человек и каждая команда. ## Сколько стоит {#price} Отдельной цены у Business нет: компанию оплачивает обычный [тариф](https://eggent.ai/r/docs/plans.md#plans) воркспейса администратора. Компания начинается с тарифа «Про»: в него входит ещё один человек кроме администратора. | Тариф | Сотрудников кроме администратора | |---|---| | Пробный период | +1, чтобы попробовать | | Основа | — | | Старт | — | | Про | +1 | | Макс | +2 | | Супер | +3, и ещё по одному с каждым шагом мощности (до 50) | «Основа» и «Старт» — тарифы для одного человека: сотрудников на них нет. Все люди тратят кредиты этого тарифа и занимают его диск. Нужно больше людей — бери шаги мощности на «Супере» (каждый — ещё один «Про» и ещё один сотрудник), а больше 50 — напиши нам, соберём Enterprise. Сколько команд, папок и публичных чатов можно завести, тоже зависит от тарифа администратора. ## Как подключить {#start} 1. Напиши нам: сколько человек и как вы работаете. 2. Мы делаем твой воркспейс воркспейсом администратора. В плавающей кнопке появляется пункт **Компания**. 3. Добавь людей в консоли или попроси своего агента. Каждый получит ссылку для входа. 4. Задай лимиты, команды и папки — и работайте. ## Безопасность и доступ {#security} - Каждый воркспейс работает отдельно от остальных. Файлы человека видят только те, кому он их открыл. - Администратор и его агент могут читать чаты людей, чтобы подготовить отчёт. Каждое такое чтение записывается, а агент каждого человека знает, что так бывает. - Удалить человека, папку или всю компанию можно только в консоли — агент этого не умеет. - Файлами с ключами доступа (`.env` и подобными) не делятся никогда. - Когда компанию закрывают, воркспейсы людей удаляются вместе с их данными и папками компании, а воркспейс администратора остаётся обычным воркспейсом. ## Чего пока нет {#not-yet} - Входа через корпоративный SSO. - Сводного журнала действий в интерфейсе. - Переписки человека с человеком и командных переписок: пишут друг другу администратор и каждый человек. - Перевода человека из одной компании в другую. --- # Файлы на компьютере > Как сделать так, чтобы папка проектов облачного Eggent лежала у тебя на компьютере как обычная папка и синхронизировалась в обе стороны через Syncthing. Source: https://eggent.ai/r/docs/file-sync/ Папку проектов облачного воркспейса можно держать у себя на компьютере как обычную папку: меняешь здесь — меняется там, и наоборот. Работает через **Syncthing** — бесплатную программу с открытым кодом. > [!NOTE] > Если пользуешься [приложением Eggent для Mac](https://eggent.ai/r/docs/desktop-app.md), всё это не нужно: приложение само держит файлы, чаты и память агента в одном состоянии с облаком ([как](https://eggent.ai/r/docs/desktop-cloud.md)). Зачем это нужно: - открывать результаты агента в привычных программах: Word, Excel, Obsidian, редакторе кода; - класть материалы в папку на компьютере, а не загружать их через браузер; - держать копию всех файлов у себя. ## Что синхронизируется {#what} Только **папка проектов** (`data/projects`): файлы оркестратора и все проекты. Не синхронизируются чаты, настройки, ключи и служебные папки (`.pi`, `node_modules`), а также `.mcp.json`, потому что в нём бывают токены. Синхронизация работает, **даже когда воркспейс спит**. ## Подключить компьютер {#setup} Открой `https://cloud.eggent.ai/sync/имя` и войди тем же email и паролем, что и в воркспейс. Дальше четыре шага, по одному разу на устройство: 1. **Установи Syncthing** с [syncthing.net](https://syncthing.net/downloads/) и оставь работать в фоне. 2. **Скажи нам ID своего устройства.** В Syncthing: **Actions → Show ID**, скопируй длинный код и вставь на странице. 3. **Добавь сервер в Syncthing.** В Syncthing нажми **Add Remote Device** и вставь ID сервера со страницы. Отметь галочку, что добавил, и нажми **Подключить**. 4. **Прими папку.** Через минуту Syncthing на компьютере предложит папку. Прими её и выбери, где она будет лежать на диске. > [!TIP] > Если предложение папки пропало, **не создавай новую папку**: у неё будет другой ID, и стороны не найдут друг друга. Добавь папку вручную, вставь в поле **Folder ID** значение «ID папки» со страницы синхронизации и поделись ею с сервером. ## Если не подключается {#troubleshooting} - Подожди минуту: устройства находят друг друга не мгновенно. - Если связи так и нет, открой в Syncthing настройки устройства-сервера, вкладку **Advanced**, и впиши в поле **Addresses** адрес сервера, указанный на странице синхронизации. - Проверь статус на странице синхронизации: «Синхронизировано», «Синхронизируется, N%», «Не в сети, последний раз …» или «Ждём первого подключения». ## Несколько устройств {#devices} На той же странице — **Подключённые устройства**. Можно подключить ещё компьютер или отключить старый. При отключении уже скачанные файлы остаются на устройстве. ## Удалённые файлы и корзина {#trash} Файлы, удалённые или перезаписанные при синхронизации, 30 дней хранятся в корзине Syncthing (папка `.stversions`). Её не видно в панели файлов Eggent. ## Когда тариф неактивен {#inactive} Если пробный период или тариф закончились, синхронизация продолжает **отдавать** файлы на компьютер, но перестаёт **принимать** изменения с него. На странице синхронизации это видно. После оплаты синхронизация снова работает в обе стороны. --- # Сон и пробуждение > Почему облачный воркспейс засыпает, когда им не пользуются, как он просыпается, сколько это занимает и что происходит с расписаниями и Telegram во время сна. Source: https://eggent.ai/r/docs/sleep/ Облачный воркспейс, которым долго не пользуются, **засыпает**: его контейнер останавливается и не тратит память сервера. Это экономит ресурсы и ничего у тебя не отнимает. ## Когда засыпает {#when} После примерно **12 часов** без активности. Активность — это твои запросы в воркспейс: открытые чаты, сообщения, работа с файлами, сообщения в Telegram. Воркспейс **не засыпает**, если в ближайшие полчаса у него запланирована [задача по расписанию](https://eggent.ai/r/docs/schedules.md). ## Как просыпается {#wake} Сам, от первого же обращения: открыл адрес в браузере, написал в Telegram, пришёл запрос по [API](https://eggent.ai/r/docs/external-api.md). Пробуждение занимает около **10 секунд**, после чего запрос выполняется как обычно. Ничего не теряется и не повторяется. ## Расписания {#schedules} Задачи по расписанию работают и во сне: облако будит воркспейс за пару минут до запуска. Поэтому ежедневная сводка или пост придут вовремя, даже если ты не заходил неделю. ## Что не засыпает {#always-on} - [Синхронизация файлов](https://eggent.ai/r/docs/file-sync.md) с компьютером — она работает с диском напрямую. - Страница оплаты и страница синхронизации. ## Свой сервер {#self-host} В открытом ядре сна нет: Eggent работает, пока работает контейнер. --- # Вход, безопасность и поддержка > Как входить в облачный воркспейс, сменить логин, пароль, язык и тему, как устроена изоляция данных, что делать с ключами и паролями и как связаться с поддержкой. Source: https://eggent.ai/r/docs/account/ ## Вход {#sign-in} Открой адрес своего воркспейса `https://имя.cloud.eggent.ai` и войди с email и паролем, которые указал при регистрации. Тот же email и пароль подходят для страниц оплаты и синхронизации. Регистрировался через Telegram? Отправь боту **`/login`**: он ответит кнопкой, которая открывает пространство уже с выполненным входом. Кнопка работает один раз и 10 минут, новую пришлёт снова `/login`. Сразу после регистрации воркспейс открывается уже с выполненным входом по одноразовой ссылке. Ссылка работает один раз и 10 минут. ## Сменить логин и пароль {#credentials} **Настройки → Основное → Авторизация dashboard.** Введи новый логин (свою почту или имя) и пароль (не короче 8 символов) и сохрани. Все остальные браузеры, где был выполнен вход, выйдут из пространства; этот останется. Новые данные действуют и для страниц оплаты и синхронизации. ## Забыл пароль {#reset} Нажми **«Забыли пароль?»** на странице входа и введи почту, на которую зарегистрировано пространство. Придёт письмо со ссылкой для каждого пространства с этим адресом; каждая ссылка работает один раз и один час. Задай по ней новый пароль — и ты внутри, а все остальные браузеры, где был выполнен вход, выйдут. Страница отвечает одинаково, знает она адрес или нет, поэтому через неё нельзя узнать, у кого есть пространство. Письмо не пришло? Загляни в спам, попроси ещё раз через несколько минут, потом напиши в [поддержку](#support). ## Подтверждение почты {#email} Сразу после регистрации приходит письмо с кодом из 6 цифр. Введи его на странице регистрации, пока пространство запускается, пришли боту, если регистрировался через Telegram, или нажми кнопку в письме (она работает два дня). Пока почта не подтверждена, боковая панель иногда напоминает об этом; больше ничего не ждёт. Telegram-аккаунт, подключённый позже по ссылке (когда агент предлагает присылать что-то в Telegram), может сразу говорить с агентом. Чтобы он мог ещё и входить командой `/login`, нужно твоё подтверждение: бот отправит на твою почту письмо с кнопкой. ## Язык и тема {#language} **Настройки → Основное**: язык интерфейса (русский или английский) и светлая или тёмная тема. Язык влияет и на то, на каком языке агент отвечает по умолчанию. ## Как защищены данные {#security} - Каждый воркспейс работает в **своём отдельном контейнере** со своим диском. Другие воркспейсы его не видят. - Модели Eggent AI доступны через шлюз Eggent: ключи провайдеров моделей в воркспейс не попадают. - Ключи своих провайдеров, сохранённые в настройках, лежат в защищённом файле воркспейса и не попадают в историю чатов. - Файлы, которые агент собирает как веб-страницы, открываются в изолированном режиме и не имеют доступа к воркспейсу. ## Правила для ключей и паролей {#secrets} Агент видит всё, что ты пишешь в чат, и история чатов хранится. Поэтому: - **Ключи моделей** вставляй в **Настройки → Модели**, а не в чат. - **Токен Telegram-бота** — в **Настройки → Мессенджеры**. - **Токены MCP-серверов** — в **Настройки → MCP**. - Пароли от личных кабинетов агенту не давай: входить на сайты он всё равно не умеет. Если секрет уже попал в чат, удали этот чат и перевыпусти ключ у сервиса. ## Поддержка {#support} - **Кнопка «Помощь»** в правом нижнем углу воркспейса — там же ссылка на поддержку и на синхронизацию файлов. - **Telegram**: [@youriisupport](https://t.me/youriisupport). - **Почта**: [aiiszdes@gmail.com](mailto:aiiszdes@gmail.com). Напиши адрес своего воркспейса (`имя.cloud.eggent.ai`) и что случилось — так ответ будет быстрее. ## Удалить воркспейс {#delete} Напиши в поддержку с того email, на который зарегистрирован воркспейс. Перед удалением скачай нужные файлы или включи [синхронизацию с компьютером](https://eggent.ai/r/docs/file-sync.md): после удаления восстановить данные нельзя. --- # Eggent для Mac > Приложение Eggent для Mac: что это, как скачать и открыть его в первый раз (подписи Apple пока нет), где лежат его файлы и как его обновить или удалить. Source: https://eggent.ai/r/docs/desktop-app/ Eggent для Mac запускает того же агента, что и Eggent Cloud, на твоём компьютере. Проекты лежат обычными файлами в папке, которую видно в Finder, а агент работает с программами и файлами на твоём Mac. Подключи облачный воркспейс — и Mac с облаком станут одним агентом: [те же файлы, чаты и память на обеих сторонах](https://eggent.ai/r/docs/desktop-cloud.md). > [!WARNING] > Это **ранняя сборка** для Apple silicon, и она **пока не подписана и не заверена (нотаризация) Apple**. При первом запуске macOS не откроет её без твоего разрешения ([как это сделать](#first-launch)). Пользуйся на свой риск, держи копию всего, что нельзя потерять, и до начала прочитай, [до чего достаёт агент](#access). ## Что это {#what} Приложение с теми же экранами, что у облачной версии, и с сервером Eggent внутри, на твоём компьютере. Сервер слушает только локальный адрес, и говорить с ним может только окно приложения. Работает двумя способами, переключаться между ними можно когда угодно: - **Само по себе.** Всё остаётся на этом компьютере. Модель подключаешь ты: свой ключ провайдера или программу, которая у тебя уже есть ([Работа на своей подписке](https://eggent.ai/r/docs/desktop-programs.md)). - **С облачным воркспейсом.** Mac и воркспейс — один агент, а ИИ, включённый в воркспейс, работает и здесь: см. [Приложение и облачный воркспейс](https://eggent.ai/r/docs/desktop-cloud.md). ## Скачать {#download} Скачай актуальную сборку на [странице Eggent для Mac](https://eggent.ai/r/mac/). Там указан размер файла и его контрольная сумма SHA-256. После скачивания сверь её: ```bash shasum -a 256 ~/Downloads/Eggent-<версия>-arm64.dmg ``` ### Что нужно {#requirements} - Mac с **Apple silicon** (M1 и новее) и **macOS 13 (Ventura) или новее**. Intel-Mac и Windows пока не поддерживаются. - Около **1,2 ГБ** места на диске под приложение (скачивается около 360 МБ) и место под твои проекты. - Интернет для модели — и если она идёт из облачного воркспейса, и если от твоего провайдера. - По желанию: **Python 3** для панели терминала. Он идёт с инструментами командной строки Apple (`xcode-select --install` в Терминале). ## Открыть в первый раз {#first-launch} macOS открывает приложение без предупреждения, только если Apple его проверила, а для этого нужен платный сертификат разработчика, которого у Eggent пока нет. Поэтому при первом запуске macOS останавливает приложение. С файлом всё в порядке: разрешаешь один раз, и macOS запоминает. 1. Открой `.dmg` и перетащи **Eggent** в **«Программы»**. 2. Открой Eggent из «Программ». macOS скажет, что не может проверить приложение на вредоносное ПО. Нажми **«Готово»** (в старых версиях macOS — **«OK»**). 3. Открой **«Системные настройки» → «Конфиденциальность и безопасность»**, прокрути до раздела **«Безопасность»**, нажми **«Всё равно открыть»** рядом с Eggent и введи пароль или приложи палец (Touch ID). 4. Открой Eggent ещё раз и нажми **«Открыть»**. Так Apple описывает открытие любого заблокированного приложения: [Safely open apps on your Mac](https://support.apple.com/en-us/102445). Новая загрузка более новой сборки спросит снова. В macOS 13 и 14 можно ещё нажать по Eggent с Control, выбрать **«Открыть»** и подтвердить. Если удобнее Терминал, сними метку «скачано из интернета» и открывай приложение как обычно: ```bash xattr -dr com.apple.quarantine /Applications/Eggent.app ``` > [!NOTE] > Если macOS пишет, что Eggent **повреждён**, и предлагает переместить его в Корзину, сверь контрольную сумму скачанного файла (см. [Скачать](#download)). Если она совпала, файл в порядке: выполни команду из Терминала выше и открой приложение снова. Если не совпала — скачай заново. ## Первый запуск {#first-run} 1. **«Где будет жить Eggent?»** Выбери папку; по умолчанию `~/Eggent`. Всё, что делает и хранит Eggent, будет внутри неё. Папку, где уже что-то лежит, Eggent не заполняет: он создаёт внутри подпапку и сначала говорит об этом. Если в выбранной папке уже есть Eggent, приложение подключится к нему и ничего не удалит. 2. **«Подключить облачный Eggent?»** Введи название воркспейса, логин и пароль, чтобы подключить облачный воркспейс ([как это работает](https://eggent.ai/r/docs/desktop-cloud.md#connect)), или нажми **«Пока без аккаунта»** и подключи позже: **меню Eggent → «Облако и синхронизация…»**. **«У меня ещё нет аккаунта»** открывает страницу регистрации в облаке в браузере; потом вернись и подключись. 3. Приложение готовит инструменты агента, запускает сервер и открывает окно. Первый запуск дольше следующих. Пароль на своём компьютере вводить не нужно: приложение само входит в своё окно. Без облачного аккаунта приложению нужна модель. В **Настройки → Модели** добавь провайдера со своим API-ключом или используй [программу, которая уже есть на компьютере](https://eggent.ai/r/docs/desktop-programs.md). ## Где что лежит {#folder} ```text ~/Eggent/ Projects/ ярлык на data/projects: твои проекты и файлы агента data/ projects/ проекты и файлы агента chats/ то, что экран показывает по каждому чату pi-sessions/ то, что агент помнит о каждом чате chat-files/ вложения settings/ … ключи и настройки этого компьютера README.txt ``` **Файл → «Показать папку Eggent в Finder»** и **«Показать Projects в Finder»** открывают их. Собственные настройки приложения лежат в `~/Library/Application Support/Eggent`, а **Файл → «Показать журнал»** показывает, где его журнал. **Файл → «Сменить папку Eggent…»** переносит её в другое место, двумя способами. **«Перенести»** перевозит всё: проекты, чаты, память агента, вход и связь с облаком. **«Открыть другую»** переключает Eggent на другую папку, а эту оставляет на диске как есть: пустая папка — начать с нуля, папка Eggent — открыть с тем, что в ней. Если облако подключено, другая папка синхронизируется с ним: то, что в ней есть, уйдёт в облако, а облачные проекты и чаты придут в неё. Сначала дождись, пока агент закончит работу: приложение на минуту остановится и запустится снова. Ключи и настройки — только этого компьютера. В облако они не синхронизируются никогда. ## Модели {#models} Чтобы отвечать, приложению нужна модель. Дать её можно тремя способами, их можно сочетать: - **ИИ твоего облачного воркспейса.** Когда [подключишь воркспейс](https://eggent.ai/r/docs/desktop-cloud.md#connect), включённые модели появятся в **Настройки → Модели** и спишутся с того же баланса, что и в облаке. Они не заменяют провайдера, которого ты выбрал сам. - **Свой провайдер.** В **Настройки → Модели** вставляется API-ключ — так же, как на сервере, который ты запускаешь сам: см. [Модели](https://eggent.ai/r/docs/models.md#own-provider). - **Программа, которая уже есть на компьютере.** Проект может работать на Claude Code или Codex по твоей подписке: [Работа на своей подписке](https://eggent.ai/r/docs/desktop-programs.md). ## До чего достаёт агент {#access} В облаке агент работает внутри компьютера, где есть только твой воркспейс. **На твоём Mac такой коробки нет.** У агента есть терминал, и команды он запускает от твоего пользователя, из папки Eggent, поэтому может читать и менять всё, что можешь ты, — как любая программа, которую ты запускаешь. Что его сдерживает: - С локальным сервером говорит только окно приложения. Страница, открытая в браузере, — нет, хотя сервер у тебя на машине. - Сервер получает небольшой фиксированный набор переменных окружения, а не те, что есть в твоём терминале, поэтому ключи, экспортированные в Терминале, ему не передаются. - Ключи и настройки, которые ты добавляешь, остаются в папке данных приложения и в облако не синхронизируются. Относись к агенту как к толковому помощнику с терминалом на твоём ноутбуке: проси о том, что готов ему доверить, и держи важные данные в резервной копии. ## Обновления {#updates} Автообновлений пока нет. Чтобы обновиться, скачай новую сборку на [странице Eggent для Mac](https://eggent.ai/r/mac/), закрой Eggent, перетащи новый Eggent в **«Программы»** с заменой старого и открой его. macOS снова попросит разрешение, как в первый раз. Папка и настройки остаются как были. Если пользуешься облаком, не отставай сильно с версией: приложение и облако обмениваются файлами чатов, и сильно разные версии могут не прочитать друг друга. ## Удалить {#remove} Закрой Eggent и перетащи его из **«Программ»** в Корзину. Две вещи остаются намеренно: папка `~/Eggent` с твоими файлами и историей чатов и собственные настройки приложения в `~/Library/Application Support/Eggent`. Чтобы начать с нуля, удали и их. Если пользовался облаком, сначала [отключи его](https://eggent.ai/r/docs/desktop-cloud.md#disconnect). ## Если что-то пошло не так {#troubleshooting} - **macOS не открывает приложение или пишет, что оно повреждено.** См. [Открыть в первый раз](#first-launch). - **«Eggent не запустился».** Экран предлагает **«Попробовать снова»** и **«Показать журнал»**. В журнале видно, что случилось; если пишешь в поддержку, приложи его. - **Первый запуск долгий.** Приложение один раз готовит инструменты агента — это около минуты. Дальше быстрее. - **Панель терминала пишет, что недоступна.** Ей нужен Python 3: поставь инструменты командной строки Apple командой `xcode-select --install`. Команды из чата при этом продолжают работать. - **«Eggent ещё работает» при выходе.** Приложение считает чаты, которые идут прямо сейчас. Если выйти, они остановятся; **«Подождать»** даст им закончить. - **Проблемы с синхронизацией.** См. [Приложение и облачный воркспейс](https://eggent.ai/r/docs/desktop-cloud.md#troubleshooting). ## Чего здесь пока нет {#limits} - Windows и Intel-Mac. - Подписи и нотаризации Apple: из-за этого при первом запуске macOS и предупреждает. Автообновлений тоже нет. - Запуска при входе в систему и значка в строке меню. - Распознавания речи и Python-инструментов для документов, которые есть на компьютере в облаке. Агент пользуется тем, что установлено у тебя. - Расписаний, которые работают при выключенном Mac. Расписание, созданное в приложении, работает, только пока приложение открыто; задачу, которая должна идти строго по времени, создай в облаке. См. [Что остаётся на каждой стороне](https://eggent.ai/r/docs/desktop-cloud.md#separate). --- # Приложение и облачный воркспейс > Подключи приложение 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)), а на том компьютере она не готова: нет входа, не установлена, исчерпан лимит. Разберись с этим в приложении на том компьютере или запусти чат здесь. - **«Этот чат только что перенесли на эту сторону…»** Ты перенёс чат на другой стороне и написал здесь, прежде чем синхронизация донесла перенос. Подожди несколько секунд и отправь снова. - **Перенос чата пишет, что тот ещё не дошёл.** Прежде чем чат переносят, сторона, которая переносит, должна иметь то, что другая записала последней. Подожди несколько секунд и попробуй снова. - **Ответ остановился, а ход продолжился.** Если связь с другой стороной обрывается посреди хода, ход продолжается там, а его ответ появится здесь, когда его принесёт синхронизация. - **Компьютер уснул или потерял связь за работой.** Облако замечает это примерно через минуту и сообщает, что связь потеряна. Ход продолжится там, когда компьютер вернётся, а ответ появится здесь через синхронизацию. «Стоп» работает с любой стороны. --- # Работа на своей подписке > В приложении Eggent для Mac проект может работать на Claude Code или Codex, уже установленных на компьютере, по твоей собственной подписке вместо модели Eggent. Экспериментально. Source: https://eggent.ai/r/docs/desktop-programs/ Если на компьютере установлен **Claude Code** или **Codex**, [приложение Eggent для Mac](https://eggent.ai/r/docs/desktop-app.md) показывает его в **Настройки → Модели**, в блоке **На этом компьютере**. Проект — или твои чаты вне проектов — может работать на нём по **твоей собственной подписке** вместо модели Eggent. С баланса Eggent ничего не списывается, а твой вход Eggent не видит: он запускает программу так, как запустил бы ты, и читает только то, что программа говорит о себе. > [!WARNING] > Это экспериментально. Claude Code и Codex — программы других компаний со своими условиями и лимитами, и Eggent не может обещать, что они продолжат с ним работать. Codex в самом приложении помечен как эксперимент. ## Что это {#what} Модель — это то, к чему Eggent обращается с запросом. Программа устроена иначе: у неё свои инструменты, и работу над проектом она делает сама, в папке проекта. Eggent передаёт ей твоё сообщение, показывает, что она делает по ходу, и хранит чат, поэтому кнопка остановки, история чата и панель файлов работают как в любом чате. Подходит для работы с файлами и кодом. Это не тот же агент: инструменты Eggent, его навыки и память не участвуют, см. [что меняется в чате](#chat). ## Включить {#start} 1. Открой **Настройки → Модели**. Найденная на компьютере программа показана в блоке **На этом компьютере** с версией. (Если не найдено ничего, блока нет.) 2. **Установлена, но не выполнен вход?** Нажми **«Войти»**. Откроется собственный вход программы в браузере, а экран заметит, когда ты закончишь. 3. Нажми **«Использовать для этого проекта»** (или **«Использовать здесь»** — для чатов вне проектов). В первый раз лист спросит, что это значит ([ниже](#sheet)), и попросит программу ответить одним словом, чтобы убедиться, что она отвечает, прежде чем что-то на неё переносить. 4. Дальше это просто переключатель. Выбрать программу можно и в списке моделей под полем сообщения. **«Вернуть модель Eggent»** возвращает проект на модель. Ничего не теряется: чаты остаются, а сообщение, на которое программа не ответила, можно отправить снова на модели кнопкой под ответом. ## Что говорит лист {#sheet} - Программа работает в папке проекта **со своими инструментами**, а не с инструментами Eggent. - Она расходует лимиты твоей подписки. То, что ты пишешь, и файлы, которые она читает, уходят в компанию, которая её делает. - **Расписания, карточки с вопросами, навыки Eggent и Telegram в этом режиме не работают**, и Eggent ничему не учится на этих чатах. - **Доступ** задаёшь ты: [см. ниже](#access). ## Доступ {#access} - **Меняет файлы только в папке этого проекта** (по умолчанию). Программа меняет файлы только внутри папки. Claude Code на этом уровне не может запускать команды; Codex запускает их в песочнице без сети. Всё, что программа читает, отправляется в компанию, которая её делает. - **Как в терминале (весь компьютер).** Программа может читать и менять на компьютере всё, что можешь ты, и запускает команды, не спрашивая. Выбирай это, только если понимаешь, что делаешь. ## Что меняется в чате {#chat} Чат, который ведёт программа, отмечен строкой под полем сообщения, а счётчики токенов при этом убраны — считать их не дело Eggent. Сообщения после первого уходят в ту же сессию программы, поэтому она помнит чат; в чате, где уже была история, на первом сообщении программа получает короткую сводку. Файлы, которые ты прикладываешь к чату, называются программе, и их папка ей открывается. Одновременно могут работать несколько программ; та, что ждёт своей очереди, так и пишет («ждёт свободного места»). ## Когда программа не готова {#not-ready} Если программа без входа, устарела или упёрлась в лимит твоей подписки, ответ говорит об этом её собственными словами и предлагает **«Продолжить на модели Eggent»**. - **Нет входа.** **Настройки → Модели → «Войти»**, потом отправь снова. - **Лимит исчерпан.** В ответе сказано, когда он откроется, если программа об этом сообщает; подожди или выбери для проекта другую модель. - **Найден API-ключ.** Программа списала бы деньги с ключа вместо подписки, поэтому Eggent её не запускает. Убери ключ из её настроек или из окружения. - **Слишком старая версия.** Обнови программу. ## Когда облако отдаёт чат твоему компьютеру {#remote} Проект на программе может запускаться и из облака, если ты это разрешил: см. [Разрешить облаку запускать чаты на твоём компьютере](https://eggent.ai/r/docs/desktop-cloud.md#computer-allow). Если выбрано **«Спрашивать про каждый чат»**, приложение спрашивает про такой чат отдельно, называет программу и то, как далеко она достаёт («Он сможет менять файлы только в папке проекта» или «Он сможет читать и менять всё на этом компьютере, что можете вы, и запускать команды без вопросов»), и разрешение действует только для этой программы с этим доступом. **«Разрешить любые чаты»** распространяется и на такие чаты. Если программа на этом компьютере не готова, чат так и скажет, а **«Запустить здесь»** вернёт его туда, где ты. --- # Установка на свой сервер > Как запустить открытое ядро Eggent на своей машине или VPS — установщик одной командой, готовый Docker-образ, сборка из исходников и первый запуск. Source: https://eggent.ai/r/docs/self-host-install/ Открытое ядро Eggent — то же рабочее пространство, что в облаке, но на твоей машине: все чаты, файлы, память и ключи лежат в папке `./data`. Лицензия MIT, код на [GitHub](https://github.com/eggent-ai/eggent). Чем отличается от облака: нет Eggent AI (нужен свой ключ модели), нет готовых карточек навыков, общего Telegram-бота, синхронизации через Syncthing и сна. Всё остальное — то же. Это один воркспейс. Eggent для всей компании — воркспейс каждому человеку, лимиты, общие файлы — на ваших серверах ставится как [Eggent Enterprise](https://eggent.ai/r/docs/enterprise.md). ## Что нужно {#requirements} - Linux, macOS или Windows с WSL2. - **Docker** (установщик поставит его сам, если сможет) или Node.js 22 для запуска без Docker. - Не меньше 2 ГБ оперативной памяти и несколько гигабайт свободного диска под образ и данные. - Ключ API любого провайдера моделей или локальная модель с OpenAI-совместимым API. ## Установка одной командой {#installer} ```bash curl -fsSL https://get.eggent.ai | bash ``` Установщик: 1. скачивает Eggent в `~/.eggent`; 2. ставит Docker, если его нет; 3. собирает и запускает контейнер; 4. ждёт, пока Eggent ответит, и пишет адрес. По умолчанию Eggent открывается только на этой машине: `http://127.0.0.1:3000`. Параметры установщика задаются переменными: ```bash EGGENT_INSTALL_DIR=/opt/eggent \ APP_PORT=3000 \ EGGENT_APP_BIND_HOST=127.0.0.1 \ bash -c "$(curl -fsSL https://get.eggent.ai)" ``` ## Готовый Docker-образ {#image} Ничего не собирать: образ `ghcr.io/eggent-ai/eggent` публикуется с каждым релизом. ```bash curl -O https://raw.githubusercontent.com/eggent-ai/eggent/main/docker-compose.ghcr.yml docker compose -f docker-compose.ghcr.yml up -d ``` Файл `docker-compose.ghcr.yml` можно вставить и в Portainer. Лучше закрепить версию в `.env` (`EGGENT_VERSION=0.2.9`), а не следовать за `latest`. ## Сборка из исходников {#source} ```bash git clone https://github.com/eggent-ai/eggent.git cd eggent cp .env.example .env # по желанию docker compose up -d --build ``` Данные хранятся в `./data`, внутри контейнера это `/app/data`. ## Без Docker, для разработки {#dev} ```bash git clone https://github.com/eggent-ai/eggent.git cd eggent npm install npm run dev ``` Нужен Node.js 22. Для голоса установи `ffmpeg` и `whisper.cpp`. ## Первый запуск {#first-run} 1. Открой `http://127.0.0.1:3000`. 2. Войди с логином `admin` и паролем `admin` — Eggent сразу попросит заменить их на свои. 3. Подключи провайдера модели: выбери его и вставь ключ. Ключ можно не класть в `.env` — он хранится в `data/`. 4. Начни первый чат. Дальше всё как в [«Первых шагах»](https://eggent.ai/r/docs/first-steps.md), кроме карточек быстрого старта. ## Открыть доступ из интернета {#public} Для VPS правильный путь — оставить Eggent на `127.0.0.1` и поставить перед ним обратный прокси с HTTPS (Caddy, Nginx, Traefik). Подробности и пример — в [«Настройка своего сервера»](https://eggent.ai/r/docs/self-host-config.md#reverse-proxy). --- # Настройка своего сервера > Переменные окружения открытого ядра Eggent, обратный прокси с HTTPS для VPS, Telegram-вебхук, исходящий прокси и правила безопасности. Source: https://eggent.ai/r/docs/self-host-config/ Почти всё настраивается в интерфейсе Eggent, и файл `.env` не обязателен. Переменные окружения нужны для того, что должно быть известно до запуска: адрес, порт, запасные ключи. ## Переменные окружения {#env} Полный список — в `.env.example` в репозитории. Основные: | Переменная | По умолчанию | Для чего | | --- | --- | --- | | `APP_BIND_HOST` | `127.0.0.1` | На каком адресе хоста слушает Docker. `0.0.0.0` — только осознанно | | `APP_PORT` | `3000` | Порт на хосте | | `APP_BASE_URL` | `http://localhost:3000` | Публичный адрес — для вебхуков и ссылок | | `EGGENT_AUTH_SECRET` | создаётся в `data/settings/` | Секрет подписи сессий | | `EXTERNAL_API_TOKEN` | не задан | Запасной токен для [внешнего API](https://eggent.ai/r/docs/external-api.md) | | `TELEGRAM_BOT_TOKEN` | не задан | Токен бота, если не хочешь вводить его в интерфейсе | | `TELEGRAM_WEBHOOK_SECRET` | не задан | Секрет вебхука Telegram | | `TELEGRAM_DEFAULT_PROJECT_ID` | не задан | Проект по умолчанию для Telegram | | `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GOOGLE_API_KEY`, `OPENROUTER_API_KEY` | не заданы | Запасные ключи провайдеров | | `EGGENT_STT_ENABLED`, `EGGENT_STT_MODEL`, `EGGENT_STT_LANGUAGE` | `1`, `base`, `auto` | [Распознавание речи](https://eggent.ai/r/docs/voice.md#self-host) | | `HTTPS_PROXY`, `HTTP_PROXY`, `NO_PROXY` | не заданы | Исходящий трафик через прокси | | `EGGENT_LEARNING` | включено | `off` не даёт агенту сохранять заметки и навыки из разговоров (см. [«Память»](https://eggent.ai/r/docs/memory.md#learned)); уже сохранённое тоже перестаёт читаться | | `EGGENT_LEARNING_MODEL` | модель чата | Модель для фонового взгляда назад: `провайдер/id` или просто id — хватит и более дешёвой | | `EGGENT_LEARNING_DAILY_CAP`, `EGGENT_LEARNING_MIN_GAP_SECONDS`, `EGGENT_LEARNING_EVERY_TURNS` | `40`, `60`, `6` | Сколько раз в сутки агент оглядывается, пауза между двумя взглядами и как часто смотрит разговор, в котором ничего не отмечено | | `EGGENT_TURN_WATCHDOG` | включено | `off` отключает проверку, которая останавливает «замолчавший» ход (см. [«Чаты»](https://eggent.ai/r/docs/chats.md#while-working)). Стоит отключить, если ты запускаешь медленную локальную модель, которая может думать дольше лимитов ниже | | `EGGENT_TURN_SILENCE_SOFT_SECONDS`, `EGGENT_TURN_SILENCE_START_SECONDS`, `EGGENT_TURN_SILENCE_MODEL_SECONDS`, `EGGENT_TURN_SILENCE_TOOL_SECONDS` | `90`, `180`, `360`, `1200` | Сколько ход может молчать, прежде чем чат скажет, что он ещё идёт, и прежде чем его остановят: пока он запускается, пока модель не ответила, пока выполняется команда. Команда, которая идёт рядом с другой, сохраняет весь свой запас | | `EGGENT_TURN_QUESTION_WAIT_SECONDS` | `86400` | Сколько вопрос к тебе может ждать ответа, прежде чем ход остановят (см. [«Чаты»](https://eggent.ai/r/docs/chats.md#questions)). `0` или `off` — вопрос ждёт сколько угодно | | `EGGENT_VISITS_MAX`, `EGGENT_VISIT_TIMEOUT_MINUTES`, `EGGENT_VISIT_STOP_GRACE_SECONDS` | `2`, `10`, `20` | [Обращение к проекту через `@`](https://eggent.ai/r/docs/projects.md#ask): сколько их может идти одновременно, сколько может занять одно и сколько ему дают на остановку, прежде чем его отпускают | | `EGGENT_BOARD` | включено | `off` — [доска задач](https://eggent.ai/r/docs/board.md) перестаёт запускать карточки; сама доска и карточки остаются | | `EGGENT_BOARD_MAX_RUNNING`, `EGGENT_BOARD_MAX_PER_PROJECT` | `3`, `1` | Сколько карточек работают одновременно на всей доске и в одном проекте. Карточки одного проекта работают в одной папке | | `EGGENT_BOARD_RETRY_SECONDS` | `60` | Сколько упавшая карточка ждёт своего единственного автоматического повтора | | `EGGENT_ZIP_MAX_MB`, `EGGENT_ZIP_MAX_FILES`, `EGGENT_ZIP_IDLE_SECONDS` | `1024`, `10000`, `120` | Размер и число файлов одного [архива](https://eggent.ai/r/docs/files.md#zip) и сколько он может простоять, когда его никто не забирает, прежде чем его бросят | | `EGGENT_VERSIONS` | включено | `off` — [версии файлов](https://eggent.ai/r/docs/files.md#history) больше не сохраняются; то, что уже сохранено, можно смотреть | | `EGGENT_VERSIONS_KEEP_DAYS`, `EGGENT_VERSIONS_DAILY_DAYS`, `EGGENT_VERSIONS_MAX_PER_FILE`, `EGGENT_VERSIONS_MAX_FILE_MB` | `30`, `90`, `200`, `10` | Сколько каждая версия хранится после того, как её заменили, до какого срока хранится по одной в день, сколько версий держит один файл и с какого размера у файла нет истории | | `EGGENT_VERSIONS_SCAN_SECONDS` | `120` | Как часто файлы с историей проверяются на изменения, сделанные в обход Eggent: синхронизация, терминал, другая программа | | `EGGENT_VERSIONS_MAX_TOTAL_MB`, `EGGENT_VERSIONS_DISK_SHARE` | `1024`, `0.25` | Сколько может занимать вся история и какую долю диска, если развёртывание сообщает его размер; сверх этого первыми уходят версии, заменённые раньше всех | | `EGGENT_WEB_SEARCH_DEFAULTS` | включено | `off` — Eggent не записывает при старте порядок бесплатных поисковиков в `data/pi-agent/web-search.json` (см. [Инструменты агента](https://eggent.ai/r/docs/agent-tools.md#web)) | | `EGGENT_CLOUD_PROMO` | включено | `0` убирает короткую карточку про Eggent Cloud внизу страницы **Настройки → Модели** | | `EGGENT_VERSION` | `latest` | Тег образа для `docker-compose.ghcr.yml` | После изменения `.env` пересоздай контейнер: ```bash docker compose up -d --force-recreate ``` ## Обратный прокси и HTTPS {#reverse-proxy} На VPS держи Eggent на `127.0.0.1` и ставь перед ним прокси с HTTPS. HTTPS нужен не только для безопасности: без него браузер не даст доступ к микрофону, а Telegram не примет вебхук. **Caddy** (сертификат получит сам): ```text eggent.example.com { request_body { max_size 100MB } reverse_proxy 127.0.0.1:3000 } ``` **Nginx**: ```nginx server { server_name eggent.example.com; client_max_body_size 100m; location / { proxy_pass http://127.0.0.1:3000; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_buffering off; proxy_read_timeout 600s; } } ``` > [!WARNING] > Прокси ограничивает размер запроса, и его лимит обычно меньше, чем у Eggent: у Nginx по умолчанию 1 МБ, и загрузка большого файла падает с ошибкой `413`. Подними лимит до 100 МБ, как в примерах. `proxy_buffering off` и большой `proxy_read_timeout` нужны, чтобы ответы агента шли потоком и долгие задачи не обрывались. После настройки прокси пропиши публичный адрес в `APP_BASE_URL`. ## Telegram на своём сервере {#telegram} Бот подключается в **Настройки → Мессенджеры**, как описано в [«Telegram»](https://eggent.ai/r/docs/telegram.md#own-bot). Режим: - **Long Polling** — работает без публичного адреса. Подходит для домашней машины. Сообщения обрабатываются по очереди, поэтому то, что ты отправляешь, пока агент занят, — включая `/reset` и «стоп», — прочитывается, когда этот ход закончится; «замолчавший» ход завершают лимиты `EGGENT_TURN_SILENCE_*` выше. - **Webhook** — нужен публичный HTTPS-адрес (`APP_BASE_URL`). Быстрее и надёжнее на VPS. Режим **Auto** сам выберет вебхук, когда публичный HTTPS-адрес задан. ## Исходящий прокси {#egress-proxy} Если сервер выходит в интернет только через прокси, задай `HTTPS_PROXY` (и при необходимости `HTTP_PROXY`, `NO_PROXY`). Нужен Node.js 22.23 или новее; в Docker-образе он уже такой. ## Безопасность {#security} - Не открывай порт Eggent в интернет без HTTPS. По умолчанию он слушает только `127.0.0.1` — так и оставь, если стоит прокси. - Сразу смени логин и пароль по умолчанию. - Относись к токену внешнего API как к паролю и не используй его в коде браузера. - Защищай и резервируй папку `data/`: там чаты, файлы, память, настройки и ключи. - У агента есть терминал внутри контейнера. Не монтируй в контейнер папки, к которым агенту не нужен доступ. --- # Обновление и резервные копии > Как обновлять открытое ядро Eggent, делать резервные копии папки data, проверять здоровье сервера, смотреть логи и переносить Eggent на другую машину. Source: https://eggent.ai/r/docs/self-host-maintenance/ ## Проверка, что всё работает {#health} ```bash curl -fsS http://127.0.0.1:3000/api/health ``` Ответ содержит статус и версию Eggent. Эту же проверку можно поставить в мониторинг. Команды `docker compose` ниже выполняются в папке установки (`~/.eggent`, если ставил установщиком). Логи контейнера: ```bash docker compose logs -f --tail=200 ``` ## Обновление {#upgrade} Перед обновлением сделай [резервную копию](https://eggent.ai/r/docs/self-host-maintenance.md#backup). **Установлено установщиком** — просто запусти его снова, он обновит код и пересоберёт контейнер: ```bash curl -fsSL https://get.eggent.ai | bash ``` **Готовый образ** — поменяй `EGGENT_VERSION` в `.env` на новую версию и выполни: ```bash docker compose -f docker-compose.ghcr.yml pull docker compose -f docker-compose.ghcr.yml up -d ``` **Из исходников**: ```bash git pull docker compose up -d --build ``` Что изменилось в каждой версии — в [релизах на GitHub](https://github.com/eggent-ai/eggent/releases). ## Резервные копии {#backup} Всё состояние Eggent — это папка `data/`. Чтобы сделать копию, достаточно заархивировать её: ```bash docker compose stop tar czf eggent-data-$(date +%F).tgz data docker compose start ``` Остановка нужна, чтобы файлы не менялись во время копирования. Храни копии вне сервера: в `data/` лежат ключи и токены, так что относись к архиву как к секрету. ## Перенос на другую машину {#migrate} 1. Установи Eggent на новой машине тем же способом. 2. Останови его и замени папку `data/` копией со старой машины. 3. Запусти снова. Чаты, проекты, настройки, ключи, расписания и Telegram-бот переедут вместе с папкой. Если меняется публичный адрес, поправь `APP_BASE_URL` и заново нажми **Активировать бота** в **Настройки → Мессенджеры**, чтобы Telegram узнал новый адрес вебхука. ## Перезапуск и расписания {#restart} При запуске Eggent заново включает все сохранённые [расписания](https://eggent.ai/r/docs/schedules.md). Запуски, пропущенные, пока сервер был выключен, не повторяются: задача выполнится в следующий раз по расписанию. Разовые задачи, время которых прошло, удаляются. ## Модель распознавания речи {#whisper} Модель `whisper.cpp` скачивается при первом распознавании в `data/models/whisper/`. Чтобы сменить её на более точную, задай `EGGENT_STT_MODEL=small` (или `medium`) и пересоздай контейнер; новая модель скачается сама. Без доступа в интернет положи файл `ggml-<модель>.bin` в эту папку вручную. --- # Eggent Enterprise > Eggent Enterprise — весь Eggent на ваших серверах. Воркспейсы людей, консоль компании, шлюз моделей, синхронизация файлов и бот Telegram внутри вашей инфраструктуры. Что ставим, что нужно и чем это отличается от бесплатной установки. Source: https://eggent.ai/r/docs/enterprise/ **Eggent Enterprise** — тот же стек, на котором работает Eggent Cloud, установленный в вашу инфраструктуру. Всё, что описано в [Eggent Business](https://eggent.ai/r/docs/business.md) и на странице [Работа в компании](https://eggent.ai/r/docs/company.md), работает так же, но файлы, чаты и память агентов хранятся на ваших серверах. > [!NOTE] > Enterprise ставим по договору. Напиши на aiiszdes@gmail.com или в поддержку в Telegram: сколько человек, где должны жить данные и какие модели вы используете. ## Что ставим {#stack} - **Воркспейсы.** У каждого человека свой воркспейс с агентом: файлы, чаты, память, расписания, навыки. Неактивный воркспейс засыпает и не занимает память, а просыпается от первого запроса — ничего не теряется. - **Панель управления.** Создание воркспейсов, вход, консоль компании и администрирование. - **Шлюз моделей.** Через него идут запросы воркспейсов к моделям: ключи провайдеров лежат в шлюзе, а воркспейс получает только свой пропуск к нему. Расходы считаются по людям и командам, с месячными лимитами. - **Синхронизация файлов.** Папки людей синхронизируются с их компьютерами ([Синхронизация](https://eggent.ai/r/docs/file-sync.md)). - **Бот Telegram.** Ваш бот: через него создают воркспейсы, общаются с агентом и получают уведомления компании. - **Домены и сертификаты.** Воркспейсы живут на поддоменах вашего домена, сертификаты выпускаются автоматически. ## Данные {#data} - Файлы, чаты, история и память агентов хранятся на ваших серверах. - Наружу уходят запросы к моделям, которые вы подключили, и то, что агент делает в интернете по задаче — например, ищет или открывает сайт. Если и модель стоит у вас, данные людей не покидают ваш периметр. - Ядро Eggent — открытый код под лицензией MIT ([github.com/eggent-ai/eggent](https://github.com/eggent-ai/eggent)): код агента можно прочитать до установки. Панель управления и шлюз ставим из наших образов. ## Модели {#models} - **Через шлюз** — по ключу OpenAI или OpenRouter. Тогда у всех людей один список моделей и общий учёт расходов по людям и командам. - **В воркспейсе** — по ключу любого провайдера: OpenAI, Anthropic, Google, OpenRouter, DeepSeek или своя модель с API, совместимым с OpenAI, в том числе на вашем сервере ([Свой провайдер](https://eggent.ai/r/docs/models.md#own-provider)). ## Чем отличается от бесплатной установки {#vs-self-host} | | Бесплатная установка | Enterprise | |---|---|---| | Что это | Один воркспейс: один агент со своими проектами | Воркспейс каждому человеку и компания | | Установка | Одной командой, сами ([Установка](https://eggent.ai/r/docs/self-host-install.md)) | Ставим мы | | Модели | Ваш ключ или своя модель | Шлюз с учётом расходов, плюс свой ключ в любом воркспейсе | | Компания | — | Люди, команды, лимиты, папки, сообщения, общие файлы, согласования | | Сон воркспейсов, синхронизация, бот Telegram | — | Есть | | Обновления | Сами ([Обслуживание](https://eggent.ai/r/docs/self-host-maintenance.md)) | Мы, по договору | | Цена | Бесплатно, лицензия MIT | По договору | ## Что нужно {#requirements} - Сервер на Linux с Docker — свой или в вашем облаке. Всё ставится контейнерами. - Домен и записи DNS: адрес панели и подстановочная запись для воркспейсов (`*.ваш-домен`). Сертификаты выпускаются автоматически. - Открытые порты: 80 и 443 для сайтов, 22000 для синхронизации файлов. - Ориентир по размеру: на нашем сервере с 6 ядрами и 12 ГБ памяти одновременно работают около 30 воркспейсов, остальные спят. - Ключи моделей или своя модель. ## Как начинаем {#start} 1. **Разговор.** Сколько людей, где запускать, какие модели и внутренние системы нужно подключить. 2. **Установка.** Ставим стек на ваш сервер, подключаем домен и заводим первых людей. 3. **Подключение.** Ваши модели, ваш бот Telegram, внутренние системы — через [MCP](https://eggent.ai/r/docs/mcp.md) или [API](https://eggent.ai/r/docs/external-api.md). 4. **Сопровождение.** Обновления и поддержка — по договору. ## Чего пока нет {#not-yet} - Входа через корпоративный SSO. - Сводного журнала действий в интерфейсе. --- # Инструменты агента > Полный справочник инструментов, которые есть у агента Eggent, — назначение, основные параметры и примеры просьб, которые к ним приводят. Пригодится и людям, и самому агенту. Source: https://eggent.ai/r/docs/agent-tools/ Инструмент — это действие, которое агент может выполнить сам. Ниже — все инструменты воркспейса в полном режиме чата. В режиме [«диалог и файлы»](https://eggent.ai/r/docs/chats.md#modes) остаются только чтение файлов и переключение проектов, в режиме «просто диалог» инструментов нет. ## Файлы и команды {#files} Базовые инструменты среды выполнения. Работают в папке текущего проекта (или оркестратора). | Инструмент | Что делает | | --- | --- | | `read` | Читает файл: текст, код, картинку (для моделей, которые умеют смотреть) | | `write` | Создаёт или перезаписывает файл | | `edit` | Точечно правит файл | | `bash` | Выполняет команду в терминале: запуск Python и Node.js, `git`, `curl`, конвертация файлов | | `ls` | Показывает содержимое папки (в режиме «диалог и файлы») | ## Интернет {#web} | Инструмент | Что делает | | --- | --- | | `web_search` | Ищет в интернете по запросу | | `fetch_content` | Загружает страницу по ссылке и достаёт из неё текст | | `get_search_content` | Достаёт полный текст найденных результатов | Для поиска ключ не нужен: если один бесплатный поисковик отказал, пробуется следующий, всего три по очереди. Чтобы искать через свой сервис, укажите его ключ в `data/pi-agent/web-search.json` — файл, в котором назван сервис или ключ, остаётся ровно таким, как вы его написали. ## Помощники и расписания {#subagents} | Инструмент | Что делает | | --- | --- | | `Agent` | Запускает помощника — отдельного агента для части работы — и ждёт его результата. Несколько вызовов в одном сообщении работают одновременно, до шести. С параметром расписания вместо этого создаёт [задачу по расписанию](https://eggent.ai/r/docs/schedules.md) | | `get_subagent_result` | Забирает результат помощника | | `steer_subagent` | Даёт работающему помощнику уточнение | | `eggent_manage_schedules` | Показывает, меняет или отменяет существующие расписания. Действия: `list`, `update` (новое время `schedule`, новое задание `prompt` и/или `enabled`, чтобы поставить на паузу или возобновить), `clear`. Отчёт запуска по расписанию может только `list`. Область: `current` или `all` | Форматы времени для расписаний: cron из 5 или 6 полей (в варианте с 6 полями первое — секунды), интервал (`5m`, `1h`), отложенный запуск (`+10m`) или дата ISO. Файлы расписаний нельзя править напрямую: только через этот инструмент. ## Проекты и воркспейс {#workspace} | Инструмент | Что делает | | --- | --- | | `list_projects` | Список проектов | | `create_project` | Создаёт проект: `name`, `description`, `instructions` | | `switch_project` | Переключается в проект или к оркестратору (`project_id: "none"`) | | `eggent_ask_project` | Поручает задачу другому проекту и ждёт его ответа. Работает только для проекта, который ты назвал через `@` в начале сообщения в этом ходе: сам агент запустить его не может. См. [Проекты](https://eggent.ai/r/docs/projects.md#ask) | | `eggent_manage_chats` | Другие чаты: `list`, `search`, `read`; `switch` переводит разговор в другой чат, `new` — в новый: в Telegram со следующего сообщения, в браузере — ссылкой | | `create_skill` | Создаёт [навык](https://eggent.ai/r/docs/skills.md): `skill_name`, `description`, `body` | | `upsert_mcp_server` | Добавляет или меняет [MCP-сервер](https://eggent.ai/r/docs/mcp.md): `stdio` (`command`, `args`, `env`) или `http` (`url`, `headers`) | | `delete_mcp_server` | Удаляет MCP-сервер | | `mcp` | Вызывает инструменты подключённых MCP-серверов | ## Память {#memory} | Инструмент | Что делает | | --- | --- | | `eggent_memory_save` | Сохраняет запись в [память](https://eggent.ai/r/docs/memory.md) текущего проекта или оркестратора | | `eggent_memory_search` | Ищет в памяти | | `eggent_memory_delete` | Удаляет подходящие записи | ## Общение с человеком {#communication} | Инструмент | Что делает | | --- | --- | | `eggent_ask_user` | Показывает карточку с вопросом: варианты (`options`), да/нет (`confirm`) или свободный ответ (`free_text`). Рядом с кнопками всегда есть поле для своего ответа | | `telegram_send_message` | Отправляет текст в Telegram: в свой чат или в канал (`chat`: `@канал`, ссылка `t.me` или числовой id) | | `telegram_send_file` | Отправляет файл. Картинка уходит фото с подписью, остальное — документом; `as_file` — отправить картинку файлом | | `eggent_manage_telegram` | Управляет своим ботом: `status`, `connect`, `disconnect`, `allow_user`, `access_code`; в облаке `link_shared` привязывает твой Telegram к общему боту | | `eggent_email` | [Почта агента](https://eggent.ai/r/docs/email.md): `send_email`, `list_emails`, `read_email`, `email_status`, `my_address` | | `eggent_google` | В облаке — твой [Google](https://eggent.ai/r/docs/google.md): `status`, `connect`, документы, таблицы, презентации, файлы и папки на Диске, `share_link` (ждёт твоего «да») | | `eggent_calendar_file` | Делает файл календаря (`.ics`) для события, который открывается в любом календаре | ## Модели и картинки {#models} | Инструмент | Что делает | | --- | --- | | `eggent_manage_models` | `status` — текущая модель и провайдеры; `add_provider` — подключить OpenAI-совместимого провайдера (`provider_id`, `base_url`, `models`); `use_provider` — сделать подключённого провайдера основным | | `eggent_generate_image` | Рисует или редактирует картинку: `prompt`, `reference_image_paths`, `aspect_ratio`, `size`, `quality`, `background`, `n` | | `eggent_usage_status` | Только в облаке: остаток кредитов, дней и места, текущий тариф | ## Доска задач {#board} | Инструмент | Что делает | | --- | --- | | `eggent_board` | [Доска задач](https://eggent.ai/r/docs/board.md): `list` и `get` читают её; `create` записывает карточки (название, задачу, проект, `after` — карточки, которых она ждёт, `#1` — более ранняя карточка того же списка) во «Входящие»; `update` и `remove` меняют только карточки, которые ещё во «Входящих». Карточку агент никогда не запускает — это делает человек | ## Работа с коллегами {#company} Только в воркспейсе, который входит в [компанию](https://eggent.ai/r/docs/company.md). | Инструмент | Что делает | | --- | --- | | `eggent_messages` | [Сообщения](https://eggent.ai/r/docs/company.md#messages) с людьми компании: `contacts`, `inbox`, `read`, `send` (с пометкой, что написал агент), `describe` (запоминает, кто чем занимается) | | `eggent_shares` | [Общие файлы](https://eggent.ai/r/docs/company.md#shares): `people`, `list`, `read` (текст общего файла), `comments`, `comment` (от имени человека, к фрагменту, если он указан), `share` (добавляет людей с ролью — просмотр, комментарии или правка — и ни у кого файл не забирает). Менять чужой файл он не может | | `eggent_approvals` | [Согласования](https://eggent.ai/r/docs/company.md#approvals): `people`, `waiting`, `sent`, `read`, `text` (текст версии), `send` (файл людям по порядку), `withdraw`. Согласовать или вернуть версию он не может — это делает человек | ## Навыки как команды {#skill-commands} Каждый установленный навык можно вызвать явно: `/skill:<имя>` в начале сообщения. Список установленных навыков — в **Настройки → Навыки**. --- # Справочник HTTP API > Все HTTP-адреса Eggent — какие из них открыты по токену для интеграций, какие требуют входа в веб-версию, и что они принимают и возвращают. Source: https://eggent.ai/r/docs/http-api/ У Eggent два вида HTTP-адресов: - **Внешний API** (`/api/external/*`) — для интеграций. Авторизация токеном `Authorization: Bearer <токен>`. Подробно — в [«HTTP API для интеграций»](https://eggent.ai/r/docs/external-api.md). - **API веб-версии** — всё остальное. Требует входа: cookie сессии, которую ставит `/api/auth/login`. Этими адресами пользуется сам интерфейс; для автоматизации лучше внешний API. Базовый адрес: `https://имя.cloud.eggent.ai` в облаке или адрес твоего сервера. ## Внешний API {#external} | Метод и адрес | Что делает | | --- | --- | | `POST /api/external/message` | Отправить сообщение, получить ответ (JSON или поток SSE) | | `POST /api/external/media-message` | То же с файлом, `multipart/form-data` | | `POST /api/external/telegram/sent` | Для Telegram-бота, который сам отправляет ответы: `{"telegramChatId","messageIds","chatId"}` — какими сообщениями ушёл ответ из какого чата, чтобы ответ на них продолжил этот чат | | `GET /api/external/token`, `POST /api/external/token` | Посмотреть или выпустить токен (нужен вход) | ## Служебное {#service} | Метод и адрес | Что делает | | --- | --- | | `GET /api/health` | Проверка: `{"status":"ok","timestamp":"…","version":"0.2.9"}`. Без авторизации | | `POST /api/auth/login` | Вход: `{"username":"…","password":"…"}` → cookie сессии | ## Проекты {#projects} | Метод и адрес | Что делает | | --- | --- | | `GET /api/projects` | Список проектов | | `POST /api/projects` | Создать: `{"name","description","instructions"}` | | `GET`, `PUT`, `DELETE /api/projects/:id` | Прочитать, изменить, удалить проект | | `GET`, `PUT /api/projects/:id/context` | Контекст проекта (`context.md`) | | `GET`, `PUT /api/projects/:id/memory` | Память проекта (`memory.md`) | | `GET`, `PUT /api/projects/:id/model` | Модель проекта (`model.json`) | | `GET`, `DELETE /api/projects/:id/skills` | Навыки проекта. `DELETE` принимает `{"name"}` и удаляет этот навык вместе с прежними версиями, оставшимися после замены | | `POST /api/projects/:id/skills/upload` | Загрузить один навык файлом (multipart-форма: `file`, и `replace=1`, чтобы заменить установленный) | | `GET`, `PUT /api/projects/:id/mcp` | MCP-серверы проекта (`.mcp.json`) | Для контекста, памяти, навыков и MCP вместо `:id` можно подставить `none` — тогда запрос относится к оркестратору. Своей модели у оркестратора нет: он отвечает моделью воркспейса. ## Что агент выучил {#learning} | Метод и адрес | Что делает | | --- | --- | | `GET /api/learning` | Заметки, навыки, которые написал агент, и включено ли обучение | | `POST /api/learning` | `{"enabled":true\|false}`, либо добавить или убрать одну заметку: `{"action":"add","target":"user\|notes","content":"…"}`, `{"action":"remove","target":"user\|notes","text":"…"}` | ## Чаты {#chats} | Метод и адрес | Что делает | | --- | --- | | `POST /api/chat` | Отправить сообщение из интерфейса (поток) | | `GET /api/chat/history` | Список чатов или история одного чата | | `GET /api/chat/:id/stream` | Подключиться к ответу, который ещё пишется | | `POST /api/chat/:id/stop` | Остановить работу в чате | | `GET`, `POST`, `DELETE /api/chat/files` | Вложения чата | ## Файлы проекта {#files} | Метод и адрес | Что делает | | --- | --- | | `GET /api/files` | Содержимое папки | | `GET /api/files/content` | Текст файла | | `GET /api/files/download` | Скачать файл. С `inline=1` — открыть в браузере в изолированном режиме | | `GET /api/files/zip` | Папка (`path=`) или несколько файлов (повтори `path=`) одним `.zip`; `check=1` отвечает, что в него войдёт. Выше пределов — отказ 413 | | `GET /api/files/stat` | Какие из перечисленных путей ещё существуют | | `GET`, `POST /api/files/telegram` | Достижим ли Telegram; отправить один файл в твой чат | | `POST /api/files/upload` | Загрузить файлы и папки, `multipart/form-data` | | `DELETE /api/files` | Удалить файл или папку | | `GET`, `DELETE /api/files/versions` | [История файла](https://eggent.ai/r/docs/files.md#history) (`project`, `path`) или её удаление | | `GET /api/files/versions/content` | Текст версии `n` | | `GET /api/files/versions/download` | Версия `n` файлом | | `POST /api/files/versions/restore` | `{ project, path, n, force? }` — восстановить версию `n` новой версией | | `GET`, `POST /api/files/versions/usage` | Сколько занимает история; `{ "action": "clear", "olderThanDays" }` очищает её | | `GET /api/files/page-link` | Где показывается [страница](https://eggent.ai/r/docs/files.md#pages) (`project`, `path`, `mode=edit\|print`), на время | | `GET /api/files/page-element` | Выбранный на странице блок: название, строки, исходник (`sha`, `el`) | | `POST /api/files/page-edit` | `{ project, path, sha, edits }` — слова, изменённые на странице, записываются туда, откуда пришли | | `GET /api/files/page-print` | Файл, подготовленный к [сохранению в PDF](https://eggent.ai/r/docs/files.md#pdf) | Параметры загрузки: `project`, `path`, `files` (можно несколько), `relativePaths` (куда положить каждый файл, по порядку), `directories` (пустые папки), `conflict` — `skip` (по умолчанию), `overwrite` или `rename`. Один запрос — не больше 100 МБ, иначе ответ `413`. ```bash curl -X POST https://имя.cloud.eggent.ai/api/files/upload \ -b cookies.txt \ -F "project=my-project" \ -F "path=." \ -F "conflict=rename" \ -F "files=@./notes.md" ``` ## Доска задач {#board} Изменения требуют сессии с того же сайта и тела в JSON, как у маршрутов терминала. | Метод и адрес | Что делает | | --- | --- | | `GET /api/board` | Все карточки, стоит ли доска, какие карточки сейчас в работе; `?archived=1` — вместе с убранными | | `GET /api/board/summary` | Сколько карточек ждут тебя, работают и стоят в очереди | | `POST /api/board/cards` | Новая карточка: `title`, `body`, `projectId`, `after`, `review`, `start` | | `GET`, `PATCH`, `DELETE /api/board/cards/:id` | Одна карточка; `PATCH` правит её или перемещает: `{ "move": { "to": "inbox" \| "queued" \| "done" \| "archived" \| "unarchived", "position" } }` | | `POST /api/board/cards/:id/answer` | `{ "text" }` — ответ на вопрос карточки | | `POST /api/board/cards/:id/stop` | Остановить; карточка из очереди возвращается во «Входящие» | | `POST /api/board/start-all` | Все карточки «Входящих» (проекта `projectId`, если указан) — в очередь | | `POST /api/board/resume` | Дать доске продолжить после отказа сервиса моделей | ## Компания {#company} Только в воркспейсе, который входит в [компанию](https://eggent.ai/r/docs/company.md). Записи требуют сессии с того же сайта и JSON в теле. | Метод и адрес | Что делает | | --- | --- | | `GET /api/mail/contacts` | Люди компании и непрочитанное | | `GET /api/mail/thread` | Переписка с человеком (`with`, `before`, `limit`) | | `POST /api/mail/send` | `{ to, text, files?, replyTo? }` | | `POST /api/mail/read` | `{ with, upTo }` — отметить прочитанным | | `POST /api/mail/assign` | `{ messageId }` — открыть чат с агентом о сообщении | | `GET /api/mail/attachments/:id` | Файл из переписки | | `GET /api/shares` | Файлы, открытые тебе, и файлы, которые открыл ты | | `GET /api/shares/people` | Кому можно открыть файл | | `GET /api/shares/file` | Твой файл и кому он открыт (`project`, `path`) | | `POST /api/shares/share` | `{ project, path, people: [{ id, role }] }` — переданный список и есть все, кому открыт файл | | `GET /api/shares/:id`, `GET /api/shares/:id/text` | Общий файл: кому открыт и что в нём | | `GET`, `POST /api/shares/:id/content` | Файл; `{ baseSha, text }` меняет его текст поверх этой версии | | `POST /api/shares/:id/page-edit` | `{ sha, edits }` — слова, изменённые на общей странице | | `GET`, `POST /api/shares/:id/comments` | Комментарии; `{ body, quote?, anchor?, replyTo? }` | | `POST /api/shares/:id/comments/:comment/resolve`, `/delete` | Отметить решённым (`{ resolved }`) или удалить комментарий | | `POST /api/shares/:id/stop` | Закрыть доступ | | `GET /api/approvals` | Согласования: `box=waiting\|sent\|involved` | | `GET /api/approvals/file` | Твой файл и его согласование (`project`, `path`) | | `POST /api/approvals/send` | `{ project, path, approvers, note? }` — версия, которая в файле сейчас | | `GET /api/approvals/:id` | Одно согласование с кругами | | `POST /api/approvals/:id/decide` | `{ round, decision: "approve" \| "reject", comment? }` | | `POST /api/approvals/:id/cancel` | Снять с согласования | | `GET /api/approvals/:id/rounds/:round/file`, `/text` | Версия круга — файлом или текстом | ## Расписания {#schedules} | Метод и адрес | Что делает | | --- | --- | | `GET /api/pi-schedules` | Все задачи по расписанию во всех проектах и у оркестратора, с отметкой, на паузе ли задача и почему | | `POST /api/pi-schedules` | Изменить одну задачу: `{"action": "pause" \| "resume" \| "retime" \| "delete", "jobId": "…"}` (для `retime` ещё `schedule`) | --- # Устройство воркспейса > Какие папки и файлы составляют воркспейс 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/ # в компании: открытые тебе папки компании (без истории) │ └── / ├── 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/` как к секрету. --- # Частые проблемы > Что делать, если агент не отвечает, не видит файл, выбрал не ту модель, бот в Telegram молчит, расписание не сработало, загрузка падает или первое сообщение приходит с задержкой. Source: https://eggent.ai/r/docs/troubleshooting/ ## Агент не отвечает {#no-answer} - **Закончились кредиты.** Агент пришлёт сообщение со ссылкой на оплату. Проверь баланс на странице оплаты или спроси «сколько у меня осталось». См. [«Тарифы и баланс»](https://eggent.ai/r/docs/plans.md#out-of-credits). - **Заполнен диск.** Удали лишнее в панели **Файлы** — работа продолжится со следующего сообщения. См. [«Место на диске»](https://eggent.ai/r/docs/plans.md#storage). - **Закончился пробный период или тариф.** Вместо воркспейса открывается страница с тарифами. Данные сохранены. - **Ошибка провайдера на своём ключе.** Eggent покажет, что именно не так: адрес не отвечает, ключ отклонён или модели нет. Проверь ключ в **Настройки → Модели** или [вернись на Eggent AI](https://eggent.ai/r/docs/models.md#back). ## Первое сообщение приходит через 10 секунд {#slow-first} Воркспейс [спал](https://eggent.ai/r/docs/sleep.md) и просыпается. Это нормально и бывает только после долгого перерыва. ## Агент не видит файл {#file-not-visible} - Файл должен лежать **в текущем проекте** или быть прикреплён к **этому чату**. Файлы другого проекта агент видит, только если переключится туда. - Проверь, в каком проекте открыт чат: название проекта выделено в боковой панели. - Скажи явно: «прочитай `reports/q3.xlsx`». ## Отвечает не та модель {#wrong-model} - Строка слева от кнопки отправки показывает, какая модель ответит **на следующее** сообщение. - У проекта может быть своя модель. Проверь **Настройки → Модели**, область — проект. - Если сохранённая модель недоступна (провайдер отключён, модель закрыта на текущем тарифе), отвечает модель по умолчанию. ## Агент не может нажать кнопку на сайте или войти в кабинет {#no-browser} У агента нет браузера с экраном: он читает страницы как текст и работает с API. Если у сервиса есть API или MCP-сервер, подключи его. См. [«Что умеет агент»](https://eggent.ai/r/docs/capabilities.md#limits). ## Бот в Telegram молчит {#telegram-silent} - Бот отвечает только в **личных сообщениях**. - Для своего бота: твой `user_id` должен быть в списке разрешённых — отправь боту `/code <код>` с кодом из **Настройки → Мессенджеры**. - Проверь, что бот активен в **Настройки → Мессенджеры**. Если токен менялся, вставь новый и нажми **Активировать бота**. См. [«Telegram»](https://eggent.ai/r/docs/telegram.md#troubleshooting). ## Расписание не сработало {#schedule-missed} - Проверь время следующего запуска в **Настройки → Расписания**: время считается по часам сервера (обычно UTC). - Пропущенные запуски не повторяются: если в нужный момент сервер был выключен, задача выполнится в следующий раз. - Если закончились кредиты, запуск не сможет выполниться, а после трёх отказов подряд задача встаёт на паузу. См. [«Задача, которая не может выполниться»](https://eggent.ai/r/docs/schedules.md#paused). - Посмотри чат, где создано расписание: результат и ошибки приходят туда. ## Ответ в Telegram завис {#telegram-stuck} Отправь `/reset`: он остановит ответ, который, кажется, завис, и сохранит разговор. См. [«Ответ, который завис»](https://eggent.ai/r/docs/telegram.md#stuck). ## `@проект` ответили как на обычное сообщение {#ask-project} Название после `@` не совпало ни с одним проектом, или после названия ничего нет. Сверь написание со списком проектов: заглавные буквы, дефисы и «ё»/«е» не важны. Не работает и в [лёгком чате](https://eggent.ai/r/docs/chats.md#modes), и в общем публичном чате. Если проект поработал, но ему чего-то не хватило — например, подключённого сервиса, — один раз открой собственный чат проекта и разреши сервис там. См. [Спросить проект](https://eggent.ai/r/docs/projects.md#ask). ## Загрузка файла не проходит {#upload-fails} - Один файл — не больше 100 МБ. - Проверь место на диске. - На своём сервере за прокси: подними лимит тела запроса у прокси до 100 МБ. См. [«Обратный прокси»](https://eggent.ai/r/docs/self-host-config.md#reverse-proxy). ## Не работает микрофон {#microphone} Браузер даёт доступ к микрофону только по `https://` или на `localhost`. Проверь разрешение на микрофон в настройках сайта в браузере. ## Забыл пароль {#password} Нажми **«Забыли пароль?»** на странице входа и введи почту, на которую зарегистрировано пространство: придёт письмо со ссылкой для каждого пространства с этим адресом, она работает один раз и один час. Регистрировался через Telegram? `/login` в боте впускает без пароля. Письмо не пришло? Загляни в спам, потом напиши в [поддержку](https://eggent.ai/r/docs/account.md#support). Подробнее — [Забыл пароль](https://eggent.ai/r/docs/account.md#reset). ## Ничего не помогло {#support} Напиши в поддержку: Telegram [@youriisupport](https://t.me/youriisupport) или [aiiszdes@gmail.com](mailto:aiiszdes@gmail.com). Укажи адрес воркспейса, что делал и что увидел — скриншот сильно ускоряет ответ. --- # Для агентов > Как языковой модели или агенту читать эту документацию — машинные версии страниц, llms.txt, устойчивые адреса и какие страницы отвечают на какие вопросы о Eggent. Source: https://eggent.ai/r/docs/for-agents/ Эта документация написана так, чтобы её могли читать не только люди, но и агенты, в том числе сам Eggent, когда ему нужно узнать о себе подробнее. ## Машинные версии {#machine-readable} | Что | Адрес | | --- | --- | | Список всех страниц с описаниями | [`/r/docs/llms.txt`](/r/docs/llms.txt) | | Вся документация одним файлом | [`/r/docs/llms-full.txt`](/r/docs/llms-full.txt) | | Одна страница в Markdown | `/r/docs/<тема>.md`, например [`/r/docs/schedules.md`](/r/docs/schedules.md) | | То же на английском | [`/docs/llms.txt`](/docs/llms.txt), `/docs/<тема>.md` | | Указатель на оба языка | [`/llms.txt`](/llms.txt) | У каждой HTML-страницы в `` есть `` со ссылкой на её Markdown-версию. ## Устойчивые адреса {#stable-urls} - Адрес страницы одинаков в обоих языках: `/docs/<тема>/` и `/r/docs/<тема>/`. - У разделов внутри страницы — постоянные якоря на латинице, одинаковые в обоих языках: `/r/docs/chats/#modes` и `/docs/chats/#modes`. - Ссылки внутри Markdown-версий ведут на Markdown-версии других страниц. ## Какая страница отвечает на какой вопрос {#map} | Вопрос | Страница | | --- | --- | | Что такое проект, оркестратор, навык, память | [concepts](https://eggent.ai/r/docs/concepts.md) | | Какие инструменты у агента и их параметры | [agent-tools](https://eggent.ai/r/docs/agent-tools.md) | | Что агент умеет и чего не умеет | [capabilities](https://eggent.ai/r/docs/capabilities.md) | | Режимы чата, остановка, уточнения на ходу | [chats](https://eggent.ai/r/docs/chats.md) | | Как создать или изменить расписание, формат времени | [schedules](https://eggent.ai/r/docs/schedules.md) | | Как подключить Telegram, каналы, коды доступа | [telegram](https://eggent.ai/r/docs/telegram.md) | | Модели, свой ключ, модель проекта | [models](https://eggent.ai/r/docs/models.md) | | Готовые навыки и карточки | [skill-catalog](https://eggent.ai/r/docs/skill-catalog.md) | | Как писать навыки | [skills](https://eggent.ai/r/docs/skills.md) | | Где что лежит на диске | [workspace-layout](https://eggent.ai/r/docs/workspace-layout.md) | | Тарифы, кредиты, диск | [plans](https://eggent.ai/r/docs/plans.md) | | Внешний API и потоковые ответы | [external-api](https://eggent.ai/r/docs/external-api.md) | | Частые проблемы и решения | [troubleshooting](https://eggent.ai/r/docs/troubleshooting.md) | ## Советы агенту Eggent {#for-eggent} - Если пользователь спрашивает, как что-то устроено в Eggent, сначала прочитай подходящую страницу, а не угадывай. - Отвечая, опирайся на свои инструменты: их точные имена и параметры есть в твоём списке инструментов, а описание — в [справочнике](https://eggent.ai/r/docs/agent-tools.md). - Названия экранов и кнопок бери из документации: они совпадают с интерфейсом на языке пользователя. - Документация описывает облако и открытое ядро. Если воркспейс свой (нет Eggent AI, нет общего бота), облачные разделы к нему не относятся.