Агенты: помощники ИИ в чатах

Агенты – это небольшие помощники ИИ, которые срабатывают вокруг основного ответа в чате. Один следит за временем и погодой, другой подбирает выражение лица персонажа, третий рисует изображение для важного момента. Это руководство показывает, как установить агентов, включить их в чате и проверить, что они сработали.

Что такое агенты

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

В свежей установке нет дополнительных агентов. Устанавливайте их из Agent Organizer (организатор агентов) – магазина официальных пакетов, которые устанавливаются одним нажатием. Исходный код и каталог открыты в репозитории Pasta-Devs/Marinara-Agents. Устанавливайте агентов через Agent Organizer, чтобы Marinara могла проверить совместимость, разрешения и хеши файлов. Что делает каждый агент, описано в руководстве Справочник агентов для скачивания. Как сделать своего: Создание своих агентов.

Добавление агента в чат

Перед началом: сначала установите агента. Откройте панель Agents (агенты) – значок Sparkles во вкладках справа, – нажмите Agent Organizer, откройте страницу агента и нажмите Get (получить). См. Установка и обновление агентов.

1. Откройте чат.
2. Откройте Chat Settings (настройки чата) и найдите раздел Agents.
3. Включите Enable Agents (включить агентов). Это главный переключатель: пока он выключен, в этом чате не работает ни один агент.
4. Нажмите Add Agent (добавить агента), откройте группу, к которой относится агент (например, Writer Agents (агенты-писатели) или Misc Agents (прочие агенты)), и выберите его.

Добавленные агенты появляются в списке активных, и у каждого есть маленькая кнопка удаления. Добавлять и убирать агентов можно в любой момент.

Примечание: Каждый режим чата показывает только тех агентов, которые в нем работают. В режиме Conversation установленные игры появляются в списке выбора игр, а Calls добавляет элементы управления на панель инструментов. В Game Mode агентов выбирают при создании игры или добавляют позже.

Если агент не сработал, проверьте, что Enable Agents включен, что агент активен в этом чате и что его режим совпадает с режимом чата.

Другие элементы управления в разделе Agents

Эти элементы находятся в том же разделе Agents.

• Agent Menus (меню агентов; только Roleplay): нажмите имя агента, чтобы перейти к его настройкам.
• Trackers Control (управление трекерами; только Roleplay): свернутая карточка с настройками трекеров, перечисленными ниже.
• Agent Suite: открывает окно, где можно прочитать и поправить то, что агенты сохранили для этого чата.
• Review Agent Outputs (проверять результаты агентов): изменения в лорбуках, сводках и карточках персонажей ждут вашего подтверждения. В Roleplay этот переключатель находится внутри Trackers Control. См. Одобрение записей агентов и редактор Agent Suite.

Настройки внутри Trackers Control:

• Attach chat summaries (прикреплять сводки чата): по умолчанию выключено. Добавляет сохраненные сводки чата в запросы агентов, в том числе при повторных запусках. Настройка не убирает сводки из основного ответа и не останавливает их создание. Агенты с доступом ко всему основному промпту по-прежнему могут читать сводки внутри него.
• Attach Lorebooks to Trackers (прикреплять лорбуки к трекерам): агенты-трекеры также получают записи лорбуков, использованные для основного ответа. Появляется, как только в чате есть агент-трекер.
• Individual tracker schedule (расписание отдельных трекеров): не дает трекеру срабатывать после каждого ответа. Его запускают вручную с панели HUD (экранной панели с состоянием в режиме Roleplay).

Справочный лорбук для одного агента

1. В Chat Settings откройте Agents, затем настройки агента.
2. Включите Attach lorebook for the specific agent (прикрепить лорбук для этого агента). Изначально эта настройка выключена.
3. Выберите лорбук в поле Reference lorebook (справочный лорбук).

Выбор относится к этому агенту в этом чате. Подходящие записи следуют обычным правилам срабатывания лорбуков и передаются этому агенту, в том числе при ручных повторах. Эта настройка не добавляет лорбук в основной ответ или посторонним агентам, но агенты, работающие вместе, тоже могут видеть те же записи. Удаленные или недоступные лорбуки ничего не передают.

Когда срабатывают агенты

Каждый агент срабатывает в одной точке вокруг ответа. Эта точка называется pipeline phase (фаза конвейера). У каждого встроенного агента есть значение по умолчанию. Его можно изменить в редакторе агента.

Как понять, что агент сработал

