Неполадки и FAQ

Здесь собраны частые вопросы и разбор типичных неполадок. Если вы только начинаете, пройдите Быстрый старт: его раздел «Если не работает» покрывает первые шаги.

Подключение и установкаКопировать ссылку на раздел

Журнал не принимает задачуКопировать ссылку на раздел

Проект не зарегистрирован. Скажите агенту в папке репозитория: «Зарегистрируй этот проект в actari». Он вызовет resolve_project, а если ничего не найдётся, register_project с именем проекта и путём к папке. Пока проект не зарегистрирован, журнал отказывает на любую задачу и любой артефакт.

MCP-сервер не стартуетКопировать ссылку на раздел

Нужен Node.js 22.5 или новее: сервер использует встроенный node:sqlite. Проверьте версию командой node --version и обновите Node, если она старее.

Подключение отклоняетсяКопировать ссылку на раздел

Токен «только чтение» для подключения не подходит: connect и sync отвечают 403 read-only token. Выпустите токен с правом записи на странице «MCP-токены» и повторите connect.

Облако на своём сервере с корпоративным сертификатомКопировать ссылку на раздел

Если адрес облака использует сертификат внутреннего центра, connect не запишет настройки: рукопожатие TLS не проходит. Передайте Node корневой сертификат переменной окружения, например NODE_EXTRA_CA_CERTS=/etc/ssl/certs/acme-root.pem, и повторите подключение.

Сервер работает, но агент не видит новых инструментовКопировать ссылку на раздел

После обновления пакета перезапустите сессию агента: старая копия сервера не знает новых возможностей.

В боковой панели облака «Подключить агента»Копировать ссылку на раздел

Ни один журнал ещё не отправлял записи в это пространство. Проверьте, что connect выполнен успешным ответом, а проект привязан к пространству (sync_scope {}). Строка «Агенты давно не выходили» означает обратное: связь была, но давно, и достаточно запустить агента и сделать sync.

Облако пустоКопировать ссылку на раздел

В облаке пусто, хотя агент отчиталсяКопировать ссылку на раздел

Возможные причины:

• Несколько пространств. Токен личный и покрывает все ваши пространства, поэтому журнал нужно разложить по ним. Вызовите sync_scope {}: он покажет, что и куда уедет. Привяжите проект: sync_scope { workspace: "acme", projects: ["acme-web"] }. Пока проекты не привязаны, а пространств несколько, ничего не отправляется.
• Облако не подключено. Без connect журнал работает локально. Смотрите там вызовом list_tasks.
• Другой проект. Задача принадлежит проекту, который не привязан к нужному пространству.

Проверить, доходят ли записи, можно во вкладке «Агенты» настроек пространства: там видны подключённые журналы и время последнего синка.

Задача принята, а карточка не в «Готово»Копировать ссылку на раздел

Если в пространстве включён учёт выпусков, принятая карточка стоит в колонке «Принято» и входит в открытый релиз, пока релиз не выпущен. Релиз выпускается кнопкой «Выпустить» на странице «Релизы» или записью record_release после выкатки, см. Выпуски.

Работа с задачамиКопировать ссылку на раздел

Вызов отвечает «недопустим из статуса»Копировать ссылку на раздел

Журнал проверяет порядок статусов. accept и request_rework работают только из REPORTED, submit_report только из DELEGATED, delegate из DRAFT или REWORK, mark_failed из DELEGATED, REPORTED и REWORK. Сообщение называет допустимые статусы. Схема переходов — на странице Журнал и статусы.

accept требует доказательствоКопировать ссылку на раздел

Политика проекта включила правило «принять можно только с доказательством». Передайте в evidence хэш коммита, ссылку на прогон или вывод тестов. Как настроить правило — на странице Политика проекта.

Нельзя отказаться от задачи, которая уже в работеКопировать ссылку на раздел

drop_task закрывает только черновик. Для задачи в работе используйте mark_failed с причиной.

Закрытую задачу нельзя открыть зановоКопировать ссылку на раздел

Закрытую задачу не возвращают. Заведите новую и свяжите со старой: link_tasks { from_task_id, to_task_id, kind: "continues" }.

