Подключение инструментов

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

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

Скриншот скоро будетКаталог инструментов

Каталог в приложении — источник истины. Нет сервиса в каталоге — значит, подключить его пока нельзя, что бы ни подсказывали общие соображения. Есть — значит, работает, включая сервисы, которых вы там не ждали.

Как подключить

Два варианта, в зависимости от сервиса.

Через вход в сервис. Так устроен Google Calendar и подобные. Вы нажимаете «подключить», открывается вкладка провайдера, вы разрешаете доступ, и карточка обновляется сама, когда вы возвращаетесь. В BossForce вы ничего не вводите.

Через ключ. Так подключается большая часть каталога. Сервис выдаёт токен или ключ, вы вставляете его в окно подключения. У каждого поля есть ссылка на страницу, где этот ключ выдают, — искать по настройкам не придётся.

Скриншот скоро будетОкно подключения инструмента по ключу

Некоторым инструментам учётные данные не нужны вовсе — подключил и готово.

Можно и просто попросить: «подключи мой календарь» запускает тот же процесс из чата.

Как только инструмент подключён, агенты видят и используют его сразу. Во время heartbeat это разница между отчётом «я не смог посмотреть цифры» и отчётом с цифрами.

Ваши ключи

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

Ключ идёт в сейф, а не через разговор
Ключ идёт в сейф, а не через разговор

Отсюда практическое следствие: никто из поддержки BossForce никогда не попросит у вас пароль в переписке.

Что подключать

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

Где сервис умеет выдать ограниченный доступ — токен на один канал, одну таблицу, одну папку, — берите ограниченный. Это ничего не стоит и превращает ошибку агента в маленькую. Подробнее — в статьях что делегировать и данные и доступы.

Как отключить

Отключить можно с карточки инструмента или попросив агента. Доступ прекращается сразу, сохранённые учётные данные удаляются. Всё, что агент успел с его помощью сделать, остаётся на месте.

Для инструментов со входом через сервис доступ можно отозвать и на стороне провайдера, в своём аккаунте, — полезно знать, если хочется убрать подключение, не открывая BossForce.

Если чего-то нет или что-то сломалось

Нет в каталоге. Скажите, что вам было нужно. Просьба записывается в список инструментов воркспейса как «нужно, но недоступно», так что она не потеряется, а агент скажет, что можно сделать пока — обычно больше, чем кажется.

Подключено, но не работает. Обычно истёк или отозван ключ; переподключение чинит. Агент, как правило, уже положил во входящие блокировку с названием инструмента и шагом, на котором он встал.

Подключено, но не используется. Если агент не берёт подключённый инструмент, скорее всего, в его инструкциях про этот инструмент ничего не сказано. Скажите, для чего он, и агент это запишет.

Читать дальше