Профили

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

Большинству пользователей следует начать со встроенного профиля и изучить его итоговый preview. Для обычного использования не нужно создавать необработанный JSON.

Чем управляет профиль

Итоговая конфигурация профиля может включать:

конфигурацию провайдера, модель и интенсивность рассуждения;
роль: supervisor, developer, reviewer или specialist;
инструкции и ссылки на skills;
разрешённые инструменты и MCP-возможности;
тайм-ауты и поведение выполнения;
ограничения полномочий writer или уровня owner;
предназначен ли он оставаться резидентным или завершать ограниченную задачу.

Мощность модели и роль в оркестрации — разные вещи. Сильная модель не становится автоматически supervisor, а имя профиля не определяет, как учитывается ёмкость.

Встроенные профили

ThreadCells поставляет неизменяемые профили для распространённых ролей, включая обычных и более сильных supervisor, developer, reviewer, работу над архитектурой и стратегией, frontend/UI и узко ограниченного owner-авторизацией исполнителя XHigh.

Примеры:

supervisor_terra_medium: постоянный orchestrator по умолчанию для обычных рабочих процессов и задач среднего риска; он выполняет декомпозицию, делегирование, проверку, приёмку и интеграцию.
supervisor_sol_medium: supervisor, ориентированный на оркестрацию рискованных, межмодульных, архитектурно чувствительных или чувствительных к жизненному циклу рабочих процессов.
developer_terra_medium: рутинная, ограниченная реализация с низкой неоднозначностью.
developer_terra_high: важная продуктовая работа, сложные ограниченные дефекты и рефакторинги, а также качество публичной семантики.
developer_sol_medium: работа, требующая глубокого анализа между подсистемами и тонких инвариантов.
reviewer_sol_high: независимая проверка рискованных или интегрированных изменений.
critical_sol_xhigh_owner: исключительный профиль owner-executor с отдельной границей авторизации.

Встроенные профили неизменяемы, поэтому знакомый ID не может незаметно изменить смысл. Чтобы настроить один из них, продублируйте его: копия получит пользовательскую идентичность.

Выбор профиля

Используйте наименее специализированный профиль, который может надёжно владеть задачей:

Задача	Отправная точка
Небольшое ограниченное изменение кода	developer
Независимая приёмочная проверка	reviewer
Несколько зависимых потоков работы	supervisor
Проектирование архитектуры или миграции	специалист по архитектуре/стратегии
Реализация UI продукта	frontend- или UI/UX-специалист
Критическое пограничное выполнение владельца	только XHigh, авторизованный owner

Больше рассуждений и более широкие полномочия требуют ёмкости и увеличивают последствия. Они должны соответствовать задаче, а не становиться значениями по умолчанию.

Supervisor Sol не подразумевает разработчика Sol. Он по-прежнему должен направлять рутинную реализацию разработчикам Terra и оставлять developer_sol_medium для работы, корректность которой зависит от тонкого межсистемного анализа.

Повторные попытки и эскалация

ThreadCells классифицирует неудачные попытки реализации перед выбором следующего агента:

Класс сбоя	Каноническая реакция
`OPERATIONAL_FAILURE`	Повторная попытка на том же уровне может быть обоснованной.
`MECHANICAL_INCOMPLETE`	Допускается одно ограниченное исправление на том же уровне.
`SEMANTIC_QUALITY_FAILURE`	Повысить уровень реализации; никогда не выполнять третью семантическую попытку на том же уровне.
`BOUNDARY_COMPLEXITY_UNDERESTIMATED`	Выбрать более сильного разработчика.
`CRITICAL_SYSTEMIC_BOUNDARY`	Использовать авторизованный владельцем `critical_sol_xhigh_owner`.

Обычный путь эскалации: developer_terra_medium → developer_terra_high → developer_sol_medium. XHigh предназначен для действительно критических системных полномочий: безопасности, exactly-once concurrency, разрушительного обслуживания, миграций или опасного восстановления. Успешные тесты — необходимое свидетельство, но сами по себе они не доказывают качество семантики.

