Настройка

Команда

Роли капитан, лид, исполнитель и 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 teamDispatcher, Team Lead, Developer 1, Developer 2, DevOps, Deploy, Checker
GroupDispatcher, Собеседник и исполнители Поисковик, Документы, Голос, Дизайнер — для бота в групповом чате

Шаблон применяется к команде, в которой ещё нет капитана и 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_catalogteams:readчто есть на колыбели: модели, инструменты, базы знаний, MCP-серверы, скиллы, политики, команды
cradle_team_planteams:readпроверка манифеста и план без записи
cradle_team_applyagents:writeсоздать (create) или заменить (replace) команду; создание — ключ admin:* или человек
cradle_team_exportteams:readманифест команды по slug
  1. Включите MCP-канал (Каналы); он слушает 127.0.0.1:31417.

  2. Выпустите ключ (admin:* для создания команд, Вход, люди и ключи) и сохраните файл cradle-mcp.json:

    {
      "mcpServers": {
        "cradle": {
          "type": "http",
          "url": "http://127.0.0.1:31417/mcp",
          "headers": { "x-api-key": "ck_live_..." }
        }
      }
    }
  3. Запустите 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: <имя> — имя инструмента неверно.