Ваше первое рабочее пространство

Что вы создадите

К концу этого руководства у вас будет:

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

Онбординг уже создал вам рабочее пространство. В этом руководстве мы намеренно создаём новое, чтобы вы увидели каждую часть процесса.

Прежде чем начать, выберите рабочую копию Git, удовлетворяющую всем трём условиям, — на шаге регистрации всё остальное отклоняется:

• она находится внутри рабочего дерева git;
• у неё есть удалённый репозиторий origin;
• этот удалённый репозиторий указывает на github.com, gitlab.com или bitbucket.org.

Шаг 1. Создайте рабочее пространство

1. Нажмите чип рабочего пространства в строке заголовка
2. Выберите Добавить рабочее пространство…
3. Введите имя, идентифицирующее проект, например «api-service» или «frontend-v2»
4. При желании выберите логотип
5. Нажмите Добавить рабочее пространство

Control Center переключается на новое рабочее пространство и открывает его входящие (/workspaces/<id>/inbox).

За этим сервер публикует событие WorkspaceCreated и закладывает в рабочее пространство:

• агента CEO, чья персона — координация и делегирование;
• четырёх специалистов — qa, architect, engineer и librarian — каждого со своими инструкциями и навыками;
• встроенные шаблоны конвейеров и их строки триггеров.

Всё это получает каждое созданное вами рабочее пространство, а не только первое.

Контрольная точка. Откройте Настройки → Рабочее пространство → Агенты. В списке пять агентов, у каждого — пустое кольцо статуса.

Шаг 2. Зарегистрируйте репозиторий

1. Перейдите в Настройки → Рабочее пространство → Репозитории
2. Нажмите Добавить репозиторий
3. Перейдите к своей рабочей копии. Диалог обходит папки на машине, где запущен cc_server, а не на вашем клиенте, и остаётся внутри корней, которые предоставляет этот сервер (по умолчанию — домашний каталог его пользователя). Рабочая копия git получает отдельный значок папки и флажок; обычная папка не получает ни того, ни другого, поэтому выбрать можно только рабочие копии.
4. Отметьте одну или несколько рабочих копий и зарегистрируйте их пакетом. Выбор сохраняется при навигации, поэтому за один проход можно собрать несколько копий, и одна неудачная отметка никогда не сбрасывает остальные.

Control Center считывает у каждой рабочей копии удалённый репозиторий origin, определяет владельца и репозиторий и создаёт строку репозитория внутри этого рабочего пространства. Второго шага для связывания нет: именно регистрация задаёт область действия.

Если позже зарегистрировать ту же рабочую копию в другом рабочем пространстве, появится вторая, независимая строка репозитория со своим идентификатором. Между рабочими пространствами рабочая копия определяется путём в файловой системе, но никогда — идентификатором.

Контрольная точка. Репозиторий появляется в списке со своим owner/repo и текущей ветвью.

Шаг 3. Сделайте одного агента готовым к запуску

У пяти агентов, только что заложенных в это рабочее пространство, нет ни адаптера, ни модели. Диспетчеризация запускает их на Control Center (built-in) и, если модель не задана, запрашивает у Anthropic модель по умолчанию — поэтому они работают, только если вы подключили аккаунт Anthropic, и на модели, которую вы не выбирали, если подключили. Онбординг при первом запуске однократно закрепляет свой выбор за каждым агентом первого рабочего пространства; рабочее пространство, созданное после этого, начинает работу со всеми пятью агентами без заданных адаптера и модели. Задайте одного сейчас.

1. Откройте Настройки → Рабочее пространство → Агенты
2. Выберите engineer в списке
3. На вкладке Настройки в поле Адаптер укажите Control Center (built-in) и выберите Модель у провайдера, подключённого в разделе Настройки → Сервер → Провайдеры моделей
4. Нажмите Сохранить изменения

Контрольная точка. Откройте агента снова — оба поля сохраняют ваш выбор.

Каждый агент несёт собственные адаптер и модель, поэтому повторите это для любого другого агента, которого собираетесь использовать. Остальные поля формы разобраны в разделе Создать и настроить агента.

Шаг 4. Посмотрите на границу изоляции

Создайте второе рабочее пространство с помощью чипа в строке заголовка — точно так же, как на шаге 1. Затем посмотрите на него:

• Раздел Настройки → Рабочее пространство → Репозитории пуст. Репозитория, зарегистрированного минуту назад, там нет.
• В разделе Настройки → Рабочее пространство → Агенты пять агентов, но это другие строки: адаптер, заданный на шаге 3, исчез.
• Список пространств, тикеты и память пусты.

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

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

Полная модель описана в разделе Рабочие пространства и изоляция.

Итоги

Вы создали рабочее пространство, увидели, как оно закладывает агента CEO и четырёх специалистов, зарегистрировали в нём репозиторий, дали одному агенту адаптер и модель и убедились, что второе рабочее пространство не делит с ним ничего из этого.

Далее: Запустите первого агента, чтобы пустить рабочее пространство в работу.