Быстрый старт

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

Этот путь проходят в браузере, устанавливать ничего не нужно: войдите → настройте рабочее пространство → позовите коллег → создайте агента → назначьте ему первую задачу → примите первое событие из внешней системы. Занимает около двадцати минут.

1. Войдите

Баунс входит по адресу электронной почты: вы вводите почту, получаете одноразовый код и подтверждаете его. Паролей нет, заводить отдельную учётную запись не нужно.

Если вас пригласил коллега, откройте ссылку из письма-приглашения и войдите тем же способом — приглашение действует 7 дней, после чего администратору нужно отправить новое.

2. Настройте рабочее пространство

При первом входе Баунс задаст несколько вопросов о вас и вашей задаче, а затем предложит создать рабочее пространство:

Название — обычно компания или подразделение.
URL — короткое латинское сокращение, из которого собирается адрес пространства (acme). Изменить его потом нельзя, поэтому берите узнаваемое.
Префикс задач — две-три буквы, с которых начинаются идентификаторы: ACME-1, ACME-2. Его видно в каждой ссылке и в каждом обсуждении, поэтому выберите узнаваемый.

Дальше идёт шаг подключения рантайма. Если машина уже развёрнута в вашем контуре, нажмите «Пропустить» — этот шаг ищет рантаймы, зарегистрированные лично вами, а серверный принадлежит всему рабочему пространству, и подключать его не нужно. Выбрать его вы сможете на следующем шаге, когда будете создавать агента.

3. Позовите коллег

Откройте настройки участников и нажмите Пригласить: введите адрес и выберите роль — администратор или участник. Человеку придёт письмо со ссылкой; аккаунт в Баунс заранее не нужен, он создаётся при первом входе.

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

4. Создайте первого агента

Откройте раздел Агенты и нажмите Новый агент:

Имя — как его будут звать в списке исполнителей и в @-упоминаниях.
Где выполнять — чип «Сервер»: агент работает в песочнице на сервере, машина не нужна.
Модель — оставьте «По умолчанию пространства», если не знаете, какую выбрать.
Видимость — «Рабочее пространство»: агентом могут пользоваться коллеги. «Личный» оставляет его владельцу агента и администрации.

Создать открывает страницу агента с новым чатом: напишите ему первое сообщение.

Затем откройте карточку агента и заполните две вещи, ради которых он и работает по-вашему, а не «вообще»:

Инструкции — постоянный бриф: роль, правила, что делать в спорных случаях. Например: «Ты аналитик клиентских обращений. Разбирай обращение по регламенту, в комментарии давай проект ответа и обоснование, спорные случаи не решай сам — эскалируй на человека».
Скиллы — в свойствах агента блок Скиллы и кнопка Добавить: регламент, методика, шаблон документа. Так агент отвечает по правилам вашей компании, а не по общим представлениям. См. Скиллы.

В каждом рабочем пространстве уже есть Помощник, агент по умолчанию: онбординг заканчивается первым чатом с ним, с ним же открывается Новый чат. Это обычный агент: его можно спросить, назначить на задачу или перенастроить.

5. Назначьте первую задачу

Создайте задачу — заголовок, описание, если нужно — проект и приоритет — и выберите исполнителем созданного агента. Он начинает сам, в течение секунд: подталкивать его не нужно.

Дальше вы наблюдаете за работой прямо в задаче:

Статус запуска проходит путь В очереди → Запуск → Работает → Завершено. Страницу обновлять не надо, всё приходит в реальном времени.
В свойствах задачи есть Запуски — там виден каждый запуск агента и его полный транскрипт: что агент читал, что делал и что решил.
Итог агент публикует комментарием в обсуждении, там же ему можно ответить — ответ запускает следующий запуск, и агент продолжает с того места, где остановился.

Задача в Бэклоге — исключение: агента на неё назначить можно, но работать он начнёт только после перевода задачи в активный статус. Если кажется, что «агент не отреагировал», сначала проверьте статус задачи.

6. Примите события из своих систем

Самый частый следующий вопрос: как отдать Баунс событие из внешней системы, чтобы агент реагировал сам. Это делает автопилот с триггером-вебхуком; полная механика — в разделе Вебхуки.

Откройте раздел Автопилот и создайте автопилот: название, исполнитель (агент, команда или воркфлоу) и промпт — текст поручения, с которым агент просыпается.
В созданном автопилоте нажмите Добавить триггер, выберите тип Вебхук и сохраните. Адрес генерируется после сохранения.
Скопируйте URL вебхука — кнопка на строке триггера.
Настройте свою систему на POST этого адреса с любым JSON.

curl -X POST "$URL_ВЕБХУКА" \
  -H "Content-Type: application/json" \
  -d '{"event":"deploy.finished","status":"failed","service":"billing"}'

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

Полезно знать сразу:

Ключ доступа — сам адрес. Вебхук не требует подписи: автопилот запустит любой, кто знает URL. Поэтому адрес хранят как секрет, не публикуют в задачах и скриншотах, а при утечке меняют на строке триггера — старый перестаёт работать немедленно.
Вебхук срабатывает с правами того, кто его настроил, поэтому URL виден только тем, кто вправе менять автопилот.
Повторы безопасны. Доставки дедуплицируются, поэтому ретраи вашей системы не создадут несколько задач.
Каждая доставка видна в автопилоте: тело запроса, заголовки и результат. Любую можно повторить вручную — удобно, пока настраиваете.

7. Что дальше

Одна задача и один вебхук — это проверка, что всё работает. Дальше начинается то, ради чего платформу ставят:

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

Как работает Баунс — словарь платформы и путь задачи целиком.
Агенты — все настройки агента и что он умеет.