Сервер отказывает по задаче из облакаКопировать ссылку на раздел

Человек мог отменить намерение, закрыть его, забрать себе или поменять критерии. Вызовите intent_status { task_id }: он покажет состояние и причину. Если агент уже взял намерение, но передумал, release_intent вернёт его в очередь, при условии что живых задач по нему нет.

take не берёт намерениеКопировать ссылку на раздел

Намерение чужое или отменённое, либо его фича не «в работе». В ответе приходит причина. Убедитесь, что в облаке у задачи нажато «В работу».

Агент сам принимает свою работуКопировать ссылку на раздел

Так быть не должно. Скилл feature требует, чтобы проверяющий был другим: субагентом без контекста автора или вами. Если вы видите иное, проверьте, какой скилл подключён, и политику проекта.

ПоискКопировать ссылку на раздел

Поиск не находит нужную задачуКопировать ссылку на раздел

search_precedents сравнивает слова по основам на русском и английском, поэтому формы слова не важны, но сами слова должны встречаться в задании, отчёте или артефакте. Служебные заметки (acceptance:, release:, released:, brief:, progress:) в поиск не попадают. Сузить поиск до проекта помогает параметр project.

Уходят ли тексты журнала куда-то при поискеКопировать ссылку на раздел

По умолчанию нет: поиск идёт по словам и работает на вашей машине. Смысловой поиск по векторам включается вручную и только если заданы обе вещи: ACTARI_SEARCH_EMBEDDINGS=on и адрес сервиса эмбеддингов OPENAI_EMBEDDING_BASE_URL с моделью OPENAI_EMBEDDING_MODEL. С включённым режимом тексты задач, артефактов и инцидентов отправляются в этот сервис для расчёта векторов. Одних переменных сервиса без переключателя недостаточно.

Self-hostКопировать ссылку на раздел

Облако не открывается после смены портаКопировать ссылку на раздел

Меняйте оба значения: ACTARI_PORT и ACTARI_URL в .env. Адрес ACTARI_URL должен совпадать с тем, что вы вводите в браузере.

После docker compose down -v все вышли из системыКопировать ссылку на раздел

Так и задумано: команда стирает базу и секреты, сессии недействительны, а ключи AI, сохранённые в пространствах, нечитаемы. Без -v данные и секреты сохраняются. Подробности — на странице Self-host.

Смена пароля Postgres не действуетКопировать ссылку на раздел

Пароль применяется при создании базы. Чтобы сменить его на уже созданной базе, придётся пересоздать её командой docker compose down -v, потеряв данные.

Как написать намКопировать ссылку на раздел

Как отправить идею, проблему или вопросКопировать ссылку на раздел

Откройте меню пользователя в левом нижнем углу и выберите «Обратная связь», затем нажмите «Новое обращение». Выберите, о чём пишете, — идея, проблема или вопрос, — опишите суть и при желании приложите скриншот (png, jpeg, webp или gif до 5 МБ). Быстрее всего — через палитру команд: ⌘K и «Новое обращение». Вместе с обращением мы видим ваше имя, почту, пространство и страницу, с которой вы писали.

Где увидеть ответКопировать ссылку на раздел

Ответ приходит письмом на почту аккаунта и виден в переписке на странице «Обратная связь». Если ответ вы ещё не открыли, у пункта меню горит точка. Отвечать можно в той же переписке: вопрос вернётся к нам как новое сообщение, в том числе в закрытом обращении.

Не вижу пункта «Обратная связь»Копировать ссылку на раздел

Раздел появляется, когда на сервере задан ACTARI_SUPER_ADMIN_EMAILS — адрес владельца, который читает обращения. На собственном сервере без этой переменной раздела нет.

Где данныеКопировать ссылку на раздел

Журнал лежит в ~/.actari/journal.db, путь меняется переменной ACTARI_DB. Рядом хранятся настройки синка, политика и состояние отправки. Облако получает копию журнала и ничего в нём не меняет. Журнал работает и без облака: цикл целиком идёт локально, а облако добавляет доску, общий вид для команды и ленту выпусков.