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

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

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

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

Когда всё готово, перейдите на страницу Агенты в рабочем пространстве и нажмите + Новый, или используйте CLI:

aacworkflow agent create

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

Выбор AI-инструмента

Каждая среда выполнения основана на конкретном AI-инструменте. AACWorkflow поддерживает 16 из них. Наиболее популярные варианты:

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

Системные инструкции

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

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

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

Выбор модели

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

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

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

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

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

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

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

Пользовательские аргументы CLI (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.

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

Лимит параллельных задач

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

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

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

Прикрепление экспертизы: Навыки (Skills)

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

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

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

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

Дальнейшие шаги

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