# Life OS — full user documentation Canonical source: https://docs.archik.tech Generated from the public user documentation. UI labels are in Russian. --- Source: https://docs.archik.tech/agents/activity # Активность и подтверждения ## Активность конкретного подключения Агенты → Нужное подключение На странице показаны число вызовов, ошибок и время последней активности. В разделе **Активность** раскройте вызов, чтобы увидеть входные данные, результат или ошибку и длительность. ## Общий журнал Активность Журнал показывает инструмент, модуль, клиента, статус и время. Содержимое ваших данных в общей таблице не отображается. ## Подтверждения Чувствительное действие не выполняется молча. Во встроенной панели агента появляется карточка с названием действия и аргументами: - **Отмена** — запретить действие; - **Подтвердить** — разрешить именно показанный вызов. Проверяйте получателя, workspace и необратимые параметры до подтверждения. --- Source: https://docs.archik.tech/agents/connect # Подключить Claude или Codex ## Создать MCP-подключение Агенты → Добавить 1. Введите понятное **Название**, например `Claude Outreach`. 2. Выберите **Роль агента**. 3. Нажмите стрелку справа от роли, чтобы посмотреть включённые инструменты. 4. Вернитесь по хлебным крошкам **Роли**. 5. Нажмите **Создать**. 6. Нажмите **Копировать** рядом с выданным MCP-адресом. Этот адрес привязан к выбранному workspace и роли. ## Claude 1. Откройте **Customize → Connectors**. 2. Нажмите **+ → Add custom connector**. 3. Введите название и вставьте MCP-адрес. 4. Нажмите **Add**, затем **Connect**. 5. Войдите в Life OS и подтвердите доступ. 6. В новом чате включите коннектор через кнопку **+**. ## Codex Добавьте MCP-сервер в настройках Codex, используя скопированный URL. Откройте ссылку авторизации, войдите в Life OS и подтвердите подключение. После этого начните новую сессию, чтобы клиент заново получил список инструментов. ::: tip Проверка Попросите агента вызвать `platform_whoami` и назвать активный workspace, пользователя и роль подключения. ::: --- Source: https://docs.archik.tech/agents/ # Работа с агентами В Life OS есть два разных способа работы с агентом. ## Агент внутри платформы Нажмите кнопку справа, чтобы открыть боковую панель. Агент видит текущий workspace и открытую страницу, может работать с разрешёнными инструментами и попросит подтвердить чувствительное действие. В верхней части панели: - **История** — предыдущие диалоги; - **Новый диалог** — чистая сессия; - **Закрыть агента** — свернуть панель. ## Внешний агент через MCP Claude, Codex или другой MCP-клиент подключается по отдельному адресу. Для каждого подключения задаются название, workspace и роль с конкретными инструментами. [Подключить Claude или Codex →](/agents/connect) --- Source: https://docs.archik.tech/agents/roles # Роли и инструменты Роль агента — сохранённый набор инструментов. Она определяет не инструкции модели, а реальные возможности подключения. ## Посмотреть роли Настройки → Роли агента В списке видно количество инструментов и подключений, использующих роль. ## Создать роль 1. Нажмите **Создать**. 2. Укажите название и назначение. 3. Раскройте нужный модуль. 4. Отметьте весь модуль или отдельные инструменты. 5. Нажмите **Сохранить**. Один профиль можно использовать в нескольких MCP-подключениях. ## Изменить роль Откройте меню действий у роли и выберите **Изменить**. Изменение влияет на подключения, которые используют эту роль. Перед удалением роли проверьте счётчик активных подключений. --- Source: https://docs.archik.tech/agents/workspaces # Несколько workspace в одном агенте Для предсказуемой работы используйте отдельное scoped-подключение на каждый workspace. Тогда агент физически не сможет случайно выполнить действие в другом пространстве. Если одному агенту нужен доступ сразу к нескольким workspace, используйте общий MCP-вход: ```text https://mcp.archik.tech/mcp ``` Во время авторизации выберите разрешённые workspace и роль инструментов для каждого. В сессии агент должен: 1. вызвать `platform_list_workspaces`; 2. выбрать пространство через `platform_change_workspace`; 3. проверить результат через `platform_current_workspace`; 4. только затем выполнять рабочие вызовы. Смена действует на последующие вызовы этой MCP-сессии. ::: warning Не поручайте работу, пока агент явно не назвал активный workspace. ::: --- Source: https://docs.archik.tech/automations/create # Создать процесс через агента Для этой работы агенту нужна роль с инструментами **n8n Автоматизации** и workflow-builder skill. ## Что написать агенту Опишите результат обычными словами. Не нужно проектировать ноды самостоятельно. > Создай процесс, который каждые 15 минут читает выбранные источники, отбирает > подходящие записи, сохраняет их в подключённую CRM и показывает лучшие > варианты через выбранный интерфейс. Перед отправкой сообщения обязательно > запрашивай подтверждение. Сам изучи доступные подключения, задай мне только > необходимые вопросы, собери процесс, протестируй его и включи после успешной > проверки. ## Что должен сделать агент 1. Прочитать инструкции Workflow Builder. 2. Найти доступные события, действия и аккаунты. 3. Задать вопросы только о выборе источника, назначения, расписания и границы подтверждения. 4. Создать неактивный черновик в n8n. 5. Получить bindings для внешних действий без передачи секретов. 6. Подключить push-события или расписание. 7. Проверить сохранённый граф. 8. Провести реальный E2E-тест с безопасными тестовыми данными. 9. Включить workflow только после успеха. 10. Сообщить ID workflow, execution и оставшиеся ручные шаги. ## События Telegram - **Telegram Account · New message** — новое личное сообщение, полученное подключённым пользовательским аккаунтом. - **Telegram Bot · New message** — сообщение, отправленное боту. - **Telegram Bot · Inline button pressed** — нажатие callback-кнопки под сообщением бота. Это push-события. Для них не нужен цикл polling или постоянно работающая wait-нода. ::: warning Если агент просит вставить API-ключ прямо в ноду n8n, остановите его. Внешние действия должны выполняться через bindings Life OS. ::: --- Source: https://docs.archik.tech/automations/human-tasks # Human Tasks Human Task — это решение или ввод данных, которых автоматизация ждёт от человека. Одна задача может появиться в веб-интерфейсе, мессенджере или другом подключённом канале, а ответ возвращается в процесс в одном формате. ## Уровни интерфейса ### L1 basic Базовые поля, текст и действия. Такая задача отображается даже обычным последовательным диалогом. ### L2 conditional Видимость, доступность и обязательность полей зависят от предыдущих ответов. Условия описываются JSONLogic. Если канал не поддерживает их нативно, автор процесса обязан заранее выбрать поддерживаемый fallback. ### L3 custom Задача использует зарегистрированный компонент. У компонента есть отдельная версия, список поверхностей, а также JSON Schema входа и ответа. ## Fallback - `web_app_button` — открыть защищённую веб-форму; - `sequential_messages` — собрать поля последовательными сообщениями; - `reject_surface` — не использовать несовместимую поверхность. Платформа проверяет это до публикации процесса по capabilities, объявленным surface provider. Ядро не содержит специальных правил для Telegram или другого конкретного продукта. ## Неизменяемые версии Изменение типа создаёт новую версию. Каждая уже созданная задача хранит замороженную копию документа, response schema, tier, fallback и точной версии custom component. Обновление типа не ломает задачи, ожидающие ответа. ## Работа в интерфейсе Откройте **Автоматизации**, выберите процесс и перейдите во вкладку **Решения**. Там находятся только запросы, без ответа на которые процесс не может продолжить работу. Если канал не поддерживает форму нативно, кнопка **Открыть форму** ведёт прямо на это решение в Life OS. ## Для агента 1. `interactions_get_instructions`; 2. `interactions_surface_catalog`; 3. при необходимости `interactions_register_component`; 4. `interactions_define_task_type`; 5. `interactions_create_task`. Для n8n агент передаёт `source_type: n8n.workflow`, `$workflow.id` как `source_id` и `$execution.id` как `source_run_id`. Уведомления и журнальные сообщения не создаются как Human Tasks. Несовместимость нужно исправлять выбором поверхности или fallback, а не обходом валидации. --- Source: https://docs.archik.tech/automations/ # Как устроены автоматизации Life OS использует n8n как исполняемый runtime. Платформа не создаёт второй собственный движок workflow. ```text Запрос пользователя ↓ Агент изучает доступные возможности ↓ Создаёт workflow в n8n ↓ Life OS выдаёт безопасные bindings ↓ Тестовый execution ↓ Публикация ``` Telegram, CRM, таблицы, отчёты и базы знаний — сменные коннекторы. Один и тот же процесс можно подключить к другому интерфейсу или хранилищу без переписывания его бизнес-логики. ## Где смотреть Автоматизации → Выбрать процесс На карточке процесса видны состояние и количество решений, которых он ждёт. Внутри доступны обзор, запуски и решения. Кнопка **Открыть в n8n** ведёт к полному графу, входам и выходам каждой ноды. --- Source: https://docs.archik.tech/automations/state # Состояние процесса State хранит этап диалога или процесса между запусками n8n. Например, бот может помнить, что у одного пользователя он ждёт имя, а у другого — подтверждение. Вместо таблицы и большого набора `If` workflow отправляет событие в `state_transition` и получает: - предыдущее и новое состояние; - сохранённый context; - номер версии; - список effects, которые нужно выполнить дальше. Повтор одного `event_id` безопасен: переход не выполнится второй раз. Состояния изолированы по workspace, machine и subject. ## В n8n Используйте: - **Life OS Trigger** для входящего события; - **Life OS Action** для перехода состояния и внешних действий; - обычный **Switch** для маршрутизации возвращённых effects. Агент сам создаёт machine, action bindings и event subscription. Ключи Telegram, CRM и других систем в workflow не помещаются. --- Source: https://docs.archik.tech/automations/testing # Проверка и запуск Конфигурация нод сама по себе не доказывает, что workflow работает. ## Перед публикацией Агент должен проверить: - в графе нет оборванных обязательных связей; - выбран правильный аккаунт и получатель; - расписание содержит timezone; - повтор одного external ID не создаёт дубликат; - действие с подтверждением невозможно выполнить раньше подтверждения; - тест создал новый execution; - конечный сервис действительно получил тестовый объект или сообщение. Тестовые записи и сообщения должны начинаться с `[E2E-WORKFLOW]`. ## После запуска Откройте workflow в n8n и перейдите к **Executions**. Успешный запуск должен содержать фактические входы и выходы нод, а не только статус планировщика. Если тест не прошёл, workflow должен остаться неактивным. Агент исправляет минимальную причину и повторяет проверку не более трёх раз. --- Source: https://docs.archik.tech/connections/ # Подключить сервис Подключение — это установленный в workspace адаптер внешнего сервиса. Один адаптер может давать агенту инструменты, события для автоматизаций, модели AI или интерфейс. Ключи остаются на сервере и используются внутри адаптера. Подключения → Карточка сервиса Галерея показывает только сервисы, разрешённые в текущем workspace. На карточке виден статус **Подключить** или **Подключено**. После открытия карточки Life OS предложит подходящий способ: - переход на страницу OAuth; - QR-код; - одноразовый код и ссылка; - форма с токеном или параметрами; - выбор одного из нескольких методов. Следуйте инструкции на экране. После успеха появится статус **Подключено**, и интеграция станет доступна разрешённым агентам. ::: info Подключение сервиса не выдаёт его всем агентам автоматически. Инструменты определяются ролью каждого MCP-подключения. ::: --- Source: https://docs.archik.tech/connections/manage # Управление подключениями Подключения → Нужный сервис У подключённого аккаунта показаны имя, email или username. - **Добавить ещё** — подключить дополнительный аккаунт того же сервиса. - **Отключить** — отозвать доступ конкретного аккаунта. Если кнопки **Отключить** нет, подключение управляется администратором или внешним сервисом. ## Как выбрать аккаунт Если подключено несколько аккаунтов, агент должен сначала запросить список доступных подключений и выбрать нужное. Не передавайте ему токен вручную. --- Source: https://docs.archik.tech/connections/secrets # Ключи и секреты Настройки открываются через меню workspace в левом верхнем углу. ## Провайдеры моделей Настройки → Личные провайдеры Личный ключ доступен только вам. В разделе **Провайдеры пространства** ключ сохраняется для workspace и управляется его администраторами. При добавлении провайдера Life OS загружает список доступных моделей и проверяет подключение до сохранения. ## Пароли и секреты Настройки → Пароли и секреты Нажмите **Добавить** для ручного сохранения или **Импорт** для CSV из Google Password Manager. Для общих секретов используйте **Секреты пространства**. Секрет используется сервером внутри разрешённого инструмента. Его значение не возвращается агенту и не должно попадать в workflow. --- Source: https://docs.archik.tech/connections/telegram-bot # Telegram Bot Подключения → Telegram Bot Подключение даёт агенту полный Telegram Bot API: сообщения и медиа, inline- и reply-клавиатуры, опросы, реакции, команды, меню, платежи, inline mode, Telegram Business и кнопки Web App. ## Подключить бота 1. Создайте бота в [@BotFather](https://t.me/BotFather) и скопируйте token. 2. Откройте **Подключения → Telegram Bot → Добавить**. 3. Назовите подключение и вставьте token. 4. При создании MCP-подключения включите Telegram-инструменты в нужную роль. Token хранится в подключении пользователя. Workflow и агент работают с ботом, но не получают сам token. ## Как агент вызывает Bot API Вместо сотен почти одинаковых инструментов агент получает небольшой динамический набор: 1. `search_methods` — находит нужный метод; 2. `describe_method` — возвращает актуальную схему параметров; 3. `invoke_read`, `invoke_write` или `invoke_destructive` — выполняет метод в соответствующей категории безопасности. Например, для сообщения с inline-кнопками агент описывает `sendMessage`, затем передаёт стандартный Telegram `reply_markup`. Тот же механизм работает для любого другого метода Bot API. ::: warning Удаление сообщений, блокировки, refunds и другие необратимые действия идут через отдельный destructive-инструмент и требуют подтверждения. ::: ## Файлы Передавайте существующий Telegram `file_id` или публичный HTTPS URL. Для небольшой загрузки агент также может использовать `$file_base64` с именем файла. Временный файл на сервере при этом не создаётся. ## Входящие события Workflow получает исходный `raw_update` без потери полей. Поэтому ему доступны не только текстовые сообщения, но и документы, фото, видео, голосовые, callback query, реакции, опросы, inline query, платежи и business updates. ## Что остаётся у BotFather Создание и удаление самого бота, получение token и отдельные настройки BotFather остаются в Telegram. Mini App тоже является отдельным веб-приложением; бот открывает его кнопкой `web_app`. --- Source: https://docs.archik.tech/help/agent # Справка для агента Эта документация — источник истины по пользовательскому интерфейсу Life OS. ## Как отвечать на вопросы 1. Сначала определите, о каком workspace и разделе говорит пользователь. 2. Найдите наиболее узкую страницу документации. 3. Используйте точные подписи кнопок из инструкции. 4. Дайте короткий путь вида: `Название workspace → Настройки → Люди → Пригласить`. 5. Если действие зависит от роли или установленного модуля, скажите об этом. 6. Приложите прямую ссылку на страницу. Не придумывайте отсутствующую кнопку и не переносите инструкции внешнего сервиса на Life OS. ## Машиночитаемый индекс - [llms.txt](/llms.txt) — краткая карта разделов. - [llms-full.txt](/llms-full.txt) — полный текст пользовательской справки. ## Основные адреса | Назначение | Адрес | |---|---| | Life OS | `https://mcp.archik.tech/home` | | Документация | `https://docs.archik.tech` | | Общий MCP | `https://mcp.archik.tech/mcp` | Для workflow используйте правила [Workflow Builder](/automations/create) и проверку [перед публикацией](/automations/testing). --- Source: https://docs.archik.tech/help/ # Частые вопросы ## Почему я не вижу CRM, Знания или Автоматизации? Пункт показывается только если соответствующий модуль активен в текущем workspace. Проверьте пространство и обратитесь к его администратору. ## Почему агент не видит подключённый сервис? Сервис и инструмент агента — разные уровни. Проверьте, что аккаунт подключён, а нужный инструмент включён в роли MCP-подключения. ## Где посмотреть, что сделал агент? Откройте **Агенты**, затем нужное подключение. В разделе **Активность** видны вызовы, результаты, ошибки и длительность. ## Где находятся созданные документы? Готовые результаты находятся в **Отчётах**. Рабочие инструкции и проверенные материалы — в **Знаниях**. ## Можно ли подключить несколько аккаунтов одного сервиса? Если коннектор это поддерживает, на его странице появится кнопка **Добавить ещё**. ## Как отозвать доступ Claude или Codex? Откройте **Агенты** и нажмите кнопку удаления у нужного подключения. Его scoped MCP-адрес немедленно перестанет работать. --- Source: https://docs.archik.tech/help/troubleshooting # Решение проблем ## Authentication expired 1. Удалите коннектор из Claude или Codex. 2. В Life OS проверьте, что MCP-подключение ещё существует. 3. Скопируйте адрес заново. 4. Добавьте коннектор и повторите авторизацию. 5. Начните новый чат или сессию. ## Агент не видит инструменты Проверьте: - коннектор включён в текущем чате; - роль содержит нужный инструмент; - модуль установлен в активном workspace; - после изменения роли начата новая сессия. Попросите агента вызвать `platform_whoami`. ## Агент работает не в том workspace Для scoped-подключения создайте адрес из нужного workspace. Для общего подключения попросите вызвать `platform_list_workspaces`, `platform_change_workspace`, затем `platform_current_workspace`. ## Подключение сервиса зависло Вернитесь к списку **Подключения**, откройте карточку заново и повторите вход. Для QR-кода или одноразового кода убедитесь, что предыдущая попытка не истекла. ## Workflow пуст или не запускается Откройте его в n8n и проверьте: - workflow опубликован; - trigger активен; - появилась новая запись в **Executions**; - последняя нода не завершилась ошибкой; - action binding и subscription не были отозваны. --- Source: https://docs.archik.tech/ --- Source: https://docs.archik.tech/reports/ # Отчёты Отчёты Отчёты создаются и публикуются агентами. На странице workspace они автоматически собираются в папки по slug: например, `sales/research/market` окажется в папке **sales**, затем **research**. ## Открыть отчёт Нажмите на папку, затем на название документа. Хлебные крошки показывают текущий путь. Кнопка возврата **Все отчёты** возвращает в раздел workspace. ## Что умеет агент При наличии инструментов отчётов агент может: - создать и опубликовать Markdown-отчёт; - дополнить существующий документ без полной перезаписи; - переименовать или перенести файл и папку; - удалить отчёт в архив; - вернуть постоянную или публичную ссылку. Удалённые документы хранятся в архиве 30 дней. Если slug занят, платформа создаёт уникальный вариант и сообщает фактический адрес. ::: info Отчёты — готовые результаты работы. Рабочие инструкции и профили команды лучше хранить в разделе **Знания**. ::: --- Source: https://docs.archik.tech/settings/ # Настройки Название workspace → Настройки Настройки открываются во всплывающем окне. Разделы слева делятся на личные и относящиеся к текущему пространству. ## Аккаунт - **Профиль** — имя и данные пользователя. - **Личные провайдеры** — ваши ключи AI-провайдеров. - **Пароли и секреты** — личное защищённое хранилище. ## Пространство - **Основное** — название и постоянный адрес workspace. - **Люди** — участники, роли и приглашения. - **Провайдеры пространства** — общие AI-провайдеры. - **Подключения** — каталог и конфигурация разрешённых коннекторов. - **Секреты пространства** — общие защищённые credentials. - **Роли агента** — наборы инструментов для MCP-подключений. - **Агент** — модель и поведение встроенной боковой панели. На телефоне вместо бокового списка используется выпадающий список разделов. Закройте окно крестиком или перейдите на главную. --- Source: https://docs.archik.tech/start/first-run # Первый запуск Онбординг появляется у нового пользователя один раз. Он не запускается заново при создании или открытии другого workspace. ## Три шага ### 1. Подключить своего агента Выберите Claude или Codex, откройте раздел **Агенты**, создайте подключение и вставьте его MCP-адрес в клиент. ### 2. Выбрать серверного агента Для исследований можно подключить Codex CLI через ChatGPT или OpenAI API key, либо Claude Code через Anthropic API key. ### 3. Запустить первое исследование Введите тему. Отдельный агент выполнит работу и сохранит результат как отчёт с постоянной ссылкой. В правом верхнем углу онбординга есть кнопка **Пропустить**. Вернуться к исследованию позже можно с главной страницы кнопкой **Исследовать**. --- Source: https://docs.archik.tech/start/ # Что такое Life OS Life OS — единая точка управления рабочими пространствами, подключёнными сервисами и агентами. Вы работаете через человека или AI-агента, а платформа отвечает за доступы, инструменты и границы каждого workspace. ## Что находится внутри