Команда
Роли капитан, лид, исполнитель и Checker, создание команды, шаблоны, манифест cradle.team/v1, настройка через Claude по MCP, инструменты исполнителей.
Команда — единица, с которой работает консоль: у неё свои агенты, базы знаний, тикеты и разговоры. Команда живёт в одной колыбели и принадлежит организации.
1. Роли в команде
| Роль в консоли | Что делает |
|---|---|
Капитан (captain) | корень структуры, один на команду; сообщения напрямую не получает |
Лид (lead) | подчиняется капитану; получает входящее сообщение и решает: ответить самому, поручить исполнителю или позвать человека |
Исполнитель (executor) | подчиняется лиду; работает только по поручениям лида (задачам) |
Checker (checker) | один на команду, хранится в структуре; сообщения напрямую не получает и как агент не вызывается |
Ответ перед отправкой проверяют программные проверки (цитаты, гигиена ответа); не прошёл — тикет ждёт человека (Ждут решения). «Общие» исполнители (без лида) получают поручения от любого лида. Подробнее о маршрутизации — Триаж и риск-движок.
2. Создайте команду
В консоли: Команды → Добавить команду → в окне «Новая команда» введите
Название (например «Поддержка»), при нескольких колыбелях выберите
Колыбель, нажмите Сохранить. То же командой (нужен admin:*):
cradle teams create support --name "Support"Команда сразу получает шаблон «Базовая команда»: Dispatcher (капитан), Team Lead (лид), Исполнитель и Checker; модели подбираются по требованиям команды (Ключи и модели).
Как проверить. На странице «Команды» появилась карточка команды; на её странице вид «Канвас» показывает четыре агента. Из CLI:
cradle teams use support
cradle agents listВ таблице четыре строки: Dispatcher, Checker, Team Lead, Исполнитель.
Если нет.
- «slug already taken» — команда с таким slug уже есть; консоль повторяет попытку с суффиксом, команда
cradle teams createотвечаетslug already taken— возьмите другое имя. - «Колыбель «…» не отвечает» — сервер не запущен или закрыт SSH-туннель GPU-сервера.
- У агентов предупреждение про модель — нет подходящей модели или контур закрыт (Ключи и модели).
3. Шаблоны команд и агентов
На странице команды нажмите Шаблоны. Вкладка Команды — готовые команды; кнопка Создать команду добавляет их агентов в открытую команду и пишет «Создано агентов: N»:
| Шаблон | Агенты |
|---|---|
| Базовая команда | Dispatcher, Team Lead, Исполнитель, Checker |
| Dev team | Dispatcher, Team Lead, Developer 1, Developer 2, DevOps, Deploy, Checker |
| Group | Dispatcher, Собеседник и исполнители Поисковик, Документы, Голос, Дизайнер — для бота в групповом чате |
Шаблон применяется к команде, в которой ещё нет капитана и Checker; иначе ответ — «team already has a captain: apply the team template to a team without a captain and a checker». Вкладка Агенты — шаблоны одного агента (поддержка, продажи, юрист и другие): клик открывает форму агента с заполненным промптом.
Из CLI (шаблон одного агента):
cradle agents create --template support --name "Support"Как проверить. В списке cradle agents list — новый агент; на канвасе появились агенты.
4. Настройте агента
Кликните агента на канвасе — справа откроется форма. Что менять в первую очередь:
- System prompt — что агент делает и чего не делает;
- «Требование» и Model — какую модель получит агент (Ключи и модели);
- Knowledge Bases — базы знаний агента (Базы знаний);
- Inbound sources (только у лида) — откуда он принимает сообщения: «любой» или
telegram,telegram:private,telegram:group,widget,api,mcp-server; - Grounding mode —
Off,Soft(по умолчанию) илиStrict: приStrictкаждый факт подтверждается источником из базы знаний.
Нажмите Save; кнопка «Выключить» / «Включить» отключает агента.
Как проверить. После Save форма не показывает ошибку, а при повторном открытии агента значения те же.
Если нет. Ошибка team_invariant — нарушена структура команды (один
капитан и один Checker, лид подчиняется капитану, исполнитель — лиду).
5. Манифест cradle.team/v1
Команда целиком — один JSON-документ (Манифест команды,
схема /schemas/team.v1.json). На странице команды:
- Экспорт скачивает файл
<slug>.team.json; - Импорт открывает окно «Импорт команды из манифеста»: вставьте JSON или выберите файл (Файл…), нажмите Проверить — покажет план («Создать», «Обновить», «Удалить») и недостающее; затем Создать команду или, с отметкой «Заменить текущую команду», Применить замену.
Проверка без записи — окно «Проверить» или инструмент cradle_team_plan (шаг 6); создание команды требует ключа admin:* или человека.
Как проверить. Проверка проходит: "valid":true, "blocking":false,
пустой errors.
Если нет.
errorsсодержит путь JSON Pointer и причину — исправьте поле.- В
missing.models— модели нет на колыбели: зарегистрируйте её (cradle models add <ref> …, Ключи и модели);blockingстанетfalse. - Базы знаний и MCP-серверы из манифеста, которых нет на колыбели, не блокируют применение: агент помечается «Не привязано при импорте» — выберите базу в форме агента и сохраните.
6. Настройка через Claude по MCP
Четыре инструмента MCP-канала собирают и применяют команду без консоли:
| Инструмент | Скоуп | Что делает |
|---|---|---|
cradle_catalog | teams:read | что есть на колыбели: модели, инструменты, базы знаний, MCP-серверы, скиллы, политики, команды |
cradle_team_plan | teams:read | проверка манифеста и план без записи |
cradle_team_apply | agents:write | создать (create) или заменить (replace) команду; создание — ключ admin:* или человек |
cradle_team_export | teams:read | манифест команды по slug |
-
Включите MCP-канал (Каналы); он слушает
127.0.0.1:31417. -
Выпустите ключ (
admin:*для создания команд, Вход, люди и ключи) и сохраните файлcradle-mcp.json:{ "mcpServers": { "cradle": { "type": "http", "url": "http://127.0.0.1:31417/mcp", "headers": { "x-api-key": "ck_live_..." } } } } -
Запустите Claude Code с этим файлом:
claude --mcp-config cradle-mcp.json. Попросите, например: «Покажи, что есть на колыбели (cradle_catalog), собери команду из капитана, лида с исполнителем и Checker, проверь еёcradle_team_planи покажи план». Применять (cradle_team_apply) стоит только после вашего согласия с планом.
Как проверить. Без Claude: curl http://127.0.0.1:31417/health отвечает
"ok":true и "toolCount":12. Вызов cradle_catalog возвращает модели,
инструменты и команды.
Если нет. Ответ unauthorized — нет ключа или заголовка x-api-key
(Authorization: Bearer … тоже подходит); ECONNREFUSED — MCP-канал не
включён; ответ 405 на GET /mcp — норма, MCP использует POST /mcp.
7. Инструменты исполнителей и внешние MCP-серверы
Исполнитель, получивший поручение, работает в цикле «модель → инструмент →
результат» (не больше 4 итераций) и вызывает только инструменты из своего
списка. Каждый вызов проходит через шлюз; инструмент класса irreversible не
выполняется сам — тикет получает причину tool_approval
(Ждут решения).
| Инструмент | Что делает | Что нужно |
|---|---|---|
web.search | поиск в интернете, до 8 результатов | SearXNG: CRADLE_SEARXNG_URL или settings.search.searxngUrl (из клона репозитория — cradle server docker up searxng); либо Brave по ключу провайдера brave |
web.fetch | текст страницы по URL, до 8 000 символов | в Docker закрыт для внутренней сети: CRADLE_WEB_ALLOW_PRIVATE |
doc.read | текст вложения разговора (PDF, DOCX, XLSX, CSV) | — |
doc.create | файл PDF, DOCX, CSV или XLSX | — |
tts.speak | голосовое сообщение (Amazon Polly) | AWS-учётные данные хоста |
image.generate | картинка 1024×1024 (OpenAI) | ключ провайдера openai |
В форме агента поля «инструменты» нет. Список задаётся полем tools манифеста
(web.search, web.fetch, doc.read, doc.create, tts.speak,
image.generate), или шаблоном «Group».
Внешние MCP-серверы (инструменты чужих сервисов для агентов) в версии 0.9.2
из веб-консоли не добавить: страница «MCP-серверы» показывает «Недоступно через
HTTP этой колыбели», а вызова для их добавления на сервере нет. Агент выбирает
только серверы, уже существующие на колыбели (поле «External MCP tools»;
в манифесте — mcpServers).
Как проверить. cradle_catalog перечисляет инструменты колыбели в поле
tools, а экспорт манифеста показывает у агента поле
tools.
Если нет. search is not configured: set settings.search.searxngUrl (or CRADLE_SEARXNG_URL) — не настроен поиск; unknown tool: <имя> — имя
инструмента неверно.