• Агенты-трекеры пишут на панель HUD и в панели трекеров. Если изменились время, место, настроение или показатели, значит, трекер сработал.
• Раздел Agent activity (активность агентов) в Chat Settings показывает короткие заметки агентов. Пока они работают, его значок вращается, а когда один из них дает сбой, на значке появляется точка. См. Agent activity.
• Prose Guardian и Continuity Checker меняют текст ответа. Вычищенный или исправленный ответ означает, что они сработали.
• Для полной картины включите Debug mode (режим отладки) в Settings → Advanced → Message Tools (настройки → дополнительно → инструменты сообщений). Он записывает промпт и ответ каждого агента в консоль сервера, а отладочные записи агентов появляются и в консоли браузера. Кешированные вставки в промпт показываются на вкладке Injections (вставки) раздела Agent activity.

Следите за расходами

Каждый агент добавляет свои инструкции, а часто и отдельный вызов модели. Агентов с общим подключением Marinara по возможности объединяет в один вызов.

Над списком агентов показана оценка дополнительных токенов и вызовов на один ход. Нажмите значок справки рядом с ней, чтобы узнать подробности. Когда нагрузка большая, оценка желтеет и рядом появляется значок предупреждения. Реальный расход выше, потому что с каждым вызовом уходят история чата и сведения о персонаже.

Если вы видите предупреждение, уберите ненужных агентов или переведите часть на более дешевое или локальное подключение. Значение Reasoning Effort (глубина рассуждений), сохраненное в подключении, действует и на агентов, которые его используют. См. Параметры для агентов.

Установка и обновление агентов

Откройте панель Agents (значок Sparkles во вкладках справа) и нажмите Agent Organizer. Он работает и на компьютере, и на телефоне.

• Home (главная) показывает рекомендуемых агентов и подборку для каждого раздела: Apps (приложения), Chat games (игры в чате), Trackers (трекеры) и Writing help (помощь в написании текста).
• Updates (обновления) перечисляет установленных агентов, для которых есть более новая версия. Installed (установленные) перечисляет все, что у вас есть, с версией и размером.
• Поиск и фильтр режима сужают каждый список.
• Выберите агента, чтобы увидеть его описание, размер скачивания, разрешения, совместимость и Version history (история версий). Нажмите Get, чтобы установить его. В меню ⋯ есть Uninstall (удалить).
• В меню ⋯ рядом с заголовком есть Update all (обновить все), Install all (установить все), Refresh catalog (обновить каталог) и Uninstall all (удалить все).

Установленные агенты разложены по группам Apps, Writer Agents, Tracker Agents (агенты-трекеры) и Misc Agents, а для агентов, которых вы делаете сами, есть группа Custom Agents (свои агенты). Apps – это пакеты с собственной вкладкой Home, например Noodle и Slurp. Ими пользуются отдельно, а не добавляют в чат.

Пакет с меткой Rules (правила) – это не агент. Он добавляет набор правил Game Mode, например 5e (SRD 5.1), который выбирают в Rules при создании игры. См. Игра с набором правил. Пакет 5e находится в предварительной версии, поэтому его показывает только Engine из ветки staging.

Удаление пакета убирает его код и настройки, но сообщения и история чатов остаются. Удаленный свой агент исчезает безвозвратно.

Обновление агентов

Когда для установленного пакета есть более новая совместимая версия, открывается окно Agent updates available (доступны обновления агентов). В нем перечислены все обновления с версией и пометкой, нужен ли перезапуск.

1. Снимите флажок с каждого обновления, которое хотите пропустить. Изначально выбраны все обновления.
2. Прочитайте What's new (что нового), если пакет опубликовал описание изменений. More (подробнее) показывает длинное описание целиком. Точкой отмечено изменение, которое вы заметите.
3. Нажмите Update all, а если вы сняли часть флажков – Update 2 of 3 (обновить 2 из 3). Каждая строка показывает Updated или Failed. В строке неудачного обновления показаны причина и Retry (повторить).
4. Если обновлению нужен перезапуск, нажмите Restart now (перезапустить сейчас) или перезапустите Marinara позже.

Нажмите Not now (не сейчас), чтобы оставить свои версии. О пропущенной версии Marinara больше не спрашивает. Обновить пакеты через Agent Organizer можно в любой момент. Установленные пакеты продолжают работать в текущей версии, даже если каталог недоступен. See in Agent Organizer (посмотреть в организаторе агентов) открывает страницу агента.

Обновления касаются только установленных вами пакетов. Пакеты хранятся на сервере Marinara, поэтому клиенты в браузере используют то, что установлено на сервере.

При обновлении с версии Engine, где эти возможности входили в комплект, Marinara один раз скачивает нужные пакеты и сохраняет то, что вы выбрали в чатах, настройки и историю. Если каталог недоступен, попытка повторяется при следующем запуске.

Смежные руководства

• Справочник агентов для скачивания
• 2D- и 3D-аватары
• Создание своих агентов
• Одобрение записей агентов и редактор Agent Suite
• Панель HUD и трекеры в режиме Roleplay