Итоговый preview

Settings → Profiles показывает как сохранённый артефакт, так и его итоговый preview. Перед запуском используйте preview, чтобы проверить фактические провайдер, модель, интенсивность рассуждений, роль, инструменты, полномочия, тайм-ауты и инструкции после применения значений по умолчанию и ссылок.

Новые запуски атомарно фиксируют эту итоговую ревизию. Позднее редактирование пользовательского профиля создаёт другую неизменяемую ревизию и не переписывает исторический смысл существующей сессии.

Старые сессии, созданные до снимков ревизий, могут показывать legacy/unavailable snapshot. ThreadCells не фабрикует прошлую конфигурацию.

Создание пользовательского профиля

Самый безопасный путь:

Откройте Settings → Profiles.
Выберите ближайший встроенный профиль.
Продублируйте его.
Дайте копии понятное имя по роли.
Измените минимально необходимые поля.
Изучите итоговый preview.
Используйте его для ограниченного пробного запуска до более широкой работы.

Пользовательские изменения создают ревизии. Профиль, на который ссылается история, отключается, а не удаляется разрушительно.

Специализированные полномочия и полномочия owner

Недоверенные импорты не могут создавать полномочия owner-executor, XHigh, unrestricted или danger-full-access. Аутентифицированный оператор может создать привилегированную пользовательскую ревизию только через защищённую control plane, а сервер всё равно требует применимый одноразовый grant owner при запуске.

Встроенный профиль critical_sol_xhigh_owner можно выбрать в обоих Web-сценариях запуска: при создании сессии или добавлении агента к существующей сессии. Каждый показывает блок исключительных полномочий и требует явного подтверждения вместе с кратковременной разблокировкой оператора перед выпуском и потреблением одной обычной возможности запуска. Add Agent ограничивает эту возможность существующей сессией и каноническим унаследованным/проектным working directory. Локальный CLI предоставляет тот же класс полномочий через --owner-xhigh и интерактивное подтверждение. Ни один из этих путей не создаёт многоразовый API-обход и не авторизует другие профили, дочерние терминалы или несвязанные изменения Settings.

Профили и ёмкость

Сессия supervisor или owner верхнего уровня занимает резидентную ёмкость supervisor. Делегированный дочерний агент занимает слот рабочего контекста. Выполнение провайдером и тяжёлое выполнение учитываются отдельно по активности, а не только потому, что имя профиля содержит supervisor или reviewer.

Перед повышением параллелизма для мощных профилей см. Модель ёмкости и ресурсов.

Расширенный импорт и экспорт

CLI предоставляет текущую схему и примеры:

threadcells profiles schema
threadcells profiles example
threadcells profiles export
threadcells profiles validate /path/to/profile.json
threadcells profiles import /path/to/profile.json

Проверяйте до импорта. Импорты используют ту же проверку сервиса, что и UI, и не могут внедрить исполняемые команды MCP. Они могут ссылаться на установленные конфигурации провайдеров и зарегистрированные идентификаторы возможностей.

Не редактируйте строки базы данных вручную и не копируйте личные инструкции, пути файловой системы, учётные данные или внутреннее состояние owner в публичный артефакт профиля.

Распространённые ошибки

Выбирать профиль только по имени модели.
Давать повседневному исполнителю полномочия уровня owner.
Редактировать пользовательский профиль, не проверив итоговый preview.
Ожидать, что редактирование изменит уже запущенные сессии.
Импортировать необработанные значения секретов вместо разрешённых ссылок.
Считать профиль установкой провайдера: выбранный CLI всё равно должен быть готов.

Далее см. Рабочие процессы и сохранённые результаты, чтобы узнать, как сотрудничают профили supervisor и worker.

Создано и поддерживается Субаевым Русланом при участии сообщества ThreadCells. Открыть репозиторий