Создание и настройка агента

Для создания агента нужны только две вещи: имя и выбор инструмента AI-программирования. Все остальное опционально — системные инструкции, модель, переменные окружения, аргументы командной строки, видимость, лимиты параллелизма — используются значения по умолчанию, так что можно начать быстро, а затем настроить позже; все поля можно изменить в любой момент.

Создание агента

Предварительные условия: на вашем компьютере установлен как минимум один поддерживаемый инструмент AI-программирования (Claude Code, Codex и др.) и запущен демон. Если вы еще не дошли до этого этапа, ознакомьтесь с быстрым стартом в облаке или быстрым стартом для саморазвертывания.

После выполнения условий перейдите на страницу Агенты в рабочем пространстве и нажмите + Создать или используйте команду:

predictorx agent create

В форме есть только два обязательных поля: имя (уникальное в рамках рабочего пространства) и среда выполнения (= выбор одного AI-инструмента). Другие поля будут разобраны далее.

Выбор инструмента AI-программирования

За средой выполнения стоит конкретный AI-инструмент. Предиктор Икс поддерживает 12 инструментов, самые популярные:

Остальные 7 инструментов (Antigravity, Hermes, Kimi, Kiro CLI, OpenCode, Pi, OpenClaw), а также сравнение их полных возможностей (восстановление сессии, MCP, пути внедрения навыков, выбор модели) см. в разделе Сравнение AI-инструментов.

Написание системных инструкций

Системные инструкции (instructions) добавляются в начало каждой задачи, определяя роль агента и правила, которым он должен следовать:

Ты — агент по проверке фронтенд-кода. Получив задачу, сначала прочитай diff, обращая внимание только на:
- проблемы стилизации (классы tailwind, блочная модель)
- доступность (a11y)
Не меняй код, только давай советы в комментариях.

Если оставить поле пустым (по умолчанию), агент использует поведение инструмента AI-программирования по умолчанию без дополнительных ограничений.

Выбор модели

Большинство AI-инструментов поддерживают выбор модели (например, Claude Code позволяет выбрать между Sonnet / Opus). Оставьте пустым → будет использована модель по умолчанию для инструмента; если выбрана явно → будет использована выбранная. Модели, поддерживаемые каждым инструментом, см. в разделе Сравнение AI-инструментов.

Изменение модели применяется только к новым задачам. Уже распределенные задачи продолжают выполняться с той моделью, которая была зафиксирована в момент запуска.

Пользовательские переменные окружения (custom_env)

Пользовательские переменные окружения (custom_env) позволяют внедрять дополнительные переменные окружения при выполнении задачи — обычно используются для API-ключей или переключения апстрим-эндпоинтов:

ANTHROPIC_API_KEY = sk-...
ANTHROPIC_BASE_URL = https://my-proxy.example.com

Системные критические переменные не могут быть перезаписаны: PATH, HOME, USER, SHELL, TERM, CODEX_HOME, а также любые ключи, начинающиеся с PREDICTORX_*, будут молча игнорироваться демоном (в логах появится предупреждение, но ошибки не будет).

Пользовательские аргументы командной строки (custom_args)

Пользовательские аргументы командной строки (custom_args) — это массив строк, который будет добавлен в конец команды запуска AI-инструмента:

["--max-turns", "100", "--append-system-prompt", "always respond in Chinese"]

В итоге получится:

claude --model <model> --max-turns 100 --append-system-prompt "always respond in Chinese" [...]

Аргументы передаются как есть, без парсинга оболочкой (риска инъекций нет), но то, распознает ли инструмент конкретный флаг, зависит от самого AI-инструмента — между ними есть существенные различия.

Видимость

• Видимый в рабочем пространстве (workspace) — может быть назначен любым участником рабочего пространства
• Приватный (private) — может быть назначен только владельцем/администратором рабочего пространства или создателем агента

При создании по умолчанию стоит private.

Приватный не значит скрытый — все участники могут видеть имя и описание приватного агента в списке, но не видят конфиденциальную конфигурацию (значения env никогда не появляются в ответе agent list/get; конфигурация MCP для тех, кто не является владельцем, будет скрыта). Полное значение см. в Агенты → Кто может назначать агентов.

Лимит параллелизма

Лимит параллелизма (max_concurrent_tasks) определяет, сколько задач агент может выполнять одновременно, по умолчанию 6. Новые задачи при достижении лимита остаются в очереди и не отклоняются.

Это только один уровень лимитов — уровень "агента", у демона есть еще более широкий лимит (по умолчанию 20), действует более строгий из двух уровней. Подробнее см. в Демон и среда выполнения → Сколько задач может выполняться параллельно.

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

Добавление профессиональных знаний: Skill

Созданному агенту можно добавить Skill — пакет специальных знаний (SKILL.md + вспомогательные файлы), которые автоматически передаются соответствующему AI-инструменту при выполнении задачи. Можно создать новые, импортировать из GitHub / ClawHub или добавить из локальной папки навыков. Подробнее см. в Навыки.

Архивация и восстановление

Больше не нужных агентов можно архивировать — они исчезают из общего вида, но исторические данные (выполненные задачи, отправленные комментарии) сохраняются. Если агент снова понадобится, его можно восстановить.

Архивированные агенты не могут получать новые задачи.

Следующие шаги

• Навыки — добавление пакетов специальных знаний агенту
• Сравнение AI-инструментов — полные различия в возможностях 12 инструментов
• Назначение задачи агенту — как начать использование после создания