---
url: /ru/guides/acp.md
---
# Agents / ACP

Memoh может подключить Bot к ACP-совместимым агентам для программирования. ACP-агенты — это внешние рабочие процессы написания кода: они работают из чат-пространства Bot, но держат свои сессии отдельно от обычных разговоров chat и discuss.

В комплекте с Memoh идут два профиля агентов: **Codex** и **Claude Code**. Считайте их поддерживаемыми путями настройки, а не единственными возможными ACP-совместимыми агентами на будущее.

ACP-агенты выполняются внутри контейнерного рабочего пространства Bot, поэтому Bot должен использовать контейнерный бэкенд рабочего пространства.

***

## Порядок настройки

1. Откройте страницу **Detail Page** нужного Bot и перейдите на вкладку **Agents**.
2. Каждый агент показан отдельной строкой с переключателем. Щёлкните по строке, чтобы открыть его настройки.
3. Выберите режим настройки и заполните поля, которые требует этот агент.
4. Сохраните, затем запустите включённого агента из чат-пространства.

Строка показывает одно из трёх состояний: **Needs setup** (включён, но не хватает учётных данных), **Disabled** или зелёная точка (включён и готов).

### Режимы настройки по агентам

| Агент | API Key | OAuth | Self-managed |
|-------|---------|-------|--------------|
| **Codex** | ✅ | ✅ вход через ChatGPT по коду устройства | ✅ |
| **Claude Code** | ✅ | ✅ вставьте токен из `claude setup-token` | ✅ |

**Self-managed** означает, что Memoh запускает агента с конфигурацией, которую вы поддерживаете сами внутри рабочего пространства.

### Авторизация Codex по коду устройства

В настройках Codex нажмите **Use Device Code**. Memoh покажет URL подтверждения и одноразовый код пользователя, а после того как вы подтвердите его на странице OpenAI, авторизация завершится автоматически.

> Вводите код только на показанном URL подтверждения OpenAI — коды устройств могут использоваться для фишинга.

## Обновления адаптеров

Адаптеры Codex и Claude Code распространяются через npm. Memoh определяет последнюю опубликованную версию адаптера один раз за запуск сервера (для каждого Bot) и запускает именно её, поэтому исправления адаптеров приходят без обновления самого Memoh. Если поиск версии или запуск не удаётся, Memoh откатывается на версию адаптера из образа рабочего пространства — до следующего перезапуска сервера.

***

## Усилие рассуждения

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

* Доступные варианты (и их названия) объявляет сам внешний агент; при смене модели они могут измениться.
* Значения по умолчанию, пока вы ничего не выбрали: у Codex — `medium`, у Claude Code — `high`.
* Выбор действует в рамках сессии и не зависит от выбора модели.

Если ранее выбранное усилие становится недоступным, Memoh обновляет список вариантов агента и просит выбрать заново, а не отказывает молча.

***

## Вложения

Сессии ACP-агентов поддерживают вложения в сообщениях:

* **Изображения** отправляются нативно, если агент объявил поддержку ввода изображений. Иначе Memoh по возможности автоматически ссылается на изображение как на файл рабочего пространства.
* **Файлы**, длинный вставленный текст и вложения из цитируемых сообщений и ответов передаются агенту как пути рабочего пространства или публичные URL.
* Можно отправить вложение вообще без текста.

Если вложение не удаётся доставить агенту, Memoh сообщает в чате понятную ошибку, а не отбрасывает его молча.

***

## Агент по умолчанию

В настройках взаимодействия Bot можно выбрать **Default Agent** (агент по умолчанию) — сам Memoh или любой включённый и полностью настроенный ACP-агент. Выбор применяется только к новым сессиям один на один; существующие сессии и групповые разговоры discuss не затрагиваются.

***

## Сессии ACP-агентов

Работа через ACP использует тип сессии `acp_agent`. Такие сессии создаются и управляются рабочим процессом Agents/ACP, а не обычной маршрутизацией `/new chat` или `/new discuss`. В приложении можно отфильтровать сессии по `acp_agent`, чтобы смотреть работу агентов для программирования отдельно от повседневных разговоров.

***

## Связанные страницы

* [Работа с Bot](./working-with-bots.md)
* [Сессии](./sessions.md)
* [Файлы](./files.md)
* [Провайдеры и модели](../integrations/providers/llm